AUTO-API.COM
Logo KB Chachacha

KB Chachacha APIScraper a parser

KB Chachacha API: inzeráty korejských dealerů s cenou ve wonech, odhadem tržní ceny, pojistnými událostmi, údaji o zástavním právu a exekuci, výbavou a fotkami.

Oficiální SDK knihovny

Metody API najdete v našich SDK jako hotové funkce, knihovny jsou open source na GitHubu.

KB Chachacha API

V KB Chachacha API přichází vedle ceny prodejce také odhad tržní ceny přímo od KB Chachacha: dolní hranice, průměr a horní hranice. Podle nich se dobře porovnávají nabídky téhož modelu a podle pojistných událostí a příznaků zástavního práva a exekuce lze vybírat inzeráty k dalšímu prověření. Vlastní parser ani scraper pro kbchachacha.com nebudete potřebovat: názvy jsou už přeloženy do angličtiny, výbava je uspořádána do seznamu a kontaktní údaje autobazaru i fotky jsou součástí odpovědi.

API

Nové inzeráty KB Chachacha, změna ceny a stažení z prodeje přicházejí jako události přes /changes.

Denní exporty

Denní soubor s inzeráty KB Chachacha, které jsou aktivní ráno daného dne.

Kompletní data

Značka, model, generace a výbavová verze, modelový rok a měsíc registrace, nájezd, palivo, převodovka, třída vozu, cena prodejce a odhad tržní ceny od KB Chachacha, pojistné události, změny majitele, zástavní právo a exekuce, výbava, prodejce s adresou a telefonem, fotky.

Získat přístup k APIPřístup poskytnut do 2 minut

Základní URL

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

Autorizace: api_key parametr

Pracovní postup

1
/filtersco lze předat do filtrů: značky, modely, hodnoty
2

Počáteční načtení inzerátů:

/change_id?date=...získat ID změny první události dne
/offersstáhnout inzeráty stránku po stránce
3
/changes?change_id=...nové inzeráty, změna ceny, stažení z prodeje
4
/offerinzerát podle jeho inner_id

Kde začít:

1. Nejprve si potřebný výběr vyzkoušejte přes /offers: zadejte značku, model a omezení ceny nebo nájezdu. Zápis značek a hodnoty ostatních filtrů berte z /filters.

2. Abyste u sebe mohli vést celou databázi inzerátů, potřebujete výchozí pozici ve feedu. Získáte ji metodou /change_id pro aktuální datum podle korejského času; při odpovědi 0 požadavek zopakujte později. Jakmile si ID změny uložíte, načtěte stránky /offers jednu po druhé: poslední je ta, kde je next_page null.

3. Po načtení aplikujte události z /changes počínaje uloženým ID změny. O další dávku žádejte s next_change_id z odpovědi. Když žádné události nejsou, přichází result jako prázdné pole JSON a next_change_id je null: při dalším dotazu předejte znovu stejné change_id.

GET/filters

Vrací všechny možné hodnoty pro filtrování

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

Odpověď:

{
  "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"]
    }
    // ... a další značky
  },
  "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

Seznam inzerátů s stránkováním a filtry

Parametry:

  • page (povinné) - číslo stránky
  • mark, model - značka a model zapsané jako v /filters
  • transmission_type, color, body_type, engine_type, drive_type, region - převodovka, barva, třída vozu, palivo, pohon a region v podobě, v jaké je vrací /filters; velikost písmen se nerozlišuje
  • year_from, year_to - rozmezí pro pole year
  • km_age_from, km_age_to - rozsah nájezdu v km
  • price_from, price_to - rozsah ceny, wony
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

Odpověď:

{
  "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\"]",  // tento vůz má celkem 53 položek výbavy
        "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\"]",  // celkem 31 fotek
        "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": "마스터즈 그래비티"
          }
        }
      }
    }
    // ... další inzeráty, celkem až 20 na stránce
  ],
  "meta": { "page": 1, "next_page": 2, "limit": 20 }
}

