Требования к фиду

Фид с объявлениями для Яндекс.Недвижимости составляется на языке YRL (Yandex Realty Language), разработанном в Яндексе.

YRL основан на стандарте XML (Extensible Markup Language). Как и XML, YRL не позволяет использовать первые 32 ASCII-символа в текстовых полях (исключения — табуляция, перевод строки, возврат каретки). Также стандарт строго требует кодировать в тексте следующие символы:

Символ, который нужно заменить Код для YRL-файла
" "
& &
> >
< &lt;
' &apos;
Кодировка

Файл фида должен быть создан в кодировке UTF-8.

Заголовок документа

YRL-документ должен начинаться (с нулевого символа первой строки) со стандартного XML-заголовка.

<?xml version="1.0" encoding="utf-8"?>
Корневой элемент

Корневой элемент YRL-фида (realty-feed) должен содержать элемент generation-date с датой создания фида и элементы offer, в каждом из которых должна находиться информация из одного объявления. Чтобы указать пространство имен в XML, используйте атрибут xmlns="http://webmaster.yandex.ru/schemas/feed/realty/2010-06".

<realty-feed xmlns="http://webmaster.yandex.ru/schemas/feed/realty/2010-06">
<generation-date>2010-10-05T16:36:00+04:00</generation-date>   
 <offer>     
  ...   
 </offer>   
 ... 
</realty-feed>
Формат даты

Все даты и время следует указывать согласно стандарту ISO 8601. В общем случае — в формате YYYY-MM-DDTHH:mm:ss+00:00, где:

  • YYYY — год;
  • MM — месяц;
  • DD — день;
  • HH — час;
  • mm — минута;
  • ss — секунда;
  • +00:00 — указание часового пояса (для Москвы — +03:00).

Ниже описаны все возможные элементы фида, сгруппированные по их назначению в языке YRL.

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

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

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

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

Тип сделки.

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

  • «продажа»
  • «аренда»
<property-type>

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

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

<category>

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

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

  • «дача»/«коттедж»/«cottage»
  • «дом»/«house»
  • «дом с участком»/«house with lot»
  • «часть дома»
  • «квартира»/«flat»
  • «комната»/«room»
  • «таунхаус»/«townhouse»
  • «участок»/«lot»
  • «коммерческая»/«commercial»
<commercial-type>

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

Элемент может повторяться несколько раз, если у объекта несколько назначений.

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

  • «auto repair» (автосервис)
  • «business» (готовый бизнес)
  • «free purpose» (помещения свободного назначения)
  • «hotel» (гостиница)
  • «land» (земли коммерческого назначения)
  • «legal address» (юридический адрес)
  • «manufacturing» (производственное помещение)
  • «office» (офисные помещения)
  • «public catering» (общепит)
  • «retail» (торговые помещения)
  • «warehouse» (склад)
<commercial-building-type>

Тип здания, в котором находится объект.

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

  • «business center» (бизнес-центр)
  • «detached building» (отдельно стоящее здание)
  • «residential building» (встроенное помещение)
  • «shopping center» (торговый центр)
  • «warehouse» (складской комплекс)
<purpose>

Рекомендуемое назначение объекта.

Элемент может повторяться несколько раз.

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

  • «bank» (помещение для банка)
  • «beauty shop» (салон красоты)
  • «food store» (продуктовый магазин)
  • «medical center» (медицинский центр)
  • «show room» (шоу-рум)
  • «touragency» (турагентство)
<purpose-warehouse>

Назначение склада.

Элемент может повторяться несколько раз.

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

  • «alcohol» (алкогольный склад)
  • «pharmaceutical storehouse» (фармацевтический склад)
  • «vegetable storehouse» (овощехранилище)
<lot-number>

Номер лота

<cadastral-number>

Кадастровый номер объекта недвижимости

<url>

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

Обязательный элемент для досок объявлений

<creation-date>

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

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

<last-update-date>

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

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

<expire-date>

Дата и время, до которых объявление актуально.

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

