Поиск по объектам недвижимости - табличный вид квартир
Метод используется для общего поиска объектов недвижимости по заданным параметрам.
Используемый метод: 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"
}
]
}
}