Требования к XML-фиду для новостроек

Перед подготовкой XML-фида ознакомьтесь с требованиями к передаче данных.

  1. Общая информация об объявлении
  2. Информация о продавце
  3. Информация об условиях сделки
  4. Информация об объекте
  5. Описание жилого помещения
  6. Описание здания
  7. Пример корректного YRL-файла

Общая информация об объявлении

У элемента offer есть обязательный атрибут internal-id, который должен быть уникальным для каждого объявления. Internal-id может состоять из цифр, латинских и кириллических букв, знаков. Мы рекомендуем заполнять его номером из вашей базы данных. 

<offer internal-id="А1245">
 ...
</offer>
Внимание. Элементы со строго ограниченным набором значений могут содержать только перечисленные варианты. Использование других значений приведет к ошибке обработки фида.
Элемент Обязательный элемент Описание
type

Тип сделки.

Строго ограниченные значения: «продажа».
property-type

Тип недвижимости.

Строго ограниченное значение: «жилая».
category

Категория объекта.

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

  • «дом»/«house»
  • «квартира»/«flat»
  • «таунхаус»/«townhouse».
url

URL страницы с объявлением.

creation-date

Дата создания объявления.

Указывается в формате YYYY-MM-DDTHH:mm:ss+00:00.

Внимание. Следите за актуальностью объявлений в фидах и удаляйте объекты, которые уже сданы или проданы. Модерация может заблокировать фид, в котором есть устаревшие объявления.
location

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

<location>     
      <country/>
      <region/>
      <district/>
      <locality-name/>
      …
 </location>
country

Страна, в которой расположен объект.

Примечание. В настоящее время объявления принимаются только для объектов недвижимости, расположенных в России.
region

Название субъекта РФ.

Необязательный элемент для объектов в Москве и Санкт-Петербурге.
district

Название района субъекта РФ.
locality-name

Название населенного пункта.
sub-locality-name

Район населенного пункта.
address

Улица и номер дома.

Номер дома необязательно указывать для загородной недвижимости.
direction

Шоссе.

Элемент передается только для объектов в Москве и Московской области.
distance

Расстояние по шоссе до МКАД.

Значение указывается в километрах.

Элемент передается только для объектов в Москве и Московской области.
latitude

Географическая широта.
longitude

Географическая долгота.
metro

Ближайшая станция метро.

Если станций несколько, каждая должна быть указана в отдельном элементе. Во вложенных тегах указывается подробная информация.

<metro>           
      <name/>
      <time-on-foot/>
      <time-on-transport/>
</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

Дополнительная услуга по продвижению объявления.

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

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

  • «premium»
  • «raise»
  • «promotion».

Для значения «raise» (опция «Поднятие») можно применить ежедневное автоподключение в определенное время.

Для этого внутри vas укажите атрибут start-time, дату и время в формате YYYY-MM-DDTHH:mm:ss+00:00 и значение raise.

Пример: 
<vas start-time="2018-06-04T10:00:00+03:00">raise</vas>

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

Можно задать расписание включения «Поднятия» добавив элемент schedule. Тогда получится выбрать несколько start-time для одного объявления. И даже несколько в один день.

Возможные значения:
  • everyday – каждый день;
  • onlyweekdays — только в будние;
  • onlyweekends — только в выходные.

Пример:

В примере автоподнятие будет происходить каждый день в 12:00 и в 15:00 часов, а в выходные еще и в 18:00 часов с 17 июля. +3:00 — это часовой пояс Москвы. 

<vas start-time="2020-07-17T12:00:00+03:00" schedule="everyday">raise</vas>
<vas start-time="2020-07-17T15:00:00+03:00" schedule="everyday">raise</vas>
<vas start-time="2020-07-17T18:00:00+03:00" schedule="onlyweekends">raise</vas>
Элемент Обязательный элемент Описание
type

Тип сделки.

Строго ограниченные значения: «продажа».
property-type

Тип недвижимости.

Строго ограниченное значение: «жилая».
category

Категория объекта.

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

  • «дом»/«house»
  • «квартира»/«flat»
  • «таунхаус»/«townhouse».
url

URL страницы с объявлением.

creation-date

Дата создания объявления.

Указывается в формате YYYY-MM-DDTHH:mm:ss+00:00.

