Тип API: Фріміум
Метод запиту: GET
Завдяки даному API ви можете здійснити пошук по оголошенням, що розміщені на AGRO.RIA та знайти потрібну вам агротехніку
Приклад запиту
curl -X GET 'https://developers.ria.com/agro_ria/agro_search/?api_key=API_KEY¤cyId=3&marka_id=1583&model_id=68389&tag_id=1'
curl -X GET 'https://developers.ria.com/agro_ria/agro_search/?api_key=API_KEY'
Перелік параметрів запиту
Параметр | Опис |
---|---|
API_KEY | ваш API ключ |
marka_id | марка |
model_id | модель |
state_id | область |
tag_id | тип пранспорту |
yearFrom | рік від |
yearTo | рік до |
city_id | місто |
currencyId | валюта: 1 - долар, 2 - євро, 3 - грн |
options | опції |
options[4]=2 | тип палива (2 - дизель) де взяти перелік опцій? |
optionsFrom[3]=1 | Максимальна потужність, к.с. від |
optionsTo[3]=3 | Максимальна потужність, к.с. до |
options[14]=16 | колісна формула (4*4 = 16) |
optionsFrom[172]=1 | Напрацювання, мтг від |
optionsTo[172]=1 | Напрацювання, мтг до |
in_stock=2 | зза кордону , 2 закордон? |
optionsFrom[45]=1 | Об'єм зернового бункера, л від |
optionsTo[45]=3 | Об'єм зернового бункера, л до |
optionsFrom[61]=1 | Максимальна ширина скошення, м від |
optionsTo[61]=2 | Максимальна ширина скошення, м до |
optionsFrom[189]=1 | Ширина жниварки, м від |
optionsTo[189]=3 | Ширина жниварки, м до |
sub_tag_ids=242 | за призначенням |
sub_tag_ids=235 | спосіб кріплення |
Приклад відповіді
{
"is_compensation_marka": 0,
"currency_id": 1,
"order_data": {
"auction_link": null,
"country_i18n": {
"2": {
"genitive": null,
"locative": null,
"name": null
},
"4": {
"genitive": null,
"locative": null,
"name": null
}
},
"country_id": null,
"is_auction": null,
"period": null
},
"vat": 0,
"has_payment_in_installments": 0,
"description_i18n": {
"2": "\u003Cp\u003EПродам трактор в ИДЕАЛЬНОМ состоянии. \u003C/p\u003E",
"4": "\u003Cp\u003EПродам трактор в ІДЕАЛЬНОМУ стані. \u003C/p\u003E"
},
"year": 2019,
"origin": 1,
"city_eng": "priluki",
"top_date_close": "2024-11-03T07:46:07",
"marka_eng": "mtz",
"created_at_formatted": {
"2": "27 октября 2024",
"4": "27 жовтня 2024"
},
"option_ids": [1, 3, 4, 5, 6, 9, 10, 11, 12, 13, 14, 15, 16, 18, 20, 22, 23, 26, 27, 29, 30, 34, 37, 172, 174, 175],
"level": 16,
"main_photo_id": 396490,
"vin": "Y4R900Z04K1130821",
"city": "Прилуки",
"marka": "МТЗ",
"video": null,
"publication": {
"adv_id": 350025212,
"autorepublication": 1,
"expire_date": "2024-11-26",
"publication_date": "2024-10-27",
"publication_date_formatted": "27.10.2024",
"user_id": 6031697
},
"model_slang": "892 Білорусь",
"seller_id": 6031697,
"in_stock": 1,
"deleted_at": null,
"model_id": 28746,
"price_uah": 768675,
"free_shipping": 1,
"link": "https://agro.ria.com/sell-traktor-mtz-892-belarus-350025212.html",
"updated_at": "2024-10-27T07:30:42",
"marka_id": 1584,
"price_usd": 18500,
"mileage": null,
"state_eng": "chernigiv",
"main_video_id": null,
"settlement_name_i18n": {
"2": null,
"4": null
},
"sub_tags": [
{
"eng": "kolisne",
"id": 230,
"name_i18n": {
"2": "Колесный",
"4": "Колісний"
},
"sub_tag_category_id": 3
},
{
"eng": "z-kabinoyu",
"id": 337,
"name_i18n": {
"2": "С кабиной",
"4": "З кабіною"
},
"sub_tag_category_id": 16
}
],
"videos": [],
"model": "892 Білорус",
"photos": [
{
"src": "https://cdn.riastatic.com/photosnewr/agro/goods/mtz-892-belarus__396490-1030x579x90.webp",
"prio": 0,
"is_main": 1,
"photo_id": 396490
},
{
"src": "https://cdn.riastatic.com/photosnewr/agro/goods/mtz-892-belarus__396488-1030x579x90.webp",
"prio": 1,
"is_main": 0,
"photo_id": 396488
},
{
"src": "https://cdn.riastatic.com/photosnewr/agro/goods/mtz-892-belarus__396491-1030x579x90.webp",
"prio": 2,
"is_main": 0,
"photo_id": 396491
},
{
"src": "https://cdn.riastatic.com/photosnewr/agro/goods/mtz-892-belarus__396489-1030x579x90.webp",
"prio": 3,
"is_main": 0,
"photo_id": 396489
},
{
"src": "https://cdn.riastatic.com/photosnewr/agro/goods/mtz-892-belarus__396492-1030x579x90.webp",
"prio": 4,
"is_main": 0,
"photo_id": 396492
},
{
"src": "https://cdn.riastatic.com/photosnewr/agro/goods/mtz-892-belarus__396487-1030x579x90.webp",
"prio": 5,
"is_main": 0,
"photo_id": 396487
},
{
"src": "https://cdn.riastatic.com/photosnewr/agro/goods/mtz-892-belarus__396493-1030x579x90.webp",
"prio": 6,
"is_main": 0,
"photo_id": 396493
}
],
"photos_cnt": 7,
"price_eur": 17044,
"labels": [
{
"2": "Бесплатная доставка",
"4": "Безкоштовна доставка",
"type": "free_shipping"
}
],
"has_leasing": 0,
"tech_condition_id": "20",
"model_eng": "892-belarus",
"has_photos": 1,
"country_id": 112,
"days_top": 6,
"state": "Чернігівська",
"options": {
"1": [
{
"basic": 0,
"option_id": 1,
"option_name_i18n": {
"2": "Объем двигателя, см3",
"4": "Об'єм двигуна, см3"
},
"options_category_id": 1,
"options_category_name_i18n": {
"2": "Двигатель",
"4": "Двигун"
},
"prio": 1,
"type": 2,
"value": 4750,
"value_int": 4750,
"values": []
}
],
"3": [
{
"basic": 1,
"option_id": 3,
"option_name_i18n": {
"2": "Максимальная мощность, л.с.",
"4": "Максимальна потужність, к.с."
},
"options_category_id": 1,
"options_category_name_i18n": {
"2": "Двигатель",
"4": "Двигун"
},
"prio": 2,
"type": 2,
"value": 89,
"value_int": 89,
"values": []
}
],
"4": [
{
"basic": 1,
"option_id": 4,
"option_name_i18n": {
"2": "Тип топлива",
"4": "Тип палива"
},
"options_category_id": 1,
"options_category_name_i18n": {
"2": "Двигатель",
"4": "Двигун"
},
"prio": 4,
"type": 5,
"value": 2,
"value_int": 2,
"values": [
{
"value_eng": "benzin",
"value_id": "1",
"value_name_i18n": {
"2": "Бензин",
"4": "Бензин"
}
},
{
"value_eng": "dizel",
"value_id": "2",
"value_name_i18n": {
"2": "Дизель",
"4": "Дизель"
}
},
{
"value_eng": "elektrika",
"value_id": "3",
"value_name_i18n": {
"2": "Электричество",
"4": "Електрика"
}
}
]
}
],
"5": [
{
"basic": 0,
"option_id": 5,
"option_name_i18n": {
"2": "Максимальный крутящий момент, Нм",
"4": "Максимальний крутний момент, Нм"
},
"options_category_id": 1,
"options_category_name_i18n": {
"2": "Двигатель",
"4": "Двигун"
},
"prio": 3,
"type": 2,
"value": 396,
"value_int": 396,
"values": []
}
],
"6": [
{
"basic": 0,
"option_id": 6,
"option_name_i18n": {
"2": "Система охлаждения",
"4": "Система охолодження"
},
"options_category_id": 1,
"options_category_name_i18n": {
"2": "Двигатель",
"4": "Двигун"
},
"prio": 5,
"type": 5,
"value": 4,
"value_int": 4,
"values": [
{
"value_eng": "ridinne-vodyane",
"value_id": "4",
"value_name_i18n": {
"2": "Жидкостное (водяное)",
"4": "Рідинне (водяне)"
}
},
{
"value_eng": "povitryane",
"value_id": "5",
"value_name_i18n": {
"2": "Воздушное",
"4": "Повітряне"
}
}
]
}
],
"9": [
{
"basic": 0,
"option_id": 9,
"option_name_i18n": {
"2": "Тип коробки передач",
"4": "Тип коробки передач"
},
"options_category_id": 2,
"options_category_name_i18n": {
"2": "Трансмиссия",
"4": "Трансмісія"
},
"prio": 1,
"type": 5,
"value": 6,
"value_int": 6,
"values": [
{
"value_eng": "mekhanichna",
"value_id": "6",
"value_name_i18n": {
"2": "Механическая",
"4": "Механічна"
}
},
{
"value_eng": "avtomatichna",
"value_id": "7",
"value_name_i18n": {
"2": "Автоматическая",
"4": "Автоматична"
}
},
{
"value_eng": "robotizovana",
"value_id": "8",
"value_name_i18n": {
"2": "Роботизированная",
"4": "Роботизована"
}
},
{
"value_eng": "variatorna",
"value_id": "9",
"value_name_i18n": {
"2": "Вариаторная",
"4": "Варіаторна"
}
},
{
"value_eng": "gidromekhanichna",
"value_id": "10",
"value_name_i18n": {
"2": "Гидромеханическая",
"4": "Гідромеханічна"
}
},
{
"value_eng": "gidrostatichna",
"value_id": "11",
"value_name_i18n": {
"2": "Гидростатическая",
"4": "Гідростатична"
}
}
]
}
],
"10": [
{
"basic": 0,
"option_id": 10,
"option_name_i18n": {
"2": "Тип привода",
"4": "Тип приводу"
},
"options_category_id": 2,
"options_category_name_i18n": {
"2": "Трансмиссия",
"4": "Трансмісія"
},
"prio": 1,
"type": 5,
"value": 14,
"value_int": 14,
"values": [
{
"value_eng": "zadnij",
"value_id": "12",
"value_name_i18n": {
"2": "Задний",
"4": "Задній"
}
},
{
"value_eng": "perednij",
"value_id": "13",
"value_name_i18n": {
"2": "Передний",
"4": "Передній"
}
},
{
"value_eng": "povnij",
"value_id": "14",
"value_name_i18n": {
"2": "Полный",
"4": "Повний"
}
}
]
}
],
"11": [
{
"basic": 0,
"option_id": 11,
"option_name_i18n": {
"2": "Количество передач вперед",
"4": "Кількість передач вперед"
},
"options_category_id": 2,
"options_category_name_i18n": {
"2": "Трансмиссия",
"4": "Трансмісія"
},
"prio": 1,
"type": 2,
"value": 18,
"value_int": 18,
"values": []
}
],
"12": [
{
"basic": 0,
"option_id": 12,
"option_name_i18n": {
"2": "Количество передач назад",
"4": "Кількість передач назад"
},
"options_category_id": 2,
"options_category_name_i18n": {
"2": "Трансмиссия",
"4": "Трансмісія"
},
"prio": 1,
"type": 2,
"value": 4,
"value_int": 4,
"values": []
}
],
"13": [
{
"basic": 0,
"option_id": 13,
"option_name_i18n": {
"2": "Блокировка дифференциала",
"4": "Блокування диференціалу"
},
"options_category_id": 2,
"options_category_name_i18n": {
"2": "Трансмиссия",
"4": "Трансмісія"
},
"prio": 2,
"type": 6,
"value": "1",
"value_int": 1,
"values": []
}
],
"14": [
{
"basic": 1,
"option_id": 14,
"option_name_i18n": {
"2": "Колесная формула",
"4": "Колісна формула"
},
"options_category_id": 2,
"options_category_name_i18n": {
"2": "Трансмиссия",
"4": "Трансмісія"
},
"prio": 4,
"type": 5,
"value": 16,
"value_int": 16,
"values": [
{
"value_eng": "4x2",
"value_id": "15",
"value_name_i18n": {
"2": "4х2",
"4": "4x2"
}
},
{
"value_eng": "4x4",
"value_id": "16",
"value_name_i18n": {
"2": "4х4",
"4": "4x4"
}
},
{
"value_eng": "6x4",
"value_id": "17",
"value_name_i18n": {
"2": "6х4",
"4": "6x4"
}
},
{
"value_eng": "6x6",
"value_id": "18",
"value_name_i18n": {
"2": "6х6",
"4": "6x6"
}
}
]
}
],
"15": [
{
"basic": 0,
"option_id": 15,
"option_name_i18n": {
"2": "ВВПот, об/мин",
"4": "Вал відбору потужності, об/хв"
},
"options_category_id": 2,
"options_category_name_i18n": {
"2": "Трансмиссия",
"4": "Трансмісія"
},
"prio": 2,
"type": 1,
"value": "1000",
"value_int": 1000,
"values": []
}
],
"16": [
{
"basic": 0,
"option_id": 16,
"option_name_i18n": {
"2": "Транспортная длина, мм",
"4": "Транспортна довжина, мм"
},
"options_category_id": 3,
"options_category_name_i18n": {
"2": "Габариты и размеры",
"4": "Габарити та розміри"
},
"prio": 1,
"type": 2,
"value": 3970,
"value_int": 3970,
"values": []
}
],
"18": [
{
"basic": 0,
"option_id": 18,
"option_name_i18n": {
"2": "Транспортная ширина, мм",
"4": "Транспортна ширина, мм"
},
"options_category_id": 3,
"options_category_name_i18n": {
"2": "Габариты и размеры",
"4": "Габарити та розміри"
},
"prio": 1,
"type": 2,
"value": 1970,
"value_int": 1970,
"values": []
}
],
"20": [
{
"basic": 0,
"option_id": 20,
"option_name_i18n": {
"2": "Транспортная высота, мм",
"4": "Транспортна висота, мм"
},
"options_category_id": 3,
"options_category_name_i18n": {
"2": "Габариты и размеры",
"4": "Габарити та розміри"
},
"prio": 1,
"type": 2,
"value": 2820,
"value_int": 2820,
"values": []
}
],
"22": [
{
"basic": 0,
"option_id": 22,
"option_name_i18n": {
"2": "Клиренс, мм",
"4": "Кліренс, мм"
},
"options_category_id": 3,
"options_category_name_i18n": {
"2": "Габариты и размеры",
"4": "Габарити та розміри"
},
"prio": 1,
"type": 2,
"value": 465,
"value_int": 465,
"values": []
}
],
"23": [
{
"basic": 0,
"option_id": 23,
"option_name_i18n": {
"2": "Колесная база, мм",
"4": "Колісна база, мм"
},
"options_category_id": 3,
"options_category_name_i18n": {
"2": "Габариты и размеры",
"4": "Габарити та розміри"
},
"prio": 1,
"type": 2,
"value": 2450,
"value_int": 2450,
"values": []
}
],
"26": [
{
"basic": 0,
"option_id": 26,
"option_name_i18n": {
"2": "Объем гидравлического бака, л",
"4": "Об'єм гідравлічного баку, л"
},
"options_category_id": 4,
"options_category_name_i18n": {
"2": "Вес и объемы",
"4": "Вага та об'єми"
},
"prio": 1,
"type": 3,
"value": 21,
"value_int": 21,
"values": []
}
],
"27": [
{
"basic": 0,
"option_id": 27,
"option_name_i18n": {
"2": "Объем топливного бака, л",
"4": "Об'єм паливного баку, л"
},
"options_category_id": 4,
"options_category_name_i18n": {
"2": "Вес и объемы",
"4": "Вага та об'єми"
},
"prio": 1,
"type": 3,
"value": 130,
"value_int": 130,
"values": []
}
],
"29": [
{
"basic": 0,
"option_id": 29,
"option_name_i18n": {
"2": "Снаряженный вес, кг",
"4": "Споряджена вага, кг"
},
"options_category_id": 4,
"options_category_name_i18n": {
"2": "Вес и объемы",
"4": "Вага та об'єми"
},
"prio": 1,
"type": 2,
"value": 4150,
"value_int": 4150,
"values": []
}
],
"30": [
{
"basic": 0,
"option_id": 30,
"option_name_i18n": {
"2": "Грузоподъемность навесного, кг",
"4": "Вантажнопідйомність навісного, кг"
},
"options_category_id": 4,
"options_category_name_i18n": {
"2": "Вес и объемы",
"4": "Вага та об'єми"
},
"prio": 2,
"type": 2,
"value": 3800,
"value_int": 3800,
"values": []
}
],
"34": [
{
"basic": 0,
"option_id": 34,
"option_name_i18n": {
"2": "Производительность насоса л/мин",
"4": "Продуктивність насоса л/хв"
},
"options_category_id": 5,
"options_category_name_i18n": {
"2": "Специальные технические характеристики",
"4": "Спеціальні технічні характеристики"
},
"prio": 2,
"type": 2,
"value": 45,
"value_int": 45,
"values": []
}
],
"37": [
{
"basic": 0,
"option_id": 37,
"option_name_i18n": {
"2": "Максимальная скорость, км/ч",
"4": "Максимальна швидкість, км/год"
},
"options_category_id": 6,
"options_category_name_i18n": {
"2": "Эксплуатационные характеристики",
"4": "Експлуатаційні характеристики"
},
"prio": 2,
"type": 2,
"value": 34,
"value_int": 34,
"values": []
}
],
"172": [
{
"basic": 1,
"option_id": 172,
"option_name_i18n": {
"2": "Наработка, мтч",
"4": "Напрацювання, мтг"
},
"options_category_id": 7,
"options_category_name_i18n": {
"2": "Характеристики технического состояния",
"4": "Характеристики технічного стану"
},
"prio": 1,
"type": 2,
"value": 902,
"value_int": 902,
"values": []
}
],
"174": [
{
"basic": 0,
"option_id": 174,
"option_name_i18n": {
"2": "VIN",
"4": "VIN"
},
"options_category_id": 8,
"options_category_name_i18n": {
"2": "VIN-код",
"4": "VIN-код"
},
"prio": 1,
"type": 1,
"value": "Y4R900Z04K1130821",
"value_int": 0,
"values": []
}
],
"175": [
{
"basic": 0,
"option_id": 175,
"option_name_i18n": {
"2": "Состояние техники",
"4": "Стан техніки"
},
"options_category_id": 7,
"options_category_name_i18n": {
"2": "Характеристики технического состояния",
"4": "Характеристики технічного стану"
},
"prio": 1,
"type": 5,
"value": 20,
"value_int": 20,
"values": [
{
"value_eng": "nova",
"value_id": "19",
"value_name_i18n": {
"2": "Новая",
"4": "Нова"
}
},
{
"value_eng": "vzhivana",
"value_id": "20",
"value_name_i18n": {
"2": "Б/у",
"4": "Вживана"
}
}
]
}
]
},
"tag": {
"eng": "traktor",
"gender": 1,
"id": 1,
"name_i18n": {
"1": "Tractor",
"2": "Трактор",
"4": "Трактор"
},
"plural": {
"1": null,
"2": "Тракторы",
"4": "Трактори"
},
"plural_genitive": {
"1": null,
"2": "Тракторов",
"4": "Тракторів"
}
},
"last_visit": "2024-10-29 12:03:59",
"engine_hours": 902,
"adv_id": 350025212,
"rnd": 0.171281575152741,
"state_id": 6,
"tag_id": 1,
"settlement_id": 0,
"city_name_i18n": {
"2": "Прилуки",
"4": "Прилуки"
},
"city_id": 560,
"level_accrued_at": "2024-10-27T07:46:07",
"sold": 0,
"sub_tag_ids": [230, 337],
"created_at": "2024-10-27T07:30:42",
"marka_slang": "МТЗ"
}
Приклад помилкової відповіді
{"message":"Not Found"}
Перелік параметрів відповіді
Параметр | Опис |
---|---|
is_compensation_marka | марка на яку діє програма компенсації від уряду України (0 - ні, 1 - так) |
currency_id | id валюти |
order_data | дата замовлення |
country_i18n | країна виробник українська/російська назви з відмінками |
country_id | id країни |
is_auction | чи техніка з аукціону |
vat | чи включено в ціну ПДВ |
has_payment_in_installments | чи є оплата частинами |
description_i18n | Опис |
year | рік |
city_eng | назва Міста англійською |
top_date_close | дата закриття ТОП рівня |
marka_eng | назва марки англійською |
created_at_formatted | дата створення та редагування (2 -id створення, 4 - id редагування |
option_ids | Id опцій |
main_photo_id | id головного фото |
vin | VIN-код |
city | місто Українською |
marka | назва марки |
video | наявність відео |
publication | Публікація |
adv_id | id оголошення |
expire_date | дата закінчення публікації |
publication_date | дата публікації |
publication_date_formatted | дата зміни публікації |
user_id | id користувача |
model_slang | сленгова назва моделі |
seller_id | id продавця |
model_id | id моделі |
price_uah | ціна в гривні |
free_shipping | безкоштовна доставка |
link | посилання на оголошення |
updated_at | дата оновлення оголошення |
marka_id | id марки |
price_usd | ціна в доларах |
mileage | пробіг |
state_eng | назва області англійською |
sub_tags | субтег до якого прив'язане оголошення |
sub_tag_category_id | категорія до якої відноситься даний субтег |
model | назва моделі |
photos | фото |
src | посилання на фото |
prio | Пріоритет - порядок фото |
is_main | головне фото (1- головне фото, 0 - інші фото) |
photo_id | id фото |
tech_condition_id | технічних стан (20 - вживаний, 19-новий) |
model_eng | назва моделі англійською |
has_photos | наявність фото в оголошенні (1-є фото) |
country_id | id країни |
state | область |
options | опції (об'єкт типу key: value де key("3") є id опції, а value є список зі значень опції що вказане в оголошенні) |
option_id | id опції |
option_name_i18n | назва опції (2-російською, 4- українською) |
options_category_id | категорія опцій до якої відноситься поточна опція |
options_category_name_i18n | назва категорії опцій (2-російською, 4- українською) |
value | при значенні категрій опцій 1- двигун - має значення "Максимальна потужність, к.с." = 153 |
engine_hours | мотогодини |
rnd | гео |
state_id | id області |
settlement_id | id населеного пункта |
city_name_i18n | назва міста (2-російською, 4- українською) |
city_id | id міста |
sold | статус оголошення |
marka_slang | сленг марки |