<payed-adv>

Признак оплаченного объявления.

Элемент указывается только для досок объявлений.

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

  • «да»/«нет»
  • «true»/«false»
  • «1»/«0»
  • «+»/«-»
<manually-added>

Признак объявления, добавленного вручную.

Элемент указывается только для досок объявлений.

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

  • «да»/«нет»
  • «true»/«false»
  • «1»/«0»
  • «+»/«-»
<vas>

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

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

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

  • «premium»
  • «raise»
  • «promotion»
<location>

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

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

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

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

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

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

<district>

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

<locality-name>

Название населенного пункта

<sub-locality-name>

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

<address>

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

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

<apartment>

Номер квартиры

<direction>

Шоссе.

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

<distance>

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

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

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

<latitude>

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

<longitude>

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

<metro>

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

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

<metro>           
      <name/>
      <time-on-foot/>
      <time-on-transport/>
</metro>
<name>

Название станции метро

<time-on-transport>

Время до метро в минутах на транспорте

<time-on-foot>

Время до метро в минутах пешком

<railway-station>

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

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

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

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

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

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

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

    или

    locality-name (название населенного пункта)

    или

    direction (шоссе — для объектов в Московской области)

    или

    railway-station (ближайшая железнодорожная станция).

Пример использования тегов <region>, <district> и <sub-locality-name> при описании адреса
<location>
    <country>Россия</country>
    <region>Московская область</region>
    <district>Одинцовский район</district>
    <locality-name>Одинцово</locality-name>
        <sub-locality-name>Центральный</sub-locality-name>
        <non-admin-sub-locality>Центр</non-admin-sub-locality>
    <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>

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

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

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

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

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

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

<phone>

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

Номер указывается в международном формате.

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

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

Тип продавца или арендодателя.

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

  • «агентство»/«agency»
  • «владелец»/«owner»
  • «застройщик»/«developer»
<organization>

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

<agency-id>

Внутренний ID агентства в базе партнера.

Элемент указывается только для досок объявлений

<url>

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

<email>

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

<photo>

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

<partner>

Название партнера, предоставившего объявление.

Элемент указывается только для досок объявлений

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

Элемент Обязательный элемент Описание
<price>

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

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

Цена.

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

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

<currency>

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

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

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

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

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

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

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

  • «кв. м»/«sq. m»
  • «cотка»
  • «гектар»/«hectare»
<commission>

Размер комиссии для клиента в процентах.

Указывается целое число в процентах без знака «%»

<security-payment>

Размер обеспечительного платежа в процентах.

Указывается целое число в процентах без знака «%»

Пример передачи данных о цене квартиры
<price>
    <value>4000000</value>
    <currency>RUR</currency>
</price>
Пример передачи данных о цене 1 кв. м.
<price>
    <value>60000</value>
    <currency>RUB</currency>
    <unit>кв. м</unit>
</price>
Пример передачи данных о цене аренды объекта недвижимости сроком на 1 месяц
<price>
    <value>700</value>
    <currency>USD</currency>
    <period>месяц</period>
</price>

Дополнительная информация об условиях сделки (для жилой недвижимости)

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

Тип сделки.

Если элемент отсутствует, все объявления партнера в новостройках считаются квартирами от застройщика.

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

  • «первичная продажа»/«продажа от застройщика»
  • «переуступка»/«reassignment»

Возможные значения для вторичной недвижимости:

  • «прямая продажа»/«sale»
  • «первичная продажа вторички»/«primary sale of secondary»
  • «встречная продажа»/«countersale»
<not-for-agents>

Просьба агентам не звонить.

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

  • «да»/«нет»
  • «true»/«false»
  • «1»/«0»
  • «+»/«-»
<haggle>

Торг.

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

  • «да»/«нет»
  • «true»/«false»
  • «1»/«0»
  • «+»/«-»
<mortgage>

Ипотека.

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

  • «да»/«нет»
  • «true»/«false»
  • «1»/«0»
  • «+»/«-»
