Республика КореяАукцион

HeyDealer for dealers API

Дилерские аукционы HeyDealer из Южной Кореи в JSON: характеристики, фото, время аукциона и ставки, если показаны.

На dealer.heydealer.com

dealer.heydealer.com

В вашем коде

{"vin": string"brand": { name }"model": { name }"year": number"listings": [{"external": {…}"auction_at": string"current_bid": number"odometer": {…}"is_auction": boolean"images": […]}]"inspections": […]"vehicle_history_reports": […]}

Названия полей взяты из реальной записи; значения – это типы, а не данные.

Что такое HeyDealer for dealers?

01/ 06О сайте

О HeyDealer for dealers

HeyDealer для дилеров (dealer.heydealer.com) – часть HeyDealer, где корейские дилеры делают ставки на авто, которые выставили на продажу владельцы, в коротком окне торгов. MotorAPIs читает эти авто со временем аукциона и текущей ставкой, если страница их показывает. API только возвращает данные и никогда не делает ставок.

Страна
Республика Корея
Тип
Аукцион
API
api.motorapis.com
Сайт
dealer.heydealer.com

Какие данные я получу?

02/ 06Поля

Что вы получаете от HeyDealer for dealers

Каждый автомобиль из аукционного списка в общей записи авто. Поля заполняются, если HeyDealer for dealers их показывает.

Автомобиль

  • VIN, если сайт его показывает
  • Марка, модель и поколение из единого каталога
  • Год, топливо, коробка передач, двигатель, мощность
  • Пробег в км

Лот

  • Сайт и ID лота, ссылка на страницу
  • Дата аукциона
  • Текущая ставка, если показана
  • Повреждения и состояние, если показаны
  • Местоположение и фотогалерея

Отчёты

  • Осмотры, если опубликованы
  • Отчёты об истории, если опубликованы

Одно авто, много сайтов

  • Одно авто на нескольких сайтах – это одно авто
  • Проданные авто остаются доступными примерно месяц

Как их запросить?

03/ 06Запросы

Три запроса для старта

ID сайтов зависят от ключа: один раз получите их из /domains, затем фильтруйте по ним.

  1. 01Найдите ID сайта HeyDealer for dealers

    GET https://api.motorapis.com/domains
      x-api-key: YOUR_API_KEY
  2. 02Ищите его автомобили

    GET https://api.motorapis.com/search?domains[]={domain_id}&perPage=20
      x-api-key: YOUR_API_KEY
  3. 03Выгрузите всё и поддерживайте в актуальном состоянии

    GET https://api.motorapis.com/cars?domains[]={domain_id}&limit=500
      x-api-key: YOUR_API_KEY

Что ещё стоит знать?

04/ 06Вопросы

Вопросы о HeyDealer for dealers API

Какие данные HeyDealer for dealers возвращает API?
Каждый автомобиль из списка HeyDealer for dealers в виде стандартной записи авто: характеристики, фото, местоположение, дата аукциона и текущая ставка, если HeyDealer for dealers их показывает, а также осмотры и отчёты об истории, если они опубликованы.
Можно ли делать ставки на HeyDealer for dealers через MotorAPIs?
Нет. MotorAPIs только возвращает данные. Ставки делаются на самом HeyDealer for dealers по его собственным правилам для покупателей.
Как выбрать HeyDealer for dealers в API?
Один раз вызовите /domains, чтобы узнать ID сайта HeyDealer for dealers для вашего ключа, затем передавайте его как domains[] в /search или /cars.
Как поддерживать копию в актуальном состоянии?
Используйте выгрузку /cars: начните без курсора и переходите по next_url до конца. Запустите её снова, чтобы обновить копию.
Как попробовать?
Запросите бесплатный демо-ключ и сообщите, какие сайты вам нужны. Он возвращает реальные данные в том же JSON, что и платные тарифы.

Что ещё подключено?

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

06/ 06Старт

Данные HeyDealer for dealers в вашем продукте

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

Получить демо-ключ

MotorAPIs – независимый поставщик данных и не связан с HeyDealer for dealers. Названия и товарные знаки принадлежат их владельцам.