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

Тип сделки.

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

• «продажа»

• «аренда»

• «посуточная аренда».

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

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

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

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

• «дача»/«коттедж»/«cottage»

• «дом»/«house»

• «дом с участком»/«house with lot»

• «участок»/«lot»

• «часть дома»

• «квартира»/«flat»

• «комната»/«room»

• «таунхаус»/«townhouse»

• «дуплекс»/«duplex»

• «гараж»/«garage».

Категория гаража.

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

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

• «гараж»/«garage»

• «машиноместо»/«parking place»

• «бокс»/«box»

Номер лота.

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

URL страницы с объявлением на вашем сайте. Мы не покажем его в объявлении.

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

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

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

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

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

• «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>

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

Внимание. Опции нельзя подключить к объявлениям без фотографий.

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

<location>
      <country/>
      <region/>
      <district/>
      <locality-name/>
         <sub-locality-name/>
      <address/>
      <direction/> 
      <distance/>
      <latitude/>
      <longitude/>
      <metro>
          <name/>
          <time-on-foot/>
          <time-on-transport/>
       </metro>
       <railway-station>
</location>

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

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

• locality-name – название населенного пункта;

• address – улица и дом.

  Пример:

<location>
    <country>Россия</country>
    <region>Московская область</region>
    <district>Одинцовский район</district>
    <locality-name>Одинцово</locality-name>
        <sub-locality-name>Центральный</sub-locality-name>
    <address>Пушкинская ул., д. 12</address>
</location>

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

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

• locality-name – название населенного пункта.Пример:

  <location>
      <country>Россия</country>
      <region>Хабаровский край</region>
      <district>Хабаровский район</district>
      <locality-name>село Князе-Волконское</locality-name>
      <address>Молодежная ул.</address>
  </location>

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

Передаётся внутри <location>.

Примечание. Мы принимаем объявления с объектами только на территории России.

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

Передаётся внутри <location>.

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

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

Передаётся внутри <location>.

Узнать свой район можно в перечне.

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

Передаётся внутри <location>.

Район в населенном пункте.

Передаётся внутри <location>.

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

Передаётся внутри <location>.

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

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

Передаётся внутри <location>.

Шоссе.

Передаётся внутри <location>.

Только для объектов в Москве и Московской области.

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

Передаётся внутри <location>.

В километрах.

Только для Москвы и Московской области.

Передаётся внутри <location>.

Можно узнать её на Яндекс.Картах, сразу под адресом.

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

Можно узнать её на Яндекс.Картах, сразу под адресом.

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

Передаётся внутри <location>.

Только для загородной недвижимости.

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

Состоит из нескольких элементов, передаётся внутри <location>.

<location> 
   ....
   <metro>           
      <name>Проспект Мира<name/>
      <time-on-foot>15<time-on-foot/>
       <time-on-transport>5<time-on-transport/>
   </metro>
   ....
</location>

Если станций несколько, передайте каждую в отдельном <metro>.

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

Передаётся внутри <metro>.

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

Передаётся внутри <metro>.

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

Передаётся внутри <metro>.

Название коттеджного посёлка.

Только для загородной недвижимости.

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

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

Только для загородной недвижимости.

Перечень yandex-village-id – https://realty.yandex.ru/export/villages.tsv

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

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

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

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

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

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

<phone>+74951234567</phone>

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

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

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

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

• «агентство»/«agency»

• «застройщик»/«developer».

Примечание. Агентам следует указывать значение «агентство»/«agency».

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

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

Электронный адрес продавца. Мы не покажем его покупателям.

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

Можно загрузить только 1 изображение. Покажем его в листинге и на карточке объявления рядом с номером телефона.

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

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

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

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

Примечание. Не добавляйте в <price> ничего, кроме перечисленных в примере элементов. Иначе ваше объявление сломается.

Цена.

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

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

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

• «RUR» или «RUB» (российский рубль)

• «EUR» (евро)

• «USD» (американский доллар).

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

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