<prepayment>

Предоплата.

Указывается числовое значение в процентах без знака «%»

<rent-pledge>

Залог.

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

  • «да»/«нет»
  • «true»/«false»
  • «1»/«0»
  • «+»/«-»
<utilities-included>

Коммунальные услуги входят в стоимость.

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

  • «да»/«нет»
  • «true»/«false»
  • «1»/«0»
  • «+»/«-»
<agent-fee>

Комиссия агента.

Указывается числовое значение в процентах без знака «%»

<with-pets>

Для аренды: можно ли с животными.

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

  • «да»/«нет»
  • «true»/«false»
  • «1»/«0»
  • «+»/«-»
<with-children>

Для аренды: можно ли с детьми.

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

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

Дополнительная информация об условиях сделки (аренда коммерческой недвижимости)

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

Тип сделки.

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

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

  • «direct rent» (прямая аренда)
  • «subrent» (субаренда)
  • «sale of lease rights» (продажа права аренды)
<period>

Период для расчета стоимости аренды.

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

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

  • «день»/«day»
  • «месяц»/«month»
<cleaning-included>

Клининг входит в договор аренды.

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

  • «да»/«нет»
  • «true»/«false»
  • «1»/«0»
  • «+»/«-»
<utilities-included>

Коммунальные услуги включены в стоимость в договоре аренды.

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

  • «да»/«нет»
  • «true»/«false»
  • «1»/«0»
  • «+»/«-»
<electricity-included>

Электроэнергия включена в стоимость в договоре аренды.

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

  • «да»/«нет»
  • «true»/«false»
  • «1»/«0»
  • «+»/«-»
<taxation-form>

Форма налогообложения арендодателя для аренды.

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

  • «НДС» (арендодатель — плательщик НДС)
  • «УСН» (арендодатель работает по упрощенной системе налогообложения)

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

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

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

Обязательный элемент для всех объявлений, кроме участков (см. элемент lot-area).

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

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

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

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

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

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

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

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

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

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

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

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

Площадь участка.

Площадь участка указывается для категорий «дом с участком» и «участок».

В коммерческой недвижимости площадь участка указывается для категории «земли коммерческого назначения» или для обозначения площади участка, прилегающего к отдельно стоящему зданию. Объекты площадью более одного гектара признаются участками коммерческого назначения.

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

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

Площадь.

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

<unit>

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

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

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

<image>

Фотография.

Обязательный элемент для объявлений о сдаче недвижимости в аренду.

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

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

<renovation>

Ремонт.

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

  • «дизайнерский»
  • «евро»
  • «с отделкой»
  • «требует ремонта»
  • «хороший»
  • «частичный ремонт»
  • «черновая отделка»
<quality>

Состояние объекта.

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

  • «отличное»
  • «хорошее»
  • «нормальное»
  • «плохое»
<description>

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

Описание в свободной форме

<lot-type>

Тип участка.

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

  • «ИЖC»
  • «садоводство»
Пример передачи данных о площадях объекта недвижимости
<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>
Пример передачи данных о площади участка
<lot-area>
    <value>15</value>
    <unit>сот</unit>
</lot-area>

Описание жилого помещения

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

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

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

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

<rooms>

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

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

<rooms-offered>

Количество комнат, участвующих в сделке.

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

<floor>

Этаж.

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

<apartments>

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

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

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

Студия.

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

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

<open-plan>

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

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

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

<rooms-type>

Тип комнат.

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

  • «смежные»
  • «раздельные»
<window-view>

Вид из окон.

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

  • «во двор»
  • «на улицу»
<balcony>

Тип балкона.

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

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

И т. п.

<bathroom-unit>

Тип санузла.

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

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

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

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

  • «да»/«нет»
  • «true»/«false»
  • «1»/«0»
  • «+»/«-»
<internet>

Наличие интернета.

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

  • «да»/«нет»
  • «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»
  • «1»/«0»
  • «+»/«-»
<refrigerator>

