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

Внимание. Мы принимаем фиды только в формате XML, составленные по нашим требованиям или по правилам Авито.
Нельзя загружать форматы:
  • Яндекс.Маркета YML;
  • CSV;
  • Excel .xls или .xlsx;
  • других сайтов с объявлениями.

Требования к передаче данных

Для размещения объявлений на Яндекс.Объявлениях необходимо составить фид в формате XML (Extensible Markup Language).

Формат XML не позволяет использовать первые 32 ASCII-символа в текстовых полях.

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

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

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

Максимальный размер фида по ссылке – 500 Мб, фида-файла — 40 Мб.

Если загружаете фид по ссылке, но используете контроль доступа извне (например, firewall), откройте доступ к этим IP Яндекса: 

5.255.210.88/31
93.158.158.104/30
77.88.23.90/31
77.88.11.152/30
77.88.4.84/31
5.255.216.102/31

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

Фид в формате XML должен начинаться с нулевого символа первой строки со стандартного заголовка.
<?xml version="1.0" encoding="utf-8"?>

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

Корневой элемент feed содержит родительский элемент offers. В offers входят элементы offer, каждый из которых содержит информацию из одного объявления. Имена элементов чувствительны к регистру и состоят только из латинских букв.

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

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

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

Id должен быть уникальным для каждого объявления.

Пример: 

<id>604389521379326</id>
Элемент Обязательное поле Описание
id Идентификатор объявления.

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

Id должен быть уникальным для каждого объявления.

Пример: 

<id>604389521379326</id>

Контакты

Элемент Обязательное поле Описание
contact-method Удобный способ связи.

Выберите одно из значений:

  • only-phone — только звонки
  • only-chat — только сообщения
  • any — звонки и сообщения
По умолчанию разрешены звонки и сообщения. 
<seller>
     <contacts>
         <contact-method>only-phone</contact-method>
         <phone>+7-777-777-77-77</phone>
     </contacts>
</seller>
phone Номер телефона.

Можно указать только один номер.

Телефон должен начинаться с +7 или 8 и содержать код города или оператора.

В фиде можно указывать городские телефонные номера.

Примечание. Обязательно только если contact-method выбран only-phone или any.
Элемент Обязательное поле Описание
contact-method Удобный способ связи.

Выберите одно из значений:

  • only-phone — только звонки
  • only-chat — только сообщения
  • any — звонки и сообщения
По умолчанию разрешены звонки и сообщения. 
<seller>
     <contacts>
         <contact-method>only-phone</contact-method>
         <phone>+7-777-777-77-77</phone>
     </contacts>
</seller>
phone Номер телефона.

Можно указать только один номер.

Телефон должен начинаться с +7 или 8 и содержать код города или оператора.

В фиде можно указывать городские телефонные номера.

Примечание. Обязательно только если contact-method выбран only-phone или any.

Места продажи

Элемент Обязательное поле Описание
location Место продажи.

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

Несколько мест продажи можно указывать только в пределах одного региона.

Пример с адресом

<seller>
    <locations>
        <location>
            <address>Россия, Москва, Тверская улица</address>
        </location>
     </locations>
</seller>
Пример с координатами
<seller>
    <locations>
        <location>
            <geopoint>
                <latitude>37.606397</latitude>
                <longitude>55.763954</longitude>  
             </geopoint>
        </location>
     </locations>
</seller>
Элемент Обязательное поле Описание
location Место продажи.

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

Несколько мест продажи можно указывать только в пределах одного региона.

Пример с адресом

<seller>
    <locations>
        <location>
            <address>Россия, Москва, Тверская улица</address>
        </location>
     </locations>
</seller>
Пример с координатами
<seller>
    <locations>
        <location>
            <geopoint>
                <latitude>37.606397</latitude>
                <longitude>55.763954</longitude>  
             </geopoint>
        </location>
     </locations>
</seller>

Характеристики товара

Элемент Обязательное поле Описание
title Название объявления.

Укажите от 2 до 80 символов.

Пример: 

<title>Увлажнитель воздуха Xiaomi CJXJSQ02ZM</title>
description Описание объявления.

По умолчанию не заполнено.

