Тип API: Фріміум
Повертає id оголошень та їх кількість згідно з заданими параметрами пошуку.
URL
GET https://developers.ria.com/auto/search?api_key=YOUR_API_KEY&PARAMETERS
або
curl -i -g -X GET "https://developers.ria.com/auto/search?api_key=YOUR_API_KEY&PARAMETERS"
де YOUR_API_KEY - персональний ключ доступу користувача, PARAMETERS - вхідні параметри пошуку. Задаються у вигляді послідовності пар
name=value, розділених амперсандом. Список параметрів вказано тут .
Примітка! За один запит максимальна кількість id оголошень (count), що відображаються на сторінці, дорівнює 100. Якщо результат пошуку перевищує це значення, до вхідних параметрів (PARAMETERS) можна додати page (порядковий номер сторінки видачі). Розрахунок сторінок починається з 0.
Для вилучення з відповіді видалених оголошень вказуйте параметр status_id=0
У відповіді ви можете отримувати перелік id нових автомобілів, що можуть підпадати під ваш запит. Для отримання оголошень лише вживаних авто ви можете використовувати додатковий параметр searchType=4
Для сортування оголошень можна використовувати параметр order_by=
| id | Опис |
|---|---|
| 2 | Від дешевих до дорогих |
| 3 | Від дорогих до дешевих |
| 7 | Дата додавання новіші |
| 8 | Дата додавання старіші |
| 12 | Пробіг, за спаданням |
| 13 | Пробіг, за зростанням |
| 5 | Рік випуску, новіші авто |
| 6 | Рік випуску, старіші авто |
Приклад
Легкові машини (category_id=1)
Кузов Седан,Універсал (bodystyle[0]=3&bodystyle[4]=2)
Японія (brandOrigin[0]=276)
Toyota (marka_id[0]=79)
Всі моделі (model_id[0]=0)
Рік випуску від 2010 до 2017р. (s_yers[0]=2010&po_yers[0]=2017)
Німеччина (brandOrigin[1]=392)
Volkswagen (marka_id[1]=84)
Всі моделі (model_id[1]=0)
Рік випуску від 2012 до 2016р. (s_yers[1]=2012&po_yers[1]=2016)
Ціна від 1000 до 60000 (price_ot=1000&price_do=60000)
Ціна вказана в доларах США (currency=1)
Можливий торг (auctionPossible=1)
Область
Вінницька - пошук по всіх містах цієї області (state[0]=1&city[0]=0)
Житомирська - пошук по всіх містах цієї області (state[1]=2&city[1]=0)
Київська - пошук по всіх містах цієї області (state[2]=10&city[2]=0)
Не відображати авто, які знаходяться не в Україні (abroad=2)
Не відображати нерозмитнені авто (custom=1)
Гаражне зберігання (auto_options[477]=477)
Паливо
Бензин (type[0]=1)
Дизель (type[1]=2)
Газ/бензин (type[3]=4)
Електро (type[5]:6)
КПП
Ручна / Механіка (gearbox[0]=1)
Автомат (gearbox[1]=2)
Типтронік (gearbox[2]=3)
Об“єм 1.4 - 3.2 л. (engineVolumeFrom=1.4&engineVolumeTo=3.2)
Потужність 90 - 250 (powerFrom=90&powerTo=250)
Одиниця виміру потужності - к.с. (power_name=1)
Тільки з фото (with_photo=1)
Зразок запиту
https://developers.ria.com/auto/search?api_key=YOUR_API_KEY&category_id=1&bodystyle[0]=3&bodystyle[4]=2&marka_id[0]=79&model_id[0]=0&s_yers[0]=2010&po_yers[0]=2017&marka_id[1]=84&model_id[1]=0&s_yers[1]=2012&po_yers[1]=2016&brandOrigin[0]=276&brandOrigin[1]=392&price_ot=1000&price_do=60000¤cy=1&auctionPossible=1&state[0]=1&city[0]=0&state[1]=2&city[1]=0&state[2]=10&city[2]=0&abroad=2&custom=1&auto_options[477]=477&type[0]=1&type[1]=2&type[3]=4&type[7]=8&gearbox[0]=1&gearbox[1]=2&gearbox[2]=3&engineVolumeFrom=1.4&engineVolumeTo=3.2&powerFrom=90&powerTo=250&power_name=1&countpage=50&with_photo=1
Зразок відповіді
{
"additional_params": {
"lang_id": 2,
"page": 0,
"view_type_id": 0,
"target": "search",
"section": "auto",
"catalog_name": "",
"elastica": true,
"nodejs": true,
"searchByTypeAction": true
},
"result": {
"search_result": {
"ids": [
"35438716",
"34903251",
"35415727",
"35451941",
"35193553",
"35338976",
"34884211",
"35429711",
"35444022",
"34351091",
"35459699",
"35456447",
"35450063",
"35449871",
"35447518",
"35441667",
"35402932",
"35462098",
"35379131",
"34824088",
"34830514",
"35280443",
"34710151",
"35458153",
"34212167",
"34723106",
"34905342",
"35455343",
"35358987",
"34202802",
"34874515",
"33800336",
"35443811",
"35263874",
"35442283",
"35437435",
"35437154",
"35071240",
"34350382",
"34880512",
"34527571",
"34878130",
"33859129",
"34844924",
"34503955",
"34872220",
"33780112",
"34871213",
"34687196",
"35415463"
],
"count": 116,
"last_id": 0
},
"search_result_common": {
"count": 116,
"last_id": 0,
"data": [
{
"id": "35438716",
"type": "UsedAuto"
},
{
"id": "34903251",
"type": "UsedAuto"
},
{
"id": "100500",
"type": "OfferOfTheDay"
},
{
"id": "35415727",
"type": "UsedAuto"
},
{
"id": "35451941",
"type": "UsedAuto"
},
{
"id": "35193553",
"type": "UsedAuto"
},
{
"id": "35338976",
"type": "UsedAuto"
},
{
"id": "34884211",
"type": "UsedAuto"
},
{
"id": "35429711",
"type": "UsedAuto"
},
{
"id": "35444022",
"type": "UsedAuto"
},
{
"id": "34351091",
"type": "UsedAuto"
},
{
"id": "35459699",
"type": "UsedAuto"
},
{
"id": "35456447",
"type": "UsedAuto"
},
{
"id": "35450063",
"type": "UsedAuto"
},
{
"id": "35449871",
"type": "UsedAuto"
},
{
"id": "35447518",
"type": "UsedAuto"
},
{
"id": "35441667",
"type": "UsedAuto"
},
{
"id": "35402932",
"type": "UsedAuto"
},
{
"id": "35462098",
"type": "UsedAuto"
},
{
"id": "35379131",
"type": "UsedAuto"
},
{
"id": "34824088",
"type": "UsedAuto"
},
{
"id": "34830514",
"type": "UsedAuto"
},
{
"id": "35280443",
"type": "UsedAuto"
},
{
"id": "34710151",
"type": "UsedAuto"
},
{
"id": "35458153",
"type": "UsedAuto"
},
{
"id": "34212167",
"type": "UsedAuto"
},
{
"id": "34723106",
"type": "UsedAuto"
},
{
"id": "34905342",
"type": "UsedAuto"
},
{
"id": "35455343",
"type": "UsedAuto"
},
{
"id": "35358987",
"type": "UsedAuto"
},
{
"id": "34202802",
"type": "UsedAuto"
},
{
"id": "34874515",
"type": "UsedAuto"
},
{
"id": "33800336",
"type": "UsedAuto"
},
{
"id": "35443811",
"type": "UsedAuto"
},
{
"id": "35263874",
"type": "UsedAuto"
},
{
"id": "35442283",
"type": "UsedAuto"
},
{
"id": "35437435",
"type": "UsedAuto"
},
{
"id": "35437154",
"type": "UsedAuto"
},
{
"id": "35071240",
"type": "UsedAuto"
},
{
"id": "34350382",
"type": "UsedAuto"
},
{
"id": "34880512",
"type": "UsedAuto"
},
{
"id": "34527571",
"type": "UsedAuto"
},
{
"id": "34878130",
"type": "UsedAuto"
},
{
"id": "33859129",
"type": "UsedAuto"
},
{
"id": "34844924",
"type": "UsedAuto"
},
{
"id": "34503955",
"type": "UsedAuto"
},
{
"id": "34872220",
"type": "UsedAuto"
},
{
"id": "33780112",
"type": "UsedAuto"
},
{
"id": "34871213",
"type": "UsedAuto"
},
{
"id": "34687196",
"type": "UsedAuto"
},
{
"id": "35415463",
"type": "UsedAuto"
}
]
},
"active_marka": {
"lang_id": 2,
"marka_id": 79,
"name": "Toyota",
"set_cat": "1,3,4,6,7,8",
"main_category": 1,
"active": 1,
"country_id": 392,
"eng": "toyota",
"count": 8986,
"fit": 0,
"count_newauto": 5265
},
"active_model": null,
"active_state": null,
"active_city": null,
"revies": null,
"isCommonSearch": true,
"additional": {
"user_auto_positions": [ ],
"search_params": {
"all": {
"category_id": 1,
"bodystyle": [
3,
2
],
"marka_id": [
79,
84
],
"model_id": [
null,
null
],
"s_yers": [
2010,
2012
],
"po_yers": [
2017,
2016
],
"price_ot": 1000,
"price_do": 60000,
"currency": "1",
"auctionPossible": "1",
"state": [
1,
2,
10
],
"city": [ ],
"abroad": false,
"custom": 0,
"auto_options": [
477
],
"type": [
"1",
"2",
null,
"4",
null,
null,
null,
"8"
],
"engineVolumeFrom": 1.4,
"engineVolumeTo": 3.2,
"powerFrom": "90",
"powerTo": "250",
"power_name": "1",
"countpage": 50,
"with_photo": "1",
"searchType": 6,
"target": "search",
"event": "little",
"lang_id": 2,
"page": 0,
"limit_page": null,
"last_id": 0,
"saledParam": 0,
"mm_marka_filtr": [ ],
"mm_model_filtr": [ ],
"useOrigAutoTable": false,
"withoutStatus": false,
"with_video": false,
"under_credit": 0,
"confiscated_car": 0,
"exchange_filter": [ ],
"old_only": false,
"user_id": [ ],
"person_id": 0,
"with_discount": false,
"auto_id_str": "",
"black_user_id": 0,
"order_by": 0,
"is_online": false,
"withoutCache": false,
"with_last_id": false,
"top": 0,
"currency_id": 0,
"currencies_arr": [ ],
"hide_black_list": [ ],
"damage": 0,
"star_auto": 0,
"year": 0,
"auto_ids_search_position": 0,
"print_qs": 0,
"is_hot": 0,
"deletedAutoSearch": 0,
"can_be_checked": 0,
"excludeMM": [
0,
0
],
"generation_id": [
null,
null
],
"modification_id": [
null,
null
],
"gear_id": [
1,
2,
3
],
"fuel_id": [
1,
2,
4,
8
],
"country": [
276,
392
]
},
"cleaned": {
"category_id": 1,
"bodystyle": [
3,
2
],
"marka_id": [
79,
84
],
"model_id": [
null,
null
],
"s_yers": [
2010,
2012
],
"po_yers": [
2017,
2016
],
"price_ot": 1000,
"price_do": 60000,
"currency": "1",
"auctionPossible": "1",
"state": [
1,
2,
10
],
"city": [ ],
"auto_options": [
477
],
"type": [
"1",
"2",
null,
"4",
null,
null,
null,
"8"
],
"engineVolumeFrom": 1.4,
"engineVolumeTo": 3.2,
"powerFrom": "90",
"powerTo": "250",
"power_name": "1",
"countpage": 50,
"with_photo": "1",
"searchType": 6,
"target": "search",
"event": "little",
"lang_id": 2,
"mm_marka_filtr": [ ],
"mm_model_filtr": [ ],
"exchange_filter": [ ],
"user_id": [ ],
"currencies_arr": [ ],
"hide_black_list": [ ],
"excludeMM": [
0,
0
],
"generation_id": [
null,
null
],
"modification_id": [
null,
null
],
"gear_id": [
1,
2,
3
],
"fuel_id": [
1,
2,
4,
8
],
"country": [
276,
392
]
}
},
"query_string": "category_id=1&bodystyle[0]=3&bodystyle[4]=2&marka_id[0]=79&model_id[0]=0&s_yers[0]=2010&po_yers[0]=2017&marka_id[1]=84&model_id[1]=0&s_yers[1]=2012&po_yers[1]=2016&brandOrigin[0]=276&brandOrigin[1]=392&price_ot=1000&price_do=60000¤cy=1&auctionPossible=1&state[0]=1&city[0]=0&state[1]=2&city[1]=0&state[2]=10&city[2]=0&abroad=2&custom=1&auto_options[477]=477&type[0]=1&type[1]=2&type[3]=4&type[7]=8&gearbox[0]=1&gearbox[1]=2&gearbox[2]=3&engineVolumeFrom=1.4&engineVolumeTo=3.2&powerFrom=90&powerTo=250&power_name=1&countpage=50&with_photo=1"
}
}
}
Параметри відповіді
| Параметер | Опис | Тип |
|---|---|---|
| additional_params | Об'єкт даних по додатковим параметрам | |
| - lang_id | Ідентифікатор мови | integer |
| - page | Порядковий номер сторінки | integer |
| - view_type_id | Ідентифікатор | integer |
| - target | string | |
| - section | string | |
| - catalog_name | Назва каталогу | string |
| - elastica | boolean | |
| - nodejs | boolean | |
| result | Об'єкт даних по результату цільової дії | |
| - search_result | Об'єкт даних по результату пошуку | |
| - - ids | Ідентифікатори оголошень | array of integer |
| - - count | Кількість оголошень, що відповідають заданим параметрам | integer |
| - - last_id | integer | |
| - search_result_common | Об'єкт загальних даних по результату пошуку | |
| - - count | Кількість оголошень, що відповідають заданим параметрам | integer |
| - - last_id | integer | |
| - - data | Масив даних | |
| - - - id | Ідентифікатор оголошення | string |
| - - - type | Тип пропозиції | string |
| - - data | Масив даних | |
| - active_marka | Об'єкт даних | |
| - - lang_id | Ідентифікатор мови | integer |
| - - marka_id | Ідентифікатор марки | integer |
| - - name | Назва марки | string |
| - - set_cat | string | |
| - - main_category | integer | |
| - - active | integer | |
| - - country_id | Ідентифікатор країни виробника | integer |
| - - eng | Сленгова назва марки авто (латиниця) | string |
| - - count | integer | |
| - - fit | integer | |
| - active_model | ||
| - active_state | ||
| - active_city | ||
| - revies | ||
| - isCommonSearch | boolean | |
| - additional | Об'єкт даних | |
| - - user_auto_positions | array | |
| - - search_params | Об'єкт даних | |
| - - - all | Об'єкт даних | |
| - - - - categori_id | Ідентифікатор типу транспорту | integer |
| - - - - bodystyle | Тип кузову | Array of integer |
| - - - - marka_id | Ідентифікатор марки | Array of integer |
| - - - - model_id | Ідентифікатор моделі | Array of integer |
| - - - - s_yers | Початкове значення року випуску авто | Array of integer |
| - - - - po_yers | Кінцеве значення року випуску авто | Array of integer |
| - - - - price_ot | Початкове значення ціни авто | string |
| - - - - price_do | Кінцеве значення ціни авто | string |
| - - - - currency | Валюта | string |
| - - - - auctionPossible | Можливий торг | string |
| - - - - state | Область продажу авто | Array of integer |
| - - - - city | Місто продажу авто | Array of integer |
| - - - - abroad | Авто не в Україні | boolean |
| - - - - custom | Нерозмитнене | integer |
| - - - - auto_options | Опції авто | Array of integer |
| - - - - type | Array of string | |
| - - - - engineVolumeFrom | Початкове значення об'єму двигуна | float |
| - - - - engineVolumeTo | Кінцеве значення об'єму двигуна | float |
| - - - - powerFrom | Початкове значення потужності двигуна | string |
| - - - - powerTo | Кінцеве значення потужності двигуна | string |
| - - - - power_name | Одиниці вимірювання потужності двигуна | string |
| - - - - countPage | integer | |
| - - - - with_photo | З фото | string |
| - - - - searchType | Тип пошуку | integer |
| - - - - target | string | |
| - - - - event | string | |
| - - - - lang_id | Ідентифікатор мови | integer |
| - - - - page | Номер сторінки пошукової видачі | integer |
| - - - - limit_page | integer | |
| - - - - last_id | integer | |
| - - - - saledParam | integer | |
| - - - - mm_marka_filtr | Array | |
| - - - - mm_model_filtr | Array | |
| - - - - useOrigAutoTable | boolean | |
| - - - - withoutStatus | boolean | |
| - - - - with_video | boolean | |
| - - - - under_credit | integer | |
| - - - - confiscated_car | integer | |
| - - - - exchange_filter | array | |
| - - - - old_only | boolean | |
| - - - - user_id | Ідентифікатор користувача | Array of integer |
| - - - - person_id | integer | |
| - - - - with_discount | boolean | |
| - - - - auto_id_str | string | |
| - - - - black_user_id | integer | |
| - - - - order_by | integer | |
| - - - - is_online | boolean | |
| - - - - withoutCache | boolean | |
| - - - - with_last_id | boolean | |
| - - - - top | integer | |
| - - - - currency_id | integer | |
| - - - - currencies_arr | Array of integer | |
| - - - - hide_black_list | Array | |
| - - - - damage | Участь в ДТП | integer |
| - - - - star_auto | integer | |
| - - - - year | Рік випуску | integer |
| - - - - auto_ids_search_position | integer | |
| - - - - print_qs | integer | |
| - - - - is_hot | Гаряча пропозиція | integer |
| - - - - deletedAutoSearch | integer | |
| - - - - can_be_checked | integer | |
| - - - - excludeMM | Array of integer | |
| - - - - generation_id | Ідентифікатор покоління | Array of integer |
| - - - - modification_id | Ідентифікатор модифікації | Array of integer |
| - - - - gear_id | Ідентифікатор коробки передач | Array of integer |
| - - - - fuel_id | Ідентифікатор типу палива | Array of integer |
| - - - - country | Ідентифікатор країни | Array of integer |
| - - - cleaned | Об'єкт даних | |
| - - - - category_id | Ідентифікатор типу транспорту | integer |
| - - - - bodystyle | Ідентифікатор типу кузову | Array of integer |
| - - - - marka_id | Ідентифікатор марки авто | Array of integer |
| - - - - model_id | Ідентифікатор моделі авто | Array of integer |
| - - - - s_yers | Початкове значення року випуску авто | Array of integer |
| - - - - po_yers | Кінцеве значення року випуску авто | Array of integer |
| - - - - price_ot | Початкове значення вартості авто | string |
| - - - - price_do | Кінцеве значення вартості авто | string |
| - - - - currency | Валюта | string |
| - - - - auctionPossible | Можливий торг | string |
| - - - - state | Область продажу авто | Array of integer |
| - - - - city | Місто продажу авто | Array of integer |
| - - - - auto_options | Опції | Array of integer |
| - - - - type | Array of string | |
| - - - - engineVolumeFrom | Початкове значення об'єму двигуна | float |
| - - - - engineVolumeTo | Кінцеве значення об'єму двигуна | float |
| - - - - powerFrom | Початкове значення потужності двигуна | string |
| - - - - powerTo | Кінцеве значення потужності двигуна | string |
| - - - - power_name | Одиниці вимірювання потужності двигуна | string |
| - - - - countPage | integer | |
| - - - - with_photo | З фото | string |
| - - - - searchType | Тип пошуку | integer |
| - - - - target | string | |
| - - - - event | string | |
| - - - - lang_id | Ідентифікатор мови | integer |
| - - - - mm_marka_filtr | Array | |
| - - - - mm_model_filtr | Array | |
| - - - - exchange_filter | array | |
| - - - - user_id | Ідентифікатор користувача | Array of integer |
| - - - - currencies_arr | Array of integer | |
| - - - - hide_black_list | Array | |
| - - - - excludeMM | Array of integer | |
| - - - - generation_id | Ідентифікатор покоління | Array of integer |
| - - - - modification_id | Ідентифікатор модифікації | Array of integer |
| - - - - gear_id | Ідентифікатор коробки передач | Array of integer |
| - - - - fuel_id | Ідентифікатор типу палива | Array of integer |
| - - - - country | Ідентифікатор країни | Array of integer |
| - - query_string | Запит | string |
В таблиці наведено перелік параметрів пошуку у відповідному API, їх тип та короткий опис.
| Element | Type | Description | Notes |
|---|---|---|---|
| category_id | int | Тип транспорту | |
| excludeMM | int[] | Флаг виключення для набору марка-модель-рік-покоління-модифікація |
|
| marka, marka_id, mm_marka | int[] | Марка | |
| model, model_id, mm_model | int, int[] | Модель | |
| generations | int[][] | Покоління | |
| modifications | int[][][] | Модифікація | |
| s_yers – po_yers, mm_s_yers – mm_po_yers |
int[] | Рік випуску | |
| bodystyle, body_id, bodyStyleId | int[] | Кузов | |
| gear_id, gearbox | int[] | Коробка передач | |
| drive_id, drive_type | int | Привід | |
| axle, axleId | int[] | Осі | |
| wheel_formula, wheelFormulaId | int[] | Колісна формула |
Містить попередні 2 |
| fuel_id, type | int[] | Тип палива | |
| fuelRateFrom – fuelRateTo & fuelRatesType | int & string | Витрати пального | |
| engineVolumeFrom – engineVolumeTo | string(float) | Об'єм двигуна | |
| powerFrom – powerTo | int | Потужність двигуна | |
| power_name | int | Одиниці вимірювання потужності двигуна | |
| published_before, published_after | Сортування по даті публікації оголошень | published_after=2024-09-05T00:00:00Z | |
| created_before, created_after | Стортування по даті створення оголошень | created_before=22024-09-05T00:00:00Z | |
| accumulatorCapacityFrom – accumulatorCapacityTo | int | Ємність акумулятора | |
| carrying, carryingFrom - carryingTo | int | Вантажопідйомність | |
| raceInt, raceFrom - raceTo | int | Пробіг | |
| door, doorsFrom - doorsTo | int | Кількість дверей | |
| seats, seatsFrom – seatsTo | int | Кількість сидінь | |
| price, priceMain, priceFrom – priceTo | int | Вартість | |
| currency | int | Валюта вартості | |
| vat | int | ПДВ | |
| installment | int | Розстрочка | |
| for_zsu_cheaper | int | Для ЗСУ дешевше | |
| under_credit | int | Під кредитом | |
| confiscated_car | int | У конфіскації | |
| auto_options | int[] | Додаткові опції | |
| color_id | int[] | Кольори | |
| metallics | int | Модифікація кольору - металік | |
| auto_repairs | int | На запчастини | (technicalCondition) |
| damage | int | Пошкоджені , 1-не був у ДТП, 2- Був у ДТП | (technicalCondition) |
| technicalCondition | int[] | Технічний стан авто | |
| paintCondition | int[] | Стан лако-фарбового покриття | |
| state, state_id, m_state | int[] | Область | |
| city, city_id, m_city | int[] | Місто | |
| plateNumber.length.gte | int (0/не 0) | Флаг наявності держ.номеру | |
| VIN | string[] | Пошук по VIN | |
| withVIN | int | Тільки з VIN | |
| withoutVIN | int | Тільки без VIN | |
| verified | int | Перевірка по VIN | |
| with_autotest_tech_check | int | Наявність замовлення тех.перевірки | |
| with_autotest_vin_check | int | Наявність замовлення перевірки по VIN | |
| with_autotest_vin_report | int | Наявність звіту перевірки по VIN | |
| autotest_vin_check_type | int[] | Тип перевірки по VIN | |
| company_id | int[] | Компанія-продавець | |
| company_type | int[] | Тип компанії-продавця | |
| abroad | int | Чи знаходиться закордоном | |
| custom | int | Необхідність розмитнення | |
| driven_from | int | Шукати авто, пригнані з країни Х | |
| was_not_driven_from | int | Виключити авто, пригнані з країни Х | |
| excludeUSA | int | Дубль двох попередніх, 1 - не завезений з США, 2- Завезений з США | |
| country, mm_country | int[] | Авто, зроблені в Х | |
| country_exception, country_exeption, Mm_country_exeption | int[] | Виключити авто, зроблені в Х | |
| brandOrigin & originExclude | int[] & int | Дубль двох попередніх | |
| status_id | int[] | Статус оголошення (активне, продане, аукціон…) | |
| auctions | int | Дубль попереднього (status 22) | |
| withTop | int | level > 0 | |
| level | int | Рівень ТОП | |
| freePublication | string(true/false) | Наявність безкоштовної публікації | |
| saledParam | int | Наявність поля saled_date | |
| user_id | int[] | Авто, що належать користувачеві Х | |
| person_id & hide_black_list | int & int | Виключити авто, що належать користувачеві Х | |
| person_id & black_user_id | Int & (int / “all”) | Використати список заблокованих для конкретного користувача | Застарів? |
| auto_ids | int[] | Видати оголошення з вказаними id | |
| auto_id_str | string | Видати оголошення з вказаними id, але одним рядковим параметром, через кому | Видалити? |
| exclude_auto_ids | int[] | Виключити по id | Видалити? |
| omni_id | string | Текстове поле | Водиться або VIN-код, або держ.номер, або id авто у базі. Треба інтуітивно здогадатися, що малось на увазі. |
| lid, last_search_id | int | Видати список з id не більше ніж Х | Видалити? |
| sid, last_send_id, last_auto_id | int | Видати список з id не менше ніж Х | Видалити? |
| with_exchange | int | Авто з наявністю обміну | |
| with_real_exchange | int | Авто з наявністю обміну на нерухомість | Застарів? |
| exchangeTypeIds | int[] | Типи обміну | |
| exchange_filter | об'єкт | category_id, sub_category_id, marka_id, model_id | |
| top | int | Опубліковані за останню годину/день/тиждень | |
| start_date | string | Авто, опубліковані (переопубліковані), починаючи з Х | |
| end_date | string | Авто, опубліковані (переопубліковані), закінчуючи Х | |
| after_date | string | Авто, опубліковані (переопубліковані) після Х (не враховуючи Х) | Видалити? |
| before_date | string | Авто, опубліковані (переопубліковані) до Х (не враховуючи Х) | Видалити? |
| with_photo | int | З фото | |
| with_video | int | З відео | |
| video_messages | int | З відеповідомленнями | |
| is_hot | int | Горяча пропозиція | Не використовується? |
| searchType | int | Тип пошуку | |
| page | int | Номер сторінки видачі | |
| countpage | int | Кількість елементів на сторінці | |
| order_by | int | Тип сортування | |
| class | int | Клас | |
| purpose | int | Призначення | Функціонал, що дублюється? |
| headlights_id | int | Тип фар | |
| interior_materials_id | int | Матеріали оздоблення | |
| interior_colors_id | int | Кольора оздоблення | |
| seat_adjustment_id | int | Налаштування сидінь | |
| seat_ventilation_id | int | Вентиляція сидінь | |
| seats_heated_id | int | Подогрів сидінь | |
| memory_seat_module_id | int | Пам'ять сидінь | |
| window_lifter_id | int | Склопідйомник | |
| conditioner_id | int | Кондиціонер | |
| power_steering_id | int | Підсилення керма | |
| steering_wheel_adjustment_id | int | Регулювання керма | |
| spare_wheel_id | int | Запасне колесо |
Версія API пошуку V2 - це фактично обгортка над V1. В версії V2 просто переіменовані назви полей (проєкт конвертувальника з V1 -> V2 та назад з V2->V1).
В таблиці наведено перелік параметрів пошуку у відповідному API, їх тип та короткий опис.
| Element | Type | Description |
|---|---|---|
| id | array of string | Ідентифікатор оголошення |
| status | array of integer | Статус оголошення |
| numberplate | array of string | Держ.номер |
| has_numberplate | boolean | Наявність держ.номеру |
| VIN | array of string | Пошук по VIN-коду |
| has_VIN | boolean | Наявність VIN-коду |
| smart_id | array of string | Текстове поле. Водиться або VIN-код, або держ.номер, або id авто у базі. Треба інтуітивно здогадатися, що малось на увазі. |
| category | array of integer | Тип транспорту |
| brand | array of integer | Марка авто |
| brand_origin | array of integer | Країна походження марки авто |
| model | array of integer | Модель авто |
| generation | array of integer | Покоління |
| modification | array of integer | Модифікація |
| year | tuple of integer | Рік випуску авто |
| bodystyle | array of integer | Тип кузову |
| gearbox | array of integer | Коробка передач |
| fuel | array of integer | Тип палива |
| engine_volume | array of integer | Об'єм двигуна |
| options | array of integer | Опції |
| has_photos | boolean | Оголошення з фото |
| paint_condition | array of integer | Стан лако-фарбового покриття |
| technical_condition | array of integer | Технічний стан авто |
| mileage | tuple of integer | Пробіг |
| abroad | boolean | Чи знаходиться закордоном |
| customs_cleared | boolean | Мітка, що авто розмитнено |
| state | array of integer | Область продажу авто |
| city | array of integer | Місто продажу авто |
| owner | array of integer | Власник |
| is_commercial | boolean | |
| is_proaccount | boolean | Є проакаунтом |
| company | array of integer | Компанія-продавець |
| company_type | array of integer | Тип компанії-продавця |
| price | tuple of integer | Вартість авто |
| has_level | array of integer | Має рівень ТОП |
| cheaper_for_zsu | boolean | Для ЗСУ дешевше |
| skip | boolean | Технологічний ключ, який використовується для відладки ( ігнорувати фільтри поточного блоку) |