Наличие холодильника.

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

  • «да»/«нет»
  • «true»/«false»
  • «1»/«0»
  • «+»/«-»
<built-in-tech>

Встроенная техника.

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

  • «да»/«нет»
  • «true»/«false»
  • «1»/«0»
  • «+»/«-»
<floor-covering>

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

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

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

Описание нежилого помещения

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

Этаж.

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

<rooms>

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

<entrance-type>

Вход в помещение.

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

  • «common» (общий)
  • «separate» (отдельный)
<phone-lines>

Количество телефонных линий

<adding-phone-on-request>

Возможность добавления телефонных линий.

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

  • «да»/«нет»
  • «true»/«false»
  • «1»/«0»
  • «+»/«-»
<internet>

Наличие интернета.

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

  • «да»/«нет»
  • «true»/«false»
  • «1»/«0»
  • «+»/«-»
<self-selection-telecom>

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

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

  • «да»/«нет»
  • «true»/«false»
  • «1»/«0»
  • «+»/«-»
<room-furniture>

Наличие мебели.

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

  • «да»/«нет»
  • «true»/«false»
  • «1»/«0»
  • «+»/«-»
<air-conditioner>

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

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

  • «да»/«нет»
  • «true»/«false»
  • «1»/«0»
  • «+»/«-»
<ventilation>

Наличие вентиляции.

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

  • «да»/«нет»
  • «true»/«false»
  • «1»/«0»
  • «+»/«-»
<fire-alarm>

Наличие пожарной сигнализации.

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

  • «да»/«нет»
  • «true»/«false»
  • «1»/«0»
  • «+»/«-»
<water-supply>

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

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

  • «да»/«нет»
  • «true»/«false»
  • «1»/«0»
  • «+»/«-»
<sewerage-supply>

Наличие канализации.

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

  • «да»/«нет»
  • «true»/«false»
  • «1»/«0»
  • «+»/«-»
<electricity-supply>

Наличие электроснабжения.

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

  • «да»/«нет»
  • «true»/«false»
  • «1»/«0»
  • «+»/«-»
<electric-capacity>

Выделенная электрическая мощность.

Указывается целое число. Значение передается в кВт

<gas-supply>

Подключение к газовым сетям.

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

  • «да»/«нет»
  • «true»/«false»
  • «1»/«0»
  • «+»/«-»
<floor-covering>

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

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

  • «ковролин»
  • «ламинат»
  • «линолеум»
  • «паркет»
<heating-supply>

Наличие отопления.

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

  • «да»/«нет»
  • «true»/«false»
  • «1»/«0»
  • «+»/«-»
<window-type>

Тип окон.

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

  • «витринные»
  • «маленькие»
  • «обычные»
<window-view>

Вид из окон.

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

  • «во двор»
  • «на улицу»

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

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

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

Обязательный элемент для новостроек

<building-name>

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

Обязательный элемент для новостроек.

Примечание. В настоящее время элемент поддерживается только для объектов в Московской, Ленинградской, Ростовской, Свердловской областях и Краснодарском крае
<yandex-building-id>

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

Обязательный элемент для новостроек.

Примечание. В настоящее время элемент поддерживается только для объектов в Московской, Ленинградской, Ростовской, Свердловской областях и Краснодарском крае.

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

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

Полный список идентификаторов yandex-building-id предоставляется по запросу с указанием региона на info@realty.yandex.ru

<office-class>

Класс бизнес-центра.

Возможные значения: «A», «A+», «B», «B+», «C», «C+»

<building-type>

Тип дома.

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

  • «блочный»
  • «деревянный»
  • «кирпичный»
  • «кирпично-монолитный»
  • «монолит»
  • «панельный»
<building-series>

Серия дома

<building-phase>

Очередь строительства.

Возможные значения: «очередь 1», «II очередь», «3» и т. п.

<building-section>

Корпус дома.

Возможные значения: «корпус 1», «корпус А», «дом 3» и т. п.

<built-year>

Год постройки, для новостроек — год сдачи.

