02 Методы

Одна машина по id

GET /v1/cars/{id}

Полная запись одной машины по id. Снятые с продажи отдаются ещё 14 дней с is_active=false. Одна запись квоты.

Примеры запросов

Параметры

Путь

id обязателенpath · source:source_id
id из каталога или ленты: encar:…, che168:…, copart:…, iaai:….

Запрос `GET`

GEThttps://api.apiauto.space/v1/cars/encar:43082263

cURL

curl -s "https://api.apiauto.space/v1/cars/encar:43082263" \
  -H "X-API-Key: $APIAUTO_KEY"

JavaScript

const response = await fetch(
  "https://api.apiauto.space/v1/cars/encar:43082263",
  { 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/encar:43082263",
    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/encar:43082263");
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER => ["X-API-Key: " . getenv("APIAUTO_KEY")],
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);

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

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

Ответ

HTTP 200

{
  "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 стабилен навсегда: храните его, а не ссылки на фото.
Что значит каждое поле — в разделе Запись о машине.