Справочник API

Документация

Документация EnCarAPI. Узнайте, как получить доступ к данным корейских автомобилей через конечные точки API. Руководства по интеграции и примеры кода.

Опыт в отрасли

Поставщик API автомобильных данных с многолетним опытом на корейском рынке.

Поддержка 7 дней в неделю

Команда поддержки доступна 7 дней в неделю для помощи с интеграцией API.

Сервис 24/7

Круглосуточный мониторинг для надёжной доставки данных.

Уведомления о новых объявлениях в реальном времени

Мгновенный доступ через API к новым объявлениям автомобилей по мере их публикации.

Загрузки CSV

Скачайте списки марок, моделей и бейджей в формате CSV - закэшируйте их и откажитесь от запросов фасетов вживую.

Гибкие форматы экспорта

Получайте данные в форматах CSV, JSON, Excel и пользовательских форматах для лёгкой интеграции.

Базовый URL

Все запросы к API выполняются по следующему базовому URL:

url

https://api.encarapi.com

Например, для получения предложений:

http

GET https://api.encarapi.com/api/catalog?manufacturer=bmw&fuel=diesel&lang=en&count=true

Интерактивный справочник API Спецификация OpenAPI

Аутентификация

Аутентифицируйте свои запросы с помощью API-ключа. Передайте его как параметр запроса или через заголовок Authorization.

bash

# Send your API key in the x-api-key header (recommended):
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.encarapi.com/api/catalog?manufacturer=bmw&fuel=diesel&lang=en&count=true"

# The api_key query parameter also works:
GET https://api.encarapi.com/api/catalog?manufacturer=bmw&fuel=diesel&lang=en&count=true&api_key=YOUR_API_KEY

Рабочий процесс интеграции

Следуйте этим четырём шагам для интеграции с EnCarAPI.

Получить доступные фильтры

Получите все возможные значения фильтров (марки, модели, комплектации, цвета и т.д.)

GET /filters

Получить объявления автомобилей

Получите постраничный список объявлений с необязательными фильтрами по марке, модели, году, цене и другим параметрам.

GET /offers?page=1

Отслеживать изменения

Получите идентификатор изменения для определённой даты, затем запрашивайте добавленные, изменённые и удалённые объявления.

GET /change_id → GET /changes

Получить детали объявления

Получите полные данные конкретного объявления по его inner_id.

GET /offer?inner_id=...

Конечные точки API

Все доступные конечные точки для получения данных корейских автомобилей.

Данные для выпадающих списков (CSV)

Скачайте списки марок, моделей и бейджей в формате CSV, закэшируйте их и стройте свои выпадающие списки на их основе - без запросов фасетов на каждый клик и без офлайн-сопоставления. Каждый файл содержит столбец с количеством, а файл бейджей несёт разбивку по типам кузова (Купе / Седан / Кабриолет).

Скачайте один раз и кэшируйте - Обновляется ежедневно

https://api.encarapi.com/api/taxonomy/makes.csv?api_key=YOUR_KEY

Все марки с количеством объявлений

https://api.encarapi.com/api/taxonomy/models.csv?api_key=YOUR_KEY

Все сочетания марок и моделей с количеством

https://api.encarapi.com/api/taxonomy/badges.csv?api_key=YOUR_KEY

Все значения марок, моделей и бейджей (включая Купе / Седан / Кабриолет) с количеством

Добавьте свой API-ключ для загрузки - добавьте ?api_key=YOUR_KEY к URL файла. Файлы защищены ключом, без действующего ключа их никто не сможет скачать.

Актуальность данных

Полный каталог обновляется каждый день, новейшие объявления подхватываются каждые 2 часа, а проданные автомобили удаляются ежечасно.

Как долго кэшировать

Значения фильтров, таксономические CSV и /api/nav: кэшируйте на 24 часа
Объявления об автомобилях (/api/catalog): кэшируйте на 1-2 часа
Детали автомобиля (/api/vehicle/:id): кэшируйте на 24 часа

Отдавайте объявления из собственной базы данных и обновляйте их с этой периодичностью, а не запрашивайте их вживую при каждом клике пользователя.

Часто задаваемые вопросы

Готовы начать?

Свяжитесь с нами в Telegram, чтобы получить учётные данные API и начать доступ к данным корейских автомобилей уже сегодня.

Связаться в Telegram