**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` required (query · 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` GET https:// api.apiauto.space/ v1/ cars? market=kr &limit=20 &brand=Kia cURL: ```bash curl -s "https://api.apiauto.space/v1/cars?market=kr&limit=20&brand=Kia" \ -H "X-API-Key: $APIAUTO_KEY" ``` JavaScript: ```js 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: ```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 ["X-API-Key: " . getenv("APIAUTO_KEY")], CURLOPT_RETURNTRANSFER => true, ]); $data = json_decode(curl_exec($ch), true); ``` ## Response HTTP 200: ```json { "items": [ { "id": "encar:43082263", "market": "kr", "source": "encar", "source_id": "43082263", "title": "2020 Kia K5 3 Gen 1.6 Turbo Noblesse", "brand": "Kia", "model": "K5", "generation": "K5 3 Gen", "trim": "1.6 Turbo Noblesse", "year": 2020, "mileage_km": 70024, "fuel": "gasoline", "transmission": null, "engine_cc": null, "body_type": null, "color": null, "vin": null, "price": { "amount": "17700000.00", "currency": "KRW" }, "price_usd": "13180.40", "location": { "country": "KR", "region": "Incheon", "city": null }, "photos": [ "https://api.apiauto.space/img/encar:43082263/1.jpg?exp=…&sig=…", "https://api.apiauto.space/img/encar:43082263/2.jpg?exp=…&sig=…" ], "photo_count": 4, "listing_url": "https://fem.encar.com/cars/detail/43082263", "is_active": true, "first_seen_at": "2026-11-03T02:17:42.264668Z", "last_seen_at": "2026-11-03T02:17:42.264668Z", "disappeared_at": null, "updated_at": "2026-11-03T02:17:42.264668Z", "raw": { "fx": { "date": "2026-11-02", "source": "ECB", "currency": "KRW", "usd_per_unit": "0.0007446554" }, "badge": "1.6 터보", "trust": [], "has_vin": false, "condition": [ "Inspection", "Record", "Resume" ], "form_year": "202009", "sell_type": "normal", "body_class": null, "office_city": "인천", "badge_detail": "노블레스", "has_accident": false, "service_mark": [], "source_values": { "fuel": "가솔린", "trim": "1.6 터보 노블레스", "brand": "기아", "model": "K5 3세대", "region": "인천", "sell_type": "일반", "transmission": null }, "has_inspection": false }, "source_mode": "replica" }, { "id": "encar:43082202", "market": "kr", "source": "encar", "source_id": "43082202", "title": "2021 Genesis GV70 2.2 2WD", "brand": "Genesis", "model": "GV70", "generation": null, "trim": "2.2 2WD", "year": 2021, "mileage_km": 73374, "fuel": "diesel", "transmission": null, "engine_cc": null, "body_type": null, "color": null, "vin": null, "price": { "amount": "30900000.00", "currency": "KRW" }, "price_usd": "23009.85", "location": { "country": "KR", "region": "Gyeongnam", "city": null }, "photos": [ "https://api.apiauto.space/img/encar:43082202/1.jpg?exp=…&sig=…", "https://api.apiauto.space/img/encar:43082202/2.jpg?exp=…&sig=…" ], "photo_count": 4, "listing_url": "https://fem.encar.com/cars/detail/43082202", "is_active": true, "first_seen_at": "2026-11-03T02:17:42.264668Z", "last_seen_at": "2026-11-03T02:17:42.264668Z", "disappeared_at": null, "updated_at": "2026-11-03T02:17:42.264668Z", "raw": { "fx": { "date": "2026-11-02", "source": "ECB", "currency": "KRW", "usd_per_unit": "0.0007446554" }, "badge": "2.2 디젤 2WD", "trust": [], "has_vin": false, "condition": [ "Inspection", "Record" ], "form_year": "202109", "sell_type": "normal", "body_class": null, "office_city": "경남", "badge_detail": "(세부등급 없음)", "has_accident": false, "service_mark": [], "source_values": { "fuel": "디젤", "trim": "2.2 디젤 2WD (세부등급 없음)", "brand": "제네시스", "model": "GV70", "region": "경남", "sell_type": "일반", "transmission": null }, "has_inspection": false }, "source_mode": "replica" } ], "next_cursor": "…", "count": null } ``` ## 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](https://apiauto.space/en/docs/record/) ; importing a whole catalog is in [Keeping in sync](https://apiauto.space/en/docs/sync/) . --- Page: https://apiauto.space/en/docs/endpoints/cars/