K Car APIScraper & Parser

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": ["Automatic", "Manual"],
  "color": ["Black", "Blue", "Gray", "Pearl", "Red", "Silver", "Silver Gray", "White", "Yellow"],
  "body_type": ["Bus", "Hatchback", "Minivan", "Pickup", "SUV", "Sedan", "Truck (Double Cab)", "Truck (Regular Cab)", "Truck (Super Cab)", "Van", "Wagon"],
  "engine_type": ["Diesel", "Electric", "Gasoline", "Hybrid (Gasoline)", "Hydrogen", "LPG"],
  "drive_type": ["AWD", "FWD", "RWD"],
  "region": ["Chungbuk", "Chungnam", "Gangwon", "Gyeongbuk", "Gyeonggi/Incheon", "Gyeongnam", "Home Service Mega Center", "Jeonbuk", "Jeonnam", "Seoul"]
}

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": "White",
        "engine_type": "Gasoline",
        "body_type": "SUV",
        "transmission_type": "Automatic",
        "drive_type": "FWD",
        "displacement": "3778",
        "doors_count": "5",
        "horse_power": "295",
        "vin": "KMHR281EBPU592982",
        "no_accidents": false,
        "equipment": "[\"ABS\", \"Navigation\", \"Leather seats\", \"Alloy wheels\", \"Airbag: side\", \"Power seat: driver\"]",  // 39 опции в пълния отговор
        "region": "Gyeonggi/Incheon",
        "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": "Minor repair",
          "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": "Insurance company" },
            { "date": "2025-04-30", "km": 15993, "source": "K Car" }
          ],
          "badges": ["Low mileage", "Manufacturer warranty", "Driver assistance"],
          "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 (задължително) - дата във формат yyyy-mm-dd

Отговор:

{ "change_id": 283 }

Използвайте върнатата стойност като параметър change_id в /changes

GET/changes

Поток от промени (добавени/променени/премахнати)

Параметри:

• change_id (задължително) - от кое 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 }
}