Зачем нужен API-токен селлеру
В кабинете продавца Wildberries вы видите цифры по продажам, остаткам, рекламе. Но эти данные показываются в одном виде, без возможности сводить их между собой, считать чистую прибыль с учётом всех расходов или строить графики в нужных разрезах.
API-токен — это ключ, который позволяет внешним сервисам безопасно получать ваши данные из WB. Сторонний сервис видит только то, на что вы дали разрешение, и только в режиме чтения, если правильно настроить права.
Для SW Profit, как и для любого нормального аналитического сервиса, нужен токен с правами «Статистика» (продажи, остатки, заказы) и «Продвижение» (рекламные расходы для точного расчёта прибыли).
WB позволяет создать токен либо «полного доступа», либо «только на чтение». Для аналитики всегда выбираем «только на чтение». Тогда даже если токен случайно утечёт, никто не сможет изменить ваши цены или удалить товары — только посмотреть данные.
Какие права требуются для аналитики
Для подключения SW Profit нужны всего две категории доступа:
- Статистика — продажи, заказы, остатки на складах, отчёты о реализации. Это основа: без этих данных сервис вообще не увидит ваш магазин.
- Продвижение — рекламные кампании и расходы по ним. Нужно для точного расчёта чистой прибыли с учётом ДРР. Без этой категории прибыль будет завышенной.
Плюс обязательно включите режим «Только на чтение». Это превращает токен в read-only ключ — даже если он случайно утечёт, никто не сможет изменить ваши цены, удалить товары или запустить рекламу от вашего имени.
«Статистика» даёт цифры выручки и удержаний WB. «Продвижение» добавляет рекламные расходы. Вместе они формируют полную картину прибыльности магазина. Других прав сервис не запрашивает — он просто их не использует.
Пошаговая инструкция получения токена
Войдите в кабинет продавца на seller.wildberries.ru. В правом верхнем углу нажмите на иконку профиля. Откроется выпадающее меню — в нём найдите и выберите пункт «Интеграции по API» (он вынесен отдельно, на одном уровне с «Настройки» и «Документы»).
На странице «Интеграции по API» нажмите кнопку «Создать новый токен». Откроется окно «Создайте токен». Здесь сделайте 3 вещи:
- В верхнем переключателе выберите вкладку «Для интеграции вручную» (правая) — это значит вы сами вставляете токен в нужный сервис.
- Из трёх типов выберите «Персональный токен» (Только для своих решений).
- В поле «Придумайте название токена» введите понятное имя — например
SW Profit. Имя нужно только вам, чтобы потом узнавать токен в списке.
Прокрутите окно до блока «К каким категориям будет доступ». WB покажет список из 13 категорий с чекбоксами. Из них вам нужны только две:
- ✅ Статистика — основа аналитики
- ✅ Продвижение — для будущих функций по детализации рекламных кампаний
Остальные оставьте без галочек: Контент, Маркетплейс, Финансы, Аналитика, Цены и скидки, Вопросы и отзывы, Чат с покупателем, Поставки, Возвраты, Документы, Пользователи. Они для аналитики не нужны.
Дальше в блоке «Уровень доступа к данным» выберите «Только чтение» — это критично для безопасности. По такому токену сервис сможет только получать данные, но не менять цены, не удалять товары, не запускать рекламу.
Внизу окна поставьте галочку «Я понимаю, что не следует передавать токен третьим лицам» — это формальное согласие WB. После всех настроек нажмите фиолетовую кнопку «Создать токен».
WB сгенерирует токен — длинную строку из ~400 символов, начинающуюся на eyJhbGci…. Вы увидите окно «Токен создан» с этой строкой в сером блоке.
Токен показывается только один раз. Если закрыть окно или потерять — заново посмотреть нельзя, придётся создавать новый. Поэтому нажмите кнопку «Скопировать и завершить» внизу окна — она и в буфер обмена положит, и закроет окно. Если кнопки нет — выделите токен целиком (Ctrl+A) и скопируйте (Ctrl+C).
Также WB напоминает справа от токена: он действует 180 дней, потом нужно создать новый.
Откройте SW Profit в новой вкладке. Зарегистрируйтесь или войдите, затем:
- В сайдбаре слева нажмите на иконку шестерёнки или раздел «Настройки»
- Выберите вкладку «Кабинеты WB»
- Нажмите «Добавить кабинет»
- В поле «Название» введите имя магазина (как удобно вам)
- В поле «API-токен» вставьте скопированный токен (Ctrl+V)
- Нажмите «Сохранить»
SW Profit сразу же проверит токен — если всё в порядке, начнётся загрузка ваших данных. Первая загрузка может занять от 2 минут (для нового магазина) до 10 минут (для магазинов с 2-летней историей). За это время сервис вытянет все продажи, заказы, остатки, рекламные расходы.
SW Profit подключается за 2 минуты
Откройте сервис, вставьте токен — получите аналитику с разрезом по товарам, реальной прибылью, ДРР и алертами.
Попробовать →Срок жизни токена и как его обновить
Стандартный токен Wildberries живёт 180 дней с момента создания. После этого срока он автоматически становится недействительным — сервис аналитики начнёт выдавать ошибку «токен истёк».
Когда срок токена приближается к концу:
- SW Profit сам напомнит вам за 7 дней до истечения (в шапке появится уведомление)
- Зайдите в кабинет WB → «Доступ к API»
- Создайте новый токен с теми же правами (Статистика + Продвижение, только на чтение)
- В SW Profit зайдите в «Настройки» → «Кабинеты WB», нажмите «Обновить токен» рядом с нужным магазином, вставьте новый
- Старый токен после этого можно удалить из кабинета WB (необязательно, но рекомендуется для порядка)
Создавая новый токен, ставьте в имени дату создания — например SW Profit Analytics — 2026-06-02. Через полгода сразу будет ясно, какой токен скоро истечёт.
Безопасность токена: 4 правила
API-токен — это как пароль от вашего магазина (даже более ценный, поскольку даёт доступ к данным, которые WB не показывает в обычном кабинете). Несколько правил помогут уберечь его от утечки.
1. Никогда не пересылайте токен незашифрованно
Не отправляйте полный токен в мессенджерах, по email, через социальные сети. Если кто-то просит токен «для проверки» — это почти всегда мошенничество. Легальные сервисы предлагают вставить токен в защищённую форму, а не пересылать.
2. Используйте «только на чтение»
Уже сказали выше, но повторим: всегда создавайте токен в режиме «только на чтение». Тогда максимум что злоумышленник может — увидеть ваши продажи. Цены, товары, рекламу — не тронет.
3. Создавайте отдельный токен для каждого сервиса
Если используете SW Profit и какой-то другой сервис — создайте два разных токена с разными именами. Если один сервис скомпрометирован — отзываете один токен, второй остаётся рабочим. И сразу видно, кто допустил утечку.
4. Если подозрение на утечку — отзывайте немедленно
Если вы случайно опубликовали токен в скриншоте, переслали не тому человеку или подозреваете что какой-то сайт его получил — заходите в кабинет WB → «Доступ к API» → найдите этот токен → нажмите «Отозвать». После отзыва он перестаёт работать мгновенно.
Если вы подозреваете что токен с правом «полного доступа» (не «только на чтение») попал не в те руки — сразу проверьте: изменились ли цены на товары, появились ли новые товары, всё ли в порядке с рекламными кампаниями. После — отзовите токен и создайте новый.
Частые вопросы и проблемы
Что дальше
Когда токен подключён и данные загрузились — следующий шаг это разобраться, что показывают цифры. Начните с расчёта чистой прибыли, чтобы увидеть реальный заработок магазина. Потом углубитесь в юнит-экономику, чтобы найти убыточные товары. И посмотрите как считать маржу и какая нормальная для вашей ниши.
Подключите кабинет за 2 минуты
14 дней бесплатно. Без карты. Все 8 статей расходов учитываются автоматически.
Попробовать →