АВИРОНА Документация Открыть автозагрузку

Для продавцов и интеграторов

Автозагрузка объявлений

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

Личный кабинетБизнесАвтозагрузка
50 МБразмер файла XML, CSV, XLS
60 000объявлений за одну загрузку
Раз в суткипроверка фида по ссылке
Бесплатнов пределах лимита тарифа

01Способы загрузки

В разделе «Автозагрузка» шесть вкладок. Каждая принимает свой формат.

ВкладкаЧто загружаетсяОграничение
XMLФайл в формате Авито XMLдо 50 МБ, до 60 000 объявлений
CSVТаблица CSV: разделитель «;», «,» или табуляция; кодировка UTF-8 или Windows-1251до 50 МБ, до 60 000 строк
XLSТаблица Excel (XLS или XLSX)до 50 МБ, до 60 000 строк
JSONМассив объявлений: вставить в окно или отправить запросомдо 60 000 объявлений, тело запроса до 12 МБ
AvitoXLSX-файл из раздела «Автозагрузка» Авито (несколько листов)до 50 МБ, до 60 000 строк
По ссылкеФид по постоянному адресу: Авито, YML, ЦИАН, Яндекс.Недвижимость и другиедо 250 МБ, до 55 000 позиций

Для программной публикации из своей системы (1С, CRM, сайт) есть API по ключу, он входит в тариф «Максимальный».

02Лимиты

Тарифы

Загрузка доступна на всех тарифах. Тариф ограничивает только число активных объявлений.

ТарифАктивных объявлений
Бесплатныйдо 5 000
Бизнесдо 50 000
Профессиональныйдо 100 000
Максимальныйбез лимита, плюс доступ к API

Если лимит достигнут, новые объявления не создаются, а в отчёте загрузки появляется строка «Лимит тарифа достигнут». Тариф подключается в разделе «Тариф и лимиты».

Технические ограничения

ПараметрЗначение
Размер файла XML, CSV, XLS, XLSX50 МБ
Объявлений за одну загрузку файла или JSON60 000
Размер тела JSON-запроса12 МБ
Фид по ссылке: размер250 МБ
Фид по ссылке: позиций55 000 (остальные не читаются)
Фотографий на объявление (файлы, JSON)10
Фотографий на объявление (API по ключу)30

Загрузка больше 500 объявлений идёт в фоне: ответ приходит сразу, ход виден на странице «Автозагрузка» или по номеру задачи.

03Поля объявления

Одинаковы для CSV, XLS и JSON. В CSV и Excel названия колонок можно писать по-русски: «Название», «Описание», «Цена», «Категория», «Подкатегория», «Город», «Фото», «Видео».

ПолеТипНужноОписание
titleстрокадаЗаголовок, не короче 3 символов (сохраняется до 200)
descriptionстрокадаОписание, не короче 5 символов (сохраняется до 5 000)
priceчислонетЦена в рублях. Если 0 или не указана, цена показывается как «Договорная»
categoryстроканетКатегория сайта (см. список). Если не указана или не распознана, раздел подбирается по названию
subcategoryстроканетПодкатегория
locationстроканетГород или адрес
photosмассив строкнетПрямые ссылки на фото, до 10. Фото скачиваются на Авирону
videoUrlстроканетСсылка на видео
contactMethodстроканетСпособ связи
paramsобъектнетХарактеристики: марка, состояние, год и т. п.
partNumberстроканетНомер детали или артикул, по нему работает поиск

Повторная загрузка

  • Если у вас уже есть объявление с таким же заголовком, оно обновляется (описание, цена, фото), дубль не создаётся.
  • Строки с одинаковыми заголовком и ценой внутри одного файла загружаются один раз.
  • Флаг skipDedup=true отключает обе проверки: каждая строка создаёт новое объявление.
  • В услугах действует правило «одна услуга, одно объявление»: повторы одной услуги не загружаются, даже со skipDedup.
Объявления проверяются автоматически: запрещённое содержимое отклоняется, объявление не из своего раздела переносится в нужный. Цифровые товары загружают только продавцы с допуском.

04Файлы: XML, CSV, XLS

Проще всего загрузить файл на странице «Автозагрузка». Те же адреса использует кабинет; запрос отправляется как multipart/form-data, файл в поле file.

