AUTO-API.COM
Лого на KB Chachacha

KB Chachacha APIScraper & Parser

KB Chachacha API: обяви на корейски дилъри с цени във вонове, оценка на пазарната цена, застрахователни събития, флагове за залог и запор, оборудване и снимки.

Официални SDK библиотеки

Нашите SDK библиотеки включват методите на API-то като готови функции, а самите библиотеки са с отворен код в GitHub.

KB Chachacha API

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

API

Новите обяви в KB Chachacha, промените в цените и свалените от продажба автомобили пристигат като събития чрез метода /changes.

Ежедневни експорти

Ежедневен файл с обявите в KB Chachacha, които са активни същата сутрин.

Пълни данни

Марка, модел, поколение и ниво на оборудване, моделна година и месец на регистрация, пробег, гориво, скоростна кутия, клас на автомобила, цена и оценка на пазарната цена от KB Chachacha, застрахователни събития, смени на собственика, залог и запор, оборудване, продавач с адрес и телефон, снимки.

Получете достъп до APIДостъпът се предоставя до 2 минути

Базов URL

https://{access_name}.auto-api.com/api/v2/kbchachacha

Оторизация: api_key параметър

Ред на работа

1
/filtersмарките, моделите и стойностите, които филтрите приемат
2

Първоначално зареждане на обявите:

/change_id?date=...получаване на ID на промяната за първото събитие за деня
/offersизтегляне на обявите страница по страница
3
/changes?change_id=...нови обяви, промени в цените, свалени от продажба автомобили
4
/offerобява по inner_id

Откъде да започнете:

1. Започнете, като изпълните нужното ви търсене чрез /offers: задайте марката, модела и ограничения за цената или пробега. Използвайте изписването на марките и стойностите на останалите филтри от /filters.

2. За да поддържате при себе си пълно копие на обявите, нужна ви е началната позиция в потока. Получете я чрез /change_id за текущата дата по сеулско време; ако върне 0, повторете заявката по-късно. След като я запазите, заредете страниците от /offers една след друга: последната страница е тази, в която полето next_page е null.

3. След зареждането прилагайте събитията от /changes, като започнете от запазената позиция. За следващата порция подавайте next_change_id от отговора. Когато няма събития, масивът result се връща празен, а next_change_id е null: при следващото извикване подайте същата стойност на change_id.

GET/filters

Връща всички възможни стойности за филтриране

https://{access_name}.auto-api.com/api/v2/kbchachacha/filters?api_key=YOUR_API_KEY

Отговор:

{
  "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": ["Automatic", "CVT", "Manual", "Other"],
  "color": ["Black", "Blue", "Brown", "Gray", "Green", "Orange", "Pearl", "Purple", "Red", "Silver", "White", "Yellow"],
  "body_type": ["Bus", "Compact car", "Full-size car", "Light car", "Mid-size car", "Minivan", "SUV", "Small car", "Sports car", "Truck", "Van"],
  "engine_type": ["CNG", "Diesel", "Electric", "Gasoline", "Gasoline + LPG", "Hybrid", "Hybrid (Diesel)", "Hybrid (Gasoline)", "Hybrid (LPG)", "LPG", "Other"],
  "drive_type": ["2WD", "4WD", "AWD"],
  "region": ["Busan", "Daegu", "Daejeon", "Gangwon", "Gwangju", "Gyeonggi", "Incheon", "Jeju", "North Chungcheong", "North Gyeongsang", "North Jeolla", "Sejong", "Seoul", "South Chungcheong", "South Gyeongsang", "South Jeolla", "Ulsan"]
}

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 - диапазон на цената, вонове
https://{access_name}.auto-api.com/api/v2/kbchachacha/offers?api_key=YOUR_API_KEY&page=1https://{access_name}.auto-api.com/api/v2/kbchachacha/offers?api_key=YOUR_API_KEY&page=1&mark=Kia&model=Mohave&year_from=2021&km_age_to=120000&drive_type=4WD&engine_type=Diesel

Отговор:

