Корея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 і не схвалений ним.