API Wildberries: как получить токен и выгрузить продажи

Wildberries даёт продавцам официальный API: программный доступ к данным своего магазина. Через него без ручных выгрузок из кабинета получают заказы, продажи, остатки, поставки, финансовые отчёты. Всё, что ниже, — по документации WB API на dev.wildberries.ru; на октябрь 2026 года она описывает именно такой порядок. Ссылки — в разделе «Источники».

Если вы ещё выбираете между API и сбором открытых страниц, начните со статьи «Парсинг или API: что выбрать». Коротко: для данных собственного магазина API — правильный канал, парсить здесь нечего.

Что можно получить через API Wildberries

API разбит на разделы, и у каждого раздела своя категория доступа в токене. Для задач продавца чаще всего нужны:

• Статистика — заказы, продажи и возвраты, остатки на складах WB, поставки;
• Финансы — отчёт о реализации с детализацией: логистика, хранение, штрафы, удержания, баланс;
• Аналитика — воронка продаж по карточкам и отчёты по остаткам;
• Контент, Цены и скидки, Маркетплейс — карточки, цены и сборочные задания. Эти категории меняют данные магазина, для выгрузок они не нужны.

Как получить токен

1. Зайти в кабинет продавца владельцем. Создавать и удалять токены может только владелец кабинета.
2. Открыть в профиле раздел интеграций по API и нажать «Создать токен».
3. Выбрать тип и категории. Для своей выгрузки нужен персональный токен. Отметьте только те категории, что нужны: для продаж — «Статистика», для денег — «Финансы». Если токен утечёт, к остальным разделам магазина он доступа не даст.
4. Включить «Только чтение». С этим уровнем токен получает данные, но не может менять цены, остатки и карточки.
5. Скопировать токен сразу. Он показывается один раз. Храните его там же, где пароли; в чаты и общие таблицы его не вставляйте.

Персональный токен действует 180 дней. О скором окончании срока Wildberries предупреждает уведомлением в кабинете, после этого нужно выпустить новый.

Правила, которые важно соблюдать

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

Как выгрузить продажи

Продажи отдаёт метод раздела «Статистика»:

GET https://statistics-api.wildberries.ru/api/v1/supplier/sales?dateFrom=2026-10-20
Authorization: <ваш токен>

Что важно знать о нём по документации:

• dateFrom — дата, с которой нужны изменения. Метод отдаёт строки, изменившиеся после неё; если строк много, следующую порцию запрашивают с даты lastChangeDate последней полученной строки.
• В ответе и продажи, и возвраты. Различить их можно по идентификатору saleID: у продаж он начинается с S, у возвратов — с R.
• Лимит — один запрос в минуту на методы статистики. Поэтому выгрузку запускают по расписанию и выдерживают паузу между запросами.
• Глубина — 90 дней. Более старые данные этим методом не получить, так что историю стоит сохранять у себя с первого дня.

Продажи показывают, что купили. Сколько за это заплатил Wildberries и что удержал, показывает отчёт о реализации из раздела «Финансы» (метод reportDetailByPeriod): там каждая строка — продажа, возврат, логистика, хранение или штраф с суммой. Для сверки денег нужен именно он.

Что дальше делать с выгрузкой

Сама по себе выгрузка — это таблица на тысячи строк. Пользу она приносит, когда её сводят в отчёт или дашборд: продажи по неделям, возвраты по артикулам, удержания по видам. Часть такой работы можно поручить автоматизации с ИИ, но цифры для неё всё равно берутся из API. Как читать самый важный из этих отчётов, разобрано в статье «Отчёт о реализации Wildberries», а какие расхождения в нём искать — на странице услуги «Финансы селлера».

Как это делаем мы

В Datamill мы делаем сверку финансов селлера: выгружаем через официальный API отчёты о реализации, продажи, возвраты и остатки и показываем, где цифры площадки не сходятся. Программа работает у вас, токен создаёте и храните вы, мы его не видим. Первый этап — около недели, от 15 000 ₽. Если нужна регулярная аналитика по нескольким площадкам, посмотрите аналитику маркетплейсов.

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

Можно ли дать токен подрядчику или сервису аналитики?

Персональный токен по правилам Wildberries нельзя передавать третьим лицам и использовать в облачных сервисах. Сервисы, которые подключают чужие кабинеты, работают через свой механизм авторизации. Если выгрузку делает подрядчик, программа должна работать у вас.

Что будет, когда токен истечёт?

Запросы с ним перестанут проходить. Персональный токен действует 180 дней, после этого владелец кабинета выпускает новый и заменяет старый в программе выгрузки.

Может ли токен с «Только чтение» что-то испортить в магазине?

Нет. С этим уровнем доступа токен получает данные и не может менять цены, остатки и карточки. Для выгрузок этого достаточно.

Почему продаж в выгрузке меньше, чем в личном кабинете?

Частые причины: выгрузка начата с поздней даты, данные старше 90 дней уже не отдаются, программа не дождалась следующей страницы из-за лимита. Возвраты приходят в той же выгрузке и уменьшают итог. Сверять лучше по отчёту о реализации.

Можно ли через API получить данные чужого магазина?

Нет. API продавца отдаёт только данные вашего кабинета. Цены и карточки конкурентов в нём не найти, для них используют открытые страницы, это другая задача.

Источники

Документация WB API, проверено на октябрь 2026 года:

• Общая информация о WB API, токены и категории — dev.wildberries.ru/openapi/api-information
• Отчёты и статистика (заказы, продажи, остатки) — dev.wildberries.ru/openapi/reports
• Финансовые отчёты и отчёт о реализации — dev.wildberries.ru/openapi/financial-reports-and-accounting
• Ответы на частые вопросы WB API — dev.wildberries.ru/faq
• Наша услуга: финансы селлера — правила токена Wildberries