Поиск по объектам недвижимости - Витрина ЖК
Метод используется для общего поиска объектов недвижимости в комплексах по заданным параметрам.
Используемый метод: Search.showcase
Поля запроса
Название ключа |
Описание |
Тип значения |
Обязательный |
Значение по-умолчанию |
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 |
Нет |
[ ] |
Пример запроса
1 QUERY_HOST='https://spn24.ru/api/v1'
2 QUERY_ID='530c4636-0408-45f8-ab41-28a749a3c43e'
3 QUERY_METHOD='Search.showcase'
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 \"build_stage_id\": \"2\",
13 \"change\": true,
14 \"codes\": \"\",
15 \"floor_from\": 2,
16 \"floor_not_first\": true,
17 \"floor_not_last\": true,
18 \"floor_to\": 15,
19 \"floors_from\": 7,
20 \"floors_to\": 17,
21 \"highway_id\": [],
22 \"house_class_id\": [],
23 \"is_apartment\": null,
24 \"is_duplex\": null,
25 \"is_promo\": null,
26 \"kitchen_area_from\": 5.1,
27 \"kitchen_area_to\": 15.6,
28 \"living_area_from\": 20.4,
29 \"living_area_to\": 40.3,
30 \"mkad_from\": null,
31 \"mkad_to\": null,
32 \"obj_term_of_delivery\": \"\",
33 \"obj_date_of_delivery_from\": \"\",
34 \"obj_date_of_delivery_to\": \"\",
35 \"page\": 1,
36 \"price_from\": 3000000,
37 \"price_to\": 9000000,
38 \"property_type\": 1,
39 \"railway_id\": [],
40 \"rooms\": [\"2\"],
41 \"rows\": 12,
42 \"searchbox\": \"\",
43 \"searchbox_caption\": \"\",
44 \"subway_id\": [],
45 \"term_id\": \"1\",
46 \"total_area_from\": 30.2,
47 \"total_area_to\": 70.7,
48 \"type_of_finish_id\": 1,
49 }
50 }"
51
52 curl -i -X POST -H $QUERY_HEADER -H $QUERY_HEADER_AUTH -d $QUERY_BODY $QUERY_HOST
Результат запроса
Результат запроса представляет собой массив из комплексов с основной информацией о нем и о объектах внутри него, удовлетворяющих заданному условию.
Описание основных полей ответа.
Название ключа |
Описание |
Тип значения |
result |
Результат запроса |
object |
count |
Количество комплексов удовлетворяющих заданному условию |
number |
rows |
Массив объектов с детализированной информацией о комплексе |
array |
address |
Адрес комплекса |
string |
caption |
Название комплекса |
string |
complex_id |
id комплекса |
number |
flats |
Общая информация о квартирах, удовлетворяющих заданному условию |
object |
offices |
Общая информация о нежилых помещениях, удовлетворяющих заданному условию |
object |
complex_yandex_id |
id комплекса в справочнике Yandex новостроек |
number |
complex_cian_id |
id комплекса в справочнике Cian новостроек |
number |
complex_avito_id |
id комплекса в справочнике Avito новостроек |
number |
Примет ответа на запрос в формате JSON
{ "id": "4f718a4f-dcec-5aae-7c4d-d05eebeb2bdf", "jsonrpc": "2.0", "result": { "count": 3, "rows": [ { "address": "Московская область, Ленинский район, пос. Развилка", "caption": "ЖК "UP!КВАРТАЛ"Римский"", "complex_id": 00000, "deals_status": false, "flats": { "caption": "квартир", "count": 7, "price_min": 5913394, "price_promo_min": null, "sqm_max": 65.9, "sqm_min": 60.7 }, "flats_count": 7, "flats_detail_count": [ { "count": 7, "rooms": 2 } ], "flats_min_price": 5913394, "flats_min_promo": null, "housing_id": 00000, "image": "http://dev.spn24.ru/files/upload/c52ac6f9-5800-4ac3-9917-b2730768c12e.png", "is_mine": true, "offices": { "caption": "нежилых помещений", "count": 0, "price_min": null, "price_promo_mini": null, "sqm_max": null, "sqm_min": null }, "special_status": false, "status": false, "stock_status": true, "term_of_delivery": "IV квартал 2018", "term_of_delivery_line1": "2018", "term_of_delivery_line2": "IV квартал", "tip_otd_status": true }, { "address": "Московская область, Мытищинский район, деревня Бородино", "caption": 'ЖК "UP!КВАРТАЛ"Скандинавский"', "complex_id": 00000, "deals_status": false, "flats": { "caption": "квартир", "count": 11, "price_min": 4633680, "price_promo_min": 5584797.0, "sqm_max": 65.8, "sqm_min": 51.6 }, "flats_count": 11, "flats_detail_count": [ { "count": 11, "rooms": 2 } ], "flats_min_price": 4633680, "flats_min_promo": 5584797.0, "housing_id": 00000, "image": "http://dev.spn24.ru/files/upload/f0f6c4ae-ed4d-4a34-b69b-df32b4c30d47.png", "is_mine": true, "offices": { "caption": "нежилых помещений", "count": 0, "price_min": null, "price_promo_mini": null, "sqm_max": null, "sqm_min": null }, "special_status": false, "status": false, "stock_status": true, "term_of_delivery": "IV квартал 2018", "term_of_delivery_line1": "2018", "term_of_delivery_line2": "IV квартал", "tip_otd_status": false }, { "address": "Московская область, г. Домодедово", "caption": "ЖК «Домодедово Парк»", "complex_id": 00000, "deals_status": false, "flats": { "caption": "квартир", "count": 26, "price_min": 3786000, "price_promo_min": null, "sqm_max": 64.0, "sqm_min": 63.1 }, "flats_count": 26, "flats_detail_count": [ { "count": 26, "rooms": 2 } ], "flats_min_price": 3786000, "flats_min_promo": null, "housing_id": 00000, "image": "http://dev.spn24.ru/files/upload/d1f07dfd-791b-4e7a-83d4-7d949a8ca628.png", "is_mine": true, "offices": { "caption": 'нежилых помещений', "count": 0, "price_min": null, "price_promo_mini": null, "sqm_max": null, "sqm_min": null }, "special_status": false, "status": false, "stock_status": true, "term_of_delivery": "сдан", "term_of_delivery_line1": "Сдан", "term_of_delivery_line2": null, "tip_otd_status": false } ] } }