Автозагрузка

XML-фид для Авито: формат, требования и проверка файла

Что такое фид Авито, как устроен XML-файл автозагрузки, требования к формату, как проверить фид валидатором и что значит ошибка «XML не соответствует формату».

Редакция ИИстока9 минут
Пример XML-файла автозагрузки Авито

Короткий ответ

Фид Авито — это XML-файл автозагрузки: корневой тег Ads, внутри — блок Ad на каждое объявление с полями Id, Category, Title, Description, Price, Address, Images и полями категории. Файл должен быть в кодировке UTF-8, открываться по ссылке без входа и соответствовать требованиям Авито к категории. Проверить фид можно официальным валидатором Авито до подключения.

Что такое фид Авито

Фидом называют файл с объявлениями, который Авито регулярно забирает по ссылке. Чаще всего это XML: его легко собрать программой, и он без потерь передаёт длинные описания и списки фото.

Фид не публикует объявления сам по себе. Он лишь описывает, какими объявления должны быть. Публикует Авито — при очередной выгрузке по расписанию, в пределах вашего тарифа.

Как выглядит XML для Авито

Структура простая: объявление — это блок Ad, поле — тег внутри блока. Описание с HTML-разметкой оборачивают в CDATA, чтобы теги описания не спутались с тегами файла. Фото — список Image со ссылками.

Точный набор тегов зависит от категории: например, у мебели свои поля для типа, материала и размеров. Берите его из требований Авито к файлам автозагрузки, а не из примеров для другой рубрики.

Пример XML-файла автозагрузки Авито с тегами Ad, Id, Title, Price, Images
Упрощённый пример фида: блок Ad на объявление, постоянный Id, описание в CDATA, фото списком.

Требования к фиду: что проверяют чаще всего

Большинство проблем с фидом — не в объявлениях, а в самом файле:

  • кодировка UTF-8 и корректный заголовок XML
  • закрыты все теги, нет лишних символов до и после корневого тега
  • спецсимволы в тексте экранированы или текст в CDATA
  • у каждого объявления свой Id, одинаковых нет
  • значения списков — дословно из требований Авито
  • ссылка отдаёт сам файл, без входа, редиректа на страницу авторизации и капчи

Как проверить фид Авито

Первое — откройте ссылку в окне инкогнито: браузер должен показать XML. Второе — прогоните файл через официальную проверку XML на сайте автозагрузки Авито: она покажет ошибки формата с номером строки.

Проверка формата не гарантирует публикацию: валидатор не знает, есть ли у вас тариф и не нарушает ли объявление правила. Поэтому после подключения обязательно смотрите отчёт первой выгрузки.

Постоянная ссылка на XML-фид в сервисе автозагрузки
Ссылка на фид в сервисе: откройте её в инкогнито — должен открыться XML.

Ошибка «XML не соответствует формату Авито»

Так Авито сообщает, что не смог прочитать файл целиком. Причина почти всегда техническая: незакрытый тег, символ «&» или «<» в тексте без экранирования, неверная кодировка, HTML-страница вместо XML (например, страница входа) или обрезанный при выгрузке файл.

Чините по порядку: найдите первую ошибку валидатора и исправьте её — последующие часто исчезают сами. Если файл собирает программа, исправлять нужно в ней, иначе ошибка вернётся с новой выгрузкой.

Как загрузить фид в Авито

Откройте в профиле раздел «Автозагрузка», выберите загрузку по расписанию и вставьте ссылку на фид. Задайте время выгрузок. Дальше Авито будет забирать файл сам — менять его содержимое можно сколько угодно, ссылку трогать не нужно.

Практический пример

Амперсанд, который сломал фид

В названии товара появилось «Шкаф & комод». Символ «&» в XML служебный, и файл перестал читаться целиком — Авито сообщил, что XML не соответствует формату, и ни одно объявление не обновилось. Замена на «и» или экранирование символа вернули выгрузку. Сервис, который собирает фид сам, экранирует такие символы автоматически.

Чек-лист

  • файл в UTF-8
  • все теги закрыты
  • описание в CDATA
  • Id уникальны
  • ссылка открывается в инкогнито
  • валидатор Авито без ошибок

Частые вопросы

Фид и файл автозагрузки — это одно и то же?

Да, фидом обычно называют XML-файл автозагрузки, который Авито забирает по ссылке.

Можно ли в фиде использовать HTML в описании?

Да, ограниченный набор тегов: p, br, strong, em, ul, ol, li. Описание лучше оборачивать в CDATA.

Что делать, если валидатор не находит ошибок, а объявления отклонены?

Значит, проблема не в формате, а в данных или правилах: пустое обязательное поле, недопустимое значение, фото не скачивается, нарушение правил Авито. Причина будет в отчёте выгрузки.

Какой размер фида допустим?

Ориентируйтесь на требования Авито и лимиты вашего тарифа. Для больших каталогов важнее, чтобы ссылка отдавала файл быстро и стабильно.

Источники и дальнейшее чтение

По этой теме

Автозагрузка на Авито в ИИсток

Таблица как в Excel с проверкой ошибок до выгрузки, постоянная ссылка на файл, отчёт Авито по каждому объявлению и ИИ-Авитолог в чате. Переезд с сохранением Id. Подписка от 490 ₽ в месяц: автозагрузка до 100 объявлений и 1000 токенов на тексты и фото.

Подключить автозагрузку