Поиск по объектам недвижимости - Витрина ЖК

Метод используется для общего поиска объектов недвижимости в комплексах по заданным параметрам.

Используемый метод: 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
      }
    ]
  }
}