Парсер KB Chachacha с доступом по API.Авто с пробегом у корейских дилеров: цена продавца и рыночная оценка площадки. Новые объявления и изменения цен приходят в ленте изменений.

GET/filters

Значения для фильтров /offers: марки и их модели, коробки, цвета, классы автомобилей, топливо, привод, регионы.

Пример

Ответ

{
  "mark": {
    "Hyundai": {
      "model": ["Avante", "Grandeur", "Ioniq 5", "Kona", "Santa Fe", "Sonata", "Staria", "Tucson", // ...]
    },
    "Kia": {
      "model": ["Carnival", "K5", "K8", "Niro", "Seltos", "Sorento", "Sportage", // ...]
    },
    "Volvo": {
      "model": ["S60", "S90", "XC40", "XC60", "XC90", // ...]
    },
    "...": { ... }
  },
  "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 - коробка, цвет кузова, класс автомобиля, топливо, привод, регион
• year_from, year_to - год от и до (сравнивается с year)
• km_age_from, km_age_to - пробег от и до, в км
• price_from, price_to - цена от и до, в вонах; объявления без цены (price равен -1) проходят под любой price_to, их убирает price_from=1

Фильтры принимают значения из /filters в любом регистре.

Примеры

Ответ

{
  "result": [
    {
      "id": 38188,
      "inner_id": "28286613",
      "change_type": "added",
      "created_at": "2026-09-29T05:02:28.319+03:00",
      "data": {
        "id": "38188",
        "inner_id": "28286613",
        "url": "https://www.kbchachacha.com/public/car/detail.kbc?carSeq=28286613",
        "mark": "Hyundai",
        "model": "Santa Fe",
        "generation": "The New Santa Fe TM",
        "configuration": "Diesel 2.2 4WD",
        "complectation": "Exclusive",
        "year": "2023",
        "price": "24700000",
        "km_age": "60819",
        "color": "Белый",
        "engine_type": "Дизель",
        "transmission_type": "Автомат",
        "body_type": "Внедорожник",
        "drive_type": "4WD",
        "displacement": "2151",
        "no_accidents": false,
        "equipment": "[\"Подогрев передних сидений\", \"Вентиляция сиденья водителя\", \"Задние датчики парковки\", \"Смарт-ключ\", \"Штатная навигация\", \"Боковые подушки безопасности\", \"Легкосплавные диски\", ...]",  // всего 41 опция
        "description": "무사고(완무)**시트플러스**스마트센스3**4WD",
        "region": "Кенгидо",
        "address": "경기 안산시 단원구 원포공원2로 24 (초지동)",
        "seller": "에이원모터스",
        "seller_type": "Дилер",
        "salon_id": "202545",
        "is_dealer": true,
        "phone": "050704721859",
        "latitude": "37.3010778",
        "longitude": "126.8121576",
        "offer_created": "2026-04-24",
        "images": "[\"https://img.kbchachacha.com/IMG/carimg/l/img08/img2828/28286613_2872692139496469.jpeg\", \"https://img.kbchachacha.com/IMG/carimg/l/img08/img2828/28286613_2872692503153851.jpeg\", ...]",  // всего 20 фото
        "extra_prep": {
          "registration_month": "2023-01",
          "car_number": "390서6303",
          "seats": 5,
          "seat_color": "Черный",
          "is_price_on_request": false,
          "is_lease_takeover": false,
          "lease_monthly_payment": null,
          "market_price_min": 22920000,
          "market_price_avg": 25570000,
          "market_price_max": 28210000,
          "insurance_accidents": 1,
          "insurance_accidents_total": 1,
          "total_loss": false,
          "flood": false,
          "owner_changes": 1,
          "seizure": false,
          "mortgage": false,
          "rental_history": true,
          "kb_diagnosis": true,
          "kb_warranty": true,
          "manufacturer_certified": false,
          "partner_certified": true,
          "kb_certified": false,
          "views": 778,
          "original_names": {
            "mark": "현대",
            "model": "싼타페",
            "generation": "더 뉴 싼타페 TM",
            "configuration": "디젤 2.2 4WD",
            "complectation": "익스클루시브"
          }
        }
      }
    },
    // ... еще до 19 объявлений этой страницы
  ],
  "meta": {
    "page": 1,
    "next_page": 2,
    "limit": 20
  }
}

Описание полей

Все поля до extra_prep приходят строками, числа тоже. У no_accidents и is_dealer значение true или false. Незаполненное поле приходит пустой строкой.

GET/change_id

По дате отдает ID, с которого читать /changes. Сутки считаются по времени Сеула. Если с этой даты изменений еще не было, придет 0.

Параметры

• date (обязательный) - дата в формате yyyy-mm-dd

Пример

Ответ

{ "change_id": 208455 }

Это значение передайте в /changes. Если вернулся 0, запросите ID позже, дату не меняйте.

GET/changes

Изменения по порядку. В change_type приходит added (новое объявление), changed (изменилась цена) или removed (снято с продажи).

Параметры

• change_id (обязательный) - с какого ID отдавать изменения

Пример

Ответ

{
  "result": [
    {
      "id": 208455,
      "inner_id": "28286640",
      "change_type": "added",
      "created_at": "2026-10-05T08:41:13.602+03:00",
      "data": { ... }  // объявление целиком, те же поля, что в /offers
    },
    {
      "id": 208456,
      "inner_id": "28286613",
      "change_type": "changed",
      "created_at": "2026-10-05T08:57:40.214+03:00",
      "data": { "new_price": 24200000 }  // продавец изменил цену, воны
    },
    {
      "id": 208457,
      "inner_id": "28286711",
      "change_type": "removed",
      "created_at": "2026-10-05T09:20:05.771+03:00",
      "data": {}  // объявление снято с продажи
    }
  ],
  "meta": {
    "cur_change_id": 208455,
    "next_change_id": 208458,
    "limit": 20
  }
}

Следующий запрос делайте с next_change_id из meta. Если он null, новых изменений пока нет, повторите запрос позже с тем же change_id.

GET/offer

Одно объявление по inner_id

Параметры

• inner_id (обязательный) - ID объявления на kbchachacha.com

Пример

Приходит карточка объявления без обертки result и data. Если объявление уже снято, придет ответ с кодом 404: {"error": "offer not found"}.