04 Guides

The car record and photos

Every market has the same keys. What the source does not provide is null, never a guess. Whatever only the source has is in raw.

Record fields

Field	Meaning
`id`	source:source_id, stable for good.
`market, source`	kr · encar, cn · che168, us · copart \| iaai
`title`	Year, make, model and trim in one line.
`brand, model`	In Latin script; the make and model family are spelled the same in every market (Hyundai Grandeur, Mercedes-Benz E-Class, BMW 3 Series). Regional names of one car stay as the market writes them (Korea's Avante is the Elantra of the USA and China); a name the market does not have finds the car under the local one: model=Sedona in Korea is the Carnival.
`generation`	Korea only: Encar's name with the generation and facelift (The New Grandeur IG, E-Class W213, 5 Series (G30)); null in other markets.
`trim`	The version: Encar's badge in Korea, Che168's full name in China, the variant in the USA (C 300, 328i, RX 350).
`year, mileage_km, engine_cc`	Numbers; mileage in kilometres.
`fuel, transmission, body_type, color`	Canonical English values; the list is in /v1/references/dictionaries.
`vin`	When the source provided it.
`price`	{amount, currency} — the price in the market's currency (US: the buy-now price or the final bid of a sold lot; the running bid is in raw.bid).
`price_usd`	The same price in dollars at the ECB daily rate.
`location`	{country, region, city}
`photos, photo_count`	Signed photo links and their number.
`listing_url`	The listing at the source (null for the US).
`is_active, first_seen_at, last_seen_at, disappeared_at, updated_at`	Status and times in UTC.
`raw`	Source fields as they are, including the original spellings (raw.source_values).

Each source's fields in detail are on the Encar, Che168, Copart and IAAI pages.

Photos

Links in photos are signed and work for about a day — keep the car id, not the link, and fetch a fresh record when needed. Photos are served by our server from a cache; when our server cannot reach a photo's host, /img answers with a redirect to the original — follow redirects. /img requests are free.

An example record

A real Che168 car from the catalog (two photo links):

GET /v1/cars/che168:59997083

{
  "id": "che168:59997083",
  "market": "cn",
  "source": "che168",
  "source_id": "59997083",
  "title": "2024 Jaguar XEL",
  "brand": "Jaguar",
  "model": "XEL",
  "trim": "Jaguar Xel 2024 2.0t 250ps R-Dynamic S Aggressive Sports Version",
  "year": 2024,
  "mileage_km": 10000,
  "fuel": "gasoline",
  "transmission": "automatic",
  "engine_cc": 1997,
  "body_type": "sedan",
  "color": "Green",
  "vin": null,
  "price": {
    "amount": "126800.00",
    "currency": "CNY"
  },
  "price_usd": "18925.15",
  "location": {
    "country": "CN",
    "region": null,
    "city": "Shenzhen"
  },
  "photo_count": 9,
  "listing_url": "https://www.che168.com/dealer/534107/59997083.html",
  "is_active": true,
  "first_seen_at": "2026-09-22T16:29:11.202005Z",
  "last_seen_at": "2026-09-22T16:29:11.202005Z",
  "disappeared_at": null,
  "updated_at": "2026-09-22T16:29:11.202005Z",
  "source_mode": "replica",
  "photos": [
    "https://api.apiauto.space/img/che168:59997083/1.jpg?exp=…&sig=…",
    "https://api.apiauto.space/img/che168:59997083/2.jpg?exp=…&sig=…"
  ],
  "photos_more": 7,
  "raw": {
    "drive": "fwd",
    "seats": null,
    "imported": false,
    "power_hp": 250,
    "power_kw": 184,
    "image_count": 9,
    "che168_infoid": "59997083",
    "first_registration": "2024-10-01"
  },
  "raw_total": 10
}