Какие данные Gumtree возвращает API?

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

Как выбрать Gumtree в API?

Один раз вызовите /domains, чтобы узнать ID сайта Gumtree для вашего ключа, затем передавайте его как domains[] в /search или /cars.

Что, если одно авто есть на нескольких сайтах?

Это одно авто с несколькими объявлениями. У каждого объявления свой сайт, ID, цена и ссылка, поэтому вы видите все места, где авто предлагается.

Как поддерживать копию в актуальном состоянии?

Используйте выгрузку /cars: начните без курсора и переходите по next_url до конца. Запустите её снова, чтобы обновить копию.

Как попробовать?

Запросите бесплатный демо-ключ и сообщите, какие сайты вам нужны. Он возвращает реальные данные в том же JSON, что и платные тарифы.

ВеликобританияПлощадка

Gumtree API

Объявления об авто Gumtree из Великобритании в JSON: цена, пробег, год, топливо и фото.

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

На gumtree.com

gumtree.com

В вашем коде

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

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

Что такое Gumtree?

01/ 06О сайте

О Gumtree

Gumtree – британский сайт объявлений с оживлённым разделом авто для частных продавцов и дилеров. В объявлениях указаны цена, пробег, год, топливо и фото. MotorAPIs читает их как стандартные записи авто.

Страна: Великобритания
Тип: Площадка
API: api.motorapis.com
Сайт: gumtree.com

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

02/ 06Поля

Что вы получаете от Gumtree

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

Автомобиль

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

Объявление

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

Отчёты

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

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

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

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

03/ 06Запросы

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

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

01Найдите ID сайта Gumtree

GET https://api.motorapis.com/domains
  x-api-key: YOUR_API_KEY

02Ищите его автомобили

GET https://api.motorapis.com/search?domains[]={domain_id}&perPage=20
  x-api-key: YOUR_API_KEY

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

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

04/ 06Вопросы

Вопросы о Gumtree API

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

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

05/ 06Похожие

Данные Gumtree в вашем продукте

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

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

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