Список объектов недвижимости

Элемент

Обязательный элемент

Описание

url

Да

URL страницы с объявлением на вашем сайте. Должен быть первым элементом внутри offer.

type

Да

Тип сделки. Строго ограниченные значения:

• «продажа»;
• «аренда».

category

Да

Категория объекта. Возможные значения:

• «дача»/«коттедж»/«cottage»;
• «дом»/«house»;
• «дом с участком»/«house with lot»;
• «участок»/«lot»;
• «часть дома»;
• «квартира»/«flat»;
• «комната»/«room»;
• «гараж»/«garage».

garagetype

Нет

Категория гаража. Обязательный элемент для объявлений о продаже и аренде гаражей.

Возможные значения:

• «гараж»/«garage»;
• «машиноместо»/«parking place»;
• «бокс»/«box».

location

Да

Внутри location передаются элементы о расположении объекта:

<location>
<address>
<latitude>
<longitude>
<apartment>
</location>

address

Да

Адрес объекта — улица и номер здания. Передается внутри location.

apartment

Нет

Номер квартиры. Передается внутри location .

latitude

Нет

Географическая широта. Передается внутри location . Можно узнать на Яндекс Картах.

longitude

Нет

Географическая долгота. Передается внутри location . Можно узнать на Яндекс Картах.

Элемент

Обязательный элемент

Описание

sales-agent

Нет

Информация о продавце или арендодателе. Во вложенных тегах передается подробная информация:

<sales-agent>
<name>
<phone>
<category>
</sales-agent>

name

Нет

Имя продавца, арендодателя или агента.

phone

Нет

Номер телефона. Должен начинаться с +7, номера с 880 не подходят. Пример: <phone>+74951234567</phone>.

Если номеров несколько, каждый из них необходимо передавать в отдельном элементе phone.

category

Нет

Тип продавца или арендодателя. Строго ограниченные значения:

• «владелец»/«owner»;
• «агентство»/«agency»/«рекламное агентство»;
• «застройщик»/«developer»;
• «агент»/«agent»;
• «частный агент»/«private agent».

Элемент

Обязательный элемент

Описание

price

Да

Набор элементов, описывающих цену объекта.

Аренда

<price> 
<value>30000</value>
<currency>RUB</currency>
<period>месяц</period> 
</price>  

Продажа

<price>
<value>5000000</value>
<currency>RUB</currency>
</price>

Можно указывать цену за единицу площади. Для этого добавьте в цену unit.

value

Да

Цена. Введите без пробелов.

Пример: <value>30000.55</value>.

currency

Да

Валюта, в которой указана цена. Возможные значения: RUR или RUB (российский рубль).

period

Нет

Период для расчета стоимости аренды. Обязательный для аренды. Не указывайте для продажи.

unit

Нет

Единица площади помещения или участка. Нужна только, если цена (value) указана за единицу площади. Указывается внутри price.

min-rentperiod

Нет

Минимальный период аренды.

rentdeposit

Нет

Депозит

pricehistory

Нет

История изменения цены. Может быть несколько элементов. Цена (по структуре аналогично полю price) и временной период изменения (в формате ISO 8601) передаются во вложенных тегах:

<price-history>
<price>
<timestamp>
</price-history>

Элемент

Обязательный элемент

Описание

dealstatus

Да

Тип сделки. Возможные значения:

• «214фз»/«фз 214»/«214 фз»/«фз214»/«214»/«по 214 фз»;
• «продажа от застройщика»/«primary»;
• «primary sale of secondary»/«первичная продажа вторички»;
• «встречка»/«в.п.»/«в/п»/«вп»/«в-п»/«встречная продажа»;
• «переуступка»;
• «прямая»/«п-п»/«прямая продажа»/«п.п.»/«п. п.»/«п/п»/«пп»;
• «прямая аренда»/«direct rent»;
• «субаренда»/«subrent»;
• «продажа права аренды»/«sale of lease rights».

agent-fee

Нет

