KB Chachacha APIПарсер и скрапер

GET/filters

Справочники и возможные значения для фильтрации

Ответ:

{
  "mark": {
    "Kia": {
      "model": ["Carnival", "EV6", "K5", "K8", "Mohave", "Morning", "Niro", "Ray", "Seltos", "Sorento", "Sportage", "Stinger"]
    },
    "Genesis": {
      "model": ["EQ900", "G70", "G80", "G90", "GV60", "GV70", "GV80"]
    },
    "BMW": {
      "model": ["3 Series", "5 Series", "7 Series", "X3", "X5", "X6", "X7", "i4", "i5", "iX"]
    }
    // ... и другие марки
  },
  "transmission_type": ["Автомат", "Вариатор", "Механика", "Прочее"],
  "color": ["Белый", "Желтый", "Зеленый", "Коричневый", "Красный", "Оранжевый", "Перламутровый", "Серебристый", "Серый", "Синий", "Фиолетовый", "Черный"],
  "body_type": ["Автобус", "Большой класс", "Внедорожник", "Грузовик", "Компактный класс", "Малолитражный", "Малый класс", "Микроавтобус", "Минивэн", "Спорткар", "Средний класс"],
  "engine_type": ["Бензин", "Бензин + Пропан", "Гибрид", "Гибрид (бензин)", "Гибрид (дизель)", "Гибрид (пропан)", "Дизель", "Другое", "Метан", "Пропан", "Электро"],
  "drive_type": ["2WD", "4WD", "AWD"],
  "region": ["Инчхон", "Канвондо", "Кванджу", "Кенгидо", "Кенсан-Намдо", "Кенсан-Пукто", "Пусан", "Седжон", "Сеул", "Тэгу", "Тэджон", "Ульсан", "Чеджу", "Чолла-Намдо", "Чолла-Пукто", "Чхунчхон-Намдо", "Чхунчхон-Пукто"]
}

GET/offers

Поиск объявлений с пагинацией и фильтрами

Параметры:

• page (обязательно) - номер страницы
• mark, model - марка и модель в написании из /filters
• transmission_type, color, body_type, engine_type, drive_type, region - коробка, цвет, класс машины, топливо, привод и регион в том виде, как их отдает /filters; регистр букв не учитывается
• year_from, year_to - границы для поля year
• km_age_from, km_age_to - диапазон пробега в километрах
• price_from, price_to - диапазон цены, воны

Ответ:

{
  "result": [
    {
      "id": 99818,
      "inner_id": "28740959",
      "change_type": "added",
      "created_at": "2026-09-29T07:19:18.930+03:00",
      "data": {
        "id": "99818",
        "inner_id": "28740959",
        "url": "https://www.kbchachacha.com/public/car/detail.kbc?carSeq=28740959",
        "mark": "Kia",
        "model": "Mohave",
        "generation": "Mohave The Master",
        "configuration": "3.0 Diesel 4WD",
        "complectation": "Masters Gravity",
        "year": "2022",
        "price": "31500000",
        "km_age": "109569",
        "color": "Черный",
        "engine_type": "Дизель",
        "transmission_type": "Автомат",
        "body_type": "Внедорожник",
        "drive_type": "4WD",
        "displacement": "2959",
        "no_accidents": false,
        "equipment": "[\"Подогрев передних сидений\", \"Вентиляция сиденья водителя\", \"Задние датчики парковки\", \"Люк\", \"Смарт-ключ\", \"Штатная навигация\"]",  // всего у этой машины 53 опции
        "description": "1인신조~~ 완전무사고차량입니다.... (렌트이력없음)<br/>2022년 7월등록~~ 모하비마스터3.0 디젤 4WD 마스터즈그래비티 풀옵션 차량입니다.. ...",
        "region": "Тэджон",
        "address": "대전광역시 서구 계룡로232번길 31",
        "seller": "주식회사 김서방",
        "seller_type": "Дилер",
        "salon_id": "114501",
        "is_dealer": true,
        "phone": "05048332992",
        "latitude": "36.3477091",
        "longitude": "127.3539739",
        "offer_created": "2026-09-08",
        "images": "[\"https://img.kbchachacha.com/IMG/carimg/l/img04/img2874/28740959_7670067415681513.jpg\", \"https://img.kbchachacha.com/IMG/carimg/l/img04/img2874/28740959_7670070461572003.jpg\"]",  // всего 31 фото
        "extra_prep": {
          "registration_month": "2022-07",
          "car_number": "289노1892",
          "seats": 7,
          "seat_color": "Черный",
          "is_price_on_request": false,
          "is_lease_takeover": false,
          "lease_monthly_payment": null,
          "market_price_min": 29840000,
          "market_price_avg": 33280000,
          "market_price_max": 36720000,
          "insurance_accidents": 1,
          "insurance_accidents_total": 1,
          "total_loss": false,
          "flood": false,
          "owner_changes": 1,
          "seizure": false,
          "mortgage": false,
          "rental_history": false,
          "kb_diagnosis": true,
          "kb_warranty": true,
          "manufacturer_certified": false,
          "partner_certified": false,
          "kb_certified": false,
          "views": 107,
          "original_names": {
            "mark": "기아",
            "model": "모하비",
            "generation": "모하비 더마스터",
            "configuration": "3.0 디젤 4WD",
            "complectation": "마스터즈 그래비티"
          }
        }
      }
    }
    // ... следующие объявления, всего до 20 на странице
  ],
  "meta": { "page": 1, "next_page": 2, "limit": 20 }
}

Поля карточки

Внутри extra_prep

GET/change_id

Получить первый ID изменения на конкретную дату (для /changes)

Параметры:

• date (обязательно) - дата в формате гггг-мм-дд

Ответ:

{ "change_id": 34419 }

Используйте это значение как параметр change_id в /changes

GET/changes

Поток изменений (новые/измененные/удаленные)

Параметры:

• change_id (обязательно) - начиная с какого change_id

Ответ:

{
  "result": [
    {
      "id": 34419,
      "inner_id": "26487093",
      "change_type": "added",    // added: новое объявление
      "created_at": "2026-09-29T03:46:49.147+03:00",
      "data": { ... }            // все поля объявления, как в /offers
    },
    {
      "id": 34420,
      "inner_id": "26502575",
      "change_type": "changed",  // changed: цена изменилась, значение в вонах
      "created_at": "2026-09-29T03:46:49.388+03:00",
      "data": { "new_price": 23000000 }
    },
    {
      "id": 34421,
      "inner_id": "28797429",
      "change_type": "removed",  // removed: объявление снято
      "created_at": "2026-09-29T08:48:00.262+03:00",
      "data": {}
    }
  ],
  "meta": { "cur_change_id": 34419, "next_change_id": 34422, "limit": 20 }
}