What can I use the KB Chachacha API for?

The KB Chachacha API helps you narrow down listings from Korean sellers using the market price estimate and insurance history. Along with the car's specifications and photos, you get the dealership's contact details. You can load this data into your own sourcing system, and API events tell you about new listings, price changes and removals from sale.

Which listings does the API include?

Used car listings from dealers and private sellers, from light cars to trucks and buses. Listings with neither photos nor a price are not returned by the API: these are usually drafts the seller has not filled in yet.

What does a price value of -1 mean?

The listing has no price. There are two possible reasons: either the seller asks buyers to contact them for the price, in which case is_price_on_request is true, or it is a lease takeover, in which case is_lease_takeover is true and the monthly payment comes in lease_monthly_payment. In all other listings, price holds the price in Korean won.

How can I tell whether a car has been in an accident?

From the insurance history shown on KB Chachacha. The insurance_accidents field is the number of claims for damage to the car itself, and insurance_accidents_total is the total number of claims, including those where other cars were damaged. The no_accidents field is true only when there are no claims at all. Total loss and flood damage come as separate flags.

Does KB Chachacha publish the VIN and engine power?

No, KB Chachacha listings carry neither the VIN nor the engine power. Instead of the VIN you get the Korean license plate number in car_number, and besides the model year there is the month of first registration in registration_month. The drivetrain is filled in when the version name states it: 2WD, 4WD or AWD.

What is the market price estimate?

KB Chachacha makes its own estimate of what a car is worth on the market and shows it as a range. In the API these are three values in won: market_price_min, market_price_avg and market_price_max. Compare them with price and you can see whether the car is listed below or above the market.

What format does the data come in?

API responses are in JSON, daily files in CSV, JSON and XLSX. Make, model, generation, version and trim are translated into English, with the Korean originals kept in original_names. Color, fuel, transmission, vehicle class, region, seller type and equipment come in English.

KB Chachacha APIScraper & Parser

KB Chachacha API: Korean dealer listings with prices in won, a market price estimate, insurance claims, lien and seizure flags, equipment and photos.

Official SDK Libraries

Our SDKs include the API methods as ready-made functions, and the library code is open source on GitHub.

PHP Node.js Python Go C#Java Ruby Rust

KB Chachacha API

In the KB Chachacha API, the seller's price comes with KB Chachacha's own market price estimate: lower bound, average and upper bound. These make it easy to compare listings for the same model, and the insurance claims and the lien and seizure flags help you pick listings for a closer look. No scraper or parser for kbchachacha.com is needed on your side: names are already translated into English, equipment comes as a list, and the dealership's contact details and the photos are part of the response.

API

New KB Chachacha listings, price changes and removals from sale arrive as events through /changes.

Daily Exports

A daily file with the KB Chachacha listings active that morning.

Complete Data

Make, model, generation and trim, model year and registration month, mileage, fuel, transmission, vehicle class, price and KB Chachacha's market price estimate, insurance claims, ownership changes, liens and seizures, equipment, seller with address and phone, photos.

Get API AccessAccess provided within 2 minutes

API

Base URL

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

Authorization: api_key parameter

Workflow

/filtersthe makes, models and values the filters accept

Initial load of listings:

/change_id?date=...get the change ID of the day's first event

/offersdownload the listings page by page

/changes?change_id=...new listings, price changes, removals from sale

/offera listing by its inner_id

Where to start:

1. Start by running the search you need through /offers: set the make, the model and limits on price or mileage. Take the spelling of makes and the values of the other filters from /filters.

2. To keep a full copy of the listings on your side, you need the feed's starting position. Get it with /change_id for the current date in Seoul time; if it returns 0, repeat the request later. Once you have stored it, load the /offers pages one after another: the last page is the one where next_page is null.

3. After the load, apply /changes events starting from the stored position. Request the next batch with next_change_id from the response. When there are no events, the result array comes back empty and next_change_id is null: pass the same change_id on the next poll.

GET/filters

Returns all possible values for filtering

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

Response:

{
  "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"]
    }
    // ... and other makes
  },
  "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

List of listings with pagination and filters

Parameters:

page (required) - page number
mark, model - make and model, spelled as in /filters
transmission_type, color, body_type, engine_type, drive_type, region - transmission, color, vehicle class, fuel, drivetrain and region as returned by /filters; case-insensitive
year_from, year_to - range for the year field
km_age_from, km_age_to - mileage range, km
price_from, price_to - price range, won

https://{access_name}.auto-api.com/api/v2/kbchachacha/offers?api_key=YOUR_API_KEY&page=1

https://{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

Response:

{
  "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\"]",  // the full response has 53 options
        "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\"]",  // the full response has 31 photos
        "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": "마스터즈 그래비티"
          }
        }
      }
    }
    // ... the other listings, up to 20 per page
  ],
  "meta": { "page": 1, "next_page": 2, "limit": 20 }
}

Record fields

id - our record number; inner_id is what links the record to the listing on KB Chachacha
inner_id - listing number on KB Chachacha, the carSeq parameter in the link: 28740959
url - link to the listing on kbchachacha.com
mark, model - make and model in English: Kia, Mohave
generation - generation, e.g. Mohave The Master
configuration - version with engine and drivetrain: 3.0 Diesel 4WD
complectation - trim: Masters Gravity; may be empty
year - model year, or the year of first registration when KB Chachacha gives no model year; the registration month comes in registration_month
color - body color from the /filters list; empty if KB Chachacha does not name the color
body_type - vehicle class as KB Chachacha defines it: "Small car", "Mid-size car", "Full-size car", "SUV", "Minivan", "Truck"; all values are in /filters
engine_type - fuel type, values from /filters
displacement - engine displacement, cc; empty for electric cars
transmission_type - transmission: "Automatic", "Manual", "CVT" or "Other"
drive_type - 2WD, 4WD or AWD when the drivetrain is given in the version name; otherwise empty
price - price in Korean won; -1 when there is no price: price on request or a lease takeover
km_age - mileage, km