Обязательный элемент для новостроек и домов, которые были сданы менее пяти лет назад.

Год необходимо указывать полностью, например — «1996», а не «96»

<ready-quarter>

Квартал сдачи дома.

Обязательный элемент для новостроек.

Строго ограниченные значения: «1», «2», «3», «4»

<building-state>

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

Обязательный элемент для новостроек.

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

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

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

<ceiling-height>

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

<guarded-building>

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

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

  • «да»/«нет»
  • «true»/«false»
  • «1»/«0»
  • «+»/«-»
<access-control-system>

Наличие пропускной системы.

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

  • «да»/«нет»
  • «true»/«false»
  • «1»/«0»
  • «+»/«-»
<twenty-four-seven>

Возможность круглосуточного доступа сотрудников арендатора на объект аренды 7 дней в неделю.

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

  • «да»/«нет»
  • «true»/«false»
  • «1»/«0»
  • «+»/«-»
<lift>

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

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

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

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

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

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

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

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

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

Количество предоставляемых парковочных мест

<parking-place-price>

Стоимость парковочного места.

Указывается стоимость одного места в месяц в рублях

<parking-guest>

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

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

  • «да»/«нет»
  • «true»/«false»
  • «1»/«0»
  • «+»/«-»
<parking-guest-places>

Количество гостевых парковочных мест

<alarm>

Наличие сигнализации в доме.

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

  • «да»/«нет»
  • «true»/«false»
  • «1»/«0»
  • «+»/«-»
<flat-alarm>

Наличие сигнализации в квартире.

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

  • «да»/«нет»
  • «true»/«false»
  • «1»/«0»
  • «+»/«-»
<security>

Наличие охраны.

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

  • «да»/«нет»
  • «true»/«false»
  • «1»/«0»
  • «+»/«-»
<eating-facilities>

Наличие предприятий общепита в здании.

Элемент передается для бизнес-центров и складских комплексов.

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

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

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

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

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

Особенности передачи данных об объектах в новостройках

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

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

Элемент Обязательный элемент Описание
<new-flat>

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

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

<building-name>

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

Примечание. В настоящее время элемент поддерживается только для объектов в Московской, Ленинградской, Ростовской, Свердловской областях и Краснодарском крае
<building-state>

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

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

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

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

<built-year>

Год сдачи дома в эксплуатацию.

Год необходимо указывать полностью, например — «1996», а не «96»

<ready-quarter>

Квартал сдачи дома в эксплуатацию.

Строго ограниченные значения: «1», «2», «3», «4»

<building-phase>

Очередь строительства.

Возможные значения: «очередь 1», «II очередь», «3» и т. п.

<location>

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

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

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

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

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

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

<district>

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

<locality-name>

Название населенного пункта

<sub-locality-name>

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

<address>

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

<building-section>

Корпус дома.

Возможные значения: «корпус 1», «корпус А», «дом 3» и т. п.

<floor>

Этаж квартиры.

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

<floors-total>

Общая этажность дома

<area>

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

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

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

Площадь.

Указывается числовое значение без пробелов

<unit>

Единица площади квартиры.

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

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

<image>

Изображение планировки квартиры.

Планировка указывается первым тэгом image

<yandex-building-id>

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

Примечание. В настоящее время элемент поддерживается только для объектов в Московской, Ленинградской, Ростовской, Свердловской областях и Краснодарском крае.

Идентификатор следует передавать, чтобы объявления корректно подгружались к соответствующему жилому комплексу

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

Полный список идентификаторов yandex-building-id предоставляется по запросу на info@realty.yandex.ru

<sales-agent>

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

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

<sales-agent>
    <organization/>
    <url/>
</sales-agent>
<url>

Сайт застройщика или агентства недвижимости

<organization>

Название компании-продавца

<price>

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

Содержит следующие вложенные элементы:

<price>
  <value/>
  <currency/>
</price>
<value>

Цена.

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

<currency>

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

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

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

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

<vas>

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

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

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

  • «premium»

  • «raise»

  • «promotion»

