Тип API: Фріміум
Даний API не підтримується. Та найближчим часом буде закрито можливість ним користуватись
Формат даних у запиті
Усі параметри, описані в таблиці підтримуваних параметрів, мають передаватися у вигляді чисел. Винятками є тільки параметри - рік випуску. пробіг, опції та коробка передач.
Якщо передати масив у параметрі коробка передач, то це буде інтерпретуватися як пошук коробок передач із логічним оператором АБО
https://developers.ria.com/auto/average_price?api_key=YOUR_API_KEY&marka_id=9&model_id=31612&gear_id=1&gear_id=2
вибере для підрахунку всі BMW 318 з автоматичними та ручними коробками передач. Аналогічно і з параметром тип палива вибере для підрахунку всі BMW 520 2014 року з дизельними та бензиновими двигунами.
https://developers.ria.com/auto/average_price?api_key=YOUR_API_KEY&marka_id=9&model_id=31887&yers=2014&fuel_id[0]=1&fuel_id[1]=2
Якщо передати масив у параметрі рік випуску або пробіг це буде інтерпретуватися як діапазон значень та буде обрано для підрахунку середньої ціни всі оголошення з пробігом від 10 до 100 тис. км.
Наприклад,
https://developers.ria.com/auto/average_price?api_key=YOUR_API_KEY&raceInt=10&raceInt=100
Якщо передати масив значень у параметрі опції, то це буде інтерпретуватися як пошук опцій із логічним оператором «І». Тобто буде обрано для підрахунку всі оголошення, у яких є опція ABS І галогенні фари.
https://developers.ria.com/auto/average_price?api_key=YOUR_API_KEY&options=217&options=463
Приклади:
Середня ціна по BMW X5 з пробігом від 10 до 100 тис. км
https://developers.ria.com/auto/average_price?api_key=YOUR_API_KEY&marka_id=9&model_id=96&raceInt=10&raceInt=100.
Середня ціна для Honda Accord у Києві
https://developers.ria.com/auto/average_price?api_key=YOUR_API_KEY&marka_id=28&model_id=262&city_id=9
Приклад успішної відповіді:
{
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
]
}
| Назва | Параметрb | Тип даних |
|---|---|---|
| Тип транспорта | 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 |
Параметри відповіді:
| Параметр | Опис |
|---|---|
| total | Загальна кількість оголошень, що беруть участь у підрахунку |
| arithmeticMean | Середнє арифметичне |
| interQuartileMean | Середнє арифметичне зі значень, що знаходяться між першим і четвертим квантилем. Умовно кажучи, це середнє арифметичне без урахування 25% найменших і найбільших значень |
| percentiles | Значення процентилів. Тобто для цього прикладу 25% усіх оголошень мають ціну нижче $3500 |
| prices | список цін, які брали участь у підрахунку середньої ціни. Розмір обмежений 1000 елементів |
| classifieds | ідентифікатори оголошень, до яких належать ціни відповідно. Розмір обмежений 1000 елементів. Записи в поля «classifields» та «prices» йдуть в однаковому порядку. |
Формат даних у відповіді
У разі успішного підрахунку середньої ціни за вказаними параметрами результат буде зі статусом 200 OK.
Якщо з якихось причин не вдалося підрахувати середню ціну, відповідь матиме статус 400 (Bad Request), а тіло відповіді міститиме наступне:
{ "message": "Not Enough Data" }