Тип API: Фріміум
Для отримання інформації про оголошення Вам необхідно виконати GET запит такого виду:
https://developers.ria.com/dom/info/id_оголошення?api_key=YOUR_API_KEY
або
curl -i -X GET "https://developers.ria.com/dom/info/id_оголошення?api_key=YOUR_API_KEY"
де id_оголошення - id оголошення; YOUR_API_KEY - ваш API ключ
Припустимо Вам потрібна інформація щодо id 13825265 .
Цей запит матиме такий вигляд:
https://developers.ria.com/dom/info/13825265?api_key=YOUR_API_KEY
або
curl -i -X GET "https://developers.ria.com/dom/info/13825265?api_key=YOUR_API_KEY
У разі успішного виконання запиту результат буде зі статусом 200 OK.
| Параметр | Опис |
|---|---|
| advert_publish_type | Статус оголошення (активне / архівне) |
| advert_type_id | тип операції (продаж, оренда) |
| advert_type_name | назва операції (продаж, оренда) |
| beautiful_url | посилання на оголошення (seo url) |
| building_number_str | номер будику |
| characteristics_values | об'єкт опцій |
| city_id | id міста |
| city_name | назва міста |
| created_at | дата створення оголошення |
| currency_type | значення валюти |
| date_end | дата до коли оголошення активне |
| description | опис (рос) |
| description_uk | опис (укр) |
| district_id | id району |
| district_name | назва району |
| district_type_id | id тип району |
| district_type_name | назва типу району (р-н, передмістя, село) |
| floor | поверх |
| floors_count | всього поверхів |
| inspected | перевірка інспектором |
| inspected_at | дата перевірки |
| is_bargain | можливий торг |
| is_commercial | користувач комерційний |
| is_exchange | можливий обмін |
| is_show_building_no | показувати номер будинку |
| kitchen_square_meters | площа кухні |
| latitude | (гео, координата широти) |
| levels | рівні топ |
| levels_expired | дата доколи діють рівні |
| living_square_meters | житлова площе |
| longitude | (гео, координата довготи) |
| main_photo | посилання на головне фото |
| metro_station_brunch | гілка метро |
| metro_station_id | id станції метро |
| metro_station_name | назва станції метро |
| photos | об'єкт фото оголошення |
| price | ціна |
| price_item | ціна за квадрат |
| price_total | загальна ціна |
| price_type | тип ціни (за квадрат, за об'єкт) |
| priceArr | ціни (конвертовані згідно курсу) |
| publishing_date | дата публікації |
| realty_id | id оголошення |
| realty_type_id | id типу нерухомості |
| realty_type_name | назва типу нерухомості |
| realty_type_parent_id | id типу будівлі |
| realty_type_parent_name | назва типу будівлі |
| rooms_count | кількість кімнат |
| state_id | id області |
| state_name | назва області |
| street_id | id вулиці |
| street_name | назва вулиці |
| total_square_meters | загальна площа |
| user | дані про власника оголошення |
| user_id | id користувача |
| user_ip | ip користувача |
| user_package_id | id комерційного пакету |
| wall_type | тип стін |
| with_panoramas | з панорамними фото |
| youtube_link | посилання на відео |
| admin_district_name_uk | адміністративний район українською |
| admin_district_name_ru | адміністративний район російською |
| admin_district_id | id адміністративного району |
admin_district_name_uk, admin_district_name_ru, admin_district_id. Поля додаються за умови, що вказаний район в оголошенні не є адміністативним районом. Якщо їх немає, це означає, що вказаний район являється адміністративним районом.
{
"street_name": "Онуфрія Трутенка вулиця",
"metro_station_id": "15",
"rooms_count": 2,
"advert_title": 1,
"type": "realty",
"is_commercial": 0,
"state_name": "Київська",
"street_id": 5581,
"state_id": 10,
"beautiful_url": "realty-perevireno-prodaja-kvartira-kiev-goloseevskiy-onufriya-trutenko-ulitsa-13825265.html",
"levels": 64,
"exchange_required_type": 13,
"district_type_name": "Район",
"description": "Светлая квартира, расположена на 23 этаже / 23 эт. дома в ЖК " 4 Сезона", потолок Н-3,5 м., панорамные окна с видом на город. Состояние от застройщика, у Вас есть возможность воплотить дизайнерские фантазии в доме. Дом имеет внешнее утепление, парковку, подземный паркинг, во дворе оборудованная детская площадка. Шикарный район, в шаговой дистанции м. " Васильковская" ( 5 мин.пешком), м. "Ипподром" (10 мин.пешком), м. "Выстовочный Центр"(18 мин. пешком) Голосеевский парк,озёра и пруды, детский сад, школа, магазины, салоны, кафе и рестораны, фитнес центр. ",
"advert_publish_type": 1,
"currency_type": "$",
"district_type_id": 1,
"longitude": "30.480281005166944",
"inspected_at": "2017-10-02 14:51:02",
"levels_expired": "2018-01-01 12:16:32",
"is_exchange": "рассмотрю любой вариант",
"district_id": "15184",
"metro_station_name": "Васильковская",
"wall_type": "кирпич",
"publishing_date": "2017-10-02 14:51:07",
"description_uk": "Світла квартира, розташована на 23 поверсі / 23 пов. будинки в ЖК "4 Сезони", стеля Н-3,5 м., панорамні вікна з видом на місто. Стан від забудовника, у Вас є можливість втілити дизайнерські фантазії в будинку. Будинок має зовнішнє утеплення, місце для паркування, підземний паркінг, у дворі обладнаний дитячий майданчик. Шикарний район, в крокової дистанції м. "Васильківська" ( 5 хв. пішки), м. "Іподром" (10 хв. пішки), м. "Вистовковий Центр"(18 хв. пішки), Голосіївський парк, озера і ставки, дитячий садок, школа, магазини, салони, кафе і ресторани, фітнес-центр. ",
"youtube_link": "",
"price_type": "за объект",
"inspected": 1,
"is_bargain": 273,
"price": 60000,
"floor": 23,
"latitude": "50.39161687881484",
"price_total": 60000,
"main_photo": "dom/photo/8070/807045/80704539/80704539.jpg",
"price_item": 645,
"realty_type_name": "Квартира",
"building_number_str": "3 Г",
"city_name": "Киев",
"metro_station_brunch": 2,
"realty_type_parent_id": 1,
"living_square_meters": 50,
"realty_type_id": 2,
"user_ip": 0,
"city_id": 10,
"characteristics_values": {
"118": 108,
"209": 2,
"214": 93,
"216": 50,
"218": 20,
"227": 23,
"228": 23,
"234": 60000,
"242": 239,
"247": 252,
"265": 264,
"273": 273,
"443": 1449,
"475": 473,
"480": 476,
"516": 512,
"791": 791,
"806": 802,
"808": 808,
"892": 890,
"1016": 1016,
"1020": 1023,
"1032": 1028,
"1157": 1149,
"1403": 1400,
"1437": 1436,
"1504": 1504,
"1571": 1571,
"1575": 1575,
"1581": 1581
},
"_id": "realty-13825265",
"floors_count": 23,
"created_at": "2017-09-20 21:12:42",
"user_id": 7160632,
"kitchen_square_meters": 20,
"user_package_id": 0,
"total_square_meters": 93,
"realty_id": 13825265,
"realty_sale_type": 2,
"photos": {
"80704539": {
"id": 80704539,
"file": "dom/photo/8070/807045/80704539/80704539.jpg",
"o": "h"
},
"80704540": {
"id": 80704540,
"file": "dom/photo/8070/807045/80704540/80704540.jpg",
"o": "h"
},
"80704541": {
"id": 80704541,
"file": "dom/photo/8070/807045/80704541/80704541.jpg",
"o": "h"
},
"80704542": {
"id": 80704542,
"file": "dom/photo/8070/807045/80704542/80704542.jpg",
"o": "h"
},
"80704543": {
"id": 80704543,
"file": "dom/photo/8070/807045/80704543/80704543.jpg",
"o": "v"
},
"80704545": {
"id": 80704545,
"file": "dom/photo/8070/807045/80704545/80704545.jpg",
"o": "v"
},
"80704546": {
"id": 80704546,
"file": "dom/photo/8070/807045/80704546/80704546.jpg",
"o": "v"
},
"80704547": {
"id": 80704547,
"file": "dom/photo/8070/807045/80704547/80704547.jpg",
"o": "v"
},
"80704548": {
"id": 80704548,
"file": "dom/photo/8070/807045/80704548/80704548.jpg",
"o": "v"
},
"80704550": {
"id": 80704550,
"file": "dom/photo/8070/807045/80704550/80704550.jpg",
"o": "h"
},
"80704552": {
"id": 80704552,
"file": "dom/photo/8070/807045/80704552/80704552.jpg",
"o": "h"
}
},
"date_end": "2018-03-02 14:51:07",
"district_name": "Голосеевский",
"advert_type_id": 1,
"advert_type_name": "продажа",
"is_show_building_no": 1,
"realty_type_parent_name": "Квартиры",
"user": {
"name": "Владимир",
"image": "",
"good_partner_top": ""
},
"priceArr": {
"1": "60 000",
"2": "50 588",
"3": "1 680 672"
},
"with_panoramas": 1
}
Для отримання фото вам необхідно додати префікс „xl“ перед .jpg Наприклад: https://cdn.riastatic.com/photos/dom/photo/20703/2070397/207039746/207039746xl.jpg
Зробити запит
Запити з документації зараховуються згідно умов пакету.
