Поиск по объектам недвижимости - табличный вид квартир
Метод используется для общего поиска объектов недвижимости по заданным параметрам.
Используемый метод: Data_tables.tv
Поля запроса
Название ключа |
Описание |
Тип значения |
Обязательный |
Значение по-умолчанию |
complex_id |
Идентификатор ЖК (поиск по всем, если не заполнено) |
number |
Нет |
Null |
codes |
Фиас коды региона |
string |
Нет |
"" |
searchbox |
ЖК, улица(строка поиска) |
string |
Нет |
"" |
obj_term_of_delivery |
Срок сдачи объекта |
string |
Нет |
"" |
obj_date_of_delivery_from |
Дата сдачи объекта от |
string |
Нет |
"" |
obj_date_of_delivery_to |
Дата сдачи объекта до |
string |
Нет |
"" |
price_from |
Цена от |
number |
Нет |
Null |
price_to |
Цена до |
number |
Нет |
Null |
floor_from |
Этаж от |
number |
Нет |
Null |
floor_to |
Этаж до |
number |
Нет |
Null |
floors_from |
Этажность от |
number |
Нет |
Null |
floors_to |
Этажность до |
number |
Нет |
Null |
total_area_from |
Общая площадь от |
number |
Нет |
Null |
total_area_to |
Общая площадь до |
number |
Нет |
Null |
living_area_from |
Жилая площадь от |
number |
Нет |
Null |
living_area_to |
Жилая площадь до |
number |
Нет |
Null |
kitchen_area_from |
Площадь кухни от |
number |
Нет |
Null |
kitchen_area_to |
Площадь кухни до |
number |
Нет |
Null |
mkad_from |
Расстояние от мкад |
number |
Нет |
Null |
mkad_to |
Расстояние до мкад |
number |
Нет |
Null |
property_type |
Тип помещения |
number |
Нет |
1 |
type_of_finish_id |
Тип отделки |
number |
Нет |
Null |
build_stage_id |
Стадия готовности |
number |
Нет |
Null |
term_id |
Условия покупки |
number |
Нет |
Null |
is_apartment |
Флаг апартаменты |
boolean |
Нет |
false |
floor_not_first |
Флаг не первый этаж |
boolean |
Нет |
false |
floor_not_last |
Флаг не последний этаж |
boolean |
Нет |
false |
is_duplex |
Флаг двухуровневый |
boolean |
Нет |
false |
rooms |
Количество комнат и признак студии |
array |
Нет |
[ ] |
house_class_id |
Класс объекта |
array |
Нет |
[ ] |
subway_id |
Метро |
array |
Нет |
[ ] |
highway_id |
Шоссе |
array |
Нет |
[ ] |
railway_id |
ЖД Станция |
array |
Нет |
[ ] |
limit |
Максимальное кол-во квартир в результате (не более 1000) |
number |
Нет |
50 |
offset |
Отступ для извлечения нужной страницы результатов, например для извлечения 3й страницы из 1000 элементов, отступ должен быть равен 2000 |
number |
Нет |
0 |
filter |
Дополнительные фильтры |
object |
Нет |
{ "complex": null, "korpus": null, "sekciya": null, "rooms": null, "etazh": null, "plochad_obsh": null, "ploshad_shil": null, "ploshad_kuchni": null, "price": null, "stoimost_kv_metra": null, "commission": null, "global_search_string": ""} |
order |
Сортировка - столбец и направление |
array |
Нет |
[{price: "asc"}] |
Пример запроса
1 QUERY_HOST='https://spn24.ru/api/v1'
2 QUERY_ID='530c4636-0408-45f8-ab41-28a749a3c43e'
3 QUERY_METHOD='Data_tables.tv'
4 QUERY_HEADER='Content-Type: application/json'
5 QUERY_HEADER_AUTH="Authorization: WWWToken XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
6
7 QUERY_BODY="{
8 \"id\": \"$QUERY_ID\",
9 \"jsonrpc\": \"2.0\",
10 \"method\": \"$QUERY_METHOD\",
11 \"params\": {
12 \"limit\": 5,
13 \"offset\": 10
14 }
15 }"
16
17 curl -i -X POST -H $QUERY_HEADER -H $QUERY_HEADER_AUTH -d $QUERY_BODY $QUERY_HOST
Результат запроса
Результат запроса представляет собой массив из помещений, удовлетворяющих заданному условию (если фильтров не задано, то всех помещений в продаже).
Описание основных полей ответа.
Название ключа |
Описание |
Тип значения |
result |
Результат запроса |
object |
count |
Количество помещений в продаже, удовлетворяющих заданным условиям |
number |
rows |
Массив помещений с детализированной информацией |
array |
commission |
Вознаграждение |
number |
flat_etazh |
Этаж |
number |
flat_id |
Идентификатор помещения |
number |
flat_plochad_obsh |
Общая площадь |
string |
flat_ploshad_kuchni |
Площадь кухни |
string |
flat_ploshad_shil |
Жилая площадь |
string |
flat_price |
Цена |
number |
flat_price_promo |
Цена по акции (null если отсутствует) |
number |
flat_rooms |
Количество комнат |
number |
flat_sekciya |
Подъезд |
number |
flat_stoimost_kv_metra |
Цена за 1 кв. метр |
number |
housing_address |
Адрес |
string |
housing_caption |
Название корпуса |
string |
housing_complex_caption |
Название ЖК |
string |
housing_complex_id |
Идентификатор ЖК |
number |
housing_etazhnost |
Этажность |
number |
housing_srok_sdachi |
Срок сдачи |
string |
housing_id |
Идентификатор корпуса |
number |
housing_lat |
Географическая широта |
number |
housing_lon |
Географическая долгота |
number |
housing_yandex_id |
id корпуса в справочнике Yandex новостроек |
number |
housing_cian_id |
id корпуса в справочнике Cian новостроек |
number |
housing_avito_id |
id корпуса в справочнике Avito новостроек |
number |
housing_complex_yandex_id |
id комплекса в справочнике Yandex новостроек |
number |
housing_complex_cian_id |
id комплекса в справочнике Cian новостроек |
number |
housing_complex_avito_id |
id комплекса в справочнике Avito новостроек |
number |
Примет ответа на запрос в формате JSON
{ "id": "4f718a4f-dcec-5aae-7c4d-d05eebeb2bdf", "jsonrpc": "2.0", "result": { "count": 3, "rows": [ { "commission": 141831, "flat_etazh": 39, "flat_id": 342651, "flat_plochad_obsh": "59,0", "flat_ploshad_kuchni": "-", "flat_ploshad_shil": "-", "flat_price": 17728910, "flat_price_promo": null, "flat_rooms": 2, "flat_sekciya": 1, "flat_stoimost_kv_metra": 300490, "housing_address": "г Москва, ул Хуторская 2-я, д 34", "housing_caption": "Корпус B - Crystal", "housing_complex_caption": "ЖК \"Symphony 34\" - \"Симфония 34\"", "housing_complex_id": 333573, "housing_etazhnost": 49, "housing_id": 333574, "housing_lat": 55.8061996, "housing_lon": 37.5709513, "housing_srok_sdachi": "IV квартал 2023" }, { "commission": 143270, "flat_etazh": 3, "flat_id": 342684, "flat_plochad_obsh": "66,92", "flat_ploshad_kuchni": "-", "flat_ploshad_shil": "-", "flat_price": 17908795, "flat_price_promo": null, "flat_rooms": 2, "flat_sekciya": 1, "flat_stoimost_kv_metra": 267614.99, "housing_address": "г Москва, ул Хуторская 2-я, д 34", "housing_caption": "Корпус B - Crystal", "housing_complex_caption": "ЖК \"Symphony 34\" - \"Симфония 34\"", "housing_complex_id": 333573, "housing_etazhnost": 49, "housing_id": 333574, "housing_lat": 55.8061996, "housing_lon": 37.5709513, "housing_srok_sdachi": "IV квартал 2023" }, { "commission": 144668, "flat_etazh": 43, "flat_id": 342666, "flat_plochad_obsh": "60,18", "flat_ploshad_kuchni": "-", "flat_ploshad_shil": "-", "flat_price": 18083488, "flat_price_promo": null, "flat_rooms": 2, "flat_sekciya": 1, "flat_stoimost_kv_metra": 300490, "housing_address": "г Москва, ул Хуторская 2-я, д 34", "housing_caption": "Корпус B - Crystal", "housing_complex_caption": "ЖК \"Symphony 34\" - \"Симфония 34\"", "housing_complex_id": 333573, "housing_etazhnost": 49, "housing_id": 333574, "housing_lat": 55.8061996, "housing_lon": 37.5709513, "housing_srok_sdachi": "IV квартал 2023" }, { "commission": 144805, "flat_etazh": 5, "flat_id": 342499, "flat_plochad_obsh": "64,53", "flat_ploshad_kuchni": "-", "flat_ploshad_shil": "-", "flat_price": 18100665, "flat_price_promo": null, "flat_rooms": 2, "flat_sekciya": 1, "flat_stoimost_kv_metra": 280500, "housing_address": "г Москва, ул Хуторская 2-я, д 34", "housing_caption": "Корпус B - Crystal", "housing_complex_caption": "ЖК \"Symphony 34\" - \"Симфония 34\"", "housing_complex_id": 333573, "housing_etazhnost": 49, "housing_id": 333574, "housing_lat": 55.8061996, "housing_lon": 37.5709513, "housing_srok_sdachi": "IV квартал 2023" }, { "commission": 144909, "flat_etazh": 44, "flat_id": 343452, "flat_plochad_obsh": "60,18", "flat_ploshad_kuchni": "-", "flat_ploshad_shil": "-", "flat_price": 18113578, "flat_price_promo": null, "flat_rooms": 2, "flat_sekciya": 1, "flat_stoimost_kv_metra": 300990, "housing_address": "г Москва, ул Хуторская 2-я, д 34", "housing_caption": "Корпус B - Crystal", "housing_complex_caption": "ЖК \"Symphony 34\" - \"Симфония 34\"", "housing_complex_id": 333573, "housing_etazhnost": 49, "housing_id": 333574, "housing_lat": 55.8061996, "housing_lon": 37.5709513, "housing_srok_sdachi": "IV квартал 2023" } ] } }