Внимание. Следите за актуальностью объявлений в фидах и удаляйте объекты, которые уже сданы или проданы. Модерация может заблокировать фид, в котором есть устаревшие объявления.
location

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

<location>     
      <country/>
      <region/>
      <district/>
      <locality-name/>
      …
 </location>
country

Страна, в которой расположен объект.

Примечание. В настоящее время объявления принимаются только для объектов недвижимости, расположенных в России.
region

Название субъекта РФ.

Необязательный элемент для объектов в Москве и Санкт-Петербурге.
district

Название района субъекта РФ.
locality-name

Название населенного пункта.
sub-locality-name

Район населенного пункта.
address

Улица и номер дома.

Номер дома необязательно указывать для загородной недвижимости.
direction

Шоссе.

Элемент передается только для объектов в Москве и Московской области.
distance

Расстояние по шоссе до МКАД.

Значение указывается в километрах.

Элемент передается только для объектов в Москве и Московской области.
latitude

Географическая широта.
longitude

Географическая долгота.
metro

Ближайшая станция метро.

Если станций несколько, каждая должна быть указана в отдельном элементе. Во вложенных тегах указывается подробная информация.

<metro>           
      <name/>
      <time-on-foot/>
      <time-on-transport/>
</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

Дополнительная услуга по продвижению объявления.

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

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

  • «premium»
  • «raise»
  • «promotion».

Для значения «raise» (опция «Поднятие») можно применить ежедневное автоподключение в определенное время.

Для этого внутри vas укажите атрибут start-time, дату и время в формате YYYY-MM-DDTHH:mm:ss+00:00 и значение raise.

Пример: 
<vas start-time="2018-06-04T10:00:00+03:00">raise</vas>

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

Можно задать расписание включения «Поднятия» добавив элемент schedule. Тогда получится выбрать несколько start-time для одного объявления. И даже несколько в один день.

Возможные значения:
  • everyday – каждый день;
  • onlyweekdays — только в будние;
  • onlyweekends — только в выходные.

Пример:

В примере автоподнятие будет происходить каждый день в 12:00 и в 15:00 часов, а в выходные еще и в 18:00 часов с 17 июля. +3:00 — это часовой пояс Москвы. 

<vas start-time="2020-07-17T12:00:00+03:00" schedule="everyday">raise</vas>
<vas start-time="2020-07-17T15:00:00+03:00" schedule="everyday">raise</vas>
<vas start-time="2020-07-17T18:00:00+03:00" schedule="onlyweekends">raise</vas>

В зависимости от типа недвижимости обязательны разные параметры, описывающие адрес.

Для городской недвижимости обязательны следующие параметры:

  • district (обязателен для городов, находящихся в областях субъектов РФ);
  • locality-name (название населенного пункта);
  • address (улица или улица и дом).

Для загородной недвижимости обязательны следующие поля:

  • district (район субъекта РФ)

    или

  • locality-name (название населенного пункта).
Пример использования тегов <region>, <district> и <sub-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>
Пример использования тега <metro> при описании городской недвижимости 
<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>
Пример использования тегов <direction> и <distance> при описании загородной недвижимости (для Московской области) 
<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

Информация о продавце.

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

<sales-agent>
    <name/>
    <phone/>
    <category/>
    <organization/>
    <url/>
    <photo/>
    …
</sales-agent>
name

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

Номер телефона.

Должен начинаться с «+7», номера с «880» не подходят.

Пример: 
<phone>+74951234567</phone>

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

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

Тип продавца.

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

  • «агентство»/«agency»
  • «застройщик»/«developer».
organization

Название организации.
url

Сайт агентства или застройщика.
email

Электронный адрес продавца.
photo

Ссылка на фотографию агента или логотип компании.

Примечание. Скачивание URL возможно только по 80 и 443 портам.
Элемент Обязательный элемент Описание
sales-agent

Информация о продавце.

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

<sales-agent>
    <name/>
    <phone/>
    <category/>
    <organization/>
    <url/>
    <photo/>
    …
</sales-agent>
name

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

Номер телефона.

Должен начинаться с «+7», номера с «880» не подходят.

Пример: 
<phone>+74951234567</phone>

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

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

Тип продавца.

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

  • «агентство»/«agency»
  • «застройщик»/«developer».
organization

Название организации.
url

Сайт агентства или застройщика.
email

Электронный адрес продавца.
photo

Ссылка на фотографию агента или логотип компании.