XHTML и HTML-разметки
Мы поддерживаем XHTML и HTML-разметки. Используйте, если умеете.
  • Разметку располагайте в блоке CDATA.
  • Мы поддерживаем строго ограниченный набор тегов: <b>, <i>, <sup>, <sub>, <strong>, <tt>, <br>, <em>, <p>, <ul>, <ol>, <li>.
  • Не забывайте закрывать теги: <li>естественное увлажнение</li>.
  • Следите за вложенностью и последовательностью.
  • Внутри блока CDATA не нужно заменять символы из таблицы в начале страницы.
Пример: 
<description>
<![CDATA[
<p><strong>Характеристики:</strong></p>
<ul>
<li>естественное увлажнение</li>
<li>обслуживаемая площадь 36 кв.м</li>
<li>производительность 240 мл/ч</li>
</ul>
]]></description>
Пример: 
<description>
Характеристики:
естественное увлажнение
обслуживаемая площадь 36 кв.м
производительность 240 мл/ч
объем резервуара для воды 4 л
регулировка скорости работы
мощность 8 Вт
управление со смартфона
Wi-Fi, Bluetooth</description>
condition Состояние товара.

Одно из значений:

  • new — новый
  • used — б/у
  • inapplicable — неприменимо

Пример: 

<condition>used</condition>
category Значение из каталога. Файл регулярно обновляется.

Передавать нужно значение из второго столбца Имя для фида.

Перед должностью обязательно укажите назначение объявления — Вакансии или Резюме.

Примеры:

<category>Очистители и увлажнители воздуха</category>
<category>Вакансии Старший Механик</category>
<category>Резюме Юрист</category>
Примечание. Наши категории отличаются от тех, что бывают на других сайтах. Сверяйте их внимательно.
images Ссылки на фотографии.
  • По одной в каждом элементе.
  • Скачивание возможно только по http или https.
  • Формат – jpeg или png.
  • Максимальный размер изображения — 20 Мб.
  • Максимальное количество фотографий — 20 штук.
Примечание. По ссылке должна открываться только фотография, а не html. Ссылки с Яндекс.Диска и других подобных хранилищ не подойдут.
Пример: 
<images>
   <image>http://..</image>
   <image>http://...</image>
</images>
video Ссылка на видео c YouTube.

По умолчанию не заполнено.

Пример: 
<video>http://...</video>
price Цена в рублях.

Если готовы отдать даром, укажите 0.

По умолчанию цена не указана.

Пример: 

<price>1000</price>
salary Зарплата в рублях.

По умолчанию не указана.

Пример:
<salary>50000</salary>
Элемент Обязательное поле Описание
title Название объявления.

Укажите от 2 до 80 символов.

Пример: 

<title>Увлажнитель воздуха Xiaomi CJXJSQ02ZM</title>
description Описание объявления.

По умолчанию не заполнено.

XHTML и HTML-разметки
Мы поддерживаем XHTML и HTML-разметки. Используйте, если умеете.
  • Разметку располагайте в блоке CDATA.
  • Мы поддерживаем строго ограниченный набор тегов: <b>, <i>, <sup>, <sub>, <strong>, <tt>, <br>, <em>, <p>, <ul>, <ol>, <li>.
  • Не забывайте закрывать теги: <li>естественное увлажнение</li>.
  • Следите за вложенностью и последовательностью.
  • Внутри блока CDATA не нужно заменять символы из таблицы в начале страницы.
Пример: 
<description>
<![CDATA[
<p><strong>Характеристики:</strong></p>
<ul>
<li>естественное увлажнение</li>
<li>обслуживаемая площадь 36 кв.м</li>
<li>производительность 240 мл/ч</li>
</ul>
]]></description>
Пример: 
<description>
Характеристики:
естественное увлажнение
обслуживаемая площадь 36 кв.м
производительность 240 мл/ч
объем резервуара для воды 4 л
регулировка скорости работы
мощность 8 Вт
управление со смартфона
Wi-Fi, Bluetooth</description>
condition Состояние товара.

Одно из значений:

  • new — новый
  • used — б/у
  • inapplicable — неприменимо

Пример: 

<condition>used</condition>
category Значение из каталога. Файл регулярно обновляется.

