Тип 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, розділених амперсандом. Список параметрів можна переглянути тут.
Для пошуку оголошень по новобудовам вказуйте параметр: newbuildings=1 , по вторинній нерухомості secondary=1
Для сортування id оголошень у відповіді можна використовувати параметр: sort . Наприклад,ви хочете відсортувати id оголошеннь по даті створення по спадаючій ви можете додати в запит наступні дані: sort=created_at
Параметри для сортування:
| Параметр | Опис |
|---|---|
| inspected_sort | сортування по перевіреності. Перевірені перші |
| pub_d | сортування по даті публікації по спадаючій |
| pub_a | сортування по даті публікації по зростаючій |
| upd_a | сортування по даті оновлення по зростаючій |
| upd_d | сортування по даті оновлення по спадаючій |
| insp_a | сортування по даті перевірки по зростаючій |
| insp_d | сортування по даті перевірки по спадаючій |
| video_insp_a | сортування по даті відео перевірки по зростаючій |
| video_insp_d | сортування по даті відео перевірки по спадаючій |
| created_at | сортування по даті створення по спадаючій |
| created_at_asc | сортування по даті створення по зростаючій |
| realty_a | сортування по айді оголошення по зростаючій |
| realty_d | сортування по айді оголошення по спадаючій |
Приклад
Припустимо, Ви шукаєте:
Об'єкт - Квартири
Тип нерухомості - квартира
Операція - продаж
Область - Київська
Місто - Київ
Район- Оболонський,Печерський,Подільський
Кількість кімнат - від 1 до 3
Загальна площа - від 60 до 90
Житлова площа - від 30 до 50
Кухня - від 4 до 9
Кухня - від 3 до 7
Рік побудови - не вказано
Ціна - від 20000 до 90000
Ціна за об'єкт
Тип валюти - долари США
Можливий торг
Тип пропозиції - від посередника
В результаті ми отримуємо запит такого типу:
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
або
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.
Врахуйте, що ви можете отримати максимальну кількість id оголошень 10 000, тобто 99 сторінок включно. Рекомендуємо використовувати більше параметрів фільтрів при формуванні запиту
{
"items": [
13336044,
14076392,
13814523,
14064249,
13078930,
13927706,
13962022
],
"count": 7
}
Параметри відповіді:
| Параметр | Опис |
|---|---|
| items | id оголошень |
| count | кількість |
Зробити запит
Запити з документації зараховуються згідно умов пакету.