Примечание. Скачивание URL возможно только по 80 и 443 портам.

Информация об условиях сделки

Элемент Обязательный элемент Описание
deal-status

Тип сделки.

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

  • если объект продаёт застройщик:
«первичная продажа»/«продажа от застройщика». 
<deal-status>первичная продажа</deal-status>
  • Если право собственности на объект принадлежит не застройщику:

«прямая продажа». 

<deal-status>прямая продажа</deal-status>
  • Если объект продаёт частное лицо или агентство, но права собственности ещё нет:
«переуступка»/«reassignment».
<deal-status>переуступка</deal-status>
price

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

<price>
  <value/>
  <currency/>
  <unit/>
  <period/>
</price>
value

Цена.

Сумма указывается без пробелов.

Цена должна включать НДС (если он есть) и постоянные эксплуатационные расходы (для коммерческой недвижимости).
currency

Валюта, в которой указана цена.

Цену предложения следует передавать только в той валюте, которая указана в объявлении.

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

  • «RUR» или «RUB» (российский рубль)
  • «EUR» (евро)
  • «USD» (американский доллар).
unit

Единица площади помещения.

Параметр нужно передавать, если цена указана за единицу площади.

Возможные значения: «кв. м»/«sq. m».

Элемент Обязательный элемент Описание
deal-status

Тип сделки.

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

  • если объект продаёт застройщик:
«первичная продажа»/«продажа от застройщика». 
<deal-status>первичная продажа</deal-status>
  • Если право собственности на объект принадлежит не застройщику:

«прямая продажа». 

<deal-status>прямая продажа</deal-status>
  • Если объект продаёт частное лицо или агентство, но права собственности ещё нет:
«переуступка»/«reassignment».
<deal-status>переуступка</deal-status>
price

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

<price>
  <value/>
  <currency/>
  <unit/>
  <period/>
</price>
value

Цена.

Сумма указывается без пробелов.

Цена должна включать НДС (если он есть) и постоянные эксплуатационные расходы (для коммерческой недвижимости).
currency

Валюта, в которой указана цена.

Цену предложения следует передавать только в той валюте, которая указана в объявлении.

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

  • «RUR» или «RUB» (российский рубль)
  • «EUR» (евро)
  • «USD» (американский доллар).
unit

Единица площади помещения.

Параметр нужно передавать, если цена указана за единицу площади.

Возможные значения: «кв. м»/«sq. m».

Пример передачи данных о цене квартиры 
<price>
    <value>4000000</value>
    <currency>RUR</currency>
</price>
Пример передачи данных о цене 1 кв. м. 
<price>
    <value>60000</value>
    <currency>RUB</currency>
    <unit>кв. м</unit>
</price>

Информация об объекте

Внимание. Элементы со строго ограниченным набором значений могут содержать только перечисленные варианты. Использование других значений приведет к ошибке обработки фида.
Элемент Обязательный элемент Описание
image

Фотография объекта и планировки.

Можно передавать несколько элементов.

В первом элементе image должны быть фотографии планировки.

Фотографии планировки следует передавать с атрибутом tag. Возможные значения атрибута: plan, plan 3d и т. п.

<image tag="plan">
 ...
</image>
Внимание. В качестве разделителя в значении атрибута используется пробел:
  • 3d plan — фотография будет использована для изображения планировки объекта,
  • 3dplan — не будет.

Если фотографий с атрибутом tag несколько, то для изображения планировки используется первая из них.

Если таких фотографий нет, то фотография для изображения планировки определяется автоматически.

Фотографию с планом этажа также следует передавать с атрибутом tag. Значение атрибута: floor-plan.

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

Примечание. Скачивание URL возможно только по 80 и 443 портам.
is-image-order-change-allowed «Умные фотографии».

Алгоритм выберет самые удачные фотографии и покажет их первыми. Это изменит порядок снимков в объявлении.

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

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

Общая площадь.

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

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

Площадь.

Указывается числовое значение.
unit

Единица площади помещения.

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

Возможные значения: «кв. м»/«sq. m».
living-space

Жилая площадь.

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

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

Площадь комнаты.

Количество передаваемых элементов должно соответствовать количеству комнат.

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

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

Элемент не используется для студий.
kitchen-space

Площадь кухни.

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

Ремонт.

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

  • «чистовая отделка»
  • «под ключ»
  • «черновая отделка».