Передавать нужно значение из второго столбца Имя для фида.

Перед должностью обязательно укажите назначение объявления — Вакансии или Резюме.

Примеры:

<category>Очистители и увлажнители воздуха</category>
<category>Вакансии Старший Механик</category>
<category>Резюме Юрист</category>
Примечание. Наши категории отличаются от тех, что бывают на других сайтах. Сверяйте их внимательно.
images Ссылки на фотографии.
  • По одной в каждом элементе.
  • Скачивание возможно только по http или https.
  • Формат – jpeg или png.
  • Максимальный размер изображения — 20 Мб.
  • Максимальное количество фотографий — 20 штук.
Примечание. По ссылке должна открываться только фотография, а не html. Ссылки с Яндекс.Диска и других подобных хранилищ не подойдут.
Пример: 
<images>
   <image>http://..</image>
   <image>http://...</image>
</images>
video Ссылка на видео c YouTube.

По умолчанию не заполнено.

Пример: 
<video>http://...</video>
price Цена в рублях.

Если готовы отдать даром, укажите 0.

По умолчанию цена не указана.

Пример: 

<price>1000</price>
salary Зарплата в рублях.

По умолчанию не указана.

Пример:
<salary>50000</salary>

Примеры фидов

С товарами 
<?xml version="1.0" encoding="utf-8"?>
<feed version="1">
    <offers>
        <offer>
            <id>full</id>
            <seller>
                <contacts>
                    <phone>+7-777-777-77-77</phone>
                    <contact-method>only-phone</contact-method>
                </contacts>
                <locations>
                    <location>
                        <address>Россия, Москва, Тверская улица 1</address>
                    </location>
                </locations>
            </seller>
            <title>Диван IKEA Бединге</title>
            <description>
                3-местный диван-кровать. Легко превращается в двуспальную кровать.
                Не нужно снимать чехол, когда вы раскладываете и складываете диван.
            </description>
            <condition>new</condition>
            <category>Диваны и кушетки</category>
            <images>
                <image>http://..</image>
                <image>http://...</image>
            </images>
            <video>http://...</video>
            <price>17000</price>
        </offer>
        <offer>
            <id>short</id>
            <seller>
                <contacts>
                    <contact-method>only-chat</contact-method>
                </contacts>
                <locations>
                    <location>
                        <address>Россия, Москва, Тверская улица</address>
                    </location>
                </locations>
            </seller>
            <title>Увлажнитель воздуха Xiaomi CJXJSQ02ZM</title>
            <condition>used</condition>
            <category>Очистители и увлажнители воздуха</category>
            <price>1000</price>
        </offer>
    </offers>
</feed>
С вакансией
<?xml version="1.0" encoding="utf-8"?>
<feed version="1">
    <offers>
        <offer>
            <id>vacancy123</id>
            <seller>
                <contacts>
                    <phone>+7-777-777-77-77</phone>
                    <contact-method>any</contact-method>
                </contacts>
                <locations>
                    <location>
                        <address>Россия, Москва, Строителей 3</address>
                    </location>
                </locations>
            </seller>
            <title>Водитель такси</title>
            <description>
                В таксопарк ищем водителя такси с опытом. 
            </description>
            <condition>inapplicable</condition>
            <category>Вакансии Водитель</category>
            <images>
                <image>https:///...jpg</image>
            </images>
            <salary>50000</salary>
        </offer> 
    </offers>
</feed>
C резюме
<?xml version="1.0" encoding="utf-8"?>
<feed version="1">
    <offers>
        <offer>
            <id>resume123</id>
            <seller>
                <contacts>
                    <contact-method>only-chat</contact-method>
                </contacts>
                <locations>
                    <location>
                        <address>Россия, Москва, м. Раменки</address>
                    </location>
                </locations>
            </seller>
            <title>Флорист</title>
            <description>
                Более 10 лет занимаюсь цветами — горшечными и срезанными.
            </description>
            <condition>inapplicable</condition>
            <category>Резюме Флорист</category>
            <images>
                <image>https:///...jpg</image>
            </images>
            <salary>70000</salary>
        </offer>
    </offers>
</feed>