API

Документация API: эндпоинты и примеры запросов

Справочник по эндпоинтам MotorFeed: примеры запросов поиска, карточек и отчётов, параметры локализации, курсы валют, расчёт по стране клиента (MD, RU, UA, AE), переопределения логистики и правила защищённого доступа.

Swagger UI

OpenAPI JSON

История и осмотр

Расчёт MD · RU · UA · AE

Курсы клиента и банка

Любые ISO-валюты

IP + x-api-key

Rate limit

структурированный поиск

JSON

POST /search
{
  "lang": "ru-MD",
  "country": "UA",
  "customer": "individual",
  "currency": "USD",
  "exchangeRates": {
    "KRW": 1390.5,
    "UAH": 41.8,
    "EUR": 0.92
  },
  "logisticsTariff": {
    "basis": "price",
    "priceCurrency": "KRW",
    "tiers": [
      { "maxPrice": 16000000, "costUsd": 4900 },
      { "minPrice": 16000000, "costUsd": 4400 }
    ]
  },
  "powerHp": 150,
  "batteryCapacityKwh": 64,
  "customsClearanceYearBufferMonths": 3,
  "sort": "newest",
  "offset": 0,
  "limit": 20,
  "filters": {
    "saleOnly": true,
    "brandId": "002",
    "modificationId": "136",
    "gradePath": ["008"],
    "fuelTypeIds": ["001", "002"],
    "colorIds": ["흰색"],
    "seatingCapacityIds": ["5"],
    "price": { "min": 15000, "max": 35000 },
    "year": { "min": 2020, "max": 2026 },
    "mileage": { "max": 100000 }
  }
}

карточка: страна, валюта и переопределения

HTTP

GET /vehicles/encar_42247740
  ?lang=ru-MD
  &country=UA
  &customer=individual
  &currency=USD
  &rates=KRW:1390.5,UAH:41.8
  &logisticsTariff=price,currency:KRW,0-16000000:4900,16000000-:4400
  &powerHp=150
  &batteryCapacityKwh=64
  &certificationCost=7000
  &customsClearanceYearBufferMonths=3

страховая история и отчёт об осмотре

HTTP

GET /vehicles/encar_42247740/history
  ?lang=ru-MD
  &currency=USD
  &rates=KRW:1390.5

GET /vehicles/encar_42247740/inspection?lang=ru-MD

Каталог

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

GET /catalog/manufacturersGET /catalog/model-groupsGET /catalog/modelsGET /catalog/badgesGET /catalog/badge-details

Поиск

Оба метода принимают lang, country, customer, currency, exchangeRates, переопределения логистики и расчёта, стандартизированный sort и структурированные filters: только продажа, каскад комплектаций, цвета, число мест и точный пробег. Диапазон price относится к итоговой цене в выбранной валюте, а не к сырой цене Encar.

POST /search/contextPOST /search

Карточка и отчёты

Карточка возвращает локализованные данные и подробный pricing по правилам выбранной страны, а history и inspection добавляют страховую историю и осмотренные зоны кузова. Идентификаторы возвращаются с префиксом, например encar_42247740.

GET /vehicles/:id?country=UA&currency=USDGET /vehicles/:id/historyGET /vehicles/:id/inspection

Интеграция

Что получает ваша команда

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

Не нужно разбирать внутренние ответы Encar: сервис возвращает понятную структуру для вашего приложения.

Поиск работает через понятные filters: бренд, модель, модификация, категория, топливо, коробка, число мест, цвет, каскад комплектаций, цена, год и точный диапазон пробега в километрах. Идентификаторы берутся из /search/context, причём цвета и комплектации Encar публикует своими корейскими значениями — «흰색» и есть id белого цвета, читаемое название лежит рядом в том же фасете.

sort использует стандартизированные значения — newest, firstListed, priceAsc, priceDesc, yearDesc, mileageAsc, mileageDesc, — которые сервис сам сопоставляет с сортировкой маркетплейса.

Параметр lang принимает ru-MD, ro-MD, en-US или ko-KR и локализует поиск, фильтры и карточку автомобиля под нужный язык интерфейса.

Курсы можно передавать со стороны клиента для расчёта именно по вашему банку, а недостающие значения сервер подставит сам.

country выбирает модуль расчёта для нужной страны — MD, RU, UA или AE, — customer уточняет тип импортёра, а currency задаёт валюту всех сумм в ответе.

logisticsCost переопределяет встроенную оценку доставки, а logisticsTariff принимает целый тариф: фиксированную стоимость по типу топлива или ценовые пороги в вашей валюте.

powerHp, batteryCapacityKwh, certificationCost и expertExaminationCost заменяют то, что страна может только оценить, а всё оставшееся оценочным помечается в ответе.

customsClearanceYearBufferMonths считает машину по тому году, в котором она реально пройдёт растаможку, поэтому осенняя покупка не оценивается по возрасту текущего года.

К карточке можно добавить страховую историю и отчёт об осмотре: смены владельцев, выплаты по ДТП, а также отремонтированные и заменённые зоны кузова с их местом на схемах повреждений.

OpenAPI показывает 401, 402, 403 и 429, а доступ можно ограничить по IP и x-api-key.

Кэширование снижает лишние обращения к источнику, а для карточки автомобиля предусмотрен fallback, если основной источник деталей недоступен.

Дальше

Выберите сценарий подключения

Можно сначала посмотреть бизнес-возможности или сразу написать в Telegram и описать, куда нужно подключить данные Encar.

Смотреть возможности Открыть контакты

Хотите подключить API к действующему продукту?

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

Обсудить интеграцию