API Documentation

Base URL: https://db.autokorea.store/api/v1

Authentication

All API requests require an API key sent via the X-API-Key header.

curl "https://db.autokorea.store/api/v1/cars" \
  -H "X-API-Key: ak_live_your_key_here"

API keys are issued by the AutoKorea team. Each key is bound to specific domains and has a daily request limit based on your tier.

Keep your API key secret. Do not expose it in client-side JavaScript. Use a backend proxy for browser-based applications.

Rate Limits

Rate limits are enforced per API key on a daily basis (reset at midnight UTC).

Tier	Daily Limit	Domains
Basic	10,000 requests	1
Pro	50,000 requests	2
Enterprise	Unlimited	Custom

When you exceed your limit, you'll receive a 429 response with details about your limit and tier.

Error Handling

The API returns standard HTTP status codes with JSON error bodies.

Code	Meaning
401	Missing API key
403	Invalid/revoked key or unauthorized domain
404	Resource not found
429	Rate limit exceeded
500	Server error

{
  "error": "Daily rate limit exceeded.",
  "limit": 10000,
  "tier": "basic"
}

List Cars

GET /api/v1/cars Search and filter vehicles

Query Parameters

Param	Type	Description
brand	string	Filter by brand name (e.g. "BMW", "Hyundai")
model	string	Exact model name
modelPrefix	string	Model starts with (e.g. "3 Series")
yearFrom	integer	Minimum year
yearTo	integer	Maximum year
fuelType	string	Gasoline, Diesel, Electric, Hybrid, LPG
transmission	string	Automatic, Manual
priceFrom	integer	Minimum EUR price
priceTo	integer	Maximum EUR price
mileageFrom	integer	Minimum mileage (km)
mileageTo	integer	Maximum mileage (km)
engineFrom	integer	Minimum engine volume (cc)
engineTo	integer	Maximum engine volume (cc)
driveWheel	string	FWD, RWD, AWD
color	string	Color name
bodyType	string	Sedan, SUV, Hatchback, Coupe, etc.
sort	string	price-asc, price-desc, year-desc, year-asc, mileage-asc, mileage-desc, random
page	integer	Page number (default: 1)
limit	integer	Results per page (default: 24, max: 100)

Response

{
  "data": [
    {
      "id": "39482716",
      "brand": "BMW",
      "model": "520d",
      "trim": "Luxury Line",
      "year": 2021,
      "mileage": 42000,
      "price": 18450,
      "priceKosovo": 21200,
      "priceUSD": 21250,
      "fuelType": "Diesel",
      "transmission": "Automatic",
      "bodyType": "Sedan",
      "color": "White",
      "engineVolume": 1995,
      "images": ["https://ci.encar.com/..."],
      "imagesBig": ["https://ci.encar.com/..."],
      "vin": "WBAPH1234...",
      "sold": 0
    }
  ],
  "total": 1247,
  "page": 1,
  "pages": 52
}

Get Car by ID

GET /api/v1/cars/:id Get a single vehicle

Returns the full car object. If the car doesn't have detailed data yet (engine, body type, etc.), the server fetches it on demand and caches it for subsequent requests.

curl "https://db.autokorea.store/api/v1/cars/39482716" \
  -H "X-API-Key: ak_live_your_key_here"

Batch Get Cars

GET /api/v1/cars/batch Get multiple vehicles at once

Param	Type	Description
ids	string	Comma-separated car IDs (max 50)

curl "https://db.autokorea.store/api/v1/cars/batch?ids=39482716,39482717,39482718" \
  -H "X-API-Key: ak_live_your_key_here"

Accident History

GET /api/v1/cars/:id/accident Insurance and accident records

Returns accident/insurance history from the Korean insurance database, if available. Includes damage records, repair history, and ownership changes.

{
  "id": "39482716",
  "accident": {
    "hasRecord": true,
    "resumeAvailable": true
  },
  "inspect": {
    "formats": [...]
  }
}

Manufacturers

GET /api/v1/manufacturers All brands with car counts

[
  { "id": "1", "name": "Hyundai", "count": 45200 },
  { "id": "2", "name": "Kia", "count": 38100 },
  { "id": "3", "name": "Genesis", "count": 12400 }
]

Models

GET /api/v1/models Models for a brand

Param	Type	Description
brand	string	Brand name (required)

curl "https://db.autokorea.store/api/v1/models?brand=BMW" \
  -H "X-API-Key: ak_live_your_key_here"

// Returns array of model names with counts
[
  { "model": "520d", "count": 342 },
  { "model": "320d", "count": 287 }
]

Stats

GET /api/v1/stats Database overview

{
  "totalCars": 152400,
  "activeCars": 148200,
  "soldCars": 4200,
  "brands": 42
}

Exchange Rates

GET /api/v1/exchange-rates Current conversion rates

{
  "usdToEur": 0.8683,
  "krwToEur": 0.0006842,
  "lastUpdated": "2026-04-06T12:00:00.000Z"
}