БолгарияПлощадка

OLX Bulgaria API

Объявления об авто OLX Bulgaria в JSON: цена, год, пробег и фото.

На olx.bg

olx.bg

В вашем коде

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

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

Что такое OLX Bulgaria?

01/ 06О сайте

О OLX Bulgaria

OLX Bulgaria (olx.bg) – универсальный сайт объявлений с разделом авто, в основном от частных продавцов. MotorAPIs читает эти объявления в ту же запись, что и Mobile.bg.

Страна
Болгария
Тип
Площадка
API
api.motorapis.com
Сайт
olx.bg

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

02/ 06Поля

Что вы получаете от OLX Bulgaria

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

Автомобиль

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

Объявление

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

Отчёты

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

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

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

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

03/ 06Запросы

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

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

  1. 01Найдите ID сайта OLX Bulgaria

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

Вопросы о OLX Bulgaria API

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

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

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

06/ 06Старт

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

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

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

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