Для продавцов и интеграторов
Автозагрузка объявлений
Загрузите сразу десятки или тысячи объявлений: файлом, выгрузкой с Авито, ссылкой на фид или через API. Автозагрузка бесплатная, ограничение одно: число активных объявлений по вашему тарифу.
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 МБ |
| Avito | XLSX-файл из раздела «Автозагрузка» Авито (несколько листов) | до 50 МБ, до 60 000 строк |
| По ссылке | Фид по постоянному адресу: Авито, YML, ЦИАН, Яндекс.Недвижимость и другие | до 250 МБ, до 55 000 позиций |
Для программной публикации из своей системы (1С, CRM, сайт) есть API по ключу, он входит в тариф «Максимальный».
02Лимиты
Тарифы
Загрузка доступна на всех тарифах. Тариф ограничивает только число активных объявлений.
| Тариф | Активных объявлений |
|---|---|
| Бесплатный | до 5 000 |
| Бизнес | до 50 000 |
| Профессиональный | до 100 000 |
| Максимальный | без лимита, плюс доступ к API |
Если лимит достигнут, новые объявления не создаются, а в отчёте загрузки появляется строка «Лимит тарифа достигнут». Тариф подключается в разделе «Тариф и лимиты».
Технические ограничения
| Параметр | Значение |
|---|---|
| Размер файла XML, CSV, XLS, XLSX | 50 МБ |
| Объявлений за одну загрузку файла или JSON | 60 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/csv | CSV |
| POST | /api/import/xls | XLS, XLSX |
| POST | /api/import/avito-xls | XLSX из автозагрузки Авито |
Необязательные поля формы: 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 массив вставляется прямо в окно. Тот же адрес принимает запрос из кабинета:
/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
}
Ход фоновой загрузки:
/api/import/status/{jobId}В ответе data.status (processing, done или error), total, processed, created, updated, skipped, percent, elapsed (секунды) и последние ошибки.
/api/import/… работают под входом в личный кабинет. Для загрузки из своей программы без браузера используйте API по ключу.06Фид по ссылке
Укажите постоянную ссылку на выгрузку на вкладке «По ссылке». Авирона сама скачивает её и обновляет объявления.
- Раз в сутки фид скачивается заново. Чаще не проверяется, что бы ни стояло в настройках.
- Формат определяется автоматически: Авито XML и XLSX, YML (Яндекс.Маркет), ЦИАН, Яндекс.Недвижимость, XML автодилера, выгрузки baz-on в XML и CSV.
- Новые позиции добавляются, у прежних обновляются цены и описания. За один проход создаётся до 500 новых объявлений, остаток догружается примерно через 20 минут.
- Объявления этого фида, которых больше нет в выгрузке, уходят в архив. Если из фида разом пропало больше половины позиций, архивация пропускается: такой фид, скорее всего, обрезан.
- Архивные по сроку объявления, снова появившиеся в фиде, публикуются заново в пределах лимита тарифа.
Требования к ссылке
- Адрес
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 или чат поддержки.