AUTO-API.COM
Logo KB Chachacha

KB Chachacha APIScraper i parser

KB Chachacha API: oferty koreańskich dealerów. Cena w wonach, szacunkowa cena rynkowa, szkody ubezpieczeniowe, dane o zastawie i zajęciu, wyposażenie, zdjęcia.

Oficjalne biblioteki SDK

Metody API są dostępne w naszych SDK jako gotowe funkcje, a otwarty kod bibliotek znajdziesz na GitHubie.

KB Chachacha API

W KB Chachacha API obok ceny sprzedawcy przychodzi szacunkowa cena rynkowa od samej platformy KB Chachacha: dolna granica, średnia i górna granica. Dzięki nim wygodnie porównasz oferty tego samego modelu, a na podstawie szkód ubezpieczeniowych oraz informacji o zastawie i zajęciu wybierzesz oferty do dalszego sprawdzenia. Własny parser ani scraper kbchachacha.com nie będzie potrzebny: nazwy są już przetłumaczone na angielski, wyposażenie zebrane w listę, a dane kontaktowe salonu samochodowego i zdjęcia są w odpowiedzi.

API

Nowe oferty KB Chachacha, zmiana ceny i wycofanie ze sprzedaży przychodzą jako zdarzenia przez /changes.

Codzienne eksporty

Codzienny plik z ofertami KB Chachacha, które są aktywne rano tego dnia.

Pełne dane

Marka, model, generacja i wersja wyposażenia, rok modelowy i miesiąc rejestracji, przebieg, paliwo, skrzynia biegów, klasa auta, cena sprzedawcy i szacunkowa cena rynkowa według KB Chachacha, szkody ubezpieczeniowe, zmiany właściciela, zastaw i zajęcie, wyposażenie, sprzedawca z adresem i telefonem, zdjęcia.

Uzyskaj dostęp do APIDostęp przyznany w ciągu 2 minut

Bazowy URL

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

Autoryzacja: api_key parametr

Schemat integracji

1
/filtersco można przekazać w filtrach: marki, modele, wartości
2

Początkowe pobranie ofert:

/change_id?date=...pobierz ID zmiany pierwszego zdarzenia dnia
/offerspobierz oferty strona po stronie
3
/changes?change_id=...nowe oferty, zmiana ceny, wycofanie ze sprzedaży
4
/offeroferta według jej inner_id

Od czego zacząć:

1. Najpierw wypróbuj potrzebne wyszukiwanie przez /offers: podaj markę, model i ograniczenia ceny lub przebiegu. Pisownię marek i wartości pozostałych filtrów bierz z /filters.

2. Aby prowadzić u siebie całą bazę ofert, potrzebna jest pozycja początkowa strumienia. Pobierz ją metodą /change_id dla bieżącej daty według czasu koreańskiego; przy odpowiedzi 0 powtórz żądanie później. Po zapisaniu ID zmiany pobierz strony /offers jedną po drugiej: ostatnia to ta, na której next_page ma wartość null.

3. Po pobraniu nanoś zdarzenia /changes, zaczynając od zapisanego ID zmiany. Kolejną porcję pobieraj z next_change_id z odpowiedzi. Gdy zdarzeń nie ma, result przychodzi jako pusta tablica, a next_change_id ma wartość null: przy następnym odpytaniu przekaż poprzedni change_id.

GET/filters

Zwraca wszystkie możliwe wartości do filtrowania

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

Odpowiedź:

{
  "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"]
    }
    // ... i inne marki
  },
  "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

Lista ogłoszeń z paginacją i filtrami

Parametry:

  • page (wymagane) - numer strony
  • mark, model - marka i model w pisowni z /filters
  • transmission_type, color, body_type, engine_type, drive_type, region - skrzynia biegów, kolor, klasa auta, paliwo, napęd i region w takiej postaci, w jakiej zwraca je /filters; wielkość liter nie jest uwzględniana
  • year_from, year_to - granice dla pola year
  • km_age_from, km_age_to - zakres przebiegu w kilometrach
  • price_from, price_to - zakres 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

Odpowiedź:

{
  "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\"]",  // to auto ma łącznie 53 opcje
        "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\"]",  // łącznie 31 zdjęć
        "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": "마스터즈 그래비티"
          }
        }
      }
    }
    // ... kolejne oferty, łącznie do 20 na stronie
  ],
  "meta": { "page": 1, "next_page": 2, "limit": 20 }
}

Pola rekordu

  • id - numer rekordu u nas; z platformą KB Chachacha ofertę wiąże inner_id
  • inner_id - numer oferty na KB Chachacha, w linku to parametr carSeq: 28740959
  • url - link do oferty na kbchachacha.com
  • mark, model - marka i model po angielsku: Kia, Mohave
  • generation - generacja, np. Mohave The Master
  • configuration - wersja z silnikiem i napędem: 3.0 Diesel 4WD
  • complectation - wersja wyposażenia: Masters Gravity; podana nie we wszystkich ofertach
  • year - rok modelowy, a jeśli KB Chachacha go nie podała, rok pierwszej rejestracji; miesiąc rejestracji przychodzi w registration_month
  • color - kolor nadwozia z listy /filters; jeśli KB Chachacha nie podała koloru, puste
  • body_type - klasa auta według KB Chachacha: "Small car", "Mid-size car", "Full-size car", "SUV", "Minivan", "Truck"; wszystkie wartości są w /filters
  • engine_type - rodzaj paliwa, wartości z /filters
  • displacement - pojemność silnika, cm³; w autach elektrycznych puste
  • transmission_type - skrzynia biegów: "Automatic", "Manual", "CVT" lub "Other"
  • drive_type - 2WD, 4WD lub AWD, gdy napęd jest podany w nazwie wersji; w przeciwnym razie puste
  • price - cena w wonach koreańskich; -1, jeśli ceny nie ma: cena na zapytanie lub cesja leasingu
  • km_age - przebieg, km
  • no_accidents - true tylko przy całkowitym braku szkód ubezpieczeniowych, w tym szkód w cudzych autach
  • equipment - lista opcji: tablica JSON w ciągu znaków; jeśli opcji nie podano, przychodzi pusty ciąg znaków
  • description - tekst sprzedawcy po koreańsku
  • seller - nazwa salonu samochodowego z oferty
  • seller_type - kto zamieścił ofertę: "Dealer", "Dealership manager", "Dealership owner" lub "Private seller"
  • is_dealer - false dla osób prywatnych, true dla pozostałych
  • salon_id - numer salonu samochodowego na KB Chachacha
  • phone - telefon z oferty
  • region - region Korei, wartości z /filters
  • address - adres salonu samochodowego po koreańsku
  • latitude, longitude - współrzędne salonu samochodowego, jeśli KB Chachacha je podała
  • images - linki do zdjęć: tablica JSON w ciągu znaków; dla ofert bez zdjęć przychodzi pusty ciąg znaków
  • offer_created - data pierwszej publikacji oferty
  • extra_prep - dodatkowe dane oferty, zawartość opisano niżej; gdy wartości brak, przychodzi null

Zawartość extra_prep

  • registration_month - miesiąc pierwszej rejestracji: 2022-07
  • car_number - koreański numer rejestracyjny
  • seats - liczba miejsc
  • seat_color - kolor siedzeń
  • is_price_on_request - true, jeśli sprzedawca nie podał ceny i proponuje o nią zapytać
  • is_lease_takeover - true dla ofert cesji leasingu
  • lease_monthly_payment - miesięczna rata leasingu w wonach; podana tylko przy cesji
  • market_price_min, market_price_avg, market_price_max - szacunkowa cena rynkowa według KB Chachacha w wonach: dolna granica, średnia, górna granica
  • views - liczba wyświetleń oferty
  • original_names - marka, model, generacja, wersja i wersja wyposażenia po koreańsku, tak jak na KB Chachacha
  • insurance_accidents - liczba szkód ubezpieczeniowych z uszkodzeniem tego auta
  • insurance_accidents_total - łączna liczba szkód ubezpieczeniowych razem z tymi, w których uszkodzono inne auta
  • total_loss, flood - czy była szkoda całkowita, czy było zalanie
  • owner_changes - ile razy zmieniał się właściciel
  • seizure, mortgage - czy auto jest objęte zajęciem, czy jest obciążone zastawem
  • rental_history - true, jeśli auto było w wynajmie lub leasingu
  • kb_diagnosis - true, jeśli auto przeszło diagnostykę KB
  • kb_warranty - true, jeśli auto jest objęte gwarancją KB
  • manufacturer_certified, partner_certified, kb_certified - trzy flagi: certyfikat producenta, partnera KB Chachacha, samej KB