Комиссия агента. Укажите число в процентах, но без знака %.

utilitiesfee

Нет

Коммунальные услуги. Строго ограниченные значения:

• «included»;
• «not_included»;
• «meter».

Элемент

Обязательный элемент

Описание

area

Да

Общая площадь. Значение и единица измерения площади передаются во вложенных тегах:

<area>
<value>
<unit>
</area>

apartmentarea

Нет

Площадь апартаментов. Значение и единица измерения площади передаются во вложенных тегах:

<apartment-area>
<value>
<unit>
</apartment-area>

roomspace

Нет

Площадь комнаты. Для каждой комнаты нужно передать отдельный roomspace. Значение и единица измерения площади передаются во вложенных тегах:

<room-space>
<value>
<unit>
</room-space>

livingspace

Нет

Жилая площадь. При продаже и сдаче комнаты укажите площадь этой комнаты, а не всей квартиры. Значение и единица измерения площади передаются во вложенных тегах:

<living-space>
<value>
<unit>
</living-space>

kitchenspace

Нет

Площадь кухни. Значение и единица измерения площади передаются во вложенных тегах:

<kitchen-space>
<value>
<unit>
</kitchen-space>

lot-area

Нет

Площадь участка . Указывается для категорий: дом с участком и участок. Значение и единица измерения площади передаются во вложенных тегах:

<lot-area>
<value>
<unit>
</lot-area>

value

Да

Площадь. Указывается числовое значение. Дробные значения указываются через точку. Пример: <value>80.50</value>.

unit

Нет

Единица площади помещения или участка. Элемент используется, если цена указана за единицу площади.

house-type

Нет

Тип дома. Возможные значения:

• «дом»/«house»;
• «таунхаус»/«townhouse»;
• «дуплекс»/«duplex»;
• «часть дома»/«parthouse».

lot-type

Нет

Тип участка. Возможные значения:

• «индивидуальное жилищное строительство»/«ижс»/«igs»;
• «садоводство»/«garden»;
• «коммерческий»/«commercial»;
• «farm»/«фер»/«фермерский»/«ферма».

image

Да

Фотография. Может быть несколько тегов. Фотографии планировок следует передавать первым тегом image.

Не следует передавать изображения, не имеющие прямого отношения к объекту (например, логотипы или фотографии сотрудников).

description

Нет

Дополнительная информация. Описание в свободной форме. Ограничение – 10 000 знаков.

Элемент

Обязательный элемент

Описание

rooms

Нет

Общее количество комнат в квартире. При свободной планировке укажите количество комнат по паспорту объекта. Не обязательно для частных домов. Не указывайте для студий.

rooms-offered

Нет

Количество комнат, участвующих в сделке. Указывайте только при продаже или сдаче комнаты. Не используйте для студий и квартир со свободной планировкой.

floor

Нет

Этажи, на которых находится объект.

apartments

Нет

Апартаменты. Строго ограниченные значения:

• «да»/«нет»;
• «true»/«false»;
• «1»/«0»;
• «+»/«-».

studio

Нет

Студия. Строго ограниченные значения:

• «да»/«нет»;
• «true»/«false»;
• «1»/«0»;
• «+»/«-».

layout-type

Нет

Тип комнат. Возможные значения:

• «смежные»;
• «раздельные».

balcony

Нет

Тип балкона. Возможные значения:

• «балкон»;
• «лоджия»;
• «2 балкона»;
• «2 лоджии»;
• и т. п.

decoration-type

Нет

Тип отделки. Возможные значения:

• «rough»/«черновая»;
• «clean»/«чистовая»;
• «turnkey»/«под ключ»;
• «pre_clean»/«предчистовая»;
• «white_box»/«белый короб»;
• «no_decoration»/«без отделки»;
• и т. п.

renovation

Нет

Тип ремонта. Возможные значения:

• «евроремонт»;
• «косметический»;
• «дизайнерский»;
• «требует ремонта».

bathroom-unit

Нет

Тип санузла. Возможные значения:

