Общие требования к передаче данных

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

Формат передачи данных

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

Ограничения:

• Нельзя использовать первые 32 ASCII‑символа в текстовых полях.

  Исключения: табуляция, перевод строки, возврат каретки.

• Необходимо кодировать определенные символы:

  Таблица замены символов в YRL‑файле

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

Кодировка

Кодировка фида — UTF‑8.

Заголовок

YRL‑документ должен начинаться со стандартного XML‑заголовка — нулевого символа первой строки:

<?xml version="1.0" encoding="utf-8"?>

Корневой элемент

Корневой элемент YRL‑фида — <realty-feed>. Он должен содержать:

• элемент <generation-date> с датой создания фида;
• элементы <offer>, в каждом из которых — информация из одного объявления.

Чтобы указать пространство имен, используйте атрибут xmlns:

<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).

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

Основные требования

Размещение и доступ:

• фид размещен на вашем домене;
• предоставлен в виде URL‑ссылки;
• доступ к фиду постоянно открыт по протоколу HTTP;
• фид доступен круглосуточно.

Формат и структура:

• структура фида соответствует формату YRL;
• фид содержит только валидные объявления (все поля заполнены согласно формату YRL);
• в фиде передются только те параметры, которые указаны в объявлении;
• для нескольких значений одного параметра (например, фотографий) используется несколько одинаковых тегов.

Содержание:

• каждое объявление посвящено одному объекту недвижимости;
• каждое объявление уникально;
• в объявлениях от агентств недвижимости явно указано агентство.

Оформление текстов:

• для оформления текстов объявлений и характеристик объектов разрешено истользовать только тег <br>, при этом символы < и > следует кодировать соответственно таблице замены символов в YRL‑файле;
• другие HTML-теги не поддерживаются.

Обновление:

• чтобы изменить объявление, обновите текущее — не удаляйте его и не создавайте дубликат;
• обновленное объявление должно иметь тот же internal‑id.

Актуальность

Фид должен содержать актуальные объявления — с достоверной информацией о реальном объекте, доступном для покупки или аренды.

Минимальные доли актуальных объявлений:

• 80 % — для объявлений о продаже недвижимости;
• 70 % — для объявлений об аренде недвижимости.

Объявление считается неактуальным, если:

• объект уже продан или сдан в аренду;
• по указанному телефонному номеру невозможно дозвониться;
• цена в объявлении существенно отличается от запрашиваемой;
• не совпадает адрес или другие параметры.

Сроки публикации

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

Цена объекта

• Цена объекта должна быть выше минимальной цены в соответствующем сегменте в регионе.
• Яндекс Недвижимость вычисляет диапазон цен на объекты разной площади:
  • отдельно для продажи;
  • отдельно для аренды.
• Учитываются различные факторы: привлекательность района, транспортная доступность, социальная инфраструктура.

Требования к объявлениям по типам недвижимости

Подробные описания обязательных и необязательных элементов фида для разных типов недвижимости, особенности значений и их использования описаны отдельно.

См. в разделах:

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