• «день»/«day»

• «месяц»/«month»

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

Нужна только если цена (value) указана за единицу площади.

Указывается внутри price.

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

• «кв. м»/«sq. m»

• «cотка»

• «гектар»/«hectare».

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

• «да»/«нет»

• «true»/«false»

• «1»/«0»

• «+»/«-».

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

Внимание. Не передавайте элемент внутри <price>.

Тип сделки.

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

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

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

• «переуступка»/«reassignment».

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

• «прямая продажа»/«sale»

• «первичная продажа вторички»/«primary sale of secondary»

• «встречная продажа»/«countersale».

Торг.

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

• «да»/«нет»

• «true»/«false»

• «1»/«0»

• «+»/«-».

Ипотека.

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

• «да»/«нет»

• «true»/«false»

• «1»/«0»

• «+»/«-».

Предоплата.

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

Максимальное значение — 100.

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

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

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

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

• «да»/«нет»

• «true»/«false»

• «1»/«0»

• «+»/«-».

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

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

• «да»/«нет»

• «true»/«false»

• «1»/«0»

• «+»/«-».

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

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

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

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

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

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

Для каждой комнаты нужно передать отдельный room-space.

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

Не используйте его для студий и объектов со свободной планировкой, достаточно будет living-space.

При продаже и сдаче комнаты укажите площадь этой комнаты, а не всей квартиры.

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

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

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

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

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

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

Объекты больше 1 гектара считаются коммерческими. Подробнее: Коммерческая недвижимость.

<lot-area>
    <value>15</value>
    <unit>сотка</unit>
</lot-area>

Площадь.

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

Тип участка.

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

• «ИЖС»

• «садоводство»

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

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

• «кв. м»/«sq. m»

• «cотка»

• «гектар»/«hectare».

Фотография.

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

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

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

Ремонт.

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

• «евроремонт»

• «косметический»

• «дизайнерский»

• «требует ремонта».

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

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

• «отличное»

• «хорошее»

• «нормальное»

• «плохое».

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

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

Убрать из объявления типовую планировку квартиры.

В объявления о сдаче и продаже квартир в домах серийной застройки может добавиться типовая планировка помещения. Чтобы убрать её, укажите этот тег.

Планировки добавляются на основе метража квартиры.

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

• «да»

• «true»

• «1»

• «+».

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

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

Не обязательно для частных домов.

Не указывайте для студий.

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

Указывайте только при продаже или сдаче комнаты.

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

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

Используйте при продаже или сдаче квартиры и комнаты.

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

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

• «да»/«нет»

• «true»/«false»

• «1»/«0»

• «+»/«-».

Студия.

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

• «да»

• «true»

• «1»

• «+».

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

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

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

• «да»

• «true»

• «1»

• «+».

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

Тип комнат.

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

• «смежные»

• «раздельные».

Вид из окон.

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

• «во двор»

• «на улицу».

Тип балкона.

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

• «балкон»

• «лоджия»

• «2 балкона»

• «2 лоджии»

И т. п.

Тип санузла.

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

• «совмещенный»

• «раздельный»

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

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

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

• «да»/«нет»

• «true»/«false»

• «1»/«0»

• «+»/«-».

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

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

• «да»/«нет»

• «true»/«false»

• «1»/«0»

• «+»/«-».

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

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

• «да»/«нет»

• «true»/«false»

• «1»/«0»

• «+»/«-».

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

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

• «да»/«нет»

• «true»/«false»

• «1»/«0»

• «+»/«-».

Наличие мебели на кухне.

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

• «да»/«нет»

• «true»/«false»

• «1»/«0»

• «+»/«-».

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

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

• «да»/«нет»

• «true»/«false»

• «1»/«0»

• «+»/«-».

Наличие стиральной машины.

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

• «да»/«нет»

• «true»/«false»

• «1»/«0»

• «+»/«-».

Наличие посудомоечной машины.

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

• «да»/«нет»

