**01** Методы # Каталог машин Кореи, Китая и США `GET /v1/cars` Каталог одного рынка с фильтрами, сортировкой и курсором. Квота — по числу машин в ответе. Примеры запросов ## Параметры ### Рынок и страница - `market` обязателен (query · kr | cn | us) Рынок: kr — Encar, cn — Che168, us — Copart и IAAI. - `limit` (query · integer · 1–100) Машин на странице, по умолчанию 20 (в демо до 20). - `cursor` (query · string) Значение next_cursor прошлой страницы. - `sort` (query · string) Порядок; по умолчанию -first_seen — сначала новые в каталоге. ### Марка и модель - `brand` (query · string) Марка как в /v1/references/brands; регистр, пробелы и дефисы не важны. - `model` (query · string) Семейство модели, одно на всех рынках: Grandeur, 3 Series. - `generation` (query · string) Только Корея: поколение, как в поле generation. - `trim` (query · string) Комплектация, точное совпадение. - `q` (query · string) До 6 слов названия: год, марка, модель, комплектация. ### Машина - `year_min` (query · integer) Год выпуска от. - `year_max` (query · integer) Год выпуска до. - `mileage_max` (query · integer · km) Пробег до, км. - `fuel` (query · string) Топливо, значение из справочника. - `transmission` (query · string) Коробка передач. - `body_type` (query · string) Кузов. - `has_photos` (query · boolean) Только с фото или только без. ### Цена - `price_min` (query · number) Цена от, в валюте рынка (KRW, CNY, USD). - `price_max` (query · number) Цена до, в валюте рынка. - `price_usd_min` (query · number · USD) Цена от, в долларах по курсу ЕЦБ. - `price_usd_max` (query · number · USD) Цена до, в долларах. ### Статус - `is_active` (query · boolean) По умолчанию true; false — снятые с продажи за 14 дней. ## Запрос `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); ``` ## Ответ 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 } ``` ## Примечания - count — сколько машин подходит под фильтры, если их не больше 10 000; больше — null. - Параметр offset не поддерживается — запрос с ним получит 400. - Поля записи — в разделе [Запись о машине](https://apiauto.space/docs/record/) ; выгрузка каталога целиком — в [Синхронизации](https://apiauto.space/docs/sync/) . --- Страница: https://apiauto.space/docs/endpoints/cars/