description

Дополнительная информация.

Описание в свободной форме. Ограничение – 10 000 знаков.
video-review Видео объекта с YouTube и возможность онлайн-показа.

<youtube-video-review-url> — прямая ссылка на видео с вашим объектом с YouTube, без сокращений и счётчиков переходов.

Примечание. Cсылка должна быть без параметра таймкода, например &t=2s.

<online-show> — если вы готовы показать недвижимость по видео-звонку, например в WhatsApp, Skype, Viber или FaceTime, добавьте этот тег со значением 1.

Пример: 

<video-review>   
  <youtube-video-review-url>http://youtu.be/iwGFalTRHDA</youtube-video-review-url>
  <online-show>1</online-show>
</video-review>
virtual-tour 3D-тур.

<model-url> – ссылка на 3D-тур.

<provider> – провайдер тура. Сейчас поддерживаются туры от matterport. Также можно добавить тур ссылкой на свой ресурс. Он будет отображаться через iframe

Примечание. Для туров через iframe есть дополнительные требования: на странице с туром должен быть только он, без дополнительных html-элементов, типа шапки, подвала, ссылок, баннеров, меню и проч.

<preview-url> – ссылка на превью.

<virtual-tour>   
                  <model-url>https://my.matterport.com/show/?m=vDRVV9w</model-url>
                  <provider>matterport</provider>
                  <preview-url>https://view3D-vDRVV9w.jpg</preview-url>
                  </virtual-tour>
Элемент Обязательный элемент Описание
image

Фотография объекта и планировки.

Можно передавать несколько элементов.

В первом элементе image должны быть фотографии планировки.

Фотографии планировки следует передавать с атрибутом tag. Возможные значения атрибута: plan, plan 3d и т. п.

<image tag="plan">
 ...
</image>
Внимание. В качестве разделителя в значении атрибута используется пробел:
  • 3d plan — фотография будет использована для изображения планировки объекта,
  • 3dplan — не будет.

Если фотографий с атрибутом tag несколько, то для изображения планировки используется первая из них.

Если таких фотографий нет, то фотография для изображения планировки определяется автоматически.

Фотографию с планом этажа также следует передавать с атрибутом tag. Значение атрибута: floor-plan.

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

Примечание. Скачивание URL возможно только по 80 и 443 портам.
is-image-order-change-allowed «Умные фотографии».

Алгоритм выберет самые удачные фотографии и покажет их первыми. Это изменит порядок снимков в объявлении.

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

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

Общая площадь.

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

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

Площадь.

Указывается числовое значение.
unit

Единица площади помещения.

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

Возможные значения: «кв. м»/«sq. m».
living-space

Жилая площадь.

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

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

Площадь комнаты.

Количество передаваемых элементов должно соответствовать количеству комнат.

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

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

Элемент не используется для студий.
kitchen-space

Площадь кухни.

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

Ремонт.

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

  • «чистовая отделка»
  • «под ключ»
  • «черновая отделка».
description

Дополнительная информация.

Описание в свободной форме. Ограничение – 10 000 знаков.
video-review Видео объекта с YouTube и возможность онлайн-показа.

<youtube-video-review-url> — прямая ссылка на видео с вашим объектом с YouTube, без сокращений и счётчиков переходов.

Примечание. Cсылка должна быть без параметра таймкода, например &t=2s.

<online-show> — если вы готовы показать недвижимость по видео-звонку, например в WhatsApp, Skype, Viber или FaceTime, добавьте этот тег со значением 1.

Пример: 

<video-review>   
  <youtube-video-review-url>http://youtu.be/iwGFalTRHDA</youtube-video-review-url>
  <online-show>1</online-show>
</video-review>
virtual-tour 3D-тур.

<model-url> – ссылка на 3D-тур.

<provider> – провайдер тура. Сейчас поддерживаются туры от matterport. Также можно добавить тур ссылкой на свой ресурс. Он будет отображаться через iframe

Примечание. Для туров через iframe есть дополнительные требования: на странице с туром должен быть только он, без дополнительных html-элементов, типа шапки, подвала, ссылок, баннеров, меню и проч.

<preview-url> – ссылка на превью.

<virtual-tour>   
                  <model-url>https://my.matterport.com/show/?m=vDRVV9w</model-url>
                  <provider>matterport</provider>
                  <preview-url>https://view3D-vDRVV9w.jpg</preview-url>
                  </virtual-tour>