Описание особенностей складских и производственных помещений

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

Ответственное хранение.

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

  • «да»/«нет»
  • «true»/«false»
  • «1»/«0»
  • «+»/«-»
<pallet-price>

Стоимость палето-места в месяц в рублях с учетом налогов.

Указывается в случае ответственного хранения

<freight-elevator>

Наличие грузового лифта.

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

  • «да»/«нет»
  • «true»/«false»
  • «1»/«0»
  • «+»/«-»
<truck-entrance>

Возможность подъезда фуры.

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

  • «да»/«нет»
  • «true»/«false»
  • «1»/«0»
  • «+»/«-»
<ramp>

Наличие пандуса.

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

  • «да»/«нет»
  • «true»/«false»
  • «1»/«0»
  • «+»/«-»
<railway>

Наличие ветки железной дороги.

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

  • «да»/«нет»
  • «true»/«false»
  • «1»/«0»
  • «+»/«-»
<office-warehouse>

Наличие офиса на складе.

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

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

Наличие открытой площадки.

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

  • «да»/«нет»
  • «true»/«false»
  • «1»/«0»
  • «+»/«-»
<service-three-pl>

Наличие 3PL (логистических) услуг.

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

  • «да»/«нет»
  • «true»/«false»
  • «1»/«0»
  • «+»/«-»
<temperature-comment>

Комментарий про температурный режим на складе

Описание загородной недвижимости

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

Возможность постоянного проживания.

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

  • «да»/«нет»
  • «true»/«false»
  • «1»/«0»
  • «+»/«-»
<water-supply>

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

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

  • «да»/«нет»
  • «true»/«false»
  • «1»/«0»
  • «+»/«-»
<sewerage-supply>

Наличие канализации.

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

  • «да»/«нет»
  • «true»/«false»
  • «1»/«0»
  • «+»/«-»
<heating-supply>

Наличие отопления.

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

  • «да»/«нет»
  • «true»/«false»
  • «1»/«0»
  • «+»/«-»
<electricity-supply>

Наличие электроснабжения.

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

  • «да»/«нет»
  • «true»/«false»
  • «1»/«0»
  • «+»/«-»
<gas-supply>

Наличие подключения к газовым сетям.

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

  • «да»/«нет»
  • «true»/«false»
  • «1»/«0»
  • «+»/«-»
<kitchen>

Наличие кухни

<toilet>

Расположение туалета.

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

  • «в доме»
  • «на улице»
<shower>

Расположение душа.

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

  • «в доме»
  • «на улице»
<pool>

Наличие бассейна.

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

  • «да»/«нет»
  • «true»/«false»
  • «1»/«0»
  • «+»/«-»
<sauna>

Наличие сауны/бани.

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

  • «да»/«нет»
  • «true»/«false»
  • «1»/«0»
  • «+»/«-»
<billiard>

Наличие бильярда.

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

  • «да»/«нет»
  • «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>2010-12-11T12:00:00+04:00</generation-date>   

<!-- Квартира на вторичном рынке -->     
<offer internal-id="1245">         
<type>продажа</type>         
<property-type>жилая</property-type>         
<category>квартира</category>   
<deal-status>первичная продажа вторички</deal-status>       
<url>http://yandex.ru/1/</url>         
<creation-date>2010-11-13T12:32:45+04:00</creation-date>
<last-update-date>2010-11-13T12:32:45+04:00</last-update-date>
<location>             
  <country>Россия</country>             
  <locality-name>Москва</locality-name>             
  <address>Яузская улица, 27</address> 
  <apartment>135</apartment>        
</location>         
<sales-agent>             
  <phone>+74951234567</phone>
</sales-agent>     
<price>     
  <value>4000000</value>        
  <currency>RUR</currency> 
</price>
<area>     
  <value>56</value>     
  <unit>кв. м</unit> 
</area> 
<rooms>1</rooms>
<rooms-offered>1</rooms-offered>
<floor>12</floor>
</offer> 

