Корея2 мин чтения

Encar API: подержанные авто из Кореи в JSON

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

О чём речь?

01/ 05Статья

Encar – это площадка объявлений

На Encar дилеры и частные владельцы выставляют машины на продажу с ценой продавца. Здесь нет ставок и даты продажи: машина остаётся в объявлениях, пока её не продадут или не снимут. Поэтому данные Encar отличаются от Copart или IAAI, и читать их нужно иначе.

Для импортёров в Центральной Азии, на Кавказе, в Восточной Европе и на Ближнем Востоке корейские машины – стабильный источник ухоженных автомобилей с документированным прошлым.

Что содержит объявление Encar

В API объявление Encar использует ту же запись об авто, что и лоты аукционов, а корейские детали идут рядом:

  • Марка, модель, поколение, год, топливо, коробка передач, цвет и пробег
  • Цена продавца в корейских вонах, как указано в объявлении
  • Фотогалерея и местоположение объявления
  • Коды опций комплектации со справочником, который называет каждую
  • Лист осмотра технического состояния и страховая история ДТП, если они есть в объявлении

Осмотр и страховая история

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

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

Повторно выставленные машины

Продавцы на Encar иногда снимают машину и выставляют её снова под новым ID. API хранит пары ID, принадлежащих одной машине, поэтому ваш каталог показывает одну машину вместо двух и сохраняет её историю.

Цены в вонах и долларах

Цены на Encar указаны в корейских вонах. Сохранённый курс KRW к USD, доступный без ключа, позволяет показать сумму в долларах рядом с исходной. Это справочный курс со временем обновления, а не биржевая котировка в реальном времени.

Не только Encar

Encar – крупнейший корейский источник, но не единственный. KB ChaChaCha, K Car и другие корейские сайты публикуют машины, которых нет на Encar. О них рассказывает гайд по данным корейского рынка подержанных авто.

Как выглядит запрос?

02/ 05Запросы

Как выглядят запросы

Каждый вызов – обычный GET с вашим ключом в заголовке x-api-key. Ответ приходит в JSON.

  1. 01Объявления Encar со всеми фильтрами поиска

    GET https://motorapis.com/api/cars?domain_id=12
    x-api-key: YOUR_API_KEY
  2. 02Одно объявление Encar по ID

    GET https://motorapis.com/api/search-lot/{listing_id}/encar_com
    x-api-key: YOUR_API_KEY
  3. 03Сохранённый курс KRW к USD (ключ не нужен)

    GET https://motorapis.com/api/exchange-rate-krw-usd
    x-api-key: YOUR_API_KEY

Что-то ещё?

03/ 05Вопросы

Вопросы

Encar – это аукцион?
Нет. Encar – площадка объявлений: продавцы выставляют машины с ценой продавца. MotorAPIs возвращает эту цену так, как она указана.
У каждой машины на Encar есть осмотр?
Не у каждой. Лист осмотра и страховая история приходят с объявлением, если продавец их опубликовал.
Что такое коды опций?
Encar указывает комплектацию кодами. Справочник в API называет каждый код, так что вы можете показать «люк» вместо числа.
Можно ли показывать цены в долларах?
Да. Умножьте цену в вонах на сохранённый курс и покажите рядом время его обновления.
Как попробовать?
Запросите бесплатный демо-ключ. Он возвращает реальные данные в том же JSON, что и платные тарифы.

Что дальше?

Готовы попробовать?

05/ 05Следующий шаг

Посмотрите объявления Encar в своём коде

Расскажите, что вы создаёте. Мы ответим письменно, пришлём демо-ключ и подскажем следующие шаги.

Telegram
Получить бесплатный демо-ключ

Encar – товарный знак его владельца. MotorAPIs – независимый сервис, не связанный с Encar и не одобренный им.