Пример передачи данных о площадях объекта недвижимости 
<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

Апартаменты.

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

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

Студия.

Строго ограниченные значения: «да», «true», «1», «+».

Элемент не используется для объектов со свободной планировкой.
open-plan

Свободная планировка.

Строго ограниченные значения: «да», «true», «1», «+».

Элемент не используется для студий.
balcony

Тип балкона.

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

  • «балкон»
  • «лоджия»
  • «2 балкона»
  • «2 лоджии»

И т. п.
window-view

Вид из окон.

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

  • «во двор»
  • «на улицу»
  • «во двор и на улицу».
floor-covering

Покрытие пола.

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

  • «ковролин»
  • «ламинат»
  • «линолеум»
  • «паркет».
bathroom-unit

Тип санузла.

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

  • «совмещенный»
  • «раздельный»
  • числовое значение (например «2»).
Элемент Обязательный элемент Описание
new-flat

Признак новостройки.

Строго ограниченные значения: «да», «true», «1», «+».
floor

Этаж.

Обязательный элемент для агентств недвижимости.
rooms

Общее количество комнат в квартире.

При свободной планировке количество комнат указывается согласно паспорту объекта.

Элемент не используется для студий.
rooms-type

Тип комнат.

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

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

Апартаменты.

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

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

Студия.

Строго ограниченные значения: «да», «true», «1», «+».

Элемент не используется для объектов со свободной планировкой.
open-plan

Свободная планировка.

Строго ограниченные значения: «да», «true», «1», «+».

Элемент не используется для студий.
balcony

Тип балкона.

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

  • «балкон»
  • «лоджия»
  • «2 балкона»
  • «2 лоджии»

И т. п.
window-view

Вид из окон.

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

  • «во двор»
  • «на улицу»
  • «во двор и на улицу».
floor-covering

Покрытие пола.

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

  • «ковролин»
  • «ламинат»
  • «линолеум»
  • «паркет».
bathroom-unit

Тип санузла.

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

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

Описание здания

Внимание. Элементы со строго ограниченным набором значений могут содержать только перечисленные варианты. Использование других значений приведет к ошибке обработки фида.
Элемент Обязательный элемент Описание
floors-total

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

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

Передавать нужно только название ЖК.

Пример:

<building-name>Северная жемчужина</building-name>
yandex-building-id

Идентификатор жилого комплекса в базе Яндекса.

Нужен чтобы объявления соответствовали правильному корпусу в ЖК.

Указан в третьем столбце списка yandex-building-id.

Будет виден в URL карточки вашего ЖК.
yandex-house-id Идентификатор корпуса жилого комплекса в базе Яндекса.

Нужен чтобы объявления соответствовали правильному корпусу в ЖК.

Указан в седьмом столбце списка yandex-building-id.
building-state

Стадия строительства дома.

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

  • «built» (дом построен, но не сдан)
  • «hand-over» (сдан в эксплуатацию)
  • «unfinished» (строится)

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

Наличие лифта.

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

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

Наличие мусоропровода.

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

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

Закрытая территория.

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

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

Наличие охраняемой парковки.

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

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

Элитная недвижимость.

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

  • «да»/«нет»
  • «true»/«false»
  • «1»/«0»
  • «+»/«-».
Элемент Обязательный элемент Описание
floors-total

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

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

Передавать нужно только название ЖК.

Пример:

<building-name>Северная жемчужина</building-name>
yandex-building-id

Идентификатор жилого комплекса в базе Яндекса.

Нужен чтобы объявления соответствовали правильному корпусу в ЖК.

Указан в третьем столбце списка yandex-building-id.

Будет виден в URL карточки вашего ЖК.
yandex-house-id Идентификатор корпуса жилого комплекса в базе Яндекса.

Нужен чтобы объявления соответствовали правильному корпусу в ЖК.

Указан в седьмом столбце списка yandex-building-id.
building-state

Стадия строительства дома.

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

  • «built» (дом построен, но не сдан)
  • «hand-over» (сдан в эксплуатацию)
  • «unfinished» (строится)

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

Наличие лифта.

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

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

Наличие мусоропровода.

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

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

Закрытая территория.

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

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

Наличие охраняемой парковки.

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

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

Элитная недвижимость.

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

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

Пример корректного 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>