GET/change_id

Pobierz pierwsze ID zmiany według daty (do użycia w /changes)

Parametry:

  • date (wymagane) - data w formacie yyyy-mm-dd
https://{access_name}.auto-api.com/api/v2/kbchachacha/change_id?api_key=YOUR_API_KEY&date=2026-09-29

Odpowiedź:

{ "change_id": 34419 }

Użyj zwróconej wartości jako parametru change_id w /changes

GET/changes

Strumień zmian (dodano/zmieniono/usunięto)

Parametry:

  • change_id (wymagane) - od którego ID zmiany
https://{access_name}.auto-api.com/api/v2/kbchachacha/changes?api_key=YOUR_API_KEY&change_id=34419

Odpowiedź:

{
  "result": [
    {
      "id": 34419,
      "inner_id": "26487093",
      "change_type": "added",    // added: nowa oferta
      "created_at": "2026-09-29T03:46:49.147+03:00",
      "data": { ... }            // wszystkie pola oferty, jak w /offers
    },
    {
      "id": 34420,
      "inner_id": "26502575",
      "change_type": "changed",  // changed: cena się zmieniła, wartość w wonach
      "created_at": "2026-09-29T03:46:49.388+03:00",
      "data": { "new_price": 23000000 }
    },
    {
      "id": 34421,
      "inner_id": "28797429",
      "change_type": "removed",  // removed: ofertę wycofano
      "created_at": "2026-09-29T08:48:00.262+03:00",
      "data": {}
    }
  ],
  "meta": { "cur_change_id": 34419, "next_change_id": 34422, "limit": 20 }
}

GET/offer

Pojedyncze ogłoszenie według inner_id

Parametry:

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

Odpowiedź: obiekt data (taki sam jak w /offers, ale bez wrappera result)

Przechowywanie

Pliki pozostają dostępne przez co najmniej 3 dni

Dostępność

Świeże pliki każdego ranka

Format CSV

Kolumny CSV są rozdzielone znakiem pipe (|)

Struktura URL:

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

Parametry:

  • access_name - Twoja osobista subdomena
  • date - data eksportu w formacie rrrr-mm-dd, np. 2026-10-07
  • file_name - nazwa pliku z rozszerzeniem

Dostępne pliki:

  • 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

Przykład żądania 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

Przykład polecenia 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) należy do KB Capital, spółki finansowej z grupy KB Financial. Razem z Encar to dwie największe w Korei platformy z ofertami sprzedaży używanych samochodów. Oferty zamieszczają głównie dealerzy z kompleksów handlu używanymi autami w całym kraju, od Seulu po Czedżu. Sprzedawane są zarówno marki koreańskie, jak i importowane: Mercedes-Benz, BMW, Audi.

KB Chachacha sama szacuje cenę rynkową auta i pokazuje jej przedział obok ceny sprzedawcy. W ofercie widać liczbę szkód ubezpieczeniowych i zmian właściciela oraz informacje o szkodzie całkowitej, zalaniu, zajęciu i zastawie. Część aut przeszła diagnostykę KB lub jest sprzedawana z gwarancją KB, niektóre mają certyfikat producenta. Zdarzają się też oferty cesji leasingu, w których zamiast ceny podana jest miesięczna rata.

Dla importera w ofercie jest wszystko, czego trzeba, by dotrzeć do sprzedawcy: nazwa salonu samochodowego, adres ze współrzędnymi i telefon. Cesja leasingu i cena na zapytanie mają osobne flagi, więc takie oferty łatwo wyłączyć z porównania cen. Metody API są te same co dla Encar i K Car, dlatego trzy koreańskie źródła można obsługiwać w jednym systemie.

Nazwy marek, modeli i wersji wyposażenia przychodzą po angielsku, a koreańskie oryginały są zachowane w original_names.

Odpowiedź w 2 min