Skip to content

ria-com/auto-ria-rest-api

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

66 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Для перегляду актуальної документації перейдіть у розділ "Документація"

Мы запускаем новую версию API с более широкими возможностями на Developers.RIA.com. Вам будут доступны все API AUTO.RIA, AUTO Search и AUTO Info, а также в дальнейшем API DOM.RIA и RIA.com. Документация по новой версии здесь

Страница API 1.0 на Github будет поддерживаться до декабря 2017.

Регистрируйтесь на Developers.RIA.com и используй все преимущества наших API.

Тенденции на рынке б/у авто с REST API AUTO.RIA

Для перегляду актуальної документації перейдіть у розділ "Документація" Отслеживайте, анализируйте и прогнозируйте

Мы запускаем в свободное пользование “Подсчёт средней цены” — первый сервис, основанный на актуальных статистических данных AUTO.RIA (ежемесячно 10 тыс. опубликованных объявлений о продаже 7 800 марок авто, которые ежедневно собирают 8 млн. просмотров).

Теперь вы можете:

  • узнавать актуальные средние цены автомобилей разных марок и моделей;
  • следить за изменениями цен в кратко- и долгосрочном периодах;
  • анализировать и прогнозировать изменения цен и спроса на автомобили;
  • размещать полученную информацию на вашем сайте.*
* Наличие ссылки на сайт AUTO.RIA с гиперссылкой на страницу https://AUTO.RIA.com, 
не закрытой для индексации поисковыми системами, является единственным 
обязательным требованием для использования сервиса.

Ознакомьтесь с технической документацией, чтобы получить доступ и экспортировать необходимую информацию в программу вашей компании.

Благодарим за содействие в запуске сервиса “Подсчёт средней цены” ТОВ «Богдан–Авто Холдинг».

Ваш AUTO.RIA, автосайт № 1 в Украине.

REST API сайта AUTO.RIA.com

Для перегляду актуальної документації перейдіть у розділ "Документація" API возвращает данные в формате JSON. Формат данных в большинстве случаев стандартный - коллекция объектов с полями name (название объекта) и value (его идентификатор).

Идентификатор любой сущности является целым числом.

Содержание

Подсчет средней цены

Для перегляду актуальної документації перейдіть у розділ "Документація"

Список поддерживаемых параметров

Для перегляду актуальної документації перейдіть у розділ "Документація"

На данный момент поддерживаются следующие параметры:

Название Параметр в строке запроса Тип данных
Тип транспорта main_category Number
Тип кузова body_id Number
Марка marka_id Number
Модель model_id Number
Год выпуска yers Number[]
Коробка передач gear_id Number[]
Тип топлива fuel_id Number[]
Тип привода drive_id Number
Объем двигателя engineVolume Number
Опции options Number[]
Пробег raceInt Number[]
Количество дверей door Number
Область state_id Number
Город city_id Number
Грузоподъемность carrying Number
Количество мест seats Number
Цвет color_id Number
Растаможка custom Number
После ДТП damage Number
Взято в кредит under_credit Number
Конфискат confiscated_car Number
Не на ходу onRepairParts Number

Формат данных в запросе

Для перегляду актуальної документації перейдіть у розділ "Документація" Все параметры описанные в таблице поддерживаемых параметров должны передаватся в виде чисел. Исключениями являются только параметры - год выпуска. пробег, опции и коробка передач.

Если передать массив в параметре коробка передач, то это будет интерпретироваться как поиск коробок передач с логическим оператором ИЛИ. Т.е. http://api.auto.ria.com/average?marka_id=9&model_id=31612&gear_id=1&gear_id=2 - выберет для подсчета все BMW 318 с автоматическими и ручными коробками передач. Аналогично и с параметром тип топлива, например: http://api.auto.ria.com/average?marka_id=9&model_id=31887&yers=2014&fuel_id=1&fuel_id=2 - выберет для подсчета все BMW 520 2014 года с дизельными и бензиновыми двигателями.

