К справке
Ключи маркетплейсов·обновлено 9 октября 2026 г.

Как получить ключ API Wildberries

Пошагово: где в кабинете WB создать токен, какие категории отметить и почему нужен уровень «Чтение и запись».

Чтобы UnitPlace видел ваши товары, заказы, остатки и деньги на Wildberries, нужен один ключ — токен API. Создаётся он в вашем кабинете продавца за пару минут и вводится у нас один раз.

Создавать токен должен сам владелец магазина — в своём кабинете. Никогда не просите и не передавайте чужой токен: правила Wildberries запрещают передавать доступ к кабинету третьим лицам.

Шаг 1. Откройте раздел с ключами

Зайдите в кабинет продавца seller.wildberries.ru под аккаунтом с правами администратора — обычным сотрудникам Wildberries создавать токены не даёт.

Нажмите на профиль в правом верхнем углу и выберите «Настройки» → «Доступ к API».

Скриншот
WB → профиль → Настройки → Доступ к API: список токенов и кнопка «Создать новый токен»

Шаг 2. Создайте новый токен

Нажмите «Создать новый токен». Появится форма из трёх частей: имя, категории доступа и уровень доступа.

Имя

Любое понятное вам — например, UnitPlace. Оно нужно только чтобы вы потом отличали этот токен от других.

Категории — отметьте все девять

Это самый важный шаг. Wildberries раздаёт доступ по разделам, и если какой-то не отметить, соответствующая часть UnitPlace просто не заработает — вы увидите пустые таблицы вместо данных. Отметьте:

  • Контент — карточки товаров, фото, штрихкоды.
  • Маркетплейс — заказы FBS, сборка, этикетки, поставки, остатки.
  • Статистика — продажи и остатки на складах WB.
  • Цены и скидки — текущие цены и скидки.
  • Вопросы и отзывы — отзывы покупателей и ответы на них.
  • Продвижение — расходы на рекламу и календарь акций (без него реклама WB в аналитике будет нулевой).
  • Финансы — отчёт о реализации: комиссия, логистика, хранение.
  • Поставки — поставки на склады Wildberries.
  • Аналитика — остатки в разбивке по складам WB.
Проще всего отметить все категории сразу — лишние ничему не мешают, а недостающая тихо ломает раздел. Если позже вы захотите урезать доступ, токен всегда можно пересоздать.
Скриншот
WB → Настройки → Доступ к API, момент выбора категорий: видно все галочки категорий, отмечены все девять

Уровень доступа — «Чтение и запись»

Wildberries спросит, что можно делать токеном: только читать или ещё и менять. Нужен вариант «Чтение и запись» (то есть галочку «Только на чтение» ставить не надо).

Почему: UnitPlace не только показывает данные, но и работает за вас — собирает заказы, печатает этикетки, отправляет коды маркировки и сроки годности, публикует ответы на отзывы и вопросы. С токеном «только чтение» всё это откажет.

Шаг 3. Скопируйте токен

После создания Wildberries один раз покажет длинную строку — это и есть ключ. Скопируйте её сразу: повторно посмотреть токен нельзя, при потере придётся создавать новый.

Скриншот
WB: окно с готовым токеном и кнопкой «Скопировать» (сам токен на скрине замазать)

Шаг 4. Вставьте ключ в UnitPlace

  1. Откройте Настройки → Магазины и ключи и в карточке магазина нажмите «+ Wildberries» (если откроется выбор площадки — выберите Wildberries).
  2. Вставьте токен в поле «Ключ API».
  3. Придумайте название интеграции — по нему вы будете отличать её от других.
  4. Нажмите «Подключить».

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

Что произойдёт дальше

Начнётся первая загрузка: подтянутся товары, заказы и остатки. Каталог обычно появляется за несколько минут. Деньги и реклама приходят позже — Wildberries отдаёт их отдельными отчётами.

Что важно знать заранее

Токен живёт 180 дней

Через полгода Wildberries его аннулирует, и данные перестанут обновляться. Это не поломка сервиса: в Настройках → Магазины и ключи появится блок «Нужно ваше действие». Создайте новый токен и нажмите «Заменить ключ». Ничего не потеряется.

Склады WB, финансы и реклама обновляются с задержкой

Wildberries ограничивает частоту таких запросов для токенов внешних сервисов. Поэтому остатки и заказы со складов WB обновляются примерно раз в 3 часа, отчёт о реализации — пару раз в сутки, реклама — раз в сутки. Обойти эти ограничения нельзя. Ваши собственные заказы FBS и остатки обновляются быстро — на них ограничение не распространяется.

Один кабинет Wildberries — один магазин

В один магазин UnitPlace можно подключить только один кабинет Wildberries. Если кабинетов два (например, на два ИП), заведите для второго отдельный магазин.

Ключ хранится в зашифрованном виде

Мы шифруем токен и используем его только для получения ваших данных. Приостановить или удалить подключение можно в любой момент: Настройки → Магазины и ключи → «⋯» в строке Wildberries.