Encar API

Encar API: объявления, каталог и расчёт стоимости авто из Кореи

Один REST-интерфейс вместо собственного парсера. MotorFeed забирает данные Encar, приводит их к постоянной схеме, переводит значения на нужный язык и отдаёт готовый JSON для сайта, CRM или внутренней панели.

Попробовать API Написать в Telegram

уровней каталога для каскадных фильтров

среза по авто: карточка, страховая история, отчёт об осмотре

страны расчёта: MD, RU, UA и AE

списаний пакета за справочники каталога

карточка автомобиля

JSON

GET /vehicles/encar_42247740
  ?lang=ru-MD&country=UA&currency=USD

{
  "title": "Hyundai Palisade 3.8 GDi AWD",
  "vehicleIdentity": {
    "brand": "Hyundai",
    "model": "Palisade",
    "generation": "LX2",
    "modification": "3.8 GDi AWD"
  },
  "vehicleId": 42247740,
  "vin": "KMHR381EDMU0*****",
  "spec": {
    "yearMonth": 202108,
    "mileage": 41500,
    "displacement": 3778,
    "fuelName": "Бензин",
    "transmissionName": "Автомат",
    "bodyName": "Внедорожник",
    "colorName": "Белый"
  },
  "photos": [
    {
      "code": "001",
      "type": "main",
      "thumbnailUrl": "https://.../thumb.jpg",
      "heroUrl": "https://.../hero.jpg",
      "url": "https://.../full.jpg"
    }
  ],
  "pricing": {
    "country": "UA",
    "currency": "USD",
    "sourcePrice": 27350,
    "customsValue": 26100,
    "fees": [
      { "code": "logistics", "amount": 4900 },
      { "code": "customs_duty", "amount": 2610 },
      { "code": "excise_tax", "amount": 1893 },
      { "code": "vat", "amount": 7370 }
    ],
    "total": 44223,
    "ratesUsed": { "KRW": 1390.5, "UAH": 41.8 },
    "estimated": false
  }
}

Что даёт API

Что вы получаете из Encar

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

Каталог

Справочники для фильтров

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

Поиск

Выдача по понятным фильтрам

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

Карточка

Полные данные по автомобилю

По сквозному идентификатору приходят характеристики, VIN при наличии, опции, состояние, описание продавца, фотографии и расчёт стоимости.

История

Страховая история

Смены владельцев, выплаты по ДТП, тотал, записи о затоплении и угоне — то, что клиент спрашивает до решения о покупке.

Осмотр

Отчёт об осмотре

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

Расчёт

Итоговая стоимость под страну

country, currency и ваши курсы дают построчный расчёт: логистика, пошлина, акциз, НДС и сборы по правилам Молдовы, России, Украины или ОАЭ.

Каталог

Марки, модели, поколения и автомобили

Каталог собран как каскад: каждый уровень принимает идентификаторы предыдущего, поэтому фильтр на сайте строится без ручных словарей и без разбора внутреннего синтаксиса Encar.

Марки

Список производителей с порядком вывода и отдельной сортировкой популярных марок.

GET /catalog/manufacturers

Модельные группы

Группы моделей внутри марки — верхний уровень выбора, который видит пользователь.

GET /catalog/model-groups

Модели и поколения

Модели с датами начала и конца производства: по ним строится поколение в единой модели данных MotorFeed.

GET /catalog/models

Комплектации

Комплектации выбранной модели и их детали через /catalog/badge-details — самый глубокий уровень фильтра.

GET /catalog/badges

Автомобили

Выдача объявлений по собранным идентификаторам: список, общее количество и фасеты фильтров со счётчиками.

POST /search

Справочники каталога помечены как бесплатные: они не списывают запросы из пакета. Пакет тратится только на поиск и карточки, поэтому построение фильтров ничего не стоит.

каскад каталога и поиск

HTTP

GET /catalog/manufacturers
GET /catalog/model-groups?manufacturerCd=001
GET /catalog/models
  ?manufacturerCd=001&modelGroupCd=019
