K Car APIПарсер и скрапер

GET/filters

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

Ответ:

{
  "mark": {
    "Hyundai": {
      "model": ["Accent", "Avante", "Casper", "Genesis", "Grandeur", "Ioniq", "Kona", "Nexo", "Palisade", "Porter", "Santa Fe", "Sonata", "Starex", "Staria", "Tucson", "Venue", "i40"]
    },
    "Kia": {
      "model": ["Bongo III Truck", "Carnival", "EV3", "EV6", "K3", "K5", "K7", "K8", "K9", "Mohave", "Morning", "Niro", "Pride", "Ray", "Seltos", "Sorento", "Sportage"]
    },
    "Genesis": {
      "model": ["EQ900", "G70", "G80", "G90", "GV70", "GV80"]
    }
    // ... остальные марки
  },
  "transmission_type": ["Автомат", "Механика"],
  "color": ["Белый", "Желтый", "Красный", "Перламутровый", "Серебристо-серый", "Серебристый", "Серый", "Синий", "Черный"],
  "body_type": ["Автобус", "Внедорожник", "Грузовик (двойная кабина)", "Грузовик (обычная кабина)", "Грузовик (полуторная кабина)", "Минивэн", "Пикап", "Седан", "Универсал", "Фургон", "Хэтчбек"],
  "engine_type": ["Бензин", "Водород", "Гибрид (бензин)", "Дизель", "Пропан", "Электро"],
  "drive_type": ["Задний", "Передний", "Полный"],
  "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": 142,
      "inner_id": "EC61380785",
      "change_type": "added",
      "created_at": "2026-09-29T02:49:46.872+03:00",
      "data": {
        "id": "142",
        "inner_id": "EC61380785",
        "url": "https://www.kcar.com/bc/detail/carInfoDtl?i_sCarCd=EC61380785",
        "mark": "Hyundai",
        "model": "Palisade",
        "generation": "The New Palisade",
        "body_configuration": "",
        "configuration": "Gasoline 3.8 2WD",
        "complectation": "Exclusive",
        "title": "Hyundai The New Palisade Gasoline 3.8 2WD Exclusive",
        "year": "2023",
        "price": "27900000",
        "km_age": "25339",
        "color": "Белый",
        "engine_type": "Бензин",
        "body_type": "Внедорожник",
        "transmission_type": "Автомат",
        "drive_type": "Передний",
        "displacement": "3778",
        "doors_count": "5",
        "horse_power": "295",
        "vin": "KMHR281EBPU592982",
        "no_accidents": false,
        "equipment": "[\"ABS\", \"Навигация\", \"Кожаные сиденья\", \"Литые диски\", \"Подушки безопасности: боковые\", \"Электропривод сиденья: водитель\"]",  // в полном ответе 39 опций
        "region": "Кенгидо/Инчхон",
        "seller": "K Car Gimpo",
        "salon_id": "087",
        "address": "경기도김포시김포대로1523-1 (장기동) 2동",
        "latitude": "37.658929",
        "longitude": "126.665366",
        "description": "● 차량 연식 대비 주행거리 매우 짧은 차량이며, 컨디션 역시 매우 우수한 차량입니다.<br/>● 신차가 대비 합리적으로 구매 가능한 가성비 추천 차량입니다. ...",
        "offer_created": "2026-06-27",
        "images": "[\"https://img.kcar.com/3dcarpicture/2026/08/087/61380785_2/main/main780.jpg\", \"https://img.kcar.com/3dcarpicture/2026/08/087/61380785_2/extra/extra_0_hq.jpg\"]",  // в полном ответе 40 фото
        "extra_prep": {
          "first_registration": "2023-03",
          "model_year": 2023,
          "price_base": 28400000,
          "is_discount": true,
          "is_time_deal": false,
          "is_reserved": false,
          "car_class": "SUV",
          "seats": 7,
          "accident_history": "Простой ремонт",
          "body_damage": {
            "frame": {},
            "exterior": { "bonnet": "repaired", "front-fender-right": "repaired", "front-door-right": "repaired", "back-door-right": "repaired" }
          },
          "insurance_history": {
            "checked_at": "2026-08-10",
            "accidents_count": 3,
            "own_damage_count": 2,
            "own_damage_amount": 771970,
            "other_damage_count": 1,
            "other_damage_amount": 1422584,
            "total_loss_count": 0,
            "flood_count": 0,
            "theft_count": 0,
            "owner_changes_count": 3,
            "plate_changes_count": 0,
            "rental_history": false,
            "business_use_history": false,
            "government_use_history": false,
            "uninsured_periods": "2023-03~2024-05"
          },
          "mileage_history": [
            { "date": "2025-05-29", "km": 16667, "source": "Страховая компания" },
            { "date": "2025-04-30", "km": 15993, "source": "K Car" }
          ],
          "badges": ["Малый пробег", "Гарантия производителя", "Ассистенты водителя"],
          "inspection_date": "2026-08-10",
          "views_count": 6054,
          "favorites_count": 53
        }
      }
    }
    // ... остальные машины, до 20 на странице
  ],
  "meta": { "page": 1, "next_page": 2, "limit": 20 }
}

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

Внутри extra_prep

GET/change_id

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

Параметры:

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

Ответ:

{ "change_id": 283 }

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

GET/changes

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

Параметры:

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

Ответ:

{
  "result": [
    {
      "id": 283,
      "inner_id": "EC61410729",
      "change_type": "added",    // added: машина появилась в продаже
      "created_at": "2026-09-29T02:58:42.752+03:00",
      "data": { ... }            // полная карточка, как в /offers
    },
    {
      "id": 284,
      "inner_id": "EC61414869",
      "change_type": "changed",  // changed: новая цена в вонах
      "created_at": "2026-09-29T03:16:53.512+03:00",
      "data": { "new_price": 10200000 }
    },
    {
      "id": 285,
      "inner_id": "EC60843517",
      "change_type": "removed",  // removed: машина снята с продажи
      "created_at": "2026-09-29T03:16:54.711+03:00",
      "data": {}
    }
  ],
  "meta": { "cur_change_id": 283, "next_change_id": 286, "limit": 20 }
}