МетодАдресФормат
POST/api/import/xmlАвито XML
POST/api/import/csvCSV
POST/api/import/xlsXLS, XLSX
POST/api/import/avito-xlsXLSX из автозагрузки Авито

Необязательные поля формы: companyId (публикация от имени вашей компании) и skipDedup.

Авито XML

Заголовок берётся из Title; если его нет, у недвижимости он собирается из типа, площади и этажа. Без Description описанием станут заголовок и адрес. Подкатегория берётся из GoodsType или SubCategory, адрес из Address (или Region, City). Остальные теги сохраняются как характеристики.

<Ads formatVersion="3" target="Avito.ru">
  <Ad>
    <Id>A-1024</Id>
    <Title>iPhone 15 Pro 256 ГБ</Title>
    <Description>Новый, в плёнке, полный комплект</Description>
    <Price>89990</Price>
    <Category>Электроника</Category>
    <SubCategory>Смартфоны</SubCategory>
    <Address>Москва</Address>
    <Images>
      <Image url="https://example.com/photo1.jpg"/>
    </Images>
  </Ad>
</Ads>

CSV

Первая строка: заголовки колонок. Несколько фото в одной ячейке разделяются символом |. Колонки сверх основных сохраняются как характеристики.

title;description;price;category;subcategory;location;photos
"iPhone 15";"Новый, запечатан";"89990";"Электроника";"Смартфоны";"Москва";"https://example.com/1.jpg|https://example.com/2.jpg"
"Galaxy S24";"Б/у, отличное состояние";"65000";"Электроника";"Смартфоны";"Санкт-Петербург";"https://example.com/3.jpg"

05JSON

На вкладке JSON массив вставляется прямо в окно. Тот же адрес принимает запрос из кабинета:

POST/api/import/json

Тело: массив объявлений (поля из раздела «Поля объявления»). Параметр строки запроса: skipDedup=true.

[
  {
    "title": "iPhone 15 Pro Max 256 ГБ",
    "description": "Новый, запечатан. Гарантия 1 год.",
    "price": 89990,
    "category": "Электроника",
    "subcategory": "Смартфоны",
    "location": "Москва",
    "photos": ["https://example.com/photo1.jpg"],
    "params": { "brand": "Apple", "condition": "Новое" }
  }
]
Ответ, до 500 объявлений
{
  "success": true,
  "message": "Создано 1, обновлено 0 из 1 объявлений",
  "data": {
    "created": 1, "updated": 0, "skipped": 0, "total": 1,
    "errors": [ /* { "row": 3, "title": "…", "error": "…" } */ ]
  }
}
Ответ, больше 500 объявлений (HTTP 202)
{
  "success": true,
  "jobId": "9f2c41d07ab3e655",
  "message": "Импорт 5000 объявлений запущен в фоне",
  "total": 5000
}

Ход фоновой загрузки:

GET/api/import/status/{jobId}

В ответе data.status (processing, done или error), total, processed, created, updated, skipped, percent, elapsed (секунды) и последние ошибки.

Важно. Адреса /api/import/… работают под входом в личный кабинет. Для загрузки из своей программы без браузера используйте API по ключу.

06Фид по ссылке

Укажите постоянную ссылку на выгрузку на вкладке «По ссылке». Авирона сама скачивает её и обновляет объявления.

  1. Раз в сутки фид скачивается заново. Чаще не проверяется, что бы ни стояло в настройках.
  2. Формат определяется автоматически: Авито XML и XLSX, YML (Яндекс.Маркет), ЦИАН, Яндекс.Недвижимость, XML автодилера, выгрузки baz-on в XML и CSV.
  3. Новые позиции добавляются, у прежних обновляются цены и описания. За один проход создаётся до 500 новых объявлений, остаток догружается примерно через 20 минут.
  4. Объявления этого фида, которых больше нет в выгрузке, уходят в архив. Если из фида разом пропало больше половины позиций, архивация пропускается: такой фид, скорее всего, обрезан.
  5. Архивные по сроку объявления, снова появившиеся в фиде, публикуются заново в пределах лимита тарифа.

Требования к ссылке

  • Адрес http или https, открывается без входа и пароля.
  • Размер до 250 МБ, позиций до 55 000.
  • Фотографии: прямые ссылки на файлы изображений, а не на страницы с ними.
  • У профиля один фид: новая ссылка заменяет прежнюю.

