Для автоимпортёров
Каталог авто из Кореи, Китая и США на сайт импортёра
Если вы возите машины из Кореи, Китая или с аукционов США, клиенты хотят выбирать сами — на вашем сайте, с фото и ценами. apiauto.space даёт для этого данные: каталоги Encar, Che168, Copart и IAAI через API в одном формате. Сайт и расчёт цены «под ключ» остаются вашими, данные и их обновление — нашими.
/v1/cars/che168:59997083{
"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).
- Лоты аукционов США с датой торгов, повреждениями и типом документа.
Как это устроено
- Ваш сайт на своём сервере запрашивает
/v1/carsс нужными фильтрами — по расписанию или когда клиент открывает каталог. - Ключ хранится на сервере: из браузера API не вызывается (CORS выключен), иначе ключ увидит любой посетитель.
- Цену в рублях с доставкой, таможней и комиссией считает ваш сайт по вашей формуле: API отдаёт цену источника и
price_usd, курс — вraw.fx. - Фото показываются по ссылкам из записи, их отдаёт наш сервер. Ссылки живут около суток — храните id машины, а не ссылку.
Что нужно от разработчика
API — это данные, а не готовый сайт: подключить его должен разработчик, на любой платформе с серверной частью (PHP и WordPress, Python, Node.js). Всё, что ему нужно, — в документации: примеры на четырёх языках, поля записи, ошибки, квоты. Сайты и шаблоны мы не делаем.
Задачу можно сформулировать так: «Каталог машин из API apiauto.space: список с фильтрами по марке, модели, году и цене, карточка машины с фото, ежечасное обновление, цена в рублях по нашей формуле».
Какой тариф выбрать
| Что возите | Тариф | Цена |
|---|---|---|
| Из одной страны: только Корея, только Китай или только США | Start | $59 в месяц, 100 000 машин |
| Из двух стран + лента новых машин и цен | Pro | $149 в месяц, 500 000 машин |
| Из всех трёх стран | Max | $299 в месяц, 2 000 000 машин |
| Перепродажа данных или полная выгрузка | Enterprise | условия и цена — по договорённости в боте |
Квота — число машин, которые вернул API за месяц, а не число посетителей сайта: кэшируйте ответы у себя, чтобы не тратить её на одинаковые запросы. Год стоит как десять месяцев.
Что стоит знать заранее
- Корея: VIN почти нет, коробки и объёма двигателя нет — подробнее об Encar.
- Китай: VIN нет совсем, цена — цена дилера в юанях — подробнее о Che168.
- США: только лоты с торгами впереди, без истории продаж — подробнее о Copart и IAAI.
- Названия марок и моделей латиницей, описаний на русском нет.
Частые вопросы
01Нужен ли программист?
Да. API отдаёт данные, а показать их на сайте — работа разработчика. Для простого каталога достаточно серверного запроса к /v1/cars и шаблона карточки машины.
02Можно ли показывать эти машины клиентам?
Да, в своём продукте и своим клиентам, включая фото. Перепродажа данных и полные выгрузки — только по договору Enterprise.
03Будут ли цены в рублях?
API отдаёт цену в валюте источника (KRW, CNY, USD) и в долларах по курсу ЕЦБ. Цену в рублях с доставкой и растаможкой считает ваш сайт по вашей формуле.
04Как часто обновляется каталог?
Копия каждого рынка обновляется по расписанию, цель — каждый час. Возраст данных приходит в каждом ответе, в заголовке X-Data-Age-Seconds.
05Как попробовать до оплаты?
Возьмите демо-ключ в боте: сутки, 100 запросов, все три рынка, без оплаты. Одно демо на аккаунт Telegram.
Другие API и руководства
Получите тестовый ключ
- Сутки и 100 запросов бесплатно, без карты
- Все три рынка — Корея, Китай и США — и лента изменений
- Ключ приходит в Telegram за минуту — без формы и звонков
100 запросов за данными, до 20 машин за раз, все три рынка и лента изменений. Справочники, расход и фото бесплатны.
Ключ — следующим сообщением. Он показывается один раз: сохраните его.
au_live_••••••••••••••••••••••••••••••••