Поиск по объектам недвижимости - табличный вид квартир

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

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