Если фид удалить, его объявления остаются на сайте, но больше не обновляются и через 30 дней без обновления уходят в архив.

07API по ключу

Для 1С, CRM и собственных сайтов. Доступ к API входит в тариф «Максимальный». Ключ создаётся на странице «API и CRM» и действует для профиля (магазина), в котором создан. Когда тариф заканчивается, ключ не удаляется, но запросы получают ответ 403 до продления.

Ключ передаётся в заголовке:

X-API-Key: avr_…
МетодАдресЧто делает
GET/api/v1/categoriesДерево категорий (без ключа)
GET/api/v1/categories/{name}/attributesХарактеристики категории (без ключа)
POST/api/v1/adsСоздать одно объявление
POST/api/v1/ads/bulkСоздать до 100 объявлений: { "ads": [ … ] }
GET/api/v1/adsВаши объявления: page, limit до 100, category, status, minPrice, maxPrice
GET/api/v1/ads/{id}Одно объявление
PUT/api/v1/ads/{id}Изменить объявление
DELETE/api/v1/ads/{id}Удалить объявление

Для POST /api/v1/ads обязательны title (от 3 символов), category, price и location (кроме цифровых товаров). Необязательные: description, subcategory, priceType, photos (до 30) и attributes (характеристики).

Лимит: 100 запросов в минуту на ключ. Остаток виден в заголовках X-RateLimit-Limit и X-RateLimit-Remaining, при превышении приходит ответ 429.

Пример
# Создать объявление
curl -X POST https://avirona.ru/api/v1/ads \
  -H "X-API-Key: $AVIRONA_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title":"iPhone 15 Pro","description":"Новый, в плёнке","price":89990,
       "category":"Электроника","subcategory":"Смартфоны","location":"Москва",
       "photos":["https://example.com/photo.jpg"]}'

# Создать пачкой
curl -X POST https://avirona.ru/api/v1/ads/bulk \
  -H "X-API-Key: $AVIRONA_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ads":[{"title":"Galaxy S24","price":65000,"category":"Электроника","location":"Казань"}]}'

08Шаблоны

Готовые файлы с правильными колонками. Скачиваются без входа.

АдресЧто внутри
/api/import/template/xlsШаблон Excel
/api/import/template/csvШаблон CSV со всеми колонками
/api/import/template/xmlШаблон Авито XML
/api/import/template/csv/{категория}CSV под категорию: transport, parts, wheels, realestate, electronics, services
/api/import/template/categoriesСправочник категорий и подкатегорий

09Категории

Указывайте название категории как на сайте. Полный список подкатегорий отдают /api/import/template/categories и /api/v1/categories.

КатегорияПримеры подкатегорий
ТранспортНовые автомобили, С пробегом, Мотоциклы, Автокраны
ЗапчастиБ/У запчасти, Двигатель, Диски
НедвижимостьПродать квартиру, Продать дом, Сдать квартиру
РаботаВакансии, Резюме
Готовый бизнес и оборудованиеОбщественное питание, Производство
УслугиШиномонтаж, Ремонт под ключ, Сантехнические работы
Личные вещиЖенская одежда, Мужская обувь, Часы
Для дома и дачиБытовая техника, Диваны и кресла, Посуда и товары для кухни
ЭлектроникаСмартфоны, Ноутбуки, Телевизоры и проекторы
Хобби и отдыхВелосипеды, Музыкальные инструменты, Книги и журналы
ГеймингPlayStation, Xbox, Игровые ПК
РастенияКомнатные растения, Рассада
Продукты питанияЧай и кофе, Мёд и продукты пчеловодства
ЖивотныеСобаки, Кошки, Товары для животных
Отдам даром / Приму в дарМебель, Одежда и обувь
ПотеряшкиПотеряно, Найдено
Красота и здоровьеКосметика и макияж, Парфюмерия
Сельское хозяйствоОвощи, Мёд, Мясо
Товары для детейКоляски, Игрушки, Детская обувь
Изделия на заказСтолешницы из камня, Кованые изделия
ОбразованиеМатематика, Английский язык
Цифровые товарыЭлектронные книги, Курсы и обучение (только с допуском)
ОбменОбмен электроники, Обмен авто
ИщуИщу поставщика, Ищу подрядчика

10Поддержка

Вопросы по загрузке: info@avirona.ru или чат поддержки.