Поиск объявлений¶
Чтобы обратиться к DOM.RIA API search, Вам необходимо выполнить 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"
Он состоит из:
- SEARCH — название метода API, к которому Вы хотите обратиться.
- API_KEY — ключ доступа. Для получения ключа доступа нужно зарегестрироватся на портале developers.ria.com
- PARAMETERS — входные параметры, последовательность пар name=value, разделенных амперсандом. Список параметров указан выше.
В ответ на такой запрос Вы получите ответ в формате JSON:
{
"items": [ //id объявлений
],
"count": // количество
}
Полное описание сервиса "Поиск объявлений" описанный с помощью стандарта DeFacto swagger 2.0
Пример
Допустим Вы ищете:
- Объект - Квартиры
- Тип недвижимости - квартира
- Операция - продажа
- Область - Киевская
- Город - Киев
- Район
- Оболонский
- Печерский
- Подольский
- Количество комнат от 1 до 3
- Общая площадь от 60 до 90
- Жилая площадь от 30 до 50
- Кухня от 4 до 9
- Кухня от 3 до 7
- Год постройки - не указан
- Цена от 20000 до 90000
- Цена за объект
- Тип валюты долары США
- Возможен торг
- Тип предложения - от посредника
В итоге мы получаем запрос такого [вида]:
или 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
}