• «совмещенный»;
• «раздельный»;
• числовое значение (например, «2»).

air-conditioner

Нет

Наличие системы кондиционирования. Строго ограниченные значения:

• «да»/«нет»;
• «true»/«false»;
• «1»/«0»;
• «+»/«-».

phone

Нет

Наличие телефона. Строго ограниченные значения:

• «да»/«нет»;
• «true»/«false»;
• «1»/«0»;
• «+»/«-».

internet

Нет

Наличие интернета. Строго ограниченные значения:

• «да»/«нет»;
• «true»/«false»;
• «1»/«0»;
• «+»/«-».

no-furniture

Нет

Отсутствие мебели. Строго ограниченные значения:

• «да»/«нет»;
• «true»/«false»;
• «1»/«0»;
• «+»/«-».

room-furniture

Нет

Наличие мебели. Строго ограниченные значения:

• «да»/«нет»;
• «true»/«false»;
• «1»/«0»;
• «+»/«-».

kitchen-furniture

Нет

Наличие мебели на кухне. Строго ограниченные значения:

• «да»/«нет»;
• «true»/«false»;
• «1»/«0»;
• «+»/«-».

television

Нет

Наличие телевизора. Строго ограниченные значения:

• «да»/«нет»;
• «true»/«false»;
• «1»/«0»;
• «+»/«-».

washing-machine

Нет

Наличие стиральной машины. Строго ограниченные значения:

• «да»/«нет»;
• «true»/«false»;
• «1»/«0»;
• «+»/«-».

dishwasher

Нет

Наличие посудомоечной машины. Строго ограниченные значения:

• «да»/«нет»;
• «true»/«false».

refrigerator

Нет

Наличие холодильника. Строго ограниченные значения:

• «да»/«нет»;
• «true»/«false»;
• «1»/«0»;
• «+»/«-».

built-in-tech

Нет

Встроенная техника. Строго ограниченные значения:

• «да»/«нет»;
• «true»/«false»;
• «1»/«0»;
• «+»/«-».

adding-phoneon-request

Нет

Телефон по запросу. Строго ограниченные значения:

• «да»/«нет»;
• «true»/«false»;
• «1»/«0»;
• «+»/«-».

self-selectiontelecom

Нет

Выбор провайдера. Строго ограниченные значения:

• «да»/«нет»;
• «true»/«false»;
• «1»/«0»;
• «+»/«-».

ventilation

Нет

Вентиляция. Строго ограниченные значения:

• «да»/«нет»;
• «true»/«false»;
• «1»/«0»;
• «+»/«-».

fire-alarm

Нет

Пожарная сигнализация. Строго ограниченные значения:

• «да»/«нет»;
• «true»/«false»;
• «1»/«0»;
• «+»/«-».

responsiblestorage

Нет

Организованное хранение. Строго ограниченные значения:

• «да»/«нет»;
• «true»/«false»;
• «1»/«0»;
• «+»/«-».

with-children

Нет

Проживание с детьми. Строго ограниченные значения:

• «да»/«нет»;
• «true»/«false»;
• «1»/«0»;
• «+»/«-».

with-pets

Нет

Проживание с животными. Строго ограниченные значения:

• «да»/«нет»;
• «true»/«false»;
• «1»/«0»;
• «+»/«-».

Элемент

Обязательный элемент

Описание

floors-total

Нет

Общее количество этажей в доме.

building-name

Нет

Название жилого комплекса.

yandexbuilding-id

Нет

Идентификатор жилого комплекса в базе Яндекса. Нужен чтобы объявления соответствовали правильному корпусу в ЖК. Указан в третьем столбце списка yandex-buildingid. Будет виден в URL карточки вашего ЖК.

yandexhouse-id

Нет

Идентификатор корпуса жилого комплекса в базе Яндекса. Нужен чтобы объявления соответствовали правильному корпусу в ЖК. Указан в седьмом столбце списка yandex-buildingid.

externalnewbuilding-id

Нет