Pole záznamu

  • id - číslo záznamu u nás; inzerát s KB Chachacha propojuje inner_id
  • inner_id - číslo inzerátu na KB Chachacha, v odkazu je to parametr carSeq: 28740959
  • url - odkaz na inzerát na kbchachacha.com
  • mark, model - značka a model v angličtině: Kia, Mohave
  • generation - generace, například Mohave The Master
  • configuration - verze s motorem a pohonem: 3.0 Diesel 4WD
  • complectation - výbavová verze: Masters Gravity; u části inzerátů není vyplněna
  • year - modelový rok, a pokud ho KB Chachacha neuvedla, rok první registrace; měsíc registrace přichází v registration_month
  • color - barva karoserie ze seznamu /filters; pokud KB Chachacha barvu neuvedla, prázdné
  • body_type - třída vozu, jak ji určuje KB Chachacha: "Small car", "Mid-size car", "Full-size car", "SUV", "Minivan", "Truck"; všechny hodnoty jsou v /filters
  • engine_type - typ paliva, hodnoty z /filters
  • displacement - objem motoru, cm³; u elektromobilů prázdné
  • transmission_type - převodovka: "Automatic", "Manual", "CVT" nebo "Other"
  • drive_type - 2WD, 4WD nebo AWD, když je pohon uveden v názvu verze; jinak prázdné
  • price - cena v korejských wonech; -1, když cena chybí: cena na dotaz nebo převzetí leasingu
  • km_age - nájezd, km
  • no_accidents - true jen tehdy, když vůz nemá žádnou pojistnou událost, včetně škod způsobených cizím vozidlům
  • equipment - seznam položek výbavy: pole JSON v podobě řetězce; když položky výbavy nejsou uvedeny, přichází prázdný řetězec
  • description - text prodejce v korejštině
  • seller - název autobazaru z inzerátu
  • seller_type - kdo inzerát zveřejnil: "Dealer", "Dealership manager", "Dealership owner" nebo "Private seller"
  • is_dealer - false u soukromých prodejců, true u ostatních
  • salon_id - číslo autobazaru na KB Chachacha
  • phone - telefon z inzerátu
  • region - region Koreje, hodnoty z /filters
  • address - adresa autobazaru v korejštině
  • latitude, longitude - souřadnice autobazaru, pokud je KB Chachacha uvedla
  • images - odkazy na fotky: pole JSON v podobě řetězce; u inzerátů bez fotek přichází prázdný řetězec
  • offer_created - datum prvního zveřejnění inzerátu
  • extra_prep - další data inzerátu, jejich obsah je popsán níže; když hodnota chybí, přichází null

Uvnitř extra_prep

  • registration_month - měsíc první registrace: 2022-07
  • car_number - korejská registrační značka
  • seats - počet míst k sezení
  • seat_color - barva sedadel
  • is_price_on_request - true, když prodejce cenu neuvedl a nabízí, že ji sdělí na dotaz
  • is_lease_takeover - true u inzerátů na převzetí leasingu
  • lease_monthly_payment - měsíční leasingová splátka ve wonech; vyplněna jen při převzetí leasingu
  • market_price_min, market_price_avg, market_price_max - odhad tržní ceny od KB Chachacha ve wonech: dolní hranice, průměr, horní hranice
  • views - počet zobrazení inzerátu
  • original_names - značka, model, generace, verze a výbavová verze korejsky, jak jsou na KB Chachacha
  • insurance_accidents - počet pojistných událostí se škodou na tomto voze
  • insurance_accidents_total - celkový počet pojistných událostí včetně těch, při nichž vznikla škoda na jiných vozidlech
  • total_loss, flood - zda došlo k totální škodě, zda došlo k zatopení
  • owner_changes - kolikrát se změnil majitel
  • seizure, mortgage - zda je na vůz uvalena exekuce, zda na něm vázne zástavní právo
  • rental_history - true, když vůz sloužil v autopůjčovně nebo byl v leasingu
  • kb_diagnosis - true, když vůz prošel prohlídkou KB
  • kb_warranty - true, když se na vůz vztahuje záruka KB
  • manufacturer_certified, partner_certified, kb_certified - tři příznaky: certifikace výrobcem, partnerem KB Chachacha, samotnou KB