{
  "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": "Black",
        "engine_type": "Diesel",
        "transmission_type": "Automatic",
        "body_type": "SUV",
        "drive_type": "4WD",
        "displacement": "2959",
        "no_accidents": false,
        "equipment": "[\"Heated Front Seats\", \"Ventilated Driver Seat\", \"Rear Parking Sensors\", \"Sunroof\", \"Smart Key\", \"Factory Navigation\"]",  // в пълния отговор има 53 опции
        "description": "1인신조~~ 완전무사고차량입니다.... (렌트이력없음)<br/>2022년 7월등록~~ 모하비마스터3.0 디젤 4WD 마스터즈그래비티 풀옵션 차량입니다.. ...",
        "region": "Daejeon",
        "address": "대전광역시 서구 계룡로232번길 31",
        "seller": "주식회사 김서방",
        "seller_type": "Dealer",
        "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": "Black",
          "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 }
}

Полета на записа

  • id - номер на записа при нас; полето inner_id свързва записа с обявата в KB Chachacha
  • inner_id - номер на обявата в KB Chachacha, параметърът carSeq във връзката: 28740959
  • url - връзка към обявата в kbchachacha.com
  • mark, model - марка и модел на английски: Kia, Mohave
  • generation - поколение, напр. Mohave The Master
  • configuration - модификация по двигател и задвижване: 3.0 Diesel 4WD
  • complectation - ниво на оборудване: Masters Gravity; може да е празно
  • year - моделна година или година на първа регистрация, когато KB Chachacha не посочва моделна година; месецът на регистрация идва в полето registration_month
  • color - цвят на каросерията от списъка във /filters; празно, ако KB Chachacha не посочва цвета
  • body_type - клас на автомобила, както го определя KB Chachacha: "Small car", "Mid-size car", "Full-size car", "SUV", "Minivan", "Truck"; всички стойности са във /filters
  • engine_type - вид гориво, стойности от /filters
  • displacement - обем на двигателя, куб. см; празно при електромобилите
  • transmission_type - скоростна кутия: "Automatic", "Manual", "CVT" или "Other"
  • drive_type - 2WD, 4WD или AWD, когато задвижването е посочено в името на модификацията; иначе празно
  • price - цена в корейски вонове; -1, когато няма цена: цена при запитване или поемане на лизинг
  • km_age - пробег, км
  • no_accidents - true само когато няма никакви застрахователни събития, включително събития с щети по други автомобили
  • equipment - списък с опции като JSON масив в низ; празен низ, когато не са посочени опции
  • description - текст на продавача, на корейски
  • seller - име на автокъщата от обявата
  • seller_type - кой е публикувал обявата: "Dealer", "Dealership manager", "Dealership owner" или "Private seller"
  • is_dealer - false за частни лица, true за всички останали
  • salon_id - ID на автокъщата в KB Chachacha
  • phone - телефонен номер от обявата
  • region - регион в Корея, стойности от /filters
  • address - адрес на автокъщата на корейски
  • latitude, longitude - координати на автокъщата, когато KB Chachacha ги предоставя
  • images - връзки към снимките като JSON масив в низ; празен низ при обяви без снимки
  • offer_created - дата на първото публикуване на обявата
  • extra_prep - допълнителни данни от обявата, описани по-долу; липсващите стойности идват като null

В обекта extra_prep

  • registration_month - месец на първа регистрация: 2022-07
  • car_number - корейски регистрационен номер
  • seats - брой места
  • seat_color - цвят на седалките
  • is_price_on_request - true, когато продавачът не е посочил цена и моли купувачите да се свържат с него за нея
  • is_lease_takeover - true при обяви за поемане на лизинг
  • lease_monthly_payment - месечна вноска по лизинга във вонове; попълнено само при поемане на лизинг
  • market_price_min, market_price_avg, market_price_max - оценка на пазарната цена от KB Chachacha във вонове: долна граница, средна стойност, горна граница
  • views - брой преглеждания на обявата
  • original_names - марка, модел, поколение, модификация и ниво на оборудване на корейски, както са показани в KB Chachacha
  • insurance_accidents - брой застрахователни събития с щети по този автомобил
  • insurance_accidents_total - общ брой застрахователни събития, включително тези с щети по други автомобили
  • total_loss, flood - дали за автомобила е отбелязана тотална щета, дали са отбелязани щети от наводнение
  • owner_changes - брой смени на собственика
  • seizure, mortgage - дали автомобилът е под запор, дали има залог
  • rental_history - true, когато автомобилът е бил използван под наем или на лизинг
  • kb_diagnosis - true, когато автомобилът е преминал проверка от KB
  • kb_warranty - true, когато автомобилът е с гаранция от KB
  • manufacturer_certified, partner_certified, kb_certified - три флага: сертифициран от производителя, от партньор на KB Chachacha, от самата компания KB