Идентификатор жилого комплекса в вашей системе. Передайте строковый идентификатор ЖК из вашей базы данных.

externalbuilding-id

Нет

Идентификатор корпуса жилого комплекса в вашей системе. Передайте числовой идентификатор корпуса ЖК из вашей базы данных.

building-type

Нет

Тип дома. Возможные значения:

• «блочный»;
• «деревянный»;
• «кирпичный»;
• «кирпично-монолитный»;
• «монолит»;
• «панельный»;
• «газобетонный»;
• «газосиликатный»;
• «пенобетонный»;
• «щитовой»;
• «каркасный».

heating-type

Нет

Тип отопления. Возможные значения:

• «central»/«центральное»;
• «autonomous»/«автономное»;
• «coal»/«угольное»;
• «electric»/«электрическое»;
• «fireplace»/«камин»;
• «stove»/«печь»;
• «diesel»/«дизельное»;
• «solid fuel»/«твердотопливное».

built-year

Нет

Год сдачи (год постройки). Год необходимо указывать полностью, например, «1996», а не «96».

ready-quarter

Нет

Квартал сдачи дома. Строго ограниченные значения: «1», «2», «3», «4».

ceiling-height

Нет

Высота потолков в метрах.

guardedbuilding

Нет

Закрытая территория. Строго ограниченные значения:

• «да»/«нет»;
• «true»/«false»;
• «1»/«0»;
• «+»/«-».

accesscontrolsystem

Нет

Наличие пропускной системы. Строго ограниченные значения:

• «да»/«нет»;
• «true»/«false»;
• «1»/«0»;
• «+»/«-».

twenty-fourseven

Нет

Круглосуточный доступ . Строго ограниченные значения:

• «да»/«нет»;
• «true»/«false»;
• «1»/«0»;
• «+»/«-».

eating-facilities

Нет

Общепит в здании. Строго ограниченные значения:

• «да»/«нет»;
• «true»/«false»;
• «1»/«0»;
• «+»/«-».

lift

Нет

Лифт. Строго ограниченные значения:

• «да»/«нет»;
• «true»/«false»;
• «1»/«0»;
• «+»/«-».

rubbish-chute

Нет

Мусоропровод. Строго ограниченные значения:

• «да»/«нет»;
• «true»/«false»;
• «1»/«0»;
• «+»/«-».

electricitysupply

Нет

Электричество. Элемент используется для домов. Строго ограниченные значения:

• «да»/«нет»;
• «true»/«false»;
• «1»/«0»;
• «+»/«-».

water-supply

Нет

Водопровод. Элемент используется для домов. Строго ограниченные значения:

• «да»/«нет»;
• «true»/«false»;
• «1»/«0»;
• «+»/«-».

gas-supply

Нет

Газ. Элемент используется для домов. Строго ограниченные значения:

• «да»/«нет»;
• «true»/«false»;
• «1»/«0»;
• «+»/«-».

seweragesupply

Нет

Канализация. Элемент используется для домов. Строго ограниченные значения:

• «да»/«нет»;
• «true»/«false»;
• «1»/«0»;
• «+»/«-».

heatingsupply

Нет

Отопление. Элемент используется для домов. Строго ограниченные значения:

• «да»/«нет»;
• «true»/«false»;
• «1»/«0»;
• «+»/«-».

toilet-location

Нет

Местонахождение туалета. Элемент используется для домов. Строго ограниченные значения: none/нет.

showerlocation

Нет

Местонахождение ванной. Элемент используется для домов. Строго ограниченные значения:

• «none»/«нет»;
• «inside»/«внутри»;
• «outside»/«снаружи».

kitchen

Нет

Кухня. Элемент используется для домов. Строго ограниченные значения:

• «да»/«нет»;
• «true»/«false»;
• «1»/«0»;
• «+»/«-».

pool

Нет

Бассейн. Элемент используется для домов. Строго ограниченные значения:

• «да»/«нет»;
• «true»/«false»;
• «1»/«0»;
• «+»/«-».

billiard

Нет