GET/change_id

Získat první ID změny podle data (pro použití v /changes)

Parametry:

  • date (povinné) - datum ve formátu yyyy-mm-dd
https://{access_name}.auto-api.com/api/v2/kbchachacha/change_id?api_key=YOUR_API_KEY&date=2026-09-29

Odpověď:

{ "change_id": 34419 }

Použijte vrácenou hodnotu jako parametr change_id v /changes

GET/changes

Stream změn (přidáno/změněno/odstraněno)

Parametry:

  • change_id (povinné) - od kterého ID změny
https://{access_name}.auto-api.com/api/v2/kbchachacha/changes?api_key=YOUR_API_KEY&change_id=34419

Odpověď:

{
  "result": [
    {
      "id": 34419,
      "inner_id": "26487093",
      "change_type": "added",    // added: nový inzerát
      "created_at": "2026-09-29T03:46:49.147+03:00",
      "data": { ... }            // všechna pole inzerátu, jako v /offers
    },
    {
      "id": 34420,
      "inner_id": "26502575",
      "change_type": "changed",  // changed: cena se změnila, hodnota ve wonech
      "created_at": "2026-09-29T03:46:49.388+03:00",
      "data": { "new_price": 23000000 }
    },
    {
      "id": 34421,
      "inner_id": "28797429",
      "change_type": "removed",  // removed: inzerát byl stažen z prodeje
      "created_at": "2026-09-29T08:48:00.262+03:00",
      "data": {}
    }
  ],
  "meta": { "cur_change_id": 34419, "next_change_id": 34422, "limit": 20 }
}

GET/offer

Jednotlivý inzerát podle inner_id

Parametry:

  • inner_id (povinné)
https://{access_name}.auto-api.com/api/v2/kbchachacha/offer?api_key=YOUR_API_KEY&inner_id=28740959

Odpověď: objekt data (stejný jako v /offers, ale bez wrapperu result)

Uchování

Soubory zůstávají dostupné nejméně 3 dny

Dostupnost

Nové soubory každé ráno

Formát CSV

Sloupce CSV jsou odděleny znakem svislítko (|)

Struktura URL:

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

Parametry:

  • access_name - vaše osobní subdoména
  • date - datum exportu ve formátu rrrr-mm-dd, např. 2026-10-07
  • file_name - název souboru s příponou

Dostupné soubory:

  • 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

Příklad požadavku 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

Příklad příkazu 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) patří KB Capital, finanční společnosti ze skupiny KB Financial. Spolu s Encarem jde o dvě největší inzertní platformy s ojetými vozy v Koreji. Inzerují tu hlavně dealeři z areálů autobazarů po celé zemi, od Soulu po Čedžu. Prodávají se tu korejské i dovážené značky: Mercedes-Benz, BMW, Audi.

KB Chachacha sama odhaduje tržní cenu vozu a její rozpětí zobrazuje vedle ceny prodejce. V inzerátu je vidět počet pojistných událostí a změn majitele a příznaky totální škody, zatopení, exekuce a zástavního práva. Část vozů prošla prohlídkou KB nebo se prodává se zárukou KB, některé mají certifikaci výrobce. Objevují se i inzeráty na převzetí leasingu, kde je místo ceny uvedena měsíční splátka.

Dovozce v inzerátu najde vše potřebné k tomu, aby se spojil s prodejcem: název autobazaru, adresu se souřadnicemi a telefon. Převzetí leasingu a cena na dotaz mají samostatné příznaky, takže takové inzeráty snadno vyřadíte z porovnání cen. Metody API jsou stejné jako u Encaru a K Car a tři korejské zdroje tak můžete spravovat v jednom systému.

Názvy značek, modelů a výbavových verzí přicházejí v angličtině, korejské originály se uchovávají v original_names.

Odpovíme do 2 minut