Если передать массив в параметре год выпуска или пробег это будет интерпретироваться как диапазон значений. Например, http://api.auto.ria.com/average?raceInt=10&raceInt=100 - выберет для подсчета средней цены все объявления с пробегом от 10 до 100 тыс. км.

Если передать массив значений в параметре опции это будет интерпретироваться как поиск опций с логическим оператором "И". Т.е. http://api.auto.ria.com/average?auto_options=217&auto_options=463 выберет для подсчета все объявления, у которых есть опция ABS И Галогенные фары.

Формат данных в ответе

Для перегляду актуальної документації перейдіть у розділ "Документація"

В случае успешного подсчета средней цены по указанным параметрам результат будет со статусом 200 OK.

Пример успешного ответа:

{
    total: 17,
    arithmeticMean: 16305.882352941177,
    interQuartileMean: 8483.333333333334,
    percentiles: {
        1.0: 1944,
        5.0: 2520,
        25.0: 3500,
        50.0: 8000,
        75.0: 23500,
        95.0: 53539.999999999985,
        99.0: 64868
    },
    prices: [
        67700,
        27000,
        3000,
        23500,
        3500,
        8100,
        10000,
        3500,
        2700,
        8000,
        11000,
        45800,
        50000,
        1800,
        4350,
        4400,
        2850
    ],
    classifieds: [
        14663610,
        14226353,
        14138132,
        13969588,
        14697569,
        13386778,
        13279188,
        14555863,
        14754932,
        14816842,
        14664706,
        13873344,
        14681607,
        14772056,
        14059841,
        14290096,
        14890250
    ]
}

Расшифровка параметров:

  • total - общее количество объявлений, учавствующих в подсчете.
  • arithmeticMean - среднее арифметическое.
  • interQuartileMean - среднее арифметическое из значений, находящихся между первым и четвертым квантилем. Грубо говоря, это среднее арифметическое без учета 25% самых маленьких и самых больших значений.
  • percentiles - значения процентилей. Т.е. для данного примера 25% всех объявлений имеют цену ниже $3500.
  • prices - список цен, которые учавствовали в подсчете средней цены. Размер ограничен 1000 элементов.
  • classifieds - идентификаторы объявлений, к которым принадлежат цены соответственно. Размер ограничен 1000 элементов.

Если по каким-либо причинам не удалось подсчитать среднюю цену, ответ будет иметь статус 400 Bad Request, а тело ответа будет содержать следующее:

{ "message": "Not Enough Data" }

Примеры

Средняя цена по BMW X5 с пробегом от 10 до 100 тыс. км. - http://api.auto.ria.com/average?marka_id=9&model_id=96&raceInt=10&raceInt=100.

Средняя цена для Honda Accord в Киеве - http://api.auto.ria.com/average?marka_id=28&model_id=262&city_id=9

Методы для работы с типами транспорта и кузова

Для перегляду актуальної документації перейдіть у розділ "Документація"

Типы транспорта

Получить список типов транспорта можно отправив GET запрос на адрес http://api.auto.ria.com/categories. Результат будет примерно следующим:

[
    { name: "Легковые", value: 1 },
    { name: "Мото", value: 2 },
    { name: "Водный транспорт", value: 3 },
    { name: "Спецтехника", value: 4 },
    { name: "Прицеп", value: 5 },
    { name: "Грузовик", value: 6 },
    { name: "Автобус", value: 7 },
    { name: "Автодом", value: 8 },
    { name: "Воздушный транспорт", value: 9 }
]

Типы кузова

Для перегляду актуальної документації перейдіть у розділ "Документація"

Типы кузова зависят от типов транспорта. Поэтому для того, чтобы получить список типов кузова необходимо отправить GET запрос на адрес http://api.auto.ria.com/categories/:categoryId/bodystyles, где categoryId - идентификатор типа транспорта.