Бильярд. Элемент используется для домов. Строго ограниченные значения:

• «да»/«нет»;
• «true»/«false»;
• «1»/«0»;
• «+»/«-».

sauna

Нет

Сауна. Элемент используется для домов. Строго ограниченные значения:

• «да»/«нет»;
• «true»/«false»;
• «1»/«0»;
• «+»/«-».

parking

Нет

Наличие охраняемой парковки. Строго ограниченные значения:

• «да»/«нет»;
• «true»/«false»;
• «1»/«0»;
• «+»/«-».

parking-guest

Нет

Наличие гостевых парковочных мест. Строго ограниченные значения:

• «да»/«нет»;
• «true»/«false»;
• «1»/«0»;
• «+»/«-».

flat-alarm

Нет

Наличие сигнализации в квартире. Строго ограниченные значения:

• «да»/«нет»;
• «true»/«false»;
• «1»/«0»;
• «+»/«-».

security

Нет

Наличие охраны. Строго ограниченные значения:

• «да»/«нет»;
• «true»/«false»;
• «1»/«0»;
• «+»/«-».

is-elite

Нет

Элитная недвижимость. Строго ограниченные значения:

• «да»/«нет»;
• «true»/«false»;
• «1»/«0»;
• «+»/«-».

building-state

Нет

Стадия строительства дома. Строго ограниченные значения:

• «built» (дом построен, но не сдан);
• «hand-over» (сдан в эксплуатацию);
• «unfinished» (строится);
• «construction-suspended» (стройка заморожена);
• «in-project» (на стадии проекта).

Если значения built-year и ready-quarter указаны в прошедшем времени, для элемента building-state следует передавать значение hand-over .

Элемент

Обязательный элемент

Описание

garage-type

Нет

Категория гаража. Обязательный элемент для объявлений о продаже и аренде гаражей. Возможные значения:

• «гараж»/«garage»;
• «машиноместо»/«parking place»;
• «бокс»/«box».

parking-type

Нет

Тип парковки. Элемент используется только для бокса и парковочного места. Возможные значения:

• «подземная»/«underground»;
• «наземная»/«ground»;
• «многоуровневая»/«multilevel».

automaticgates

Нет

Наличие автоматических ворот. Строго ограниченные значения:

• «да»/«нет»;
• «true»/«false»;
• «1»/«0»;
• «+»/«-».

cctv

Нет

Наличие видеонаблюдения. Строго ограниченные значения:

• «да»/«нет»;
• «true»/«false»;
• «1»/«0»;
• «+»/«-».

inspectionpit

Нет

Наличие смотровой ямы. Строго ограниченные значения:

• «да»/«нет»;
• «true»/«false»;
• «1»/«0»;
• «+»/«-».

cellar

Нет

Наличие подвала или погреба. Строго ограниченные значения:

• «да»/«нет»;
• «true»/«false»;
• «1»/«0»;
• «+»/«-».

car-wash

Нет

Наличие автомойки. Строго ограниченные значения:

• «да»/«нет»;
• «true»/«false»;
• «1»/«0»;
• «+»/«-».

auto-repair

Нет

Наличие автосервиса. Строго ограниченные значения:

• «да»/«нет»;
• «true»/«false»;
• «1»/«0»;
• «+»/«-».

Элемент

Обязательный элемент

Описание

creationtime

Нет

Дата и время создания объявления. Передается таймстемп строкой (в формате ISO 8601).

updatetime

Нет

Дата и время последнего обновления объявления. Передается таймстемп строкой (в формате ISO 8601).

Элемент

Обязательный элемент

Описание

virtualtours

Нет

ВВиртуальный тур по объекту.

Может быть несколько элементов.

URL модели и превью передаются во вложенных тегах:

<virtual-tours>
<model-url>
<preview-url>
</virtual-tours>

model-url

Нет

URL 3D-модели виртуального тура. Передается внутри virtual-tours .

preview-url

Нет

URL превью виртуального тура. Передается внутри virtual-tours .