Требования к XML-фиду для жилой недвижимости
Перед подготовкой XML-фида ознакомьтесь с требованиями к передаче данных.
Общая информация об объявлении
У элемента offer
есть обязательный атрибут internal-id
, который должен быть уникальным для каждого объявления. Internal-id
может состоять из цифр, латинских и кириллических букв, знаков. Мы рекомендуем заполнять его номером из вашей базы данных.
<offer internal-id="А1245">
...
</offer>
Внимание
Элементы со строго ограниченным набором значений могут содержать только перечисленные варианты. Использование других значений приведет к ошибке обработки фида.
Элемент |
Обязательный элемент |
Описание |
|
|
Тип сделки. Строго ограниченные значения:
|
|
|
Тип недвижимости. Строго ограниченное значение: «жилая»/«living». |
|
|
Категория объекта. Возможные значения:
|
|
Категория гаража. Обязательный элемент для объявлений о продаже и аренде гаражей. Возможные значения:
|
|
|
Номер лота. |
|
|
Кадастровый номер объекта недвижимости. |
|
|
URL страницы с объявлением на вашем сайте. Мы не покажем его в объявлении. |
|
|
|
Дата создания объявления. Указывается в формате Внимание Следите за актуальностью объявлений в фидах и удаляйте объекты, которые уже сданы или проданы. Модерация может заблокировать фид, в котором есть устаревшие объявления. |
|
Дополнительная опция по продвижению объявления. Элемент указывается, если к объявлению должна быть применена дополнительная опция. Возможные значения:
Для значения «raise» («Поднятие») можно применить ежедневное автоподключение в определенное время. Для этого внутри Пример: Обновлять атрибут не нужно. Объявление, к которому применена опция, будет подниматься ежедневно в указанное время. Можно задать расписание включения «Поднятия» добавив элемент Возможные значения:
Пример: В примере автоподнятие будет происходить каждый день в 12:00 и в 15:00 часов, а в выходные ещё и в 18:00 часов с 17 июля. +3:00 — это часовой пояс Москвы.
Внимание Опции нельзя подключить к объявлениям без фотографий. |
|
|
|
Внутри
У каждого типов объекта свои обязательные элементы: для городской недвижимости
для загородной недвижимости
Примечание Допускается передача всего адреса тегом
|
|
|
Страна, в которой расположен объект. Передаётся внутри Примечание Мы принимаем объявления с объектами только на территории России. |
|
Название субъекта РФ. Передаётся внутри Необязательно для Москвы и Санкт-Петербурга. |
|
|
|
Название района субъекта РФ. Передаётся внутри Узнать свой район можно в перечне. |
|
|
Название населенного пункта. Передаётся внутри |
|
Район в населенном пункте. Передаётся внутри |
|
|
|
Адрес объекта — улица и номер здания. Передаётся внутри Необязательно для загородной недвижимости. |
|
|
Номер квартиры. Передаётся внутри |
|
Шоссе. Передаётся внутри Только для объектов в Москве и Московской области. |
|
|
Расстояние по шоссе до МКАД. Передаётся внутри В километрах. Только для Москвы и Московской области. |
|
|
Географическая широта. Передаётся внутри Можно узнать её на Яндекс Картах, сразу под адресом. |
|
|
Географическая долгота. Передаётся внутри Можно узнать её на Яндекс Картах, сразу под адресом. |
|
|
Ближайшая железнодорожная станция. Передаётся внутри Только для загородной недвижимости. |
|
|
Ближайшая станция метро. Состоит из нескольких элементов, передаётся внутри Пример
Если станций несколько, передайте каждую в отдельном |
|
|
Название станции метро. Передаётся внутри |
|
|
Время до метро в минутах на транспорте. Передаётся внутри |
|
|
Время до метро в минутах пешком. Передаётся внутри |
|
|
Название коттеджного посёлка. Только для загородной недвижимости. |
|
|
Идентификатор коттеджного поселка в базе данных Яндекса. Элемент нужен, чтобы объявления подгружались к правильному коттеджному посёлку. Только для загородной недвижимости. Перечень yandex-village-id – https://realty.yandex.ru/export/villages.tsv |
Информация о продавце или арендодателе
Элемент |
Обязательный элемент |
Описание |
|
|
Информация о продавце или арендодателе. Во вложенных тегах указывается подробная информация.
|
|
Имя продавца, арендодателя или агента. |
|
|
|
Номер телефона. Должен начинаться с «+7», номера с «880» не подходят. Пример: Если номеров несколько, каждый из них необходимо передавать в отдельном элементе Примечание Для агентств недвижимости обязательно укажите прямые номера агентов. |
|
Номер телефона для подключения функционала чатов. Должен начинаться с «+79», номера с «880» не подходят. Пример: Примечание На указанном номере телефона обязательно должен быть установлен WhatsApp. |
|
|
|
Тип продавца или арендодателя. Строго ограниченные значения:
Примечание Агентам следует указывать значение «агентство»/«agency». |
|
Название организации. |
|
|
Сайт агентства или застройщика. |
|
|
Электронный адрес продавца. Мы не покажем его покупателям. |
|
|
Ссылка на фотографию агента или логотип компании. Можно загрузить только 1 изображение. Покажем его в листинге и на карточке объявления рядом с номером телефона. Примечание Скачивание URL возможно только по 80 и 443 портам. |
Информация об условиях сделки
Элемент |
Обязательный элемент |
Описание |
|
|
Набор элементов, описывающих цену объекта. Аренда
Продажа
Можно указывать цену за единицу площади. Для этого добавьте в цену Примечание Не добавляйте в <price> ничего, кроме перечисленных в примере элементов. Иначе ваше объявление сломается. |
|
|
Цена. Введите без пробелов. |
|
|
Валюта, в которой указана цена. Возможные значения:
|
|
|
Период для расчета стоимости аренды. Обязательный для аренды. Не указывайте для продажи. Возможные значения:
|
|
Единица площади помещения или участка. Нужна только если цена ( Указывается внутри Возможные значения:
|
|
|
Залог. Строго ограниченные значения:
Элемент не используется для объявлений о продаже. Внимание Не передавайте элемент внутри <price>. |
|
|
Сумма залога в рублях. Применяется в предложениях аренды. Передавать в теге цифрой без указания валюты. ПримерЗалог составляет 50 тысяч рублей. Передавать: |
Дополнительная информация об условиях сделки (для жилой недвижимости)
Элемент |
Обязательный элемент |
Описание |
|
|
Тип сделки. Если элемент отсутствует, все объявления партнера в новостройках считаются квартирами от застройщика. Возможные значения:
Возможные значения для вторичной недвижимости:
|
|
Торг. Строго ограниченные значения:
|
|
|
Ипотека. Строго ограниченные значения:
|
|
|
Предоплата. Укажите число в процентах, но без знака «%». Максимальное значение — 100. |
|
|
Комиссия агента. Укажите число в процентах, но без знака «%». |
|
|
Пометка «Просьба агентам не звонить». Строго ограниченные значения:
|
|
|
Коммунальные услуги включены в стоимость в договоре аренды. Строго ограниченные значения:
|
|
|
Оплата коммунальных услуг по счетчикам. Возможные значения:
|
Информация об объекте
Элемент |
Обязательный элемент |
Описание |
|
|
Общая площадь. Обязательный элемент для всех объявлений, кроме участков (см. элемент lot-area). Значение и единица измерения площади передаются во вложенных тэгах:
|
|
|
Площадь комнаты. Обязательный элемент для продажи и аренды комнаты. Для каждой комнаты нужно передать отдельный
Не используйте его для студий и объектов со свободной планировкой, достаточно будет |
|
|
Жилая площадь. При продаже и сдаче комнаты укажите площадь этой комнаты, а не всей квартиры.
|
|
Площадь кухни.
|
|
|
Площадь участка. Указывается для категорий: «дом с участком» и «участок». В коммерческой недвижимости площадь участка указывается для категории «земли коммерческого назначения» или для обозначения площади участка, прилегающего к отдельно стоящему зданию. Объекты больше 1 гектара считаются коммерческими. Подробнее: Коммерческая недвижимость. Пример
|
|
|
Площадь. Указывается числовое значение. |
|
|
Тип участка. Возможные значения:
|
|
|
Единица площади помещения или участка. Элемент используется, если цена указана за единицу площади. Возможные значения:
|
|
|
|
Фотография. Обязательный элемент. Добавьте не менее 3 фото. Может быть несколько тегов. Фотографии планировок следует передавать первым тегом Не следует передавать изображения, не имеющие прямого отношения к объекту (например, логотипы или фотографии сотрудников). Примечание Скачивание URL возможно только по 80 и 443 портам. |
|
«Умные фотографии». Алгоритм выберет самые удачные фотографии и покажет их первыми. Это изменит порядок снимков в объявлении. Возможные значения:
|
|
|
Ремонт. Возможные значения:
|
|
|
Дополнительная информация. Описание в свободной форме. Ограничение – 10 000 знаков. |
|
|
Убрать из объявления типовую планировку квартиры. В объявления о сдаче и продаже квартир в домах серийной застройки может добавиться типовая планировка помещения. Чтобы убрать её, укажите этот тег. Планировки добавляются на основе метража квартиры. Строго ограниченные значения:
|
|
|
Видео объекта с YouTube и возможность онлайн-показа.
Примечание 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>
Описание жилого помещения
Элемент |
Обязательный элемент |
Описание |
|
|
Общее количество комнат в квартире. При свободной планировке укажите количество комнат по паспорту объекта. Не обязательно для частных домов. Не указывайте для студий. |
|
|
Количество комнат, участвующих в сделке. Указывайте только при продаже или сдаче комнаты. Не используйте для студий и квартир со свободной планировкой. |
|
|
Этаж, на котором находится объект. Используйте при продаже или сдаче квартиры и комнаты. |
|
Апартаменты. Строго ограниченные значения:
|
|
|
Студия. Элемент используется только для объявлений о продаже и аренде квартиры. Строго ограниченные значения:
Элемент не используется для объектов со свободной планировкой. |
|
|
Свободная планировка. Элемент используется только для объявлений о продаже квартиры. Строго ограниченные значения:
Элемент не используется для студий. |
|
|
Тип комнат. Возможные значения:
|
|
|
Вид из окон. Возможные значения:
|
|
|
Тип балкона. Возможные значения:
И т. п. |
|
|
Тип санузла. Возможные значения:
|
|
|
Наличие системы кондиционирования. Строго ограниченные значения:
|
|
|
Наличие телефона. Строго ограниченные значения:
|
|
|
Наличие интернета. Строго ограниченные значения:
|
|
|
|
Наличие мебели. Строго ограниченные значения:
|
|
Наличие мебели на кухне. Строго ограниченные значения:
|
|
|
Наличие телевизора. Строго ограниченные значения:
|
|
|
Наличие стиральной машины. Строго ограниченные значения:
|
|
|
Наличие посудомоечной машины. Строго ограниченные значения:
|
|
|
Наличие холодильника. Строго ограниченные значения:
|
|
|
Встроенная техника. Строго ограниченные значения:
|
|
|
Покрытие пола. Возможные значения:
|
|
|
Проживание с детьми. Строго ограниченные значения:
|
|
|
Проживание с животными. Строго ограниченные значения:
|
Описание здания
Элемент |
Обязательный элемент |
Описание |
|
Общее количество этажей в доме. |
|
|
Название жилого комплекса. |
|
|
|
Идентификатор жилого комплекса в базе Яндекса. Нужен чтобы объявления соответствовали правильному корпусу в ЖК. Указан в третьем столбце списка yandex-building-id. Будет виден в URL карточки вашего ЖК. |
|
|
Идентификатор корпуса жилого комплекса в базе Яндекса. Нужен чтобы объявления соответствовали правильному корпусу в ЖК. Указан в седьмом столбце списка yandex-building-id. |
|
Тип дома. Возможные значения:
|
|
|
|
Год сдачи (год постройки). Обязательный элемент для домов (жилищных комплексов), которые были сданы менее 5 лет назад или будут сданы в будущем. Год необходимо указывать полностью, например — «1996», а не «96». Необязательный элемент для частных домов. |
|
Корпус дома. Возможные значения: «корпус 1», «корпус А», «дом 3» и т. п. |
|
|
Высота потолков в метрах. |
|
|
Закрытая территория. Строго ограниченные значения:
|
|
|
Возможность ПМЖ. Элемент используется для домов. Строго ограниченные значения:
|
|
|
Наличие пропускной системы. Строго ограниченные значения:
|
|
|
Лифт. Строго ограниченные значения:
|
|
|
Мусоропровод. Строго ограниченные значения:
|
|
|
Электричество. Элемент используется для домов. Строго ограниченные значения:
|
|
|
Водопровод. Элемент используется для домов. Строго ограниченные значения:
|
|
|
Газ. Элемент используется для домов. Строго ограниченные значения:
|
|
|
Канализация. Элемент используется для домов. Строго ограниченные значения:
|
|
|
Отопление. Элемент используется для домов. Строго ограниченные значения:
|
|
|
Туалет. Элемент используется для домов. Строго ограниченные значения:
|
|
|
Душ. Элемент используется для домов. Строго ограниченные значения:
|
|
|
Бассейн. Элемент используется для домов. Строго ограниченные значения:
|
|
|
Бильярд. Элемент используется для домов. Строго ограниченные значения:
|
|
|
Сауна. Элемент используется для домов. Строго ограниченные значения:
|
|
|
Наличие охраняемой парковки. Строго ограниченные значения:
|
|
|
Количество предоставляемых парковочных мест. |
|
|
Стоимость парковочного места. Указывается стоимость одного места в месяц в рублях. |
|
|
Наличие гостевых парковочных мест. Строго ограниченные значения:
|
|
|
Количество гостевых парковочных мест. |
|
|
Наличие сигнализации в доме. Строго ограниченные значения:
|
|
|
Наличие сигнализации в квартире. Строго ограниченные значения:
|
|
|
Наличие охраны. Строго ограниченные значения:
|
|
|
Элитная недвижимость. Строго ограниченные значения:
|
Описание гаражей
Внимание
Элементы со строго ограниченным набором значений могут содержать только перечисленные варианты. Использование других значений приведет к ошибке обработки фида.
Элемент |
Обязательный элемент |
Описание |
|
Категория объекта. Возможные значения: «гараж»/«garage». |
|
|
|
Категория гаража. Возможные значения:
|
|
Статус собственности. Возможные значения:
|
|
|
Название гаражно-строительного кооператива. |
|
|
Тип парковки. Элемент используется только для бокса и парковочного места. Возможные значения:
|
|
|
Материал стен. Элемент используется только для гаража. Возможные значения:
|
|
|
Наличие отопления. Возможные значения:
|
|
|
Наличие электроснабжения. Возможные значения:
|
|
|
Наличие водопровода. Возможные значения:
|
|
|
Наличие охраны. Возможные значения:
|
|
|
Наличие автоматических ворот. Возможные значения:
|
|
|
Наличие видеонаблюдения. Возможные значения:
|
|
|
Наличие пожарной сигнализации. Возможные значения:
|
|
|
Наличие пропускной системы. Возможные значения:
|
|
|
Наличие смотровой ямы. Возможные значения:
|
|
|
Наличие подвала или погреба. Возможные значения:
|
|
|
Наличие автомойки. Возможные значения:
|
|
|
Наличие автосервиса. Возможные значения:
|
|
|
Признак гаража в новостройке. Возможные значения:
|
Пример корректного 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>
<creation-date>2010-11-13T12:32:45+04:00</creation-date>
<location>
<country>Россия</country>
<locality-name>Москва</locality-name>
<address>Яузская улица, 27</address>
<apartment>135</apartment>
<metro>
<name>Китай-город</name>
<time-on-foot>10</time-on-foot>
<time-on-transport>5</time-on-transport>
</metro>
</location>
<sales-agent>
<category>agency</category>
<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>
<yandex-building-id>12345</yandex-building-id>
<yandex-house-id>54321</yandex-house-id></offer>
<!-- Аренда комнаты -->
<offer internal-id="3">
<type>аренда</type>
<property-type>жилая</property-type>
<category>комната</category>
<creation-date>2010-11-13T12:32:45+04:00</creation-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>
<rent-pledge>да</rent-pledge>
<area>
<value>140</value>
<unit>кв. м</unit>
</area>
<room-space>
<value>15</value>
<unit>кв. м</unit>
</room-space>
<living-space>
<value>15</value>
<unit>кв. м</unit>
</living-space>
<rooms>5</rooms>
<rooms-offered>1</rooms-offered>
<floor>12</floor>
</offer>
<!-- Гараж -->
<offer internal-id="15">
<type>продажа</type>
<category>гараж</category>
<garage-type>гараж</garage-type>
<creation-date>2017-03-22T10:10:05+04:00</creation-date>
<location>
<country>Россия</country>
<region>Московская область</region>
<locality-name>Протвино</locality-name>
</location>
<sales-agent>
<category>agency</category>
<phone>+74952203206</phone>
</sales-agent>
<price>
<value>600000</value>
<currency>RUR</currency>
</price>
<area>
<value>20</value>
<unit>кв. м</unit>
</area>
<building-type>железобетонный</building-type>
<heating-supply>да</heating-supply>
<electricity-supply>да</electricity-supply>
<water-supply>нет</water-supply>
<inspection-pit>нет</inspection-pit>
<cellar>да</cellar>
</offer>
</realty-feed>