<!-- Квартира в новостройке -->
<offer internal-id="15782295">
<type>продажа</type>
<property-type>жилая</property-type>
<category>квартира</category>
<deal-status>первичная продажа</deal-status>
<url>http://www.developer.ru/search18</url>
<creation-date>2015-04-02T19:00:06+03:00</creation-date>
<location>
  <country>Россия</country>
   <locality-name>Санкт-Петербург</locality-name>
   <address>18-я линия В.О., 32</address>
   <apartment>64</apartment> 
   <metro>
     <name>Василеостровская</name>
   </metro>
</location>
<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>
<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>

<!-- Комната/комнаты -->     
<offer internal-id="3">         
<type>продажа</type>         
<property-type>жилая</property-type>         
<category>комната</category>          
<url>http://yandex.ru/1/</url>         
<creation-date>2010-11-13T12:32:45+04:00</creation-date>
<last-update-date>2010-11-20T12:32:45+04:00</last-update-date>
<location>             
  <country>Россия</country>             
  <region>Ленинградская область</region>             
  <district>Выборгский район</district>             
  <locality-name>Выборг</locality-name>             
  <address>Cторожевой башни, 2</address>   
  <apartment>16</apartment>       
</location>          
<sales-agent>             
  <phone>+79104565459</phone>             
  <category>владелец</category>         
</sales-agent>
<image>http://yandex.ru/image/1.jpg</image>  
<price>     
  <value>15000</value>        
  <currency>RUR</currency>
  <period>месяц</period> 
</price>
<area>     
  <value>15</value>     
  <unit>кв. м</unit> 
</area> 
<rooms>5</rooms>
<rooms-offered>1</rooms-offered>
<floor>12</floor>
</offer>

<!-- Загородная недвижимость -->     
<offer internal-id="4">         
<type>продажа</type>         
<property-type>жилая</property-type>         
<category>коттедж</category>          
<url>http://yandex.ru/1/</url>         
<creation-date>2010-11-13T12:32:45+04:00</creation-date>
<last-update-date>2010-11-20T12:32:45+04:00</last-update-date>
<location>             
  <country>Россия</country>
  <region>Московская область</region>             
  <locality-name>Протвино</locality-name>             
</location>          
<sales-agent>             
  <phone>+74952203206</phone>             
</sales-agent>     
<price>     
  <value>15000000</value>        
  <currency>RUR</currency> 
</price>
<area>     
  <value>150</value>     
  <unit>кв. м</unit> 
</area>
</offer>

<!--Дом с участком-->     
<offer internal-id="7">          
<type>продажа</type>         
<property-type>жилая</property-type>         
<category>дом с участком</category>         
<url>http://yandex.ru/7/</url>         
<payed-adv>1</payed-adv>         
<manually-added>1</manually-added>         
<creation-date>2010-12-05T00:00:00+04:00</creation-date>         
<expire-date>2011-12-20T00:00:00+04:00</expire-date>         
<last-update-date>2010-12-12T00:00:00+04:00</last-update-date>         
<location>                 
  <country>Россия</country>                 
  <region>Тверская область</region>                 
  <district>Вышневолоцкий район</district>                 
  <locality-name>г.Вышний Волочек</locality-name>                 
  <railway-station>Вышний Волочек</railway-station>         
</location>        
<sales-agent>                
  <name>Алексей</name>                
  <phone>+79038080053</phone>                 
  <category>агентство</category>                 
  <organization>Успех</organization>                 
  <url>www.site.ru</url>                 
  <email>site@ya.ru</email>    
  <photo> http://yandex.ru/photo/123</photo>
</sales-agent>         
<price>                 
  <value>2300000</value>                 
  <currency>RUR</currency>         