• «true»/«false»

• «1»/«0»

• «+»/«-».

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

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

• «да»/«нет»

• «true»/«false»

• «1»/«0»

• «+»/«-».

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

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

• «да»/«нет»

• «true»/«false»

• «1»/«0»

• «+»/«-».

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

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

• «ковролин»

• «ламинат»

• «линолеум»

• «паркет».

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

• «да»/«нет»

• «true»/«false»

• «1»/«0»

• «+»/«-».

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

• «да»/«нет»

• «true»/«false»

• «1»/«0»

• «+»/«-».

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

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

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

• Республика Башкортостан
• Республика Крым
• Республика Саха (Якутия)
• Республика Татарстан
• Республика Чувашия
• Алтайский край
• Астраханская область
• Брянская область
• Владимирская область
• Волгоградская область
• Вологодская область
• Воронежская область
• Калининградская область
• Калужская область
• Кемеровская область
• Кировская область
• Костромская область
• Краснодарский край
• Красноярский край
• Ленинградская область
• Московская область
• Нижегородская область
• Новосибирская область
• Омская область
• Орловская область
• Пензенская область
• Пермский край
• Приморский край
• Ростовская область
• Рязанская область
• Самарская область
• Саратовская область
• Свердловская область
• Ставропольский край
• Тверская область
• Тульская область
• Тюменская область
• Ульяновская область
• Хабаровский край
• Челябинская область
• Ярославская область

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

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

• Республика Башкортостан
• Республика Крым
• Республика Саха (Якутия)
• Республика Татарстан
• Республика Чувашия
• Алтайский край
• Астраханская область
• Брянская область
• Владимирская область
• Волгоградская область
• Вологодская область
• Воронежская область
• Калининградская область
• Калужская область
• Кемеровская область
• Кировская область
• Костромская область
• Краснодарский край
• Красноярский край
• Ленинградская область
• Московская область
• Нижегородская область
• Новосибирская область
• Омская область
• Орловская область
• Пензенская область
• Пермский край
• Приморский край
• Ростовская область
• Рязанская область
• Самарская область
• Саратовская область
• Свердловская область
• Ставропольский край
• Тверская область
• Тульская область
• Тюменская область
• Ульяновская область
• Хабаровский край
• Челябинская область
• Ярославская область

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

Будет виден в URL карточки вашего ЖК.

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

• Республика Башкортостан
• Республика Крым
• Республика Саха (Якутия)
• Республика Татарстан
• Республика Чувашия
• Алтайский край
• Астраханская область
• Брянская область
• Владимирская область
• Волгоградская область
• Вологодская область
• Воронежская область
• Калининградская область
• Калужская область
• Кемеровская область
• Кировская область
• Костромская область
• Краснодарский край
• Красноярский край
• Ленинградская область
• Московская область
• Нижегородская область
• Новосибирская область
• Омская область
• Орловская область
• Пензенская область
• Пермский край
• Приморский край
• Ростовская область
• Рязанская область
• Самарская область
• Саратовская область
• Свердловская область
• Ставропольский край
• Тверская область
• Тульская область
• Тюменская область
• Ульяновская область
• Хабаровский край
• Челябинская область
• Ярославская область

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

Тип дома.

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

• «блочный»

• «деревянный»

• «кирпичный»

• «кирпично-монолитный»

• «монолит»

• «панельный».

Год сдачи (год постройки).

Обязательный элемент для домов (жилищных комплексов), которые были сданы менее 5 лет назад или будут сданы в будущем.

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

Необязательный элемент для частных домов.

Корпус дома.

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

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

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

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

• «да»/«нет»

• «true»/«false»

• «1»/«0»

• «+»/«-».

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

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

• «да»/«нет»

• «true»/«false»

• «1»/«0»

• «+»/«-».

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

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

• «да»/«нет»

• «true»/«false»

• «1»/«0»

• «+»/«-».

Лифт.

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

• «да»/«нет»

• «true»/«false»