Например, для легковых автомобилей (http://api.auto.ria.com/categories/1/bodystyles), результат будет следующим:

[
    { name: "Седан", value: 3 },
    { name: "Внедорожник / Кроссовер", value: 5 },
    { name: "Минивэн", value: 8 },
    { name: "Хэтчбек", value: 4 },
    { name: "Универсал", value: 2 },
    { name: "Купе", value: 6 },
    { name: "Легковой фургон (до 1,5 т)", value: 254 },
    { name: "Кабриолет", value: 7 },
    { name: "Пикап", value: 9 },
    { name: "Лимузин", value: 252 },
    { name: "Другой", value: 28 }
]

Также типы кузова могут быть разделены на группы. Это актуально для спецтехники. Поэтому существует способ получить сгруппированные типы кузова отправив GET запрос по адресу http://api.auto.ria.com/categories/:categoryId/bodystyles/_group, где categoryId - идентификатор типа транспорта.

Например, для мотоциклов (http://api.auto.ria.com/categories/2/bodystyles/_group), результат будет следующим:

[
    [
        { name: "Мопеды", value: 58 },
        { name: "Скутер / Мотороллер", value: 11 },
        { name: "Макси-скутер", value: 12 }
    ],
    [
        { name: "Мотоциклы", value: 13 },
        { name: "Мотоцикл Без обтекателей (Naked bike)", value: 15 },
        { name: "Мотоцикл Внедорожный (Enduro)", value: 21 },
        { name: "Мотоцикл Кастом", value: 30 },
        { name: "Мотоцикл Классик", value: 14 },
        { name: "Мотоцикл Кросс", value: 19 },
        { name: "Мотоцикл Круизер", value: 24 },
        { name: "Мотоцикл Многоцелевой (All-round)", value: 25 },
        { name: "Мотоцикл с коляской", value: 29 },
        { name: "Спортбайк", value: 18 },
        { name: "Мотоцикл Спорт-туризм", value: 17 },
        { name: "Мотоцикл Супермото (Motard)", value: 22 },
        { name: "Мотоцикл Триал", value: 20 },
        { name: "Мотоцикл Туризм", value: 16 },
        { name: "Мотоцикл Чоппер", value: 23 }
    ],
    [
        { name: "Мини мотоциклы", value: 31 },
        { name: "Мини спорт", value: 32 },
        { name: "Мини крос (Питбайк)", value: 33 }
    ],
        { name: "Трицикл", value: 34 },
        { name: "Трайк", value: 57 },
    [
        { name: "Квадроциклы", value: 35 },
        { name: "Квадроцикл детский", value: 36 },
        { name: "Квадроцикл спортивный", value: 39 },
        { name: "Квадроцикл утилитарный", value: 41 },
        { name: "Мотовездеход", value: 42 },
        { name: "Вездеход-амфибия", value: 43 },
        { name: "Гольф-кар", value: 44 },
        { name: "Картинг", value: 45 }
    ],
    { name: "Снегоход", value: 46 },
    { name: "Другое", value: 56 }
]

Формат данных при этом отличается от обычного - это коллекция объектов, в которой есть другие коллекции. Группа типов кузовов всегда начинается с её названия. Например, в группу Квадроциклы входят типы кузовов Квадроцикл детский, Квадроцикл спортивный, Квадроцикл утилитарный, Мотовездеход и т.д.

Также, при необходимости, можно получиться просто весь список типов кузовов, послав GET запрос по адресу http://api.auto.ria.com/bodystyles.

Методы для работы с марками и моделями

Для перегляду актуальної документації перейдіть у розділ "Документація"

Марки

Для перегляду актуальної документації перейдіть у розділ "Документація"

Марки зависят от типов транспорта. Поэтому для того, чтобы получить список марок необходимо отправить GET запрос по адресу http://api.auto.ria.com/categories/:categoryId/marks, где categoryId - идентификатор типа транспорта.

Например, для легковых автомобилей (http://api.auto.ria.com/categories/1/marks), результат будет следующим:

[
    { name: "Acura", value: 98 },
    { name: "Adler", value: 2396 },
    { name: "Aixam", value: 2 },
    { name: "Alfa Romeo", value: 3 },
    { name: "Alpine", value: 100 },
    { name: "Altamarea", value: 3988 },
    { name: "Aro", value: 101 },
    { name: "Artega", value: 3105 },
    { name: "Asia", value: 4 },
    { name: "Aston Martin", value: 5 },
    { name: "Audi", value: 6 },
    { name: "Austin", value: 7 },
    { name: "Autobianchi", value: 102 }
    ...
]

Модели

Для перегляду актуальної документації перейдіть у розділ "Документація"

Модели зависят от типов транспорта и марок. Следовательно список марок можно получить по адресу http://api.auto.ria.com/categories/:categoryId/marks/:markId/models, где categoryId - идентификатор типа транспорта а markId - идентификатор марки.

Например, для мотоциклов BMW (http://api.auto.ria.com/categories/2/marks/9/models), список моделей будет следующим:

[
    { name: "Adventure", value: 25290 },
    { name: "C", value: 25291 },
    { name: "CS", value: 25292 },
    { name: "DKW", value: 28318 },
    { name: "F", value: 25293 },
    { name: "G", value: 29468 },
    { name: "GS", value: 25295 },
    { name: "HP", value: 38148 },
    { name: "Independent", value: 25297 },
    { name: "K", value: 25298 },
    { name: "LT", value: 25299 },
    { name: "R", value: 25300 },
    { name: "RS", value: 32736 },
    { name: "RT", value: 25301 },
    { name: "S", value: 25302 },
    { name: "X", value: 42030 }
]

Модели, также как и типы кузовов, могут быть сгруппированы. Чтобы получить такой список, необходимо отправить запрос по адресу http://api.auto.ria.com/categories/:categoryId/marks/:markId/models/_group, где categoryId - идентификатор типа транспорта а markId - идентификатор марки.

Например, для легковых автомобилей BMW (http://api.auto.ria.com/categories/1/marks/9/models/_group), список моделей будет следующим:

[
    [
        { name: "1 Series (все)", value: 2161 },
        { name: "116", value: 34670 },
        { name: "118", value: 34671 },
        { name: "120", value: 34672 },
        { name: "123", value: 34673 },
        { name: "125", value: 34674 },
        { name: "130", value: 34675 },
        { name: "135", value: 34676 }
    ],
    [
        { name: "3 Series (все)", value: 3219 },
        { name: "3 Series GT", value: 43029 },
        { name: "315", value: 37454 },
        { name: "316", value: 30851 },
        { name: "318", value: 31612 },
        { name: "320", value: 31611 },
        { name: "321", value: 37389 },
        { name: "323", value: 34677 },
        { name: "324", value: 30687 },
        { name: "325", value: 29713 },
        { name: "326", value: 44061 },
        { name: "328", value: 31661 },
        { name: "330", value: 34678 },
        { name: "335", value: 34679 },
        { name: "340", value: 35568 }
    ],
    ...
    { name: "Alpina", value: 906 },
    { name: "Dixi", value: 33383 },
    { name: "I3", value: 44838 },
    { name: "I8", value: 44537 },
    { name: "Isetta", value: 32380 },
    { name: "Z1", value: 97 },
    { name: "Z3", value: 98 },
    { name: "Z4", value: 99 },
    { name: "Z8", value: 100 }
]

Формат данных такой же как и в случае с типа кузова - коллекция объектов, в которой могут быть другие объекты. Группа моделей всегда начинается с её названия.

Также, при необходимости, можно просто получить список всех моделей, отправив GET запрос по адресу http://api.auto.ria.com/models.

Методы для работы с областями и городами

Для перегляду актуальної документації перейдіть у розділ "Документація"

Области

Получить список областей можно отправив GET запрос по адресу http://api.auto.ria.com/states.

Результат будет следующим:

[
    { name: "Винницкая", value: 1 },
    { name: "Волынская", value: 18 },
    { name: "Днепропетровская", value: 11 },
    { name: "Донецкая", value: 13 },
    { name: "Житомирская", value: 2 },
    { name: "Закарпатская", value: 22 },
    { name: "Запорожская", value: 14 },
    { name: "Ивано-Франковская", value: 15 },
    { name: "Киевская", value: 10 },
    { name: "Кировоградская", value: 16 },
    { name: "Луганская", value: 17 },
    { name: "Львовская", value: 5 },
    { name: "Николаевская", value: 19 },
    { name: "Одесская", value: 12 },
    { name: "Полтавская", value: 20 },
    { name: "Республика Крым", value: 21 },
    { name: "Ровенская", value: 9 },
    { name: "Сумская", value: 8 },
    { name: "Тернопольская", value: 3 },
    { name: "Харьковская", value: 7 },
    { name: "Херсонская", value: 23 },
    { name: "Хмельницкая", value: 4 },
    { name: "Черкасская", value: 24 },
    { name: "Черниговская", value: 6 },
    { name: "Черновицкая", value: 25 }
]

Города

Для перегляду актуальної документації перейдіть у розділ "Документація"

Города зависят от областей, поэтому, чтобы получить их список, необходимо послать GET запрос по адресу http://api.auto.ria.com/states/:stateId/cities, где stateId - идентификатор области.

Например, для Винницкой области (http://api.auto.ria.com/states/1/cities) список городов будет следующим:

[
    { name: "Винница", value: 1 },
    { name: "Жмеринка", value: 27 },
    { name: "Казатин", value: 30 },
    { name: "Крыжополь", value: 31 },
    { name: "Липовец", value: 32 },
    { name: "Литин", value: 33 },
    { name: "Могилев-Подольский", value: 34 },
    { name: "Мурованые Куриловцы", value: 35 },
    { name: "Немиров", value: 36 },
    { name: "Оратов", value: 37 },
    { name: "Песчанка", value: 38 },
    { name: "Погребище", value: 39 },
    { name: "Теплик", value: 40 },
    { name: "Тывров", value: 41 },
    { name: "Томашполь", value: 42 },
    { name: "Тростянец", value: 43 },
    { name: "Тульчин", value: 44 },
    { name: "Хмельник", value: 45 },
    { name: "Черновцы", value: 46 },
    { name: "Чечельник", value: 47 },
    { name: "Шаргород", value: 48 },
    { name: "Ямполь", value: 49 },
    { name: "Бар", value: 597 },
    { name: "Бершадь", value: 599 },
    { name: "Гайсин", value: 602 },
    { name: "Ильинцы", value: 603 },
    { name: "Калиновка", value: 604 },
    { name: "Гнивань", value: 609 },
    { name: "Ладыжин", value: 644 }
]

Методы для работы с техническими характеристиками

Для перегляду актуальної документації перейдіть у розділ "Документація"

Коробки передач

Коробки передач зависят от типа транспорта, поэтому, чтобы получить их список, необходимо послать GET запрос по адресу http://api.auto.ria.com/categories/:categoryId/gearboxes, где categoryId - идентификатор типа транспорта.

Например, список коробок передач для мотоциклов (http://api.auto.ria.com/categories/2/gearboxes) будет выглядеть следующим образом:

[
    { name: "Ручная / Механика", value: 1 },
    { name: "Автомат", value: 2 },
    { name: "Типтроник", value: 3 },
    { name: "Адаптивная", value: 4 },
    { name: "Вариатор", value: 5 }
]

Типы привода

Для перегляду актуальної документації перейдіть у розділ "Документація"

Типы привода также зависят от типа транспорта, поэтому, чтобы получить их список, необходимо плсать GET запрос по адресу http://api.auto.ria.com/categories/:categoryId/driverTypes, где categoryId - идентификатор типа транспорта.

Например, список типов привода для мотоциклов (http://api.auto.ria.com/categories/2/driverTypes) выглядит следующим образом:

[
    { name: "Кардан", value: 4 },
    { name: "Ремень", value: 5 },
    { name: "Цепь", value: 6 }
]

Типы топлива

Для перегляду актуальної документації перейдіть у розділ "Документація"

Типы топлива можно получить отправив GET запрос по адресу http://api.auto.ria.com/fuels. Ответ будет выглядеть так:

[
    { name: "Бензин", value: 1 },
    { name: "Дизель", value: 2 },
    { name: "Газ", value: 3 },
    { name: "Газ/бензин", value: 4 },
    { name: "Гибрид", value: 5 },
    { name: "Электро", value: 6 },
    { name: "Другое", value: 7 },
    { name: "Газ метан", value: 8 },
    { name: "Газ пропан-бутан", value: 9 }
]

Опции

Для перегляду актуальної документації перейдіть у розділ "Документація"

Опции зависят от типа транспорта. Получить их список можно отправив GET запрос по адресу http://api.auto.ria.com/categories/:categoryId/options, где categoryId - идентификатор типа транспорта.

Например, список опций для легковых автомобилей (http://api.auto.ria.com/categories/1/options) будет выглядеть примерно так:

[
    { name: "ABD", value: 354 },
    { name: "ABS", value: 217 },
    { name: "ESP", value: 459 },
    { name: "Галогенные фары", value: 463 },
    { name: "Замок на КПП", value: 481 },
    { name: "Иммобилайзер", value: 225 },
    { name: "Пневмоподвеска", value: 442 },
    { name: "Подушка безопасности (Airbag)", value: 211 },
    { name: "Серворуль", value: 485 },
    { name: "Сигнализация", value: 303 },
    ...
]

Цвета

Для перегляду актуальної документації перейдіть у розділ "Документація"

Получить список всех цветов можно, если отправить GET запрос по адресу http://api.auto.ria.com/colors. Результат будет седующим:

[
    { name: "Бежевый", value: 1 },
    { name: "Черный", value: 2 },
    { name: "Синий", value: 3 },
    { name: "Бронзовый", value: 4 },
    { name: "Коричневый", value: 5 },
    { name: "Золотой", value: 6 },
    { name: "Зеленый", value: 7 },
    { name: "Серый", value: 8 },
    { name: "Апельсин", value: 9 },
    { name: "Магнолии", value: 10 },
    { name: "Розовый", value: 11 },
    { name: "Фиолетовый", value: 12 },
    { name: "Красный", value: 13 },
    { name: "Серебряный", value: 14 },
    { name: "Белый", value: 15 },
    { name: "Желтый", value: 16 },
    { name: "Голубой", value: 17 },
    { name: "Вишнёвый", value: 18 },
    { name: "Сафари", value: 19 },
    { name: "Гранатовый", value: 20 },
    { name: "Асфальт", value: 21 }
]

Растаможка

Для перегляду актуальної документації перейдіть у розділ "Документація"

Параметр растаможки может принимать только два значения: 1 - нерастаможенный и 0 - растаможенный.

После ДТП

Для перегляду актуальної документації перейдіть у розділ "Документація"

Данный параметр принимает следующие значения: 1 - объявления после ДТП 0 - остальные объявления

Взято в кредит

Для перегляду актуальної документації перейдіть у розділ "Документація"

Данный параметр может принимать следующие значения: 1 - объявления взятые в кредит 0 - остальные объявления

Конфискат

Для перегляду актуальної документації перейдіть у розділ "Документація"

Данный параметр может принимать следующие значения: 1 - только конфискованные объявления 0 - только неконфискованные объявления

Не на ходу

Данный параметр может принимать следующие значения: 1 - только объявления не на ходу 0 - только объявления на ходу

About

Документация к REST API сайта AUTO.RIA.com

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published