</price>         
<haggle>1</haggle>         
<mortgage>1</mortgage>
<image>http://yandex.ru/components/com_estateagent/pictures/ea1279882313.jpg</image>
<image>http://yandex.ru/components/com_estateagent/pictures/ea1279882363.jpg</image>
<image>http://yandex.ru/components/com_estateagent/pictures/ea1279882395.jpg</image>
<description>Тверская область, г. Вышний Волочек (от МКАД 320 км по асфальтированной дороге). Продаю дом 80 кв.м с земельным участком 7 соток. В доме — вода, газовое отопление, электричество. 3 комнаты, кухня, ванная, туалет. Земельный участок разработан. На участке — гараж, баня, хоз. постройки.</description>         
<quality>хорошее</quality>         
<area>                 
  <value>80</value>                 
  <unit>кв. м</unit>        
</area>         
<lot-area>                 
  <value>7</value>                 
  <unit>cот.</unit>         
</lot-area>         
<living-space>                 
  <value>61</value>                 
  <unit>кв. м</unit>         
</living-space>         
<kitchen-space>                 
  <value>9</value>                 
  <unit>кв. м</unit>         
</kitchen-space>         
<lot-type>ИЖС</lot-type>         
<rooms>3</rooms>         
<kitchen-furniture>1</kitchen-furniture>         
<balcony>0</balcony>         
<bathroom-unit>совмещенный</bathroom-unit>         
<floors-total>1</floors-total>         
<building-type>деревянный</building-type>         
<pmg>1</pmg>         
<is-elite>0</is-elite>         
<toilet>в доме</toilet>         
<shower>в доме</shower>         
<kitchen>1</kitchen>         
<heating-supply>1</heating-supply>         
<water-supply>1</water-supply>         
<electricity-supply>1</electricity-supply>         
<sewerage-supply>1</sewerage-supply>         
<gas-supply>1</gas-supply>        
<parking>1</parking>         
<alarm>0</alarm>         
<pool>0</pool>         
<sauna>1</sauna>      
</offer>

<!--Коммерческая недвижимость-->     
<offer internal-id="1">
<type>аренда</type>
<category>commercial</category>
<commercial-type>office</commercial-type>
<commercial-building-type>business center</commercial-building-type>
<url>http://commer.ru/spb/1</url>
<creation-date>2013-11-22T12:25:20+04:00</creation-date>
<last-update-date>2016-03-23T11:38:29+04:00</last-update-date>
<location>
  <country>Россия</country>
  <district>Санкт-Петербург</district>
  <locality-name>г. Санкт-Петербург</locality-name>
  <sub-locality-name>Центральный</sub-locality-name>
  <address>Невский пр., 35, лит. А</address>
</location>
<sales-agent>
   <phone>+78121234567</phone>
   <organization>Успех</organization>
   <url>http://commer.ru/spb/</url>
   <photo>http://commer.ru/new/logo.png</photo>
</sales-agent>
<price>
    <value>276800</value>
    <currency>RUB</currency>
    <period>month</period>
    <taxation-form>НДС</taxation-form>
</price>
<commission>0</commission>
<security-payment>100</security-payment>
<utilities-included>true</utilities-included>
<electricity-included>true</electricity-included>
<deal-status>direct rent</deal-status>
<area>
  <value>138.4</value>
  <unit>кв. м</unit>
</area>
<image>http://commer.ru/image/1.jpg</image>
<renovation>с отделкой</renovation>
<quality>отличное</quality>
<description>Офисный блок состоит из 3 помещений с мансардными окнами: зал open-space 105,3 кв. м и еще 2 помещения (16.7 и 16.4 кв. м)</description>
<rooms>1</rooms>
<internet>true</internet>
<air-conditioner>true</air-conditioner>
<ventilation>true</ventilation>
<fire-alarm>true</fire-alarm>
<heating-supply>true</heating-supply>
<electricity-supply>true</electricity-supply>
<floor>4</floor>
<floors-total>6</floors-total>
<building-name>Невский 38</building-name>
<office-class>A</office-class>
<built-year>2004</built-year>
<access-control-system>true</access-control-system>
<twenty-four-seven>true</twenty-four-seven>
<lift>true</lift>
<security>true</security>
</offer>
</realty-feed>