Тип API: Фріміум
Для отримання переліку оголошень Вам необхідно виконати GET запит такого виду:
https://developers.ria.com/dom/search?api_key=YOUR_API_KEY&PARAMETERS
або
curl -X GET "https://developers.ria.com/dom/search?api_key=YOUR_API_KEY&PARAMETERS" -H "accept: application/json"
API_KEY — ваш API ключ
PARAMETERS — вхідні параметри, послідовність параметів name=value, розділених амперсандом. Список параметрів можна переглянути тут.
Параметри відповіді:
Параметр | Опис |
---|---|
items | id оголошень |
count | кількість |
Приклад
Припустимо, Ви шукаєте:
Об'єкт - Квартири
Тип нерухомості - квартира
Операція - продаж
Область - Київська
Місто - Київ
Район- Оболонський,Печерський,Подільський
Кількість кімнат - від 1 до 3
Загальна площа - від 60 до 90
Житлова площа - від 30 до 50
Кухня - від 4 до 9
Кухня - від 3 до 7
Рік побудови - не вказано
Ціна - від 20000 до 90000
Ціна за об'єкт
Тип валюти - долари США
Можливий торг
Тип пропозиції - від посередника
В результаті ми отримуємо запит такого типу:
https://developers.ria.com/auto/search?api_key=YOUR_API_KEY&category=1&realty_type=2&operation_type=1….\
або
curl -X GET "https://developers.ria.com/dom/search?category=1&realty_type=2&operation_type=1&state_id=10&city_id=10&district_id=15187&district_id=15189&district_id=15188&characteristic[209][from]=1&characteristic[209][to]=3&characteristic[214][from]=60&characteristic[214][to]=90&characteristic[216][from]=30&characteristic[216][to]=50&characteristic[218][from]=4&characteristic[218][to]=9&characteristic[227][from]=3&characteristic[227][to]=7&characteristic[443]=442&characteristic[234][from]=20000&characteristic[234][to]=90000&characteristic[242]=239&characteristic[273]=273&characteristic[1437]=1434&api_key=YOUR_API_KEY" -H "accept: application/json"
У разі успішного виконання запиту за вказаними параметрами результат буде зі статусом 200 OK.
Приклад успішної відповіді:
{
"items": [
13336044,
14076392,
13814523,
14064249,
13078930,
13927706,
13962022
],
"count": 7
}
Зробити запит
Запити з документації зараховуються згідно умов пакету.