API How it works

From key to first car in three steps.

One HTTPS call with your key returns Korean cars as JSON. Here is the path from key to first record, and the endpoints you will use most.

Open the docs
  1. api_key
    kca_
    Demo key sent on Telegram

    1 Step

    Get your key

    Ask on Telegram or WhatsApp. We reply in writing with a demo key for the Korean sources you need.

  2. GET /search?

    is_auction=false&year_from=2022&lang=en

    200 · 1,204 cars

    2 Step

    Search and filter

    GET /search with brand, model, year, price and mileage filters, marketplaces or auctions. Add lang=en for English fields.

    • XReplacement
    • WSheet metal
    • CCorrosion
    • AScratch
    • UDent
    • TDamage

    3 Step

    Open the full record

    GET /cars/{car_id} returns specs, options and photos, plus inspection and history reports: every checked part with its damage type.

Try a request

Switch between marketplace listings and auction lots, and between cURL, Python and Node.js. The response has the same shape for every source.

Request
curl --get https://api.auctionsapi.com/cars \
  -d is_auction=false \
  -d limit=100 \
  -d lang=en \
  -d api_key=$API_KEY
Response200 OK
{
  "data": [{
    "year": 2022,
    "brand": { "name": "Kia" },
    "model": { "name": "Sorento" },
    "listings": [{
      "external": { "domain": { "name": "encar.com" } },
      "is_auction": false,
      "odometer": 48200,
      "price": {
        "price": 31500000,
        "currency": { "name": "krw" }
      }
    }]
  }],
  "next_url": "https://api.auctionsapi.com/cars?scroll_id=..."
}

The endpoints you will use most

The full reference with every parameter and field is in the documentation.

  • GET /cars

    Export every active car with a cursor. Follow next_url for the next batch. is_auction switches between marketplaces and auctions.

  • GET /search

    Filtered search by brand, model, generation, trim, year, price, mileage, damage, inspections and history.

  • GET /search/count

    Count matching cars before you load them.

  • GET /cars/vin/{vin}

    Every listing of one car by its VIN, across Korean sources.

  • GET /listing/{domain_id}/{listing_id}

    Open a car by the listing ID you see on the source site.

  • GET /domains

    The sources enabled for your key, with their IDs for domains[].

  • GET /brands, /models, /generations

    Dictionaries to build filters in your own interface.

  • GET /car-options

    Equipment options with English names, grouped by section.

Start with a free demo key

One key for all 22 Korean sites we cover. We reply in writing with a demo key and the details of paid access.

Open the docs