GET /catalog/badges
  ?manufacturerCd=001&modelCd=136
GET /catalog/badge-details
  ?manufacturerCd=001&modelCd=136&badgeCd=008

POST /search
{
  "lang": "ru-MD",
  "country": "UA",
  "currency": "USD",
  "filters": {
    "saleOnly": true,
    "brandId": "001",
    "modificationId": "136",
    "gradePath": ["008"],
    "year": { "min": 2020 },
    "mileage": { "max": 100000 }
  },
  "sort": "newest",
  "limit": 20
}

Изображения

Фотографии с готовыми ссылками

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

thumbnailUrl

Миниатюра для списка и выдачи поиска.

heroUrl

Крупный кадр для обложки карточки автомобиля.

url

Полный размер для галереи.

Тип и порядок

У фото сохраняются код, тип, описание и дата обновления — можно отделить кузов от салона и не показывать устаревшие кадры.

Схемы осмотра

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

Фото дилера

В выдаче поиска отдельно приходят миниатюра объявления и фото продавца.

Характеристики

Какие поля приходят по автомобилю

Ниже — состав ответа карточки. Словарные значения переводятся параметром lang: ru-MD, ro-MD, en-US или ko-KR.

Идентификация

Сквозной идентификатор вида encar_42247740
VIN и номер кузова при наличии
Марка, модель, поколение и модификация одной структурой
Связь с исходной записью Encar и статус сопоставления

Технические данные

Год выпуска и дата первой регистрации
Пробег в километрах
Объём двигателя и тип топлива
Коробка передач, тип кузова, цвет
Опции и оснащение объявления

Объявление

Цена источника в вонах и пересчёт в вашу валюту
Регион, дилер и контактные данные объявления
Дата публикации
Статус продажи, включая авто под задатком
Описание продавца

Состояние и расчёт

Страховая история и отчёт об осмотре
Логистика, пошлина, акциз, НДС и сборы построчно
Итоговая сумма и использованные курсы валют
Флаг estimated там, где значение оценено, а не известно точно

Актуальность

Как обновляются данные

Поиск и карточка обращаются к источнику в момент вызова, поэтому в ответе актуальные цена и статус, а не вчерашняя копия базы.

Чтение в момент запроса

Выдача и карточка автомобиля читаются у источника при вызове — цена, наличие и статус объявления верны на момент ответа.

Кэш там, где он безопасен

Справочники каталога кэшируются на сутки, изменчивые данные — нет. Это убирает лишнюю нагрузку и не показывает устаревшую цену.

Снятые с продажи

Фильтр saleOnly убирает из выдачи недоступные объявления, а salesStatus отдельно помечает авто, на которое уже внесён задаток.

Запасной путь

Если основной источник карточки недоступен, сервис отвечает из резервного пути вместо ошибки интеграции.

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

Swagger UI и OpenAPI

Все методы, параметры и коды ответов описаны в OpenAPI — начать интеграцию можно без переписки и без примеров по запросу.

Swagger UI по адресу /docs: методы вызываются прямо из браузера вашим ключом.
Машинная схема /docs-json — можно сгенерировать клиент на своём языке.
Ошибки описаны явно: 401 без ключа, 402 без активной подписки, 403 при запросе с чужого IP, 429 при превышении лимита.
Ключи, доверенные IP и расход запросов видны в личном кабинете.

Стоимость

Доступ к Encar API

€149

в месяц, тариф Start

В тариф уже входят каталог, поиск, карточки, документация и поддержка. Оплата за год — со скидкой 15%.

Start — до 10 000 запросов в месяц

Grow — до 30 000 запросов и приоритетная поддержка

Scale — до 100 000 запросов и до 3 доменов или IP

Справочники каталога не расходуют пакет ни на одном тарифе

Все тарифы

Подключить Encar API к вашему продукту?

Создайте аккаунт и получите ключ, или напишите в Telegram — подскажем, какие методы закрывают ваш сценарий: витрина на сайте, CRM, панель менеджера или внутренний подбор.

Попробовать API Написать в Telegram