GET/change_id

Получаване на първото ID на промяна по дата (за използване в /changes)

Параметри:

  • date (задължително) - дата във формат yyyy-mm-dd
https://{access_name}.auto-api.com/api/v2/kbchachacha/change_id?api_key=YOUR_API_KEY&date=2026-09-29

Отговор:

{ "change_id": 34419 }

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

GET/changes

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

Параметри:

  • change_id (задължително) - от кое ID на промяна да се започне
https://{access_name}.auto-api.com/api/v2/kbchachacha/changes?api_key=YOUR_API_KEY&change_id=34419

Отговор:

{
  "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 }
}

GET/offer

Една обява по inner_id

Параметри:

  • inner_id (задължително)
https://{access_name}.auto-api.com/api/v2/kbchachacha/offer?api_key=YOUR_API_KEY&inner_id=28740959

Отговор: обект data (същият като в /offers, но без обвивката result)

Съхранение

Файловете остават достъпни поне 3 дни

Достъпност

Нови файлове всяка сутрин

CSV формат

Колоните в CSV са разделени с вертикална черта (|)

Структура на URL адреса:

https://{access_name}.auto-api.com/{date}/{file_name}

Параметри:

  • access_name - вашият личен поддомейн
  • date - дата на експорта във формат yyyy-mm-dd, напр. 2026-10-07
  • file_name - име на файла с разширението

Налични файлове:

  • CSV - all_active.csv, new_daily.csv, removed_daily.csv
  • JSON - all_active.json, new_daily.json, removed_daily.json
  • Excel - all_active.xlsx, new_daily.xlsx, removed_daily.xlsx

Примерна заявка с cURL

curl -L -X GET 'https://{access_name}.auto-api.com/yyyy-mm-dd/all_active.csv' \
  -H 'Authorization: Basic XXX' \
  -o daily_car_data.csv

Примерна команда с Wget

wget --method GET \
  --header 'Authorization: Basic XXX==' \
  'https://{access_name}.auto-api.com/yyyy-mm-dd/all_active.csv'
KB Chachacha

KB Chachacha (kbchachacha.com) е собственост на KB Capital, финансова компания от KB Financial Group. Заедно с Encar е един от двата най-големи сайта за обяви за употребявани автомобили в Корея. Повечето обяви се публикуват от дилъри в комплекси за употребявани автомобили в цялата страна, от Сеул до Чеджу. Сред обявените за продажба автомобили има корейски марки и вносни автомобили като Mercedes-Benz, BMW и Audi.

KB Chachacha прави собствена оценка на пазарната цена на автомобила и показва диапазона редом с цената на продавача. Обявата показва броя на застрахователните събития и на смените на собственика, както и флагове за тотална щета, наводнение, запор и залог. Някои автомобили са преминали проверка от KB или се продават с гаранция от KB, а някои имат сертификация от производителя. Има и обяви за поемане на лизинг, в които вместо цена е посочена месечна вноска.

За вносителя в обявата има всичко необходимо, за да се свърже с продавача: името на автокъщата, адреса ѝ с координати и телефонен номер. Обявите за поемане на лизинг и обявите с цена при запитване имат отделни флагове, така че лесно можете да ги изключите от сравнението на цените. Методите на API-то са същите като за Encar и K Car, така че и трите корейски източника могат да се обработват в една система.

Имената на марките, моделите и нивата на оборудване идват на английски; корейските оригинали са запазени в полето original_names.

Отговор до 2 мин