ЯпонияПлощадка

Goo-net API

Объявления о подержанных авто Goo-net из Японии в JSON: цена, пробег, фото и характеристики.

На goo-net.com

goo-net.com

В вашем коде

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

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

Что такое Goo-net?

01/ 06О сайте

О Goo-net

Goo-net – один из крупнейших порталов подержанных авто в Японии, которым управляет Proto Corporation. Дилеры по всей Японии размещают свой сток с ценой, пробегом и фото. MotorAPIs читает внутренние объявления; у экспортного сайта Goo-net Exchange есть своя страница.

Страна
Япония
Тип
Площадка
API
api.motorapis.com
Сайт
goo-net.com

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

02/ 06Поля

Что вы получаете от Goo-net

Каждое объявление в общей записи авто. Поля заполняются, если Goo-net их показывает.

Автомобиль

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

Объявление

  • Сайт и ID объявления, ссылка на объявление
  • Цена и валюта
  • Тип продавца и местоположение
  • Фотогалерея
  • Комплектация

Отчёты

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

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

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

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

03/ 06Запросы

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

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

  1. 01Найдите ID сайта Goo-net

    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Вопросы

Вопросы о Goo-net API

Какие данные Goo-net возвращает API?
Каждое объявление в виде стандартной записи авто: марка, модель и поколение из единого каталога, год, пробег, цена и валюта, местоположение, фото и комплектация, а также осмотры и отчёты об истории, если Goo-net их публикует.
Как выбрать Goo-net в API?
Один раз вызовите /domains, чтобы узнать ID сайта Goo-net для вашего ключа, затем передавайте его как domains[] в /search или /cars.
Что, если одно авто есть на нескольких сайтах?
Это одно авто с несколькими объявлениями. У каждого объявления свой сайт, ID, цена и ссылка, поэтому вы видите все места, где авто предлагается.
Как поддерживать копию в актуальном состоянии?
Используйте выгрузку /cars: начните без курсора и переходите по next_url до конца. Запустите её снова, чтобы обновить копию.
Как попробовать?
Запросите бесплатный демо-ключ и сообщите, какие сайты вам нужны. Он возвращает реальные данные в том же JSON, что и платные тарифы.

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

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

06/ 06Старт

Данные Goo-net в вашем продукте

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

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

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