Требования к XML-фиду для новостроек
Общая информация об объявлении
У элемента offer
есть обязательный атрибут internal-id
, который должен быть уникальным для каждого объявления. Internal-id
может состоять из цифр, латинских и кириллических букв, знаков. Мы рекомендуем заполнять его номером из вашей базы данных.
<offer internal-id="А1245">
...
</offer>
Элемент | Обязательный элемент | Описание |
---|---|---|
type | Тип сделки. Строго ограниченные значения: «продажа». | |
property-type | Тип недвижимости. Строго ограниченное значение: «жилая». | |
category | Категория объекта. Возможные значения:
| |
url | URL страницы с объявлением. | |
creation-date | Дата создания объявления. Указывается в формате Внимание. Следите за актуальностью объявлений в фидах и удаляйте объекты, которые уже сданы или проданы. Модерация может заблокировать фид, в котором есть устаревшие объявления. | |
location | Набор элементов, описывающих местоположение объекта. | |
country | Страна, в которой расположен объект. Примечание. В настоящее время объявления принимаются только для объектов недвижимости, расположенных в России. | |
region | Название субъекта РФ. Необязательный элемент для объектов в Москве и Санкт-Петербурге. | |
district | Название района субъекта РФ. | |
locality-name | Название населенного пункта. | |
sub-locality-name | Район населенного пункта. | |
address | Улица и номер дома. Номер дома необязательно указывать для загородной недвижимости. | |
direction | Шоссе. Элемент передается только для объектов в Москве и Московской области. | |
distance | Расстояние по шоссе до МКАД. Значение указывается в километрах. Элемент передается только для объектов в Москве и Московской области. | |
latitude | Географическая широта. | |
longitude | Географическая долгота. | |
metro | Ближайшая станция метро. Если станций несколько, каждая должна быть указана в отдельном элементе. Во вложенных тегах указывается подробная информация. | |
name | Название станции метро. | |
time-on-transport | Время до метро в минутах на транспорте. | |
time-on-foot | Время до метро в минутах пешком. | |
railway-station | Ближайшая железнодорожная станция. Элемент указывается только для загородной недвижимости. | |
village-name | Название коттеджного посёлка. Только для загородной недвижимости. | |
yandex-village-id | Идентификатор коттеджного поселка в базе данных Яндекса. Элемент нужен, чтобы объявления подгружались к правильному коттеджному посёлку. Только для загородной недвижимости. Перечень yandex-village-id – https://realty.ya.ru/export/villages.tsv | |
vas | Дополнительная услуга по продвижению объявления. Элемент указывается, если к объявлению должна быть применена дополнительная услуга. Возможные значения:
Для значения «raise» (опция «Поднятие») можно применить ежедневное автоподключение в определенное время. Для этого внутри Пример:
Обновлять атрибут не нужно. Объявление, к которому применена услуга, будет подниматься ежедневно в указанное время. Можно задать расписание включения «Поднятия» добавив элемент Возможные значения:
Пример: В примере автоподнятие будет происходить каждый день в 12:00 и в 15:00 часов, а в выходные еще и в 18:00 часов с 17 июля. +3:00 — это часовой пояс Москвы. |
Элемент | Обязательный элемент | Описание |
---|---|---|
type | Тип сделки. Строго ограниченные значения: «продажа». | |
property-type | Тип недвижимости. Строго ограниченное значение: «жилая». | |
category | Категория объекта. Возможные значения:
| |
url | URL страницы с объявлением. | |
creation-date | Дата создания объявления. Указывается в формате Внимание. Следите за актуальностью объявлений в фидах и удаляйте объекты, которые уже сданы или проданы. Модерация может заблокировать фид, в котором есть устаревшие объявления. | |
location | Набор элементов, описывающих местоположение объекта. | |
country | Страна, в которой расположен объект. Примечание. В настоящее время объявления принимаются только для объектов недвижимости, расположенных в России. | |
region | Название субъекта РФ. Необязательный элемент для объектов в Москве и Санкт-Петербурге. | |
district | Название района субъекта РФ. | |
locality-name | Название населенного пункта. | |
sub-locality-name | Район населенного пункта. | |
address | Улица и номер дома. Номер дома необязательно указывать для загородной недвижимости. | |
direction | Шоссе. Элемент передается только для объектов в Москве и Московской области. | |
distance | Расстояние по шоссе до МКАД. Значение указывается в километрах. Элемент передается только для объектов в Москве и Московской области. | |
latitude | Географическая широта. | |
longitude | Географическая долгота. | |
metro | Ближайшая станция метро. Если станций несколько, каждая должна быть указана в отдельном элементе. Во вложенных тегах указывается подробная информация. | |
name | Название станции метро. | |
time-on-transport | Время до метро в минутах на транспорте. | |
time-on-foot | Время до метро в минутах пешком. | |
railway-station | Ближайшая железнодорожная станция. Элемент указывается только для загородной недвижимости. | |
village-name | Название коттеджного посёлка. Только для загородной недвижимости. | |
yandex-village-id | Идентификатор коттеджного поселка в базе данных Яндекса. Элемент нужен, чтобы объявления подгружались к правильному коттеджному посёлку. Только для загородной недвижимости. Перечень yandex-village-id – https://realty.ya.ru/export/villages.tsv | |
vas | Дополнительная услуга по продвижению объявления. Элемент указывается, если к объявлению должна быть применена дополнительная услуга. Возможные значения:
Для значения «raise» (опция «Поднятие») можно применить ежедневное автоподключение в определенное время. Для этого внутри Пример:
Обновлять атрибут не нужно. Объявление, к которому применена услуга, будет подниматься ежедневно в указанное время. Можно задать расписание включения «Поднятия» добавив элемент Возможные значения:
Пример: В примере автоподнятие будет происходить каждый день в 12:00 и в 15:00 часов, а в выходные еще и в 18:00 часов с 17 июля. +3:00 — это часовой пояс Москвы. |
В зависимости от типа недвижимости обязательны разные параметры, описывающие адрес.
Для городской недвижимости обязательны следующие параметры:
district
(обязателен для городов, находящихся в областях субъектов РФ);locality-name
(название населенного пункта);address
(улица или улица и дом).
Для загородной недвижимости обязательны следующие поля:
district
(район субъекта РФ)или
locality-name
(название населенного пункта).
<location>
<country>Россия</country>
<region>Московская область</region>
<district>Одинцовский район</district>
<locality-name>Одинцово</locality-name>
<sub-locality-name>Центральный</sub-locality-name>
<address>Пушкинская ул., д. 12</address>
<direction>Минское шоссе</direction>
</location>
<location>
<country>Россия</country>
<locality-name>Санкт-Петербург</locality-name>
<sub-locality-name>Адмиралтейский</sub-locality-name>
<address>Измайловский пр., 16</address>
<metro>
<name>Технологический институт</name>
<time-on-foot>10</time-on-foot>
<time-on-transport>5</time-on-transport>
</metro>
</location>
<location>
<country>Россия</country>
<region>Московская область</region>
<district>Истринский район</district>
<locality-name>деревня Подушкино</locality-name>
<direction>Рублево-Успенское шоссе</direction>
<distance>10</distance>
</location>
<address>
и координатами:
<location>
<address>Москва, Садовническая улица, 82с2</address>
<latitude>55.735525</latitude>
<longitude>37.642474</longitude>
</location>
Информация о продавце
Элемент | Обязательный элемент | Описание |
---|---|---|
sales-agent | Информация о продавце. Во вложенных тегах указывается подробная информация. | |
name | Имя продавца, арендодателя или агента. | |
phone | Номер телефона. Должен начинаться с «+7», номера с «880» не подходят. Пример:
Если номеров несколько, каждый из них необходимо передавать в отдельном элементе Примечание. Для агентств недвижимости обязательно должны быть указаны прямые номера агентов. | |
category | Тип продавца. Строго ограниченные значения:
| |
organization | Название организации. | |
url | Сайт агентства или застройщика. | |
email | Электронный адрес продавца. | |
photo | Ссылка на фотографию агента или логотип компании. Примечание. Скачивание URL возможно только по 80 и 443 портам. |
Элемент | Обязательный элемент | Описание |
---|---|---|
sales-agent | Информация о продавце. Во вложенных тегах указывается подробная информация. | |
name | Имя продавца, арендодателя или агента. | |
phone | Номер телефона. Должен начинаться с «+7», номера с «880» не подходят. Пример:
Если номеров несколько, каждый из них необходимо передавать в отдельном элементе Примечание. Для агентств недвижимости обязательно должны быть указаны прямые номера агентов. | |
category | Тип продавца. Строго ограниченные значения:
| |
organization | Название организации. | |
url | Сайт агентства или застройщика. | |
email | Электронный адрес продавца. | |
photo | Ссылка на фотографию агента или логотип компании. Примечание. Скачивание URL возможно только по 80 и 443 портам. |
Информация об условиях сделки
Элемент | Обязательный элемент | Описание |
---|---|---|
deal-status | Тип сделки. Возможные значения:
«первичная продажа»/«продажа от застройщика».
«прямая продажа».
«переуступка»/«reassignment».
| |
price | Набор элементов, описывающих цену объекта. | |
value | Цена. Сумма указывается без пробелов. Цена должна включать НДС (если он есть) и постоянные эксплуатационные расходы (для коммерческой недвижимости). | |
currency | Валюта, в которой указана цена. Цену предложения следует передавать только в той валюте, которая указана в объявлении. Возможные значения:
| |
unit | Единица площади помещения. Параметр нужно передавать, если цена указана за единицу площади. Возможные значения: «кв. м»/«sq. m». | |
discount | Набор элементов, описывающих скидку. Примечание. Скидка показывается в объявлениях и на карточках ЖК, доступна только для владельцев Карточки PRO. | |
final-price | Финальная цена со скидкой. Это конечная цена в рублях – строго положительная и не больше первоначальной стоимости (без скидки). В ином случае, скидка не будет отображаться на сервисе. | |
end-date | Дата окончания скидки в формате ISO 8601: YYYY-MM-DDTHH:MM |
Элемент | Обязательный элемент | Описание |
---|---|---|
deal-status | Тип сделки. Возможные значения:
«первичная продажа»/«продажа от застройщика».
«прямая продажа».
«переуступка»/«reassignment».
| |
price | Набор элементов, описывающих цену объекта. | |
value | Цена. Сумма указывается без пробелов. Цена должна включать НДС (если он есть) и постоянные эксплуатационные расходы (для коммерческой недвижимости). | |
currency | Валюта, в которой указана цена. Цену предложения следует передавать только в той валюте, которая указана в объявлении. Возможные значения:
| |
unit | Единица площади помещения. Параметр нужно передавать, если цена указана за единицу площади. Возможные значения: «кв. м»/«sq. m». | |
discount | Набор элементов, описывающих скидку. Примечание. Скидка показывается в объявлениях и на карточках ЖК, доступна только для владельцев Карточки PRO. | |
final-price | Финальная цена со скидкой. Это конечная цена в рублях – строго положительная и не больше первоначальной стоимости (без скидки). В ином случае, скидка не будет отображаться на сервисе. | |
end-date | Дата окончания скидки в формате ISO 8601: YYYY-MM-DDTHH:MM |
<price>
<value>4000000</value>
<currency>RUR</currency>
</price>
<price>
<value>60000</value>
<currency>RUB</currency>
<unit>кв. м</unit>
</price>
<discount>
<final-price>7449000</final-price>
<end-date>2023-10-25T15:00:00+03:00</end-date>
</discount>
Информация об объекте
Элемент | Обязательный элемент | Описание |
---|---|---|
image | Фотография объекта и планировки. Можно передавать несколько элементов. В первом элементе Фотографии планировки следует передавать с атрибутом Внимание. В качестве разделителя в значении атрибута используется пробел:
Если фотографий с атрибутом Если таких фотографий нет, то фотография для изображения планировки определяется автоматически. Фотографию с планом этажа также следует передавать с атрибутом Не следует передавать изображения, не имеющие прямого отношения к объекту (например, логотипы или фотографии сотрудников). Примечание. Скачивание URL возможно только по 80 и 443 портам. | |
is-image-order-change-allowed | «Умные фотографии». Алгоритм выберет самые удачные фотографии и покажет их первыми. Это изменит порядок снимков в объявлении. Возможные значения:
| |
area | Общая площадь. Значение и единица измерения площади передаются во вложенных тэгах: | |
value | Площадь. Указывается числовое значение. | |
unit | Единица площади помещения. Элемент используется, если цена указана за единицу площади. Возможные значения: «кв. м»/«sq. m». | |
living-space | Жилая площадь. Во вложенных тегах указывается подробная информация. | |
room-space | Площадь комнаты. Количество передаваемых элементов должно соответствовать количеству комнат. Во вложенных тегах указывается подробная информация. Элемент не используется для студий. | |
kitchen-space | Площадь кухни. | |
renovation | Ремонт. Возможные значения:
| |
description | Дополнительная информация. Описание в свободной форме. Ограничение – 10 000 знаков. | |
video-review | Видео объекта с YouTube и возможность онлайн-показа.
Примечание. Cсылка должна быть без параметра таймкода, например &t=2s . Пример: | |
virtual-tour | 3D-тур.
Примечание. Для туров через iframe есть дополнительные требования: на странице с туром должен быть только он, без дополнительных html-элементов, типа шапки, подвала, ссылок, баннеров, меню и проч.
|
Элемент | Обязательный элемент | Описание |
---|---|---|
image | Фотография объекта и планировки. Можно передавать несколько элементов. В первом элементе Фотографии планировки следует передавать с атрибутом Внимание. В качестве разделителя в значении атрибута используется пробел:
Если фотографий с атрибутом Если таких фотографий нет, то фотография для изображения планировки определяется автоматически. Фотографию с планом этажа также следует передавать с атрибутом Не следует передавать изображения, не имеющие прямого отношения к объекту (например, логотипы или фотографии сотрудников). Примечание. Скачивание URL возможно только по 80 и 443 портам. | |
is-image-order-change-allowed | «Умные фотографии». Алгоритм выберет самые удачные фотографии и покажет их первыми. Это изменит порядок снимков в объявлении. Возможные значения:
| |
area | Общая площадь. Значение и единица измерения площади передаются во вложенных тэгах: | |
value | Площадь. Указывается числовое значение. | |
unit | Единица площади помещения. Элемент используется, если цена указана за единицу площади. Возможные значения: «кв. м»/«sq. m». | |
living-space | Жилая площадь. Во вложенных тегах указывается подробная информация. | |
room-space | Площадь комнаты. Количество передаваемых элементов должно соответствовать количеству комнат. Во вложенных тегах указывается подробная информация. Элемент не используется для студий. | |
kitchen-space | Площадь кухни. | |
renovation | Ремонт. Возможные значения:
| |
description | Дополнительная информация. Описание в свободной форме. Ограничение – 10 000 знаков. | |
video-review | Видео объекта с YouTube и возможность онлайн-показа.
Примечание. Cсылка должна быть без параметра таймкода, например &t=2s . Пример: | |
virtual-tour | 3D-тур.
Примечание. Для туров через iframe есть дополнительные требования: на странице с туром должен быть только он, без дополнительных html-элементов, типа шапки, подвала, ссылок, баннеров, меню и проч.
|
<area>
<value>56</value>
<unit>кв. м</unit>
</area>
<living-space>
<value>36</value>
<unit>кв. м</unit>
</living-space>
<room-space>
<value>20</value>
<unit>кв. м</unit>
</room-space>
<room-space>
<value>16</value>
<unit>кв. м</unit>
</room-space>
<kitchen-space>
<value>8</value>
<unit>кв. м</unit>
</kitchen-space>
Описание жилого помещения
Элемент | Обязательный элемент | Описание |
---|---|---|
new-flat | Признак новостройки. Строго ограниченные значения: «да», «true», «1», «+». | |
floor | Этаж. Обязательный элемент для агентств недвижимости. | |
rooms | Общее количество комнат в квартире. При свободной планировке количество комнат указывается согласно паспорту объекта. Элемент не используется для студий. | |
rooms-type | Тип комнат. Возможные значения:
| |
apartments | Апартаменты. Строго ограниченные значения:
| |
studio | Студия. Строго ограниченные значения: «да», «true», «1», «+». Элемент не используется для объектов со свободной планировкой. | |
open-plan | Свободная планировка. Строго ограниченные значения: «да», «true», «1», «+». Элемент не используется для студий. | |
balcony | Тип балкона. Возможные значения:
И т. п. | |
window-view | Вид из окон. Возможные значения:
| |
floor-covering | Покрытие пола. Возможные значения:
| |
bathroom-unit | Тип санузла. Возможные значения:
|
Элемент | Обязательный элемент | Описание |
---|---|---|
new-flat | Признак новостройки. Строго ограниченные значения: «да», «true», «1», «+». | |
floor | Этаж. Обязательный элемент для агентств недвижимости. | |
rooms | Общее количество комнат в квартире. При свободной планировке количество комнат указывается согласно паспорту объекта. Элемент не используется для студий. | |
rooms-type | Тип комнат. Возможные значения:
| |
apartments | Апартаменты. Строго ограниченные значения:
| |
studio | Студия. Строго ограниченные значения: «да», «true», «1», «+». Элемент не используется для объектов со свободной планировкой. | |
open-plan | Свободная планировка. Строго ограниченные значения: «да», «true», «1», «+». Элемент не используется для студий. | |
balcony | Тип балкона. Возможные значения:
И т. п. | |
window-view | Вид из окон. Возможные значения:
| |
floor-covering | Покрытие пола. Возможные значения:
| |
bathroom-unit | Тип санузла. Возможные значения:
|
Описание здания
Элемент | Обязательный элемент | Описание |
---|---|---|
floors-total | Общее количество этажей в доме. | |
building-name | Название жилого комплекса. Передавать нужно только название ЖК. Пример: | |
yandex-building-id | Идентификатор жилого комплекса в базе Яндекса. Нужен чтобы объявления соответствовали правильному корпусу в ЖК. Указан в третьем столбце списка yandex-building-id. Будет виден в URL карточки вашего ЖК. | |
yandex-house-id | Идентификатор корпуса жилого комплекса в базе Яндекса. Нужен чтобы объявления соответствовали правильному корпусу в ЖК. Указан в седьмом столбце списка yandex-building-id. | |
building-state | Стадия строительства дома. Строго ограниченные значения:
Если значения | |
built-year | Год сдачи (год постройки). Обязательный элемент для домов (жилищных комплексов), которые были сданы менее 5 лет назад или будут сданы в будущем. Год необходимо указывать полностью, например — «1996», а не «96». | |
ready-quarter | Квартал сдачи дома. Строго ограниченные значения: «1», «2», «3», «4». | |
building-phase | Очередь строительства. Возможные значения: «очередь 1», «II очередь», «3» и т. п. | |
building-type | Тип дома. Возможные значения:
| |
building-series | Серия дома. | |
building-section | Корпус дома. Возможные значения: «корпус 1», «корпус А», «дом 3» и т. п. | |
ceiling-height | Высота потолков в метрах. | |
lift | Наличие лифта. Строго ограниченные значения:
| |
rubbish-chute | Наличие мусоропровода. Строго ограниченные значения:
| |
guarded-building | Закрытая территория. Строго ограниченные значения:
| |
parking | Наличие охраняемой парковки. Строго ограниченные значения:
| |
is-elite | Элитная недвижимость. Строго ограниченные значения:
|
Элемент | Обязательный элемент | Описание |
---|---|---|
floors-total | Общее количество этажей в доме. | |
building-name | Название жилого комплекса. Передавать нужно только название ЖК. Пример: | |
yandex-building-id | Идентификатор жилого комплекса в базе Яндекса. Нужен чтобы объявления соответствовали правильному корпусу в ЖК. Указан в третьем столбце списка yandex-building-id. Будет виден в URL карточки вашего ЖК. | |
yandex-house-id | Идентификатор корпуса жилого комплекса в базе Яндекса. Нужен чтобы объявления соответствовали правильному корпусу в ЖК. Указан в седьмом столбце списка yandex-building-id. | |
building-state | Стадия строительства дома. Строго ограниченные значения:
Если значения | |
built-year | Год сдачи (год постройки). Обязательный элемент для домов (жилищных комплексов), которые были сданы менее 5 лет назад или будут сданы в будущем. Год необходимо указывать полностью, например — «1996», а не «96». | |
ready-quarter | Квартал сдачи дома. Строго ограниченные значения: «1», «2», «3», «4». | |
building-phase | Очередь строительства. Возможные значения: «очередь 1», «II очередь», «3» и т. п. | |
building-type | Тип дома. Возможные значения:
| |
building-series | Серия дома. | |
building-section | Корпус дома. Возможные значения: «корпус 1», «корпус А», «дом 3» и т. п. | |
ceiling-height | Высота потолков в метрах. | |
lift | Наличие лифта. Строго ограниченные значения:
| |
rubbish-chute | Наличие мусоропровода. Строго ограниченные значения:
| |
guarded-building | Закрытая территория. Строго ограниченные значения:
| |
parking | Наличие охраняемой парковки. Строго ограниченные значения:
| |
is-elite | Элитная недвижимость. Строго ограниченные значения:
|
Пример корректного YRL-файла
<?xml version="1.0" encoding="UTF-8"?>
<realty-feed xmlns="http://webmaster.yandex.ru/schemas/feed/realty/2010-06">
<generation-date>2015-04-11T12:00:00+04:00</generation-date>
<offer internal-id="15782295">
<type>продажа</type>
<property-type>жилая</property-type>
<category>квартира</category>
<creation-date>2015-04-02T19:00:06+03:00</creation-date>
<location>
<country>Россия</country>
<locality-name>Санкт-Петербург</locality-name>
<address>18-я линия В.О., 32</address>
<metro>
<name>Василеостровская</name>
</metro>
</location>
<deal-status>первичная продажа</deal-status>
<price>
<value>4780000</value>
<currency>RUR</currency>
</price>
<sales-agent>
<phone>+7812500400</phone>
<organization>ЗАО "Застройщик"</organization>
<url>http://www.developer.ru/</url>
<category>developer</category>
<photo>http://www.developer.ru/company/logo</photo>
</sales-agent>
<rooms>2</rooms>
<new-flat>1</new-flat>
<bathroom-unit>раздельный</bathroom-unit>
<balcony>балкон</balcony>
<floor>13</floor>
<floors-total>15</floors-total>
<building-name>Северная фантазия</building-name>
<yandex-building-id>12345</yandex-building-id>
<yandex-house-id>54321</yandex-house-id>
<building-section>Корпус 1</building-section>
<building-state>unfinished</building-state>
<ready-quarter>3</ready-quarter>
<built-year>2018</built-year>
<building-phase>3</building-phase>
<image>http://www.developer.ru/images/plans/000001289.jpg</image>
<description>Продается 2 к. кв., 13 этаж, 15 минут на машине до метро "Василеостровская". Дом комфорт-класса с продуманными планировочными решениями и широким выбором квартир. Внутренний двор «Северной фантазии» выполнен по эксклюзивному дизайн-проекту. В районе постройки нового ЖК развита инфраструктура: школы и детские сады, больница, аптеки магазины, кафе и спортивные центры. Доступны разные условия ипотеки, скидки и зачет жилья.</description>
<area>
<value>63.00</value>
<unit>кв. м</unit>
</area>
<living-space>
<value>50.00</value>
<unit>кв. м</unit>
</living-space>
<kitchen-space>
<value>10.00</value>
<unit>кв. м</unit>
</kitchen-space>
<room-space>
<value>15</value>
<unit>кв. м</unit>
</room-space>
<room-space>
<value>35</value>
<unit>кв. м</unit>
</room-space>
</offer>
</realty-feed>