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