Global vehicle auction &
market data — one API.

Overview

ApiCar gives you programmatic access to vehicle auction and marketplace data across three regions. Every response is JSON, authenticated with a single API key and cached at the global edge.

Quickstart

Pass your key as a Bearer token. Here's the US manifest in three languages:

curl https://api-car.com/v1/us/manifest \
  -H "Authorization: Bearer ak_live_your_key"

const res = await fetch("https://api-car.com/v1/us/manifest", {
  headers: { Authorization: "Bearer ak_live_your_key" }
});
const data = await res.json();

import requests
r = requests.get("https://api-car.com/v1/us/manifest",
    headers={"Authorization": "Bearer ak_live_your_key"})
data = r.json()

Test connectivity first with the public health check (no key required):

curl https://api-car.com/v1/health
→ {"status":"ok","service":"apicar"}

Authentication

Every data endpoint requires an API key. Send it as a Bearer token, or as X-Api-Key:

Authorization: Bearer ak_live_your_key
# or
X-Api-Key: ak_live_your_key

Keep your key server-side. Rotate anytime — contact us to issue or revoke keys.

Get an API key

Regions

Asia (cn, kr) is our differentiator — data Western auction APIs don't carry. Gated to premium plans; requesting it on a non-premium key returns 402 plan_upgrade_required.

Endpoints

Base URL https://api-car.com/v1 · all GET · {region} = us | cn | kr.

Public service status. No key required.

Lightweight index of every lot — id, make, updated, bid, sale date. Poll for a full snapshot / to detect the current version.

curl https://api-car.com/v1/us/manifest -H "Authorization: Bearer ak_live_your_key"

→ {
  "version": 42,
  "count": 87532,
  "lots": [ { "id":"55123456", "make":"TOYOTA", "year":2021, "bid":8200 } ]
}

New / updated / sold lots since the previous version — incremental sync without re-pulling everything. Each entry carries a change flag.

Available makes for the region (China & Korea). Drives full/{make} pulls.

Complete per-lot records for one make — 50+ fields (see Lot fields).

curl https://api-car.com/v1/cn/full/BYD -H "Authorization: Bearer ak_live_your_key"  # premium

Query parameters

Response headers

Lot fields

Each lot in a full/{make} response carries these fields (US example; China/Korea add EV specs and history):

China adds EV specs (power_kw, battery_kwh, range_km) and factory data; Korea adds accident/owner history.

Localization

Localize catalog fields with ?lang= (or an Accept-Language header):

curl "https://api-car.com/v1/cn/manifest?lang=ru" -H "Authorization: Bearer ak_live_your_key"

Supported: en · ru · es · ar · zh · pt · fr · de · pl · uk. The resolved locale comes back in x-locale.

Rate limits & quotas

Each key has a per-minute rate limit and a monthly request quota set by its plan. Usage is reflected in response headers. Exceeding the rate → 429 rate_limit_exceeded; exceeding the monthly quota → 402 monthly_quota_exceeded.

Errors

Errors are JSON — {"error":"code"} — with the matching HTTP status.

Plans & pricing

Need a landed-cost add-on (import duties for BY/RU/KZ/PL) or bulk export? Talk to us.

Storefront

FAQ