no_accidents - true only when there are no insurance claims at all, including claims for damage to other cars
equipment - list of options as a JSON array inside a string; an empty string when no options are listed
description - the seller's text, in Korean
seller - dealership name from the listing
seller_type - who posted the listing: "Dealer", "Dealership manager", "Dealership owner" or "Private seller"
is_dealer - false for private sellers, true for everyone else
salon_id - dealership ID on KB Chachacha
phone - phone number from the listing
region - region of Korea, values from /filters
address - dealership address in Korean
latitude, longitude - dealership coordinates, when KB Chachacha provides them
images - photo links as a JSON array inside a string; an empty string for listings without photos
offer_created - date the listing was first published
extra_prep - additional listing data, described below; missing values come as null

Inside extra_prep

registration_month - month of first registration: 2022-07
car_number - Korean license plate number
seats - number of seats
seat_color - seat color
is_price_on_request - true when the seller gave no price and asks buyers to contact them for it
is_lease_takeover - true for lease takeover listings
lease_monthly_payment - monthly lease payment in won; filled in only for lease takeovers
market_price_min, market_price_avg, market_price_max - KB Chachacha's market price estimate in won: lower bound, average, upper bound
views - number of listing views
original_names - make, model, generation, version and trim in Korean, as shown on KB Chachacha

insurance_accidents - number of insurance claims for damage to this car
insurance_accidents_total - total number of insurance claims, including those for damage to other cars
total_loss, flood - whether the car has a total loss on record, whether it has flood damage on record
owner_changes - number of ownership changes
seizure, mortgage - whether the car is under seizure, whether there is a lien
rental_history - true when the car has been used as a rental or lease car
kb_diagnosis - true when the car has passed a KB inspection
kb_warranty - true when the car is covered by a KB warranty
manufacturer_certified, partner_certified, kb_certified - three flags: certified by the manufacturer, by a KB Chachacha partner, by KB itself

GET/change_id

Get first change ID by date (for use in /changes)

Parameters:

date (required) - date in yyyy-mm-dd format

https://{access_name}.auto-api.com/api/v2/kbchachacha/change_id?api_key=YOUR_API_KEY&date=2026-09-29

Response:

{ "change_id": 34419 }

Use the returned value as the change_id parameter in /changes

GET/changes

Changes feed (added/changed/removed)

Parameters:

change_id (required) - starting from which change ID

https://{access_name}.auto-api.com/api/v2/kbchachacha/changes?api_key=YOUR_API_KEY&change_id=34419

Response:

{
  "result": [
    {
      "id": 34419,
      "inner_id": "26487093",
      "change_type": "added",    // added: new listing
      "created_at": "2026-09-29T03:46:49.147+03:00",
      "data": { ... }            // all listing fields, as in /offers
    },
    {
      "id": 34420,
      "inner_id": "26502575",
      "change_type": "changed",  // changed: the new price, in won
      "created_at": "2026-09-29T03:46:49.388+03:00",
      "data": { "new_price": 23000000 }
    },
    {
      "id": 34421,
      "inner_id": "28797429",
      "change_type": "removed",  // removed: the listing was taken off sale
      "created_at": "2026-09-29T08:48:00.262+03:00",
      "data": {}
    }
  ],
  "meta": { "cur_change_id": 34419, "next_change_id": 34422, "limit": 20 }
}

GET/offer

Single listing by inner_id

Parameters:

inner_id (required)

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

Response: data object (same as in /offers, but without result wrapper)

Daily Exports

Retention

Files stay available for at least 3 days

Availability

Fresh files every morning

CSV Format

CSV columns are separated by the pipe character (|)

URL structure:

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

Parameters:

access_name - your personal subdomain
date - export date in yyyy-mm-dd format, e.g. 2026-10-07
file_name - file name with extension

Available files:

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 request example

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 command example

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) is owned by KB Capital, a finance company in KB Financial Group. Together with Encar, it is one of the two largest used car listing sites in Korea. Most listings are posted by dealers at used car complexes all over the country, from Seoul to Jeju. The cars listed include Korean makes and imports such as Mercedes-Benz, BMW and Audi.

KB Chachacha makes its own estimate of a car's market price and shows the range next to the seller's price. A listing shows the number of insurance claims and ownership changes, plus flags for total loss, flood, seizure and lien. Some cars have passed a KB inspection or are sold with a KB warranty, and some carry manufacturer certification. There are also lease takeover listings, where a monthly payment is given instead of a price.

For an importer, a listing has everything needed to reach the seller: the dealership name, its address with coordinates and a phone number. Lease takeovers and price-on-request listings carry separate flags, so they are easy to leave out of a price comparison. The API methods are the same as for Encar and K Car, so all three Korean sources can be handled in one system.

Make, model and trim names come in English; the Korean originals are kept in original_names.

Other Automotive Data

Expand your automotive data coverage across global markets with our platform APIs:

🇰🇷

Encar API

Korea car market data API

🇰🇷

K Car API

Korea car market data API

🇨🇳

Che168 API

China automotive data API