API ключ Wildberries (токен WB) — это то, с чего начинается любая автоматизация. Получить его несложно: несколько кликов в личном кабинете. Сложнее — что делать дальше. Большинство продавцов сталкиваются с необходимостью писать код или нанимать разработчика. В этой статье разберём: как получить API ключ WB, какие токены существуют и как использовать WB API без единой строки кода.
WB API (Application Programming Interface) — это официальный интерфейс, через который сторонние программы могут получать данные из личного кабинета Wildberries и управлять им. По сути, это набор URL-адресов (эндпоинтов), по которым можно запросить нужные данные.
Продавцу WB API нужен для:
Важно: API ключ WB не даёт доступ к финансовым операциям — выводу средств или изменению реквизитов. Это только инструмент для работы с данными.
Получить токен WB API можно только через личный кабинет продавца. Это занимает не больше 3 минут.
Откройте seller.wildberries.ru и авторизуйтесь. Для получения API ключа нужен аккаунт продавца — покупательский аккаунт не подойдёт.
В правом верхнем углу нажмите на иконку профиля или найдите раздел «Настройки» в боковом меню. Внутри выберите пункт «Доступ к API».
Кнопка находится в правом верхнем углу раздела. Введите название токена (например, «EcomConnector» или «Google Таблицы») — это поможет отличать токены друг от друга. Выберите нужные права доступа.
После создания WB покажет токен только один раз. Скопируйте его и сохраните в надёжном месте. Если потеряете — придётся создавать новый и перенастраивать все интеграции, которые используют старый ключ.
Совет: создавайте отдельный токен для каждого сервиса или интеграции. Если один из них будет скомпрометирован, достаточно отозвать только его — остальные продолжат работать.
При создании токена WB предлагает выбрать категории прав доступа. Каждая категория открывает доступ к определённому набору методов API.
| Категория токена | Что даёт доступ | Когда нужен |
|---|---|---|
| Статистика | Заказы, продажи, возвраты, остатки FBS, отчёты аналитики | Основной токен для выгрузки данных |
| Контент | Карточки товаров, фото, характеристики, SEO-описания | Управление карточками |
| Реклама | Рекламные кампании, ставки, бюджеты, статистика рекламы | Управление и анализ рекламы |
| Склады и тарифы | Склады WB, тарифы FBO/FBS, остатки на складах WB | Расчёт себестоимости, логистика |
| Цены и скидки | Установка цен, акционных скидок, управление SPP | Автоматизация ценообразования |
| Акции | Участие в промоакциях WB, список акций, условия | Управление участием в промо |
Принцип минимальных привилегий: давайте токену только те права, которые действительно нужны для конкретной задачи. Для выгрузки отчётов в Google Таблицы достаточно прав «Статистика» и, при необходимости, «Склады и тарифы».
Самые востребованные методы WB API для аналитики продаж:
/api/v1/supplier/orders — список заказов за период/api/v1/supplier/sales — продажи и возвраты/api/v1/supplier/reportDetailByPeriod — детализированный финансовый отчёт/api/v1/supplier/incomes — поставки на склады WB/api/v1/supplier/stocks — остатки FBS (на вашем складе)/api/v3/warehouses — список складов WB/api/v1/analytics/warehouse-remains — остатки на складах WB (FBO)/api/v1/analytics/nm-report/grouped — аналитика по артикулам WB (воронка, просмотры, корзины)/api/v1/analytics/brand-share — доля бренда в категории/api/v1/analytics/excise-report — акцизный отчёт/adv/v1/promotion/adverts — список рекламных кампаний/adv/v2/fullstats — статистика рекламных кампаний/adv/v1/upd — ставки и бюджеты кампанийWB API строго ограничивает частоту запросов. Превышение лимита — ошибка 429, и запрос придётся повторять. Типичные ограничения:
Большинство методов отчётности WB API позволяют запросить данные за последние 90 дней. Некоторые методы имеют меньшее окно:
На практике: если вы хотите хранить историю данных дольше 90 дней, необходимо регулярно сохранять данные в свою базу (или Google Таблицу). Именно поэтому важно настроить автоматическое обновление, а не делать выгрузки вручную.
WB регулярно обновляет API: добавляет новые методы, изменяет структуру ответов, переносит методы на новые версии (v1 → v2 → v3). Самостоятельно следить за всеми изменениями и адаптировать код — это постоянная работа.
Большинство продавцов получают API ключ WB и сталкиваются с одной проблемой: чтобы реально использовать API, нужно либо писать код, либо нанимать разработчика. EcomConnector решает эту проблему — это готовое расширение для Google Таблиц, которое уже умеет работать со всеми основными методами WB API.
Вам не нужно знать Python, JavaScript или разбираться в REST API. Вы просто:
EcomConnector устанавливается из Google Workspace Marketplace прямо в вашу Google Таблицу. Это занимает одну минуту.
В боковом сайдбаре EcomConnector укажите токен WB. Расширение автоматически проверит ключ и покажет название вашего магазина.
Отметьте галочками: заказы, продажи, остатки, аналитика, тарифы, реклама. Для каждого отчёта задайте интервал обновления.
Нажмите «Обновить» — через несколько секунд данные появятся в отдельных листах вашей таблицы. Дальше всё обновляется по расписанию автоматически.
| Параметр | Самостоятельный код | EcomConnector |
|---|---|---|
| Время до первых данных | Дни или недели разработки | 5 минут |
| Нужны навыки программирования | Да (Python / JS / Apps Script) | Нет |
| Поддержка при обновлении API WB | Ваша ответственность | Автоматически |
| Обработка rate limits | Нужно реализовать самому | Встроена |
| Количество поддерживаемых отчётов | Только то, что написали | 30+ отчётов WB |
| Поддержка Ozon | Отдельный проект | Да, в одном расширении |
| Расписание обновлений | Нужно настраивать cron/триггеры | Встроено |
| Данные хранятся у вас | В вашей инфраструктуре | В вашем Google Sheets |
Вставьте API ключ Wildberries — и данные появятся в вашей Google Таблице через 30 секунд. Бесплатная установка.
Установить EcomConnectorЧитайте также: API ключ Ozon: как получить и использовать · Интеграция WB с Google Таблицами · Выгрузка отчётов WB · Автоматизация отчётов WB