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`

GEThttps://api.apiauto.space/v1/cars?market=kr&limit=20&brand=Kia

cURL

curl -s "https://api.apiauto.space/v1/cars?market=kr&limit=20&brand=Kia" \
  -H "X-API-Key: $APIAUTO_KEY"

JavaScript

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

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
$ch = curl_init("https://api.apiauto.space/v1/cars?market=kr&limit=20&brand=Kia");
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER => ["X-API-Key: " . getenv("APIAUTO_KEY")],
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);

Получить тестовый ключ

Сайт запросов не отправляет: скопируйте код и запустите со своим ключом.

Ответ

HTTP 200

{
  "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.
Поля записи — в разделе Запись о машине; выгрузка каталога целиком — в Синхронизации.