Если вы продаёте на Wildberries или планируете автоматизировать работу с платформой, рано или поздно столкнётесь с необходимостью интеграции через API. Без этого инструмента сложно масштабировать бизнес: вручную обновлять остатки, отслеживать заказы или анализировать продажи при большом ассортименте практически невозможно. API Wildberries позволяет подключить вашу систему учёта, 1С, CRM или собственное ПО к маркетплейсу, чтобы обмениваться данными в реальном времени — от статусов заказов до финансовых отчётов.
Проблема в том, что документация платформы разрозненная, а процесс подключения часто вызывает вопросы. Новичков пугают термины вроде «OAuth 2.0», «токены доступа» или «вебхуки», хотя на практике всё сводится к нескольким шагам в личном кабинете. В этой статье разберём, что такое API Wildberries на самом деле, где его найти, как получить доступ и какие данные можно через него получать — без лишней теории, только практические действия.
Важный момент: API на Wildberries не универсален. Для продавцов и партнёров доступны разные методы, а некоторые функции (например, работа с отзывами или рекламой) требуют отдельных разрешения. Также платформа регулярно обновляет условия использования — поэтому перед интеграцией всегда проверяйте актуальные требования в официальных источниках.
Что такое API Wildberries и зачем он нужен
API (Application Programming Interface) — это «мост» между вашей системой и платформой Wildberries. Через него можно автоматически:
- получать списки заказов и обновлять их статусы;
- управлять остатками товаров на складах;
- загружать и редактировать карточки товаров;
- отслеживать финансовые операции (выплаты, комиссии, штрафы);
- работать с отзывами, вопросами покупателей и возвратами;
- настраивать рекламные кампании.
На практике это означает, что вам не придётся вручную скачивать Excel-файлы с заказами или заходить в личный кабинет каждые 10 минут. Например, если вы используете 1С, то после настройки интеграции все новые заказы будут автоматически попадать в вашу базу, а остатки на Wildberries — синхронизироваться с вашим складом.
Кто может пользоваться API Wildberries
Доступ к API предоставляется:
- Продавцам (официальным партнёрам Wildberries) — для управления заказами, товарами и финансами.
- Разработчикам — если вы создаёте софт для работы с маркетплейсом (например, сервисы аналитики или автоматизации).
- Логистическим партнёрам — для интеграции с системами доставки.
Важно: для разных типов пользователей открыты разные методы API. Например, продавцы не смогут через стандартный доступ получить данные о трафике на карточках товаров — для этого нужны дополнительные разрешения.
Какие данные можно получать через API
Список доступных методов зависит от вашего статуса, но в целом через API можно работать с:
| Категория данных | Примеры методов | Для кого доступно |
|---|---|---|
| Заказы | Получение списка заказов, обновление статусов, информация о доставке | Продавцы, логистические партнёры |
| Товары | Создание/редактирование карточек, управление остатками, цены | Продавцы |
| Финансы | Выплаты, комиссии, штрафы, детализация операций | Продавцы |
| Отзывы и вопросы | Получение отзывов, ответы на вопросы покупателей | Продавцы (с отдельным доступом) |
| Реклама | Управление кампаниями, статистика показов | Продавцы (требуется подключение к WB Ads) |
Например, чтобы автоматически обновлять остатки товаров на складе, вам понадобится метод POST /api/v2/stocks, а для получения списка новых заказов — GET /api/v2/orders.
Где найти API Wildberries и как получить доступ
Чтобы начать работать с API, сначала нужно получить доступ в личном кабинете Wildberries. Вот что нужно сделать:
- Авторизуйтесь в личном кабинете продавца на сайте Wildberries (раздел Для партнёров).
- Перейдите в раздел
API → Настройки API(путь может отличаться в зависимости от версии интерфейса). - Нажмите Подключить API и подтвердите соглашение на обработку данных.
- Сгенерируйте ключ API (он понадобится для авторизации запросов).
📋 Подключение API в личном кабинете
После этого вы получите Client ID и Client Secret — эти данные нужны для авторизации по протоколу OAuth 2.0. Их нельзя передавать третьим лицам!
Как выглядит личный кабинет с доступом к API
В разделе API вы увидите:
- Ключи доступа — здесь генерируются и хранятся ваши токены.
- Документация — ссылка на официальные методы API (открывается в новой вкладке).
- Логи запросов — история ваших обращений к API (полезно для отладки).
- Вебхуки — настройка уведомлений о событиях (например, новый заказ).
Если раздел API отсутствует в меню, значит:
- вы не подтвердили статус продавца (нужно завершить регистрацию);
- ваш аккаунт не имеет прав на подключение API (обратитесь в поддержку);
- Wildberries временно ограничил доступ (проверьте уведомления в личном кабинете).
Где взять документацию по API
Официальная документация доступна:
- в личном кабинете продавца (раздел
API → Документация); - на отдельном портале для разработчиков (ссылка обычно приходит на email после подключения).
В документации описаны:
- доступные методы (endpoint’ы);
- параметры запросов и ответов;
- примеры кода на разных языках (Python, PHP, JavaScript);
- ограничения по количеству запросов (рейт-лимиты).
Пошаговая инструкция: как подключиться к API Wildberries
После получения ключей нужно настроить авторизацию и сделать первый запрос. Вот универсальная схема для большинства задач:
- Получите токен доступа через OAuth 2.0:
- Отправьте POST-запрос на
https://suppliers-api.wildberries.ru/oauth/tokenс параметрами:grant_type=client_credentialsclient_id=ВАШ_CLIENT_IDclient_secret=ВАШ_CLIENT_SECRET
- В ответе получите
access_token(действует 1 час).
- Отправьте POST-запрос на
- Сделайте тестовый запрос:
- Возьмите любой метод из документации (например, получение списка заказов).
- Добавьте в заголовок запроса
Authorization: Bearer ВАШ_TOKEN. - Отправьте запрос и проверьте ответ (должен вернуться JSON с данными).
- Настройте автоматическое обновление токена:
- Токен действует ограниченное время, поэтому его нужно обновлять каждые 60 минут.
- Используйте скрипт или планировщик задач (cron), чтобы запрашивать новый токен автоматически.
Пример запроса для получения токена на Python:
import requests
url = "https://suppliers-api.wildberries.ru/oauth/token"
data = {
"grant_type": "client_credentials",
"client_id": "ВАШ_CLIENT_ID",
"client_secret": "ВАШ_CLIENT_SECRET"
}
response = requests.post(url, data=data)
token = response.json()["access_token"]
Примеры популярных запросов
Вот несколько полезных методов для старта:
| Задача | Метод | Пример запроса |
|---|---|---|
| Получить список заказов | GET /api/v2/orders | curl -X GET "https://suppliers-api.wildberries.ru/api/v2/orders" -H "Authorization: Bearer ТОКЕН" |
| Обновить остатки | POST /api/v2/stocks | curl -X POST "https://suppliers-api.wildberries.ru/api/v2/stocks" -H "Authorization: Bearer ТОКЕН" -d '{"stocks": [{"warehouseId": 1, "sku": 12345, "amount": 10}]}' |
| Получить финансовую аналитику | GET /api/v1/supplier/reportDetailByPeriod | curl -X GET "https://suppliers-api.wildberries.ru/api/v1/supplier/reportDetailByPeriod?dateFrom=2026-01-01" -H "Authorization: Bearer ТОКЕН" |
Как настроить вебхуки (уведомления)
Вебхуки позволяют получать уведомления о событиях в реальном времени (например, когда поступил новый заказ). Для этого:
- В личном кабинете перейдите в
API → Вебхуки. - Укажите URL вашего сервера, куда будут приходить уведомления.
- Выберите события, которые хотите отслеживать (например, Создание заказа или Изменение статуса).
- Подтвердите подключение (Wildberries отправит тестовый запрос на ваш URL).
Ваш сервер должен принимать POST-запросы и возвращать статус 200 OK, иначе Wildberries перестанет отправлять уведомления.
Нюансы и подводные камни при работе с API
Даже после успешного подключения можно столкнуться с проблемами. Вот на что обратить внимание:
Ограничения и лимиты
Wildberries устанавливает жёсткие ограничения на количество запросов:
- 60 запросов в минуту для большинства методов.
- 1000 запросов в день для некоторых аналитических отчётов.
- Запрещены параллельные запросы к одному и тому же методу (может заблокировать IP).
Если превысите лимит, получите ошибку 429 Too Many Requests. В этом случае:
- подождите 1–2 минуты и повторите запрос;
- оптимизируйте код, чтобы сократить количество обращений (например, получайте данные пачками);
- используйте кэширование, чтобы не запрашивать одни и те же данные повторно.
Что делать, если заблокировали доступ
Обычно блокировка временная (на 1–2 часа). Если проблема повторяется, проверьте:
- не отправляете ли вы запросы чаще, чем раз в секунду;
- не используете ли вы один токен с нескольких IP-адресов;
- нет ли в вашем коде бесконечных циклов, которые «забивают» API запросами.
Если блокировка длится дольше суток, обратитесь в поддержку с логами ошибок.
Распространённые ошибки авторизации
Чаще всего проблемы возникают из-за:
- Неверного токена — проверьте, что токен не истёк (действует 1 час) и передан в заголовке
Authorization: Bearer. - Неправильных прав — некоторые методы требуют дополнительных разрешений (например, работа с отзывами).
- Ошибок в Client ID/Secret — убедитесь, что вы скопировали ключи без пробелов и лишних символов.
Если получаете ошибку 401 Unauthorized, значит:
- токен просрочен (обновите его);
- неверно указан заголовок авторизации;
- ваш IP-адрес заблокирован (проверьте логи в личном кабинете).
Проблемы с данными
Иногда API возвращает неполные или некорректные данные. Например:
- Заказы дублируются — это может быть из-за задержек в обновлении статусов. Всегда проверяйте уникальные идентификаторы заказов.
- Остатков нет в ответе — некоторые склады (например, WB Warehouse) могут не отображаться в API. Уточняйте список доступных складов в документации.
- Финансовые отчёты не совпадают с личным кабинетом — это нормально, так как API может выдавать данные с задержкой до 24 часов.
Важный момент: не полагайтесь только на API для критических операций. Например, перед массовым обновлением цен проверяйте данные вручную в личном кабинете.
Типичные ошибки при работе с API Wildberries
Вот самые частые проблемы, с которыми сталкиваются новички:
- Игнорирование рейт-лимитов. Многие начинают отправлять запросы в цикле без задержек, из-за чего их блокируют. Всегда добавляйте паузу между запросами (например,
time.sleep(1)в Python). - Хранение токена в открытом виде. Токены и Client Secret нельзя сохранять в публичных репозиториях или отправлять по email. Используйте переменные окружения или защищённые хранилища.
- Неправильная обработка ошибок. Если API вернул ошибку (например,
500 Server Error), не повторяйте запрос бесконечно — добавьте ограничение на количество попыток. - Использование устаревших методов. Wildberries периодически обновляет API, и старые endpoint’ы могут перестать работать. Следите за анонсами в личном кабинете.
Ещё одна распространённая ошибка — попытка получить данные, к которым нет доступа. Например, если вы не подключены к WB Ads, запросы к рекламному API будут возвращать 403 Forbidden.
☑️ Проверка перед интеграцией
Как эффективно использовать API Wildberries в бизнесе
Просто подключиться к API недостаточно — нужно грамотно внедрить его в рабочие процессы. Вот несколько способов автоматизации, которые реально экономят время:
1. Синхронизация заказов с 1С или CRM. Настройте интеграцию так, чтобы новые заказы с Wildberries автоматически попадали в вашу систему учёта. Это избавит от ручного ввода данных и сократит ошибки. Например, можно:
- сразу резервировать товар на складе;
- формировать накладные для сборки;
- отправлять уведомления менеджерам о срочных заказах.
2. Автоматическое обновление остатков. Если вы продаёте на нескольких площадках, API поможет избежать перепродаж. Настройте скрипт, который будет:
- каждые 30 минут проверять остатки на вашем складе;
- обновлять их на Wildberries с учётом резервов;
- отправлять алерты, если остатки ниже минимального порога.
3. Аналитика продаж в реальном времени. Вместо того чтобы скачивать отчёты в Excel, настройте дашборд (например, в Google Data Studio или Power BI), который будет:
- отображать динамику продаж по часам/дням;
- сравнивать конверсию по разным товарам;
- показывать прибыль с учётом комиссий Wildberries.
На практике даже базовая автоматизация через API позволяет сэкономить до 20–30 часов в месяц на рутинных задачах. Главное — начинать с маленьких шагов: сначала настройте синхронизацию заказов, затем добавьте обновление остатков, а потом переходите к аналитике.
Важный момент: не пытайтесь автоматизировать всё сразу. Начните с одного процесса (например, заказов), протестируйте его в течение недели, а затем добавляйте новые функции. Так вы избежите ошибок, которые могут парализовать работу.