Для автоимпортёров

# Каталог авто из Кореи, Китая и США на сайт импортёра

Если вы возите машины из Кореи, Китая или с аукционов США, клиенты хотят выбирать сами — на вашем сайте, с фото и ценами. apiauto.space даёт для этого данные: каталоги Encar, Che168, Copart и IAAI через API в одном формате. Сайт и расчёт цены «под ключ» остаются вашими, данные и их обновление — нашими.

GET`/v1/cars/che168:59997083`

```json
{
  "id": "che168:59997083",
  "title": "2024 Jaguar XEL",
  "year": 2024,
  "mileage_km": 10000,
  "price": {
    "amount": "126800.00",
    "currency": "CNY"
  },
  "price_usd": "18925.15",
  "location": {
    "country": "CN",
    "region": null,
    "city": "Shenzhen"
  },
  "photo_count": 9,
  …
}
```

200 OK · настоящая запись из каталога

## Что увидит ваш клиент

- Машины с фото, годом, пробегом, городом и ценой — в валюте источника и в долларах.
- Фильтры: марка, модель, год, цена, пробег, топливо, коробка, кузов.
- Свежие поступления и снижения цены — из ленты изменений (тарифы Pro и Max).
- Лоты аукционов США с датой торгов, повреждениями и типом документа.

## Как это устроено

1. Ваш сайт на своём сервере запрашивает `/v1/cars` с нужными фильтрами — по расписанию или когда клиент открывает каталог.
2. Ключ хранится на сервере: из браузера API не вызывается (CORS выключен), иначе ключ увидит любой посетитель.
3. Цену в рублях с доставкой, таможней и комиссией считает ваш сайт по вашей формуле: API отдаёт цену источника и `price_usd` , курс — в `raw.fx` .
4. Фото показываются по ссылкам из записи, их отдаёт наш сервер. Ссылки живут около суток — храните id машины, а не ссылку.

## Что нужно от разработчика

API — это данные, а не готовый сайт: подключить его должен разработчик, на любой платформе с серверной частью (PHP и WordPress, Python, Node.js). Всё, что ему нужно, — в [документации](https://apiauto.space/docs/): примеры на четырёх языках, поля записи, ошибки, квоты. Сайты и шаблоны мы не делаем.

Задачу можно сформулировать так: «Каталог машин из API apiauto.space: список с фильтрами по марке, модели, году и цене, карточка машины с фото, ежечасное обновление, цена в рублях по нашей формуле».

## Какой тариф выбрать

| Что возите | Тариф | Цена |
| --- | --- | --- |
| Из одной страны: только Корея, только Китай или только США | Start | $59 в месяц, 100 000 машин |
| Из двух стран + лента новых машин и цен | Pro | $149 в месяц, 500 000 машин |
| Из всех трёх стран | Max | $299 в месяц, 2 000 000 машин |
| Перепродажа данных или полная выгрузка | Enterprise | условия и цена — по договорённости в боте |

Квота — число машин, которые вернул API за месяц, а не число посетителей сайта: кэшируйте ответы у себя, чтобы не тратить её на одинаковые запросы. Год стоит как десять месяцев.

## Что стоит знать заранее

- Корея: VIN почти нет, коробки и объёма двигателя нет — [подробнее об Encar](https://apiauto.space/encar-api/) .
- Китай: VIN нет совсем, цена — цена дилера в юанях — [подробнее о Che168](https://apiauto.space/che168-api/) .
- США: только лоты с торгами впереди, без истории продаж — [подробнее о Copart и IAAI](https://apiauto.space/copart-iaai-api/) .
- Названия марок и моделей латиницей, описаний на русском нет.

## Частые вопросы

### 01Нужен ли программист?

Да. API отдаёт данные, а показать их на сайте — работа разработчика. Для простого каталога достаточно серверного запроса к /v1/cars и шаблона карточки машины.

### 02Можно ли показывать эти машины клиентам?

Да, в своём продукте и своим клиентам, включая фото. Перепродажа данных и полные выгрузки — только по договору Enterprise.

### 03Будут ли цены в рублях?

API отдаёт цену в валюте источника (KRW, CNY, USD) и в долларах по курсу ЕЦБ. Цену в рублях с доставкой и растаможкой считает ваш сайт по вашей формуле.

### 04Как часто обновляется каталог?

Копия каждого рынка обновляется по расписанию, цель — каждый час. Возраст данных приходит в каждом ответе, в заголовке X-Data-Age-Seconds.

### 05Как попробовать до оплаты?

Возьмите демо-ключ в боте: сутки, 100 запросов, все три рынка, без оплаты. Одно демо на аккаунт Telegram.

## Другие API и руководства

- [API источника **API Encar**](https://apiauto.space/encar-api/)
- [API источника **API Che168**](https://apiauto.space/che168-api/)
- [API источника **API Copart и IAAI**](https://apiauto.space/copart-iaai-api/)
- [Руководство **Парсер или готовый API**](https://apiauto.space/parser-vs-api/)
- [Разработчикам **Документация**](https://apiauto.space/docs/)

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

- Сутки и 100 запросов бесплатно, без карты
- Все три рынка — Корея, Китай и США — и лента изменений
- Ключ приходит в Telegram за минуту — без формы и звонков

---

Страница: https://apiauto.space/importers/