01 Endpoints

Car catalog of Korea, China and the USA

GET /v1/cars

One market's catalog with filters, sorting and a cursor. The quota counts the cars returned.

Example requests

Parameters

Market and page

market requiredquery · kr | cn | us
The market: kr — Encar, cn — Che168, us — Copart and IAAI.
limit query · integer · 1–100
Cars per page, 20 by default (up to 20 on the demo).
cursor query · string
The next_cursor of the previous page.
sort query · string
The order; -first_seen by default — newest in the catalog first.

Make and model

brand query · string
A make as /v1/references/brands spells it; case, spaces and hyphens are ignored.
model query · string
The model family, one name in every market: Grandeur, 3 Series.
generation query · string
Korea only: the generation as in the generation field.
trim query · string
The trim, an exact match.
q query · string
Up to 6 words of the title: year, make, model, trim.

Car

year_min query · integer
Model year from.
year_max query · integer
Model year to.
mileage_max query · integer · km
Mileage up to, km.
fuel query · string
Fuel, a value from the dictionary.
transmission query · string
Gearbox.
body_type query · string
Body type.
has_photos query · boolean
Only with photos, or only without.

Price

price_min query · number
Price from, in the market's currency (KRW, CNY, USD).
price_max query · number
Price up to, in the market's currency.
price_usd_min query · number · USD
Price from, in dollars at the ECB rate.
price_usd_max query · number · USD
Price up to, in dollars.

Status

is_active query · boolean
true by default; false — taken off sale within 14 days.

Request `GET`

GEThttps://api.apiauto.space/v1/cars?market=kr&limit=20&brand=Kia

cURL

curl -s "https://api.apiauto.space/v1/cars?market=kr&limit=20&brand=Kia" \
  -H "X-API-Key: $APIAUTO_KEY"

JavaScript

const response = await fetch(
  "https://api.apiauto.space/v1/cars?market=kr&limit=20&brand=Kia",
  { headers: { "X-API-Key": process.env.APIAUTO_KEY } },
);
if (!response.ok) throw new Error(`${response.status}: ${await response.text()}`);
const data = await response.json();

Python

import os
import httpx

data = httpx.get(
    "https://api.apiauto.space/v1/cars?market=kr&limit=20&brand=Kia",
    headers={"X-API-Key": os.environ["APIAUTO_KEY"]},
    timeout=30,
).raise_for_status().json()

PHP

<?php
$ch = curl_init("https://api.apiauto.space/v1/cars?market=kr&limit=20&brand=Kia");
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER => ["X-API-Key: " . getenv("APIAUTO_KEY")],
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);

Get a test key

The site sends no requests: copy the code and run it with your key.

Response

HTTP 200

{
  "items": [
    {
      "id": "encar:43079113",
      "market": "kr",
      "source": "encar",
      "source_id": "43079113",
      "title": "2021 BMW 7 Series (G11) 740Li xDrive Design Pure Excellence",
      "brand": "BMW",
      "model": "7 Series",
      "generation": "7 Series (G11)",
      "trim": "740Li xDrive Design Pure Excellence",
      "year": 2021,
      "mileage_km": 179132,
      "fuel": "gasoline",
      "transmission": null,
      "engine_cc": null,
      "body_type": null,
      "color": null,
      "vin": null,
      "price": {
        "amount": "34900000.00",
        "currency": "KRW"
      },
      "price_usd": "25988.47",
      "location": {
        "country": "KR",
        "region": "Gyeonggi",
        "city": null
      },
      "photos": [
        "https://api.apiauto.space/img/encar:43079113/1.jpg?exp=…&sig=…",
        "https://api.apiauto.space/img/encar:43079113/2.jpg?exp=…&sig=…"
      ],
      "photo_count": 4,
      "listing_url": "https://fem.encar.com/cars/detail/43079113",
      "is_active": true,
      "first_seen_at": "2026-11-02T14:34:16.763020Z",
      "last_seen_at": "2026-11-02T14:34:16.763020Z",
      "disappeared_at": null,
      "updated_at": "2026-11-02T14:34:16.763020Z",
      "raw": {
        "fx": {
          "date": "2026-11-02",
          "source": "ECB",
          "currency": "KRW",
          "usd_per_unit": "0.0007446554"
        },
        "badge": "740Li xDrive 디자인 퓨어 엑셀런스",
        "trust": [
          "Warranty"
        ],
        "has_vin": false,
        "condition": [
          "Record"
        ],
        "form_year": "202101",
        "sell_type": "normal",
        "body_class": null,
        "office_city": "경기",
        "badge_detail": null,
        "has_accident": false,
        "service_mark": [
          "EncarDiagnosisP1"
        ],
        "source_values": {
          "fuel": "가솔린",
          "trim": "740Li xDrive 디자인 퓨어 엑셀런스",
          "brand": "BMW",
          "model": "7시리즈 (G11)",
          "region": "경기",
          "sell_type": "일반",
          "transmission": null
        },
        "has_inspection": false
      },
      "source_mode": "replica"
    },
    {
      "id": "encar:43079086",
      "market": "kr",
      "source": "encar",
      "source_id": "43079086",
      "title": "2022 Volvo XC60 2 Gen B5 Inscription",
      "brand": "Volvo",
      "model": "XC60",
      "generation": "XC60 2 Gen",
      "trim": "B5 Inscription",
      "year": 2022,
      "mileage_km": 60699,
      "fuel": "gasoline",
      "transmission": null,
      "engine_cc": null,
      "body_type": null,
      "color": null,
      "vin": null,
      "price": {
        "amount": "40800000.00",
        "currency": "KRW"
      },
      "price_usd": "30381.94",
      "location": {
        "country": "KR",
        "region": "Gyeonggi",
        "city": null
      },
      "photos": [
        "https://api.apiauto.space/img/encar:43079086/1.jpg?exp=…&sig=…",
        "https://api.apiauto.space/img/encar:43079086/2.jpg?exp=…&sig=…"
      ],
      "photo_count": 4,
      "listing_url": "https://fem.encar.com/cars/detail/43079086",
      "is_active": true,
      "first_seen_at": "2026-11-02T14:34:16.763020Z",
      "last_seen_at": "2026-11-02T14:34:16.763020Z",
      "disappeared_at": null,
      "updated_at": "2026-11-02T14:34:16.763020Z",
      "raw": {
        "fx": {
          "date": "2026-11-02",
          "source": "ECB",
          "currency": "KRW",
          "usd_per_unit": "0.0007446554"
        },
        "badge": "B5 인스크립션",
        "trust": [],
        "has_vin": false,
        "condition": [
          "Inspection",
          "Record"
        ],
        "form_year": "202207",
        "sell_type": "normal",
        "body_class": null,
        "office_city": "경기",
        "badge_detail": null,
        "has_accident": false,
        "service_mark": [],
        "source_values": {
          "fuel": "가솔린",
          "trim": "B5 인스크립션",
          "brand": "볼보",
          "model": "XC60 2세대",
          "region": "경기",
          "sell_type": "일반",
          "transmission": null
        },
        "has_inspection": false
      },
      "source_mode": "replica"
    }
  ],
  "next_cursor": "…",
  "count": null
}

Sample data: the cars are real, from the catalog when the site was built; photos are cut to two.

Notes

count is how many cars match the filters when there are at most 10,000; above that, null.
offset is not supported — a request with it gets 400.
The record's fields are in The car record; importing a whole catalog is in Keeping in sync.