API-ключ Wildberries — источник данных о вашей торговле на маркетплейсах для сервиса оцифровки и аналитики. Рассказываем, как его получить и обновить, а также добавить в наш сервис.

Чтобы вы смогли начать пользоваться нашими отчетами нам нужен API доступ к вашим данным, делается это в 2 простых шага

• Создать ваш АПИ-ключ(и) (они же токены) в вашем Личном Кабинета поставщика Вайлдберриз
• Вставить его в раздел «АПИ ключи» в Личном Кабинете сервиса PI-Data
• ВАЖНО НЕ использовать один и тот же ключ в Pi-Data и каком-то другом сервисе — данные будут загружаться с ошибками из-за превышения частоты обращений к API WB

Какие ключи мы просим?

Сначала немного теории (но ее можно и пропустить) — с 28 ноября 2023 года Wildberries позволяет гибко настраивать права доступа АПИ ключей: на что именно (выбрать категории) и какие права у них будут. И теперь это надо указывать при создании любого ключа. Категорий много, ниже мы перечислим только те, которые нужны для работы нашего сервиса (у всех категорий нам нужен доступ только на чтение, т.к. мы ничего не меняем в данных)

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

В итоге нам нужен ключ с правами на чтение к восьми категориям: «Контент», «Статистика», «Аналитика», «Продвижение», «Цены и скидки», «Маркетплейс», «Поставки» и «Возвраты». По этому ключу невозможно ничего отредактировать (нет прав на запись) — в частности Цены и Скидки в безопасности

Как создать АПИ ключ для нашего сервиса?

АПИ ключ создается в личном кабинете на Wildberries Профиль —> Настройки —> Доступ к API (важно — выпускать ключи, они же токены, может только владелец кабинета)

Инструкция для создания нового ключа

• В разделе «Интеграции по API» нажмите на кнопку «Создать токен» (токен = АПИ ключ)

• Откроется окно в котором нужно выбрать иконку Pi-Data из каталога сервисов и кликнуть на него

• или можно просто вбить Pi-Data или PiData в поиске. Тогда в результатах поисках будет отображаться только иконка Pi-Data. Далее нужно будет кликнуть на иконку Pi-Data.

• Заполните появившееся окно как показано на картинке ниже
  • Выберите вариант «только чтение»
  • Важно: Галочку «Тестовый контур» ставить НЕ нужно.
  • Обязательно выберите 8 категорий: Контент, Маркетплейс, Статистика, Аналитика, Продвижение, Цены и скидки, Поставки, Возвраты. Без них наш сервис не примет ваш токен (и подсветит какой категории вам не хватает)

• Нажмите «Создать» и откроется всплывающее окно в котором будет указан, созданный токен. Сразу скопируйте токен и вставьте в наш сервис, потому что он отображается только в момент создания! (мы не рекомендуем его где-либо записывать и сохранять, т.к. это опять-таки небезопасно — лучше при необходимости его перевыпустить, вас в этом никто не ограничивает)

Примечание от команды: таким способом вы можете создавать любое количество ключей (в пределах лимита Wildberries — в марте 2024 лимит равнялся 20 токенам), и мы рекомендуем делать разные ключи для разных сервисов аналитики и программ, с которыми вы работаете.

На это есть как минимум 3 причины, связанные с безопасностью:
— в случае проблем вы сможете быстро отключить любой сервис, которые вызывает подозрения, и не придется менять ключи везде
— по истории вы сможете понять, какой сервис (если вдруг такое случится) что-то «накосячил»
— для каждого сервиса вы выдаете минимум необходимых прав

Как добавить АПИ ключ в наш сервис?

Для этого вам понадобятся

• Доступ в сервис Pi-Data в раздел API ключи
• АПИ ключи из ЛК WB — либо кто-то вам их прислал, либо вы можете сделать их самостоятельно (по инструкции ниже)

В нашем сервисе перейдите в раздел API ключи и нажмите на кнопку «+», появится новая строка для указания поставщика и ввода ключа:

В появившейся строке укажите название поставщика (по этому имени вы впоследствии сможете фильтровать данные — важно, если у вас будет более одного поставщика) и вставьте ключ. После этого нажмите галочку для добавления

После этого система проверит ваши ключи и либо вы увидите сообщение, что мы «запускаем» загрузку данных, либо система выдаст сообщение об ошибке (например, ошибка формата ключа или недостаточно прав или что данный поставщик уже добавлен в систему). Если не получится устранить ошибку самостоятельно, то обязательно обратитесь в техническую поддержку (чат в правом нижнем углу экрана)

Если ошибок нет и запуск прошел успешно, то ключ получит зеленый статус работает — значит все прошло хорошо и скоро данные появятся в системе. О том как быстро это происходит — читайте тут

Если вы хотите подключить к нашему сервису сразу несколько личных кабинетов, то повторите процедуру необходимое число раз.

Подключение по OAuth 2.0

В Pi-Data появился еще один способ интегрировать магазин по API — авторизация через WB OAuth.  При авторизации по OAuth не потребуется создавать, вводить и обновлять API-токены самостоятельно. Всё будет происходить автоматически.

Подключение через Pi-Data

1. Зайди на страницу Настройки и перейди в раздел API ключи

2. Нажми на кнопку «+» и тогда откроется выпадающий список из 2 пунктов и тебе нужно выбрать «Подключить через кабинет поставщика Wb»

3. После этого ты перейдешь на Wildberries. Разреши Pi-Data доступ к твоим данным.

4. Готово! Pi-Data потребуется 10-15 минут, чтобы загрузить информацию. Скорость обработки данных зависит от размера данных твоих магазинов.

Подключение через Wildberries

1. Зайди на страницу Авторизованные сервисы на Wildberries и найди Pi-Data. Нажми кнопку Подключить.

2. Во всплывающем окне нажми кнопку Подключить: вход выполнен.

3. Ты перейдешь на страницу Настройки в раздел API ключи. Нажми на кнопку «+» и тогда откроется выпадающий список из 2 пунктов и тебе нужно выбрать «Подключить через кабинет поставщика Wb»

4. После этого ты вернешься на Wildberries. Разреши Pi-Data доступ к твоим данным. Pi-Data потребуется 10-15 минут, чтобы загрузить информацию.

Состояния ключей и их редактирование

Вы можете увидеть следующие состояния ваших Ключей:
— «Запускаем», голубой: мы запрашиваем данные по ключам и проверяем их работу, занимает несколько первых минут
— «Работает», зеленый: все в порядке, все работает стабильно
— «Отключен», голубой: появляется, когда вы ставите загрузку на паузу
— Красный: данные не загружаются/ ключ не прошел проверку инициализации. Проверьте ключи, возможно, они поменялись и вам нужен новый.
— Желтый: данные не загружаются/временная ошибка.

Действующие ключи можно:
— редактировать (значок карандаша), когда вам нужно обновить ключ поставщика или, например, исправить ошибку в его имени
— временно остановить загрузку данных
— удалить
ВАЖНО: будьте внимательны при удалении, все раннее загруженные данные по поставщику удаляются без возможности восстановления

Дата актуализации статьи: 03 ноября 2025

Pi-Data — сервис оцифровки и аналитики бизнеса на маркетплейсах Wildberries и Ozon