Wildberries API: Изменить цены и скидки

Сценарий из mcp-everything. Актуально на 2026-10-24.

Массово обновить цены: переоценка, акция, синхронизация с прайсом.

Нужен токен с категорией «Цены и скидки», хост https://discounts-prices-api.wildberries.ru.
Посмотри текущие цены: GET /api/v2/list/goods/filter с limit (до 1 000) и offset, или с filterNmID для одного товара.
Загрузи новые: POST /api/v2/upload/task — в data список товаров с nmID, price (цена до скидки, в рублях, целое число) и discount (скидка в процентах). До 1 000 товаров за запрос, цена и скидка не могут быть пустыми одновременно.
Загрузка обрабатывается заданием: в ответе id задания. Лимит — 10 запросов за 6 секунд.

curl -X POST https://discounts-prices-api.wildberries.ru/api/v2/upload/task \
  -H "Authorization: $WB_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"data": [{"nmID": 123, "price": 999, "discount": 30}, {"nmID": 456, "price": 2490, "discount": 15}]}'

Базовые URL

Боевой (Контент): https://content-api.wildberries.ru
Тестовый (Контент): https://content-api-sandbox.wildberries.ru
Боевой (Цены и скидки): https://discounts-prices-api.wildberries.ru
Тестовый (Цены и скидки): https://discounts-prices-api-sandbox.wildberries.ru
Боевой (Маркетплейс): https://marketplace-api.wildberries.ru
Боевой (Статистика): https://statistics-api.wildberries.ru
Тестовый (Статистика): https://statistics-api-sandbox.wildberries.ru
Боевой (Аналитика): https://seller-analytics-api.wildberries.ru
Боевой (Продвижение): https://advert-api.wildberries.ru
Боевой (Вопросы и отзывы): https://feedbacks-api.wildberries.ru
Боевой (Чат с покупателями): https://buyer-chat-api.wildberries.ru
Боевой (Поставки): https://supplies-api.wildberries.ru
Боевой (Возвраты): https://returns-api.wildberries.ru
Боевой (Документы): https://documents-api.wildberries.ru
Боевой (Тарифы, Новости): https://common-api.wildberries.ru

Авторизация

Тип: API-ключ

Токен создаётся в кабинете продавца: «Настройки» → «Доступ к API» → выбрать категории → «Создать токен». Сохраните его сразу — повторно посмотреть нельзя. Токен — JWT, действует 180 дней. Передаётся в заголовке Authorization.

Типы токенов: стандартный (полный доступ к выбранным категориям), тестовый (работает только в песочнице) и «только на чтение». Категория токена должна совпадать с категорией вызываемого API, иначе будет 401.

Проверить доступ можно методом /ping на хосте категории, например https://content-api.wildberries.ru/ping. Ответ:

{"TS": "...", "Status": "OK"}

Методы сценария

POST /api/v2/upload/task — Установка цен и скидок

Хост «Цены и скидки». До 1 000 товаров в запросе; цена и скидка не могут быть пустыми одновременно.

Параметр	Где	Тип	Обяз.	Описание
`data`	body	array	да	Товары с ценами и скидками

GET /api/v2/list/goods/filter — Товары с ценами

Параметр	Где	Тип	Обяз.	Описание
`limit`	query	integer	да	Максимум 1 000
`offset`	query	integer	нет	Смещение
`filterNmID`	query	integer	нет	Фильтр по артикулу WB

Нюансы

У каждой категории свой хост и свой токен-доступ; токен без нужной категории даёт 401.
Лимиты работают по алгоритму token bucket: допустимы всплески, а X-Ratelimit-Remaining показывает, сколько запросов можно сделать без задержки.
При 429 приходят заголовки X-Ratelimit-Retry (через сколько секунд повторять), X-Ratelimit-Limit (размер всплеска) и X-Ratelimit-Reset (через сколько секунд всплеск восстановится). Повтор раньше Retry снова вернёт 429.
В категории «Маркетплейс» ответ 409 засчитывается как 5 запросов.
Создание карточек асинхронное: успешный ответ не гарантирует создание, ошибки смотрят отдельным методом.
Обновление карточки перезаписывает её целиком.

Другие сценарии

Если этого недостаточно — официальная документация: https://dev.wildberries.ru/openapi/api-information Вся интеграция одним документом: https://mcp-everything.ru/integrations/wildberries.md