• «1»/«0»

• «+»/«-».

Мусоропровод.

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

• «да»/«нет»

• «true»/«false»

• «1»/«0»

• «+»/«-».

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

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

• «да»/«нет»

• «true»/«false»

• «1»/«0»

• «+»/«-».

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

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

• «да»/«нет»

• «true»/«false»

• «1»/«0»

• «+»/«-».

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

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

• «да»/«нет»

• «true»/«false»

• «1»/«0»

• «+»/«-».

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

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

• «да»/«нет»

• «true»/«false»

• «1»/«0»

• «+»/«-».

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

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

• «да»/«нет»

• «true»/«false»

• «1»/«0»

• «+»/«-».

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

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

• «да»/«нет»

• «true»/«false»

• «1»/«0»

• «+»/«-».

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

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

• «да»/«нет»

• «true»/«false»

• «1»/«0»

• «+»/«-».

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

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

• «да»/«нет»

• «true»/«false»

• «1»/«0»

• «+»/«-».

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

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

• «да»/«нет»

• «true»/«false»

• «1»/«0»

• «+»/«-».

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

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

• «да»/«нет»

• «true»/«false»

• «1»/«0»

• «+»/«-».

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

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

• «да»/«нет»

• «true»/«false»

• «1»/«0»

• «+»/«-».

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

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

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

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

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

• «да»/«нет»

• «true»/«false»

• «1»/«0»

• «+»/«-».

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

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

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

• «да»/«нет»

• «true»/«false»

• «1»/«0»

• «+»/«-».

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

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

• «да»/«нет»

• «true»/«false»

• «1»/«0»

• «+»/«-».

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

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

• «да»/«нет»

• «true»/«false»

• «1»/«0»

• «+»/«-».

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

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

• «да»/«нет»

• «true»/«false»

• «1»/«0»

• «+»/«-».

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

Возможные значения: «гараж»/«garage».

Категория гаража.

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

• «гараж»/«garage»

• «машиноместо»/«parking place»

• «бокс»/«box».

Статус собственности.

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

• «собственность»/«private»

• «кооператив»/«cooperative»

• «по доверенности»/«by proxy».

Название гаражно-строительного кооператива.

Тип парковки.

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

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

• «подземная»/«underground»

• «наземная»/«ground»

• «многоуровневая»/«multilevel».

Материал стен.

Элемент используется только для гаража.

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

• «кирпичный»/«brick»

• «железобетонный»/«ferroconcrete»

• «металлический»/«metal».

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

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

• «да»/«нет»

• «true»/«false»

• «1»/«0»

• «+»/«-».

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

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

• «да»/«нет»

• «true»/«false»

• «1»/«0»

• «+»/«-».

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

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

• «да»/«нет»

• «true»/«false»

• «1»/«0»

• «+»/«-».

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

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

• «да»/«нет»

• «true»/«false»

• «1»/«0»

• «+»/«-».

Наличие автоматических ворот.

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

• «да»/«нет»

• «true»/«false»

• «1»/«0»

• «+»/«-».

Наличие видеонаблюдения.

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

• «да»/«нет»

• «true»/«false»

• «1»/«0»

• «+»/«-».

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

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

• «да»/«нет»

• «true»/«false»

• «1»/«0»

• «+»/«-».

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

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

• «да»/«нет»

• «true»/«false»

• «1»/«0»

• «+»/«-».

Наличие смотровой ямы.

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

• «да»/«нет»

• «true»/«false»

• «1»/«0»

• «+»/«-».

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

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

• «да»/«нет»

• «true»/«false»

• «1»/«0»

• «+»/«-».

Наличие автомойки.

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

• «да»/«нет»

• «true»/«false»

• «1»/«0»

• «+»/«-».

Наличие автосервиса.

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

• «да»/«нет»

• «true»/«false»

• «1»/«0»

• «+»/«-».

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

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

• «да»/«нет»

• «true»/«false»

• «1»/«0»

• «+»/«-».