Методы (Methods)
GET Сделки
Метод GET Сделки соответствует типу данных «Сделки из Росреестра» в личном кабинете сервиса API bnMap.pro.
Примечание
Процесс получения персональной ссылки для выгрузки необходимых данных с регионом и токеном описан в одноименном разделе.
Параметры запроса
| Имя | Обязательность | Описание | Значение по умолчанию | Комментарий |
|---|---|---|---|---|
| pbi | Обязательный | Персональный токен доступа | ||
| page | Необязательный | Номер страницы | 1 | Параметр необходим для постраничной выгрузки. Постраничная выгрузка предотвращает зависание браузера. |
Пример запроса
Curl:
curl -X 'GET' \
'https://api.bndev.it/cmap/analytics.json?act=pbi-full-deals&pbi=ТОКЕН&page=1' \
-H 'accept: application/json'
URL:
https://api.bndev.it/cmap/analytics.json?act=pbi-full-deals&pbi=ТОКЕН&page=1
Пример ответа
Ответ сервер передает в формате JSON.
{
"status": "ok",
"content": {
"page": 1,
"per_page": 1000,
"total": "1432647",
"total_pages": 1433,
"data": [
{...},
{...},
...
]
},
"auth": true
}
Список параметров
| Название параметра | Описание | Тип данных | Обязательность |
|---|---|---|---|
| id | ID записи | числовой, целое | Обязательный |
| hc_name | Название проекта | текстовый, до 255 символов | Обязательный |
| hc_id_hash | ID проекта, в котором находится объект проектной декларации со сделкой | текстовый, GUID | Обязательный |
| region_name | Москва/Новая Москва/Московская область | текстовый, до 255 символов | Обязательный |
| loc_area | Административные границы, в которых расположен проект | текстовый, до 255 символов | Необязательный |
| loc_district | Административные границы, в которых расположен проект | текстовый, до 255 символов | Обязательный |
| b_id_hash | ID корпуса, в котором находится объект проектной декларации со сделкой | текстовый, GUID | Обязательный |
| loc_address | Адрес корпуса | текстовый, до 255 символов | Обязательный |
| s_stage | Стадия строительной готовности, актуальная на дату подписания договора | текстовый, до 255 символов | Обязательный |
| date_state_commission | Заявленная дата ввода в эксплатацию, актуальная на дату договора | дата, ГГГГ-MM-ДД | Обязательный |
| b_start_sales | Старт рыночной реализации корпуса | дата, ГГГГ-MM-ДД | Обязательный |
| class | Классификация уровня потребительских предпочтений по корпусу | текстовый, до 255 символов | Обязательный |
| developer | Название компании-девелопера | текстовый, до 255 символов | Обязательный |
| builder | Название юридического лица компании-застройщика | текстовый, до 255 символов | Обязательный |
| agreement_date | Дата договора на основании которого зарегистрировано обременение | дата, ГГГГ-MM-ДД | Обязательный |
| agreement_date_m_y | Месяц и год договора, на основании которого зарегистрировано обременение | дата, MM.ГГГГ | Обязательный |
| agreement_date_q_y | Квартал и год договора, на основании которого зарегистрировано обременение | текстовый, до 255 символов | Обязательный |
| agreement_date_y | Год договора, на основании которого зарегистрировано обременение | дата, ГГГГ | Обязательный |
| reg_date | Дата регистрации договора | дата, ГГГГ-MM-ДД | Обязательный |
| reg_date_m_y | Месяц и год регистрации договора | дата, MM.ГГГГ | Обязательный |
| reg_date_q_y | Квартал и год регистрации договора | текстовый, до 255 символов | Обязательный |
| reg_date_y | Год регистрации договора | дата, ГГГГ | Обязательный |
| registration_number | Номер регистрации договора | текстовый, до 255 символов | Обязательный |
| concession | Тип договора, на основании которого регистрируется обременение - ДДУ (участие) или варианты уступок ДДУ (уступка) | текстовый, до 255 символов | Обязательный |
| pbo_id_hash | ID объекта проектной декларации со сделкой (лот) | текстовый, GUID | Обязательный |
| ot_name | Тип объекта недвижимости, участвующего в сделке | текстовый, до 255 символов | Обязательный |
| object_id | Уникальный номер объекта недвижимости, указанный в ЕГРН | текстовый, до 255 символов | Обязательный |
| pbo_number | Уникальный номер объекта недвижимости, указанный в проектной декларации | текстовый, до 255 символов | Обязательный |
| section | Номер секции, в котором расположен объект недвижимости | текстовый, до 255 символов | Обязательный |
| floor | Этаж, на котором расположен объект недвижимости | текстовый, до 255 символов | Обязательный |
| rooms | Количество комнат в объекте недвижимости, согласно проектной декларации | текстовый, до 255 символов | Обязательный |
| do_square | Площадь объекта недвижимости, согласно ЕГРН | числовой, 2 знака после запятой | Обязательный |
| square | Площадь объекта недвижимости, согласно проектной декларации | числовой, 2 знака после запятой | Обязательный |
| price_square_r | Расчетный параметр цены за 1 кв.м. в сделке | числовой, 2 знака после запятой | Обязательный |
| method_ppsmr | Описание алгоритма определения расчетного значения ценообразования в сделке | текстовый, до 255 символов | Обязательный |
| est_budget | Расчетный параметр бюджета покупки | числовой, 5 знаков после точки | Обязательный |
| discount | Включение условий скидок и акций в расчет ценообразования в сделке | текстовый, до 255 символов | Обязательный |
| discount_desc | Описание скидки/акции на дату подписания договора | текстовый, до 65535 символов | Обязательный |
| interior | Наличие и тип отделки по корпусу, в котором расположен объект недвижимости | текстовый, до 255 символов | Обязательный |
| interior_price | Стоимость отделки по корпусу, в котором расположен объект недвижимости | текстовый, до 255 символов | Обязательный |
| object_desc | Прямое цитирование записи ЕГРН | текстовый, до 65535 символов | Обязательный |
| deals_seller | Тип лица, от которого совершена сделка | текстовый, до 255 символов | Обязательный |
| bt_name | Тип лица, в адрес которого совершена сделка | текстовый, до 255 символов | Обязательный |
| buyer_cnt | Количество лиц в договоре по объекту недвижимости | числовой, целое | Обязательный |
| buyer | Описание лица, правообладателя на текущий момент | текстовый, до 255 символов | Обязательный |
| mortgage | Наличие/отсутствие ипотеки | текстовый, до 255 символов | Обязательный |
| bank_name | Название залогодержателя - банка | текстовый, до 255 символов | Обязательный |
| history | Описание всех лиц - правообладателей в динамике по объекту недвижимости | текстовый, до 255 символов | Обязательный |
| mortgage_term | Количество месяцев обременения у залогодержателя | числовой, целое | Обязательный |
| wholesale | Указание об участии объекта в оптовой сделке | текстовый, до 255 символов | Обязательный |
| document_date | Дата актуальности данных, на которую была заказана выписка из росреестра (фиксируется только значение последнего по дате слоя данных) | дата, ГГГГ-MM-ДД | Обязательный |
| parent_reg_num | Родительский регистрационный номер договора | текстовый, до 255 символов | Обязательный |
| mortgage_type | Тип ипотеки | текстовый, до 255 символов | Обязательный |
| compensation_amount | Сумма списания из КФ | текстовый, до 255 символов | Обязательный |
| ddu_amount | Расчетная сумма ДДУ из КФ | текстовый, до 255 символов | Обязательный |
| do_compensation_square | Площадь из КФ | текстовый, до 255 символов | Обязательный |
| tin | ИНН банка-залогодержателя | текстовый, до 255 символов | Обязательный |
| parent_reg_date | Дата регистрации материнской сделки | дата, ГГГГ-MM-ДД | Обязательный |
| parent_date | Дата договора материнской сделки | дата, ГГГГ-MM-ДД | Обязательный |
| rep_deals_count | Количество повторных сделок | текстовый, до 255 символов | Обязательный |
| first_for_object_date | Дата первого появления в экспозиции | дата, ГГГГ-MM-ДД | Обязательный |
| expo_term | Срок в экспозиции до момента сделки, дней | текстовый, до 255 символов | Обязательный |
| first_price_square_r | Цена 1 кв.м первого появления в экспозиции | текстовый, до 255 символов | Обязательный |
| first_price_r | Бюджет покупки первого появления в экспозиции | текстовый, до 255 символов | Обязательный |
| expo_price_square_rise | Рост цены за 1 кв.м за период экспонирования | текстовый, до 255 символов | Обязательный |
| expo_price_rise | Рост бюджета покупки за период экспонирования | текстовый, до 255 символов | Обязательный |
| rooms_prices_t | Количество комнат в прайс-листе, типология bnmap.pro | текстовый, до 255 символов | Обязательный |