Каждый второй продавец, который пишет нам в поддержку, на вопрос «а вы подключили API?» отвечает «боюсь давать ключ, вдруг спишут деньги с кабинета». Это главный миф вокруг темы Wildberries API подключить: токен доступа не умеет проводить операции с деньгами и не может изменить ваши реквизиты — он только читает данные, которые вы сами разрешили ему видеть. Разбираем, что такое API Wildberries, как подключить его за 10 минут и что конкретно вы получите: от реальной прибыли по каждому SKU до отчётов, которые больше не нужно собирать вручную по вечерам.
Что такое API Wildberries
API — это программный интерфейс, через который сторонние сервисы получают данные из вашего личного кабинета WB Партнёры без ручного экспорта таблиц. Вместо того чтобы каждый день заходить в кабинет, скачивать отчёт и переносить цифры в Excel, вы один раз выдаёте токен доступа — и данные обновляются автоматически.
У Wildberries несколько независимых API, и подключаются они порознь:
- Statistics API — продажи, заказы, остатки на складах;
- Finance API — детализация финансовых отчётов, все виды удержаний;
- Content API — карточки товаров, характеристики, медиафайлы;
- Prices API — текущие цены и скидки;
- Advertising API — кампании, ставки, расход на рекламу;
- Feedbacks API — отзывы и вопросы покупателей.
Для управленческой аналитики и расчёта реальной прибыли обычно достаточно первых трёх — остальное подключают по мере необходимости.
Как подключить API Wildberries: пошаговая инструкция
Чтобы Wildberries API подключить, не нужен разработчик — вся процедура делается в кабинете за 5 шагов.
Шаг 1. Откройте раздел «Доступ к API»
В личном кабинете WB Партнёры зайдите в Настройки → Доступ к API. Раздел доступен только владельцу аккаунта или сотруднику с соответствующими правами.
Шаг 2. Создайте новый токен
Нажмите «Создать новый токен» и выберите категории доступа. Здесь ключевое решение: не отмечайте разделы, которые сервису не нужны.
| Категория доступа | Что открывает | Нужна для аналитики прибыли |
|---|---|---|
| Статистика | Продажи, заказы, остатки | Да |
| Финансы | Отчёты о реализации, удержания | Да |
| Продвижение | Кампании и расход на рекламу | Да, для расчёта ДРР |
| Цены и скидки | Изменение цен на карточках | Только если сервис сам меняет цены |
| Контент | Карточки товаров, медиа | Нет, для базовой аналитики |
| Вопросы и отзывы | Тексты отзывов покупателей | Нет, для базовой аналитики |
Шаг 3. Установите срок действия ключа
WB позволяет выдать токен бессрочно или с датой истечения. Для сервисов, которыми пользуетесь постоянно, срок не критичен — важнее возможность отозвать ключ вручную в любой момент.
Шаг 4. Скопируйте токен
Ключ показывается один раз в момент создания. Если закрыли окно, не сохранив его, — создавайте новый, старый восстановить нельзя.
Шаг 5. Вставьте токен в сервис аналитики
В настройках интеграции сервиса (например «Лёгких цифр») вставьте скопированный ключ и запустите синхронизацию. Первая выгрузка истории обычно занимает 15–40 минут в зависимости от количества SKU и глубины истории — дальше данные обновляются в фоне без вашего участия.
Что доступно через API
Сам по себе API не считает прибыль — он отдаёт сырые данные, из которых прибыль можно посчитать. Разница принципиальная: в личном кабинете WB вы видите выручку, а не то, сколько денег реально осталось после всех расходов.
Через API Statistics и Finance доступны:
- продажи и заказы по дням, по SKU, по складам;
- остатки товара на каждом складе WB;
- полная детализация финансового отчёта — все виды удержаний, а не только итоговая строка;
- возвраты, штрафы и их причины;
- стоимость логистики и хранения по факту, а не по тарифной сетке.
Финансовый отчёт через API отдаётся с лагом 1–3 дня после начисления, зато включает все статьи списаний, которые в интерфейсе кабинета разбросаны по разным вкладкам и экспортам. Если добавить сюда себестоимость товара (её вы вносите сами — WB такими данными не располагает), получается полноценная юнит-экономика: сколько денег реально принёс каждый артикул после комиссии, логистики, рекламы и налога.
С Advertising API добавляется расход на продвижение по каждой кампании — это позволяет считать долю рекламных расходов (ДРР) не в целом по магазину, а по конкретному SKU, и видеть, какие карточки рекламируются в убыток.
Безопасность подключения и отзыв доступа
Токен с правами «только чтение» физически не может вывести деньги, изменить банковские реквизиты продавца или совершить операцию с товаром без вашего участия в кабинете. Он читает данные — и всё. Тем не менее подходить к выдаче ключа стоит внимательно.
- ✓ Выдавайте токен только с теми категориями доступа, которые реально нужны сервису
- ✓ Проверяйте, что сервис хранит ключ в зашифрованном виде и не передаёт третьим лицам
- ✓ Периодически проверяйте список активных токенов в разделе «Доступ к API»
- ✗ Не отправляйте ключ в мессенджерах и не публикуйте его в открытых чатах
- ✗ Не выдавайте права «Управление ценами» или «Управление контентом», если сервису нужна только аналитика
Отозвать доступ можно в любой момент: в разделе «Доступ к API» найдите нужный токен и нажмите «Удалить». Доступ прекращается мгновенно, обращаться в поддержку WB не нужно — данные, которые сервис уже успел выгрузить, у него остаются, но новых обновлений он получать не сможет.