{"name":"Wildberries API","vendor":"Wildberries","industry":"marketplaces","summary":"API маркетплейса Wildberries для продавцов. Разделён на категории, у каждой свой хост: контент (карточки товаров), цены и скидки, маркетплейс (сборочные задания FBS, поставки, остатки), статистика, аналитика, продвижение, вопросы и отзывы, чат с покупателями, поставки FBW, возвраты, документы, тарифы. Токен выпускается в кабинете продавца под нужные категории.","docsUrl":"https://dev.wildberries.ru/openapi/api-information","coverage":{"included":[],"excluded":[]},"scenarios":[{"id":"sobrat-zakazy-fbs-i-peredat-postavku","title":"Собрать заказы FBS и передать поставку в доставку","summary":"Ежедневная работа продавца со своего склада: забрать новые заказы, собрать их в поставку, напечатать стикеры и отгрузить.","steps":["Создай токен в кабинете продавца с категорией «Маркетплейс» и проверь его запросом /ping на хосте https://marketplace-api.wildberries.ru.","Забери новые заказы: GET /api/v3/orders/new. Каждый заказ — сборочное задание с id, артикулом и складом.","Создай поставку: POST /api/v3/supplies с name. В ответе — id поставки вида WB-GI-1234567.","Добавь задания в поставку: PATCH /api/marketplace/v3/supplies/{supplyId}/orders с массивом orders (до 100 за запрос). Задания перейдут в статус confirm.","Напечатай стикеры: POST /api/v3/orders/stickers с type (png, svg или zpl), width и height (58×40 или 40×30) и orders — до 100 заданий. Наклей стикер на каждую упаковку.","Когда всё собрано, закрой поставку: PATCH /api/v3/supplies/{supplyId}/deliver. Задания уйдут в доставку."],"code":"H=\"Authorization: $WB_TOKEN\"\nAPI=https://marketplace-api.wildberries.ru\n\ncurl \"$API/api/v3/orders/new\" -H \"$H\"\n\nSUPPLY=$(curl -s -X POST \"$API/api/v3/supplies\" -H \"$H\" -H 'Content-Type: application/json' \\\n  -d '{\"name\": \"Поставка 24.10\"}' | jq -r .id)\n\ncurl -X PATCH \"$API/api/marketplace/v3/supplies/$SUPPLY/orders\" -H \"$H\" -H 'Content-Type: application/json' \\\n  -d '{\"orders\": [5632423, 5632424]}'\n\ncurl -X POST \"$API/api/v3/orders/stickers?type=png&width=58&height=40\" -H \"$H\" -H 'Content-Type: application/json' \\\n  -d '{\"orders\": [5632423, 5632424]}'\n\ncurl -X PATCH \"$API/api/v3/supplies/$SUPPLY/deliver\" -H \"$H\"","language":"bash","methods":["GET /api/v3/orders/new","POST /api/v3/supplies","PATCH /api/marketplace/v3/supplies/{supplyId}/orders","PATCH /api/v3/supplies/{supplyId}/deliver","POST /api/v3/orders/stickers"]},{"id":"obnovit-ostatki-na-svoem-sklade","title":"Обновить остатки на своём складе","summary":"Синхронизировать остатки из учётной системы, чтобы WB не продал то, чего нет.","steps":["Нужен токен с категорией «Маркетплейс» и ID твоего склада продавца (warehouseId) — он виден в кабинете в разделе складов.","Остатки задаются по размерам товара: в каждой позиции chrtId (ID размера из карточки: sizes[].chrtID в списке карточек) и amount — количество.","Отправь остатки: PUT /api/v3/stocks/{warehouseId} — до 1 000 позиций за запрос. Успех — ответ 204 без тела.","Поля с неверными именами молча игнорируются: если остатки не поменялись, проверь написание chrtId и amount.","Лимит категории — 300 запросов в минуту. При 429 жди столько секунд, сколько в заголовке X-Ratelimit-Retry."],"code":"curl -X PUT \"https://marketplace-api.wildberries.ru/api/v3/stocks/<warehouseId>\" \\\n  -H \"Authorization: $WB_TOKEN\" \\\n  -H 'Content-Type: application/json' \\\n  -d '{\"stocks\": [{\"chrtId\": 12345678, \"amount\": 10}, {\"chrtId\": 12345679, \"amount\": 0}]}'","language":"bash","methods":["PUT /api/v3/stocks/{warehouseId}"]},{"id":"izmenit-tseny-i-skidki","title":"Изменить цены и скидки","summary":"Массово обновить цены: переоценка, акция, синхронизация с прайсом.","steps":["Нужен токен с категорией «Цены и скидки», хост 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 секунд."],"code":"curl -X POST https://discounts-prices-api.wildberries.ru/api/v2/upload/task \\\n  -H \"Authorization: $WB_TOKEN\" \\\n  -H 'Content-Type: application/json' \\\n  -d '{\"data\": [{\"nmID\": 123, \"price\": 999, \"discount\": 30}, {\"nmID\": 456, \"price\": 2490, \"discount\": 15}]}'","language":"bash","methods":["POST /api/v2/upload/task","GET /api/v2/list/goods/filter"]},{"id":"vygruzit-vse-kartochki-tovarov","title":"Выгрузить все карточки товаров","summary":"Получить список своих товаров с артикулами WB, артикулами продавца и размерами — для сопоставления с учётной системой.","steps":["Нужен токен с категорией «Контент», хост https://content-api.wildberries.ru. Лимит — 100 запросов в минуту на все методы категории.","Запроси первую страницу: POST /content/v2/get/cards/list с settings.cursor.limit = 100 и settings.filter.withPhoto = -1 (все карточки).","Для следующей страницы скопируй из ответа cursor.updatedAt и cursor.nmID в settings.cursor запроса.","Повторяй, пока cursor.total не станет меньше limit — значит, получены все карточки.","Из каждой карточки сохрани nmID, vendorCode и sizes[].chrtID — по chrtID обновляются остатки."],"code":"curl -X POST https://content-api.wildberries.ru/content/v2/get/cards/list \\\n  -H \"Authorization: $WB_TOKEN\" \\\n  -H 'Content-Type: application/json' \\\n  -d '{\"settings\": {\"cursor\": {\"limit\": 100}, \"filter\": {\"withPhoto\": -1}}}'\n\n# Следующая страница — с курсором из предыдущего ответа\ncurl -X POST https://content-api.wildberries.ru/content/v2/get/cards/list \\\n  -H \"Authorization: $WB_TOKEN\" \\\n  -H 'Content-Type: application/json' \\\n  -d '{\"settings\": {\"cursor\": {\"limit\": 100, \"updatedAt\": \"2023-12-06T11:17:00.96577Z\", \"nmID\": 123654123}, \"filter\": {\"withPhoto\": -1}}}'","language":"bash","methods":["POST /content/v2/get/cards/list"]},{"id":"sozdat-kartochku-tovara","title":"Создать карточку товара","summary":"Завести новый товар: найти предмет, заполнить обязательные характеристики и отправить карточку.","steps":["Найди предмет (категорию): GET /content/v2/object/all с name — в ответе subjectID.","Узнай характеристики предмета: GET /content/v2/object/charcs/{subjectId}. Обязательные поля отмечены required; для каждой характеристики указан тип значения и единица измерения.","Отправь карточку: POST /content/v2/cards/upload с subjectID и variants — вариантами товара (до 30 на карточку), у каждого vendorCode, title, description, brand, sizes и characteristics.","Создание асинхронное: успешный ответ не значит, что карточка создана. Через минуту-две проверь ошибки методом /content/v2/cards/error/list и найди карточку в списке.","Править карточку — POST /content/v2/cards/update, но она перезаписывается целиком: передавай все поля, а не только изменённые."],"code":"curl -G https://content-api.wildberries.ru/content/v2/object/all \\\n  -H \"Authorization: $WB_TOKEN\" \\\n  --data-urlencode 'name=Кружки' -d limit=10\n\ncurl https://content-api.wildberries.ru/content/v2/object/charcs/<subjectID> -H \"Authorization: $WB_TOKEN\"\n\ncurl -X POST https://content-api.wildberries.ru/content/v2/cards/upload \\\n  -H \"Authorization: $WB_TOKEN\" \\\n  -H 'Content-Type: application/json' \\\n  -d '[{\n        \"subjectID\": <subjectID>,\n        \"variants\": [{\n          \"vendorCode\": \"MUG-WHITE-330\",\n          \"title\": \"Кружка керамическая 330 мл\",\n          \"description\": \"Белая керамическая кружка, подходит для посудомоечной машины.\",\n          \"brand\": \"Моя марка\",\n          \"sizes\": [{\"price\": 990, \"skus\": [\"2000000000017\"]}],\n          \"characteristics\": [{\"id\": <id характеристики>, \"value\": [\"керамика\"]}]\n        }]\n      }]'","language":"bash","methods":["POST /content/v2/cards/upload","POST /content/v2/cards/update","GET /content/v2/object/all","GET /content/v2/object/charcs/{subjectId}"]}],"baseUrls":[{"label":"Боевой (Контент)","url":"https://content-api.wildberries.ru"},{"label":"Тестовый (Контент)","url":"https://content-api-sandbox.wildberries.ru"},{"label":"Боевой (Цены и скидки)","url":"https://discounts-prices-api.wildberries.ru"},{"label":"Тестовый (Цены и скидки)","url":"https://discounts-prices-api-sandbox.wildberries.ru"},{"label":"Боевой (Маркетплейс)","url":"https://marketplace-api.wildberries.ru"},{"label":"Боевой (Статистика)","url":"https://statistics-api.wildberries.ru"},{"label":"Тестовый (Статистика)","url":"https://statistics-api-sandbox.wildberries.ru"},{"label":"Боевой (Аналитика)","url":"https://seller-analytics-api.wildberries.ru"},{"label":"Боевой (Продвижение)","url":"https://advert-api.wildberries.ru"},{"label":"Боевой (Вопросы и отзывы)","url":"https://feedbacks-api.wildberries.ru"},{"label":"Боевой (Чат с покупателями)","url":"https://buyer-chat-api.wildberries.ru"},{"label":"Боевой (Поставки)","url":"https://supplies-api.wildberries.ru"},{"label":"Боевой (Возвраты)","url":"https://returns-api.wildberries.ru"},{"label":"Боевой (Документы)","url":"https://documents-api.wildberries.ru"},{"label":"Боевой (Тарифы, Новости)","url":"https://common-api.wildberries.ru"}],"auth":{"type":"api_key","description":"Токен создаётся в кабинете продавца: «Настройки» → «Доступ к API» → выбрать категории → «Создать токен». Сохраните его сразу — повторно посмотреть нельзя. Токен — JWT, действует 180 дней. Передаётся в заголовке `Authorization`.\n\nТипы токенов: стандартный (полный доступ к выбранным категориям), тестовый (работает только в песочнице) и «только на чтение». Категория токена должна совпадать с категорией вызываемого API, иначе будет `401`.\n\nПроверить доступ можно методом `/ping` на хосте категории, например `https://content-api.wildberries.ru/ping`. Ответ:","example":"{\"TS\": \"...\", \"Status\": \"OK\"}"},"methods":[{"id":"POST /content/v2/get/cards/list","title":"Список карточек товаров","httpMethod":"POST","path":"/content/v2/get/cards/list","description":"Хост «Контент». Возвращает созданные карточки с курсорной пагинацией.","params":[{"name":"locale","in":"query","type":"string","required":false,"description":"Язык"},{"name":"settings","in":"body","type":"object","required":true,"description":"Настройки выборки"},{"name":"settings.cursor.limit","in":"body","type":"integer","required":false,"description":"Количество карточек на странице"},{"name":"settings.filter.withPhoto","in":"body","type":"integer","required":false,"description":"Фильтр по наличию фото; -1 — все"}],"requestExample":"{\n  \"settings\": {\n    \"cursor\": {\n      \"limit\": 100\n    },\n    \"filter\": {\n      \"withPhoto\": -1\n    }\n  }\n}","responseExample":"","docsUrl":""},{"id":"POST /content/v2/cards/upload","title":"Создание карточек товаров","httpMethod":"POST","path":"/content/v2/cards/upload","description":"Создание обрабатывается асинхронно; ошибки смотрят в `/content/v2/cards/error/list`.","params":[{"name":"subjectID","in":"body","type":"integer","required":true,"description":"Предмет (категория)"},{"name":"variants","in":"body","type":"array","required":true,"description":"Варианты товара, до 30 на карточку"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"POST /content/v2/cards/update","title":"Редактирование карточек","httpMethod":"POST","path":"/content/v2/cards/update","description":"Карточка перезаписывается целиком — передавайте все параметры.","params":[{"name":"nmID","in":"body","type":"integer","required":true,"description":"Артикул WB"},{"name":"vendorCode","in":"body","type":"string","required":true,"description":"Артикул продавца"},{"name":"sizes","in":"body","type":"array","required":true,"description":"Размеры"},{"name":"brand","in":"body","type":"string","required":false,"description":"Бренд"},{"name":"title","in":"body","type":"string","required":false,"description":"Наименование, до 60 символов"},{"name":"description","in":"body","type":"string","required":false,"description":"Описание"},{"name":"characteristics","in":"body","type":"array","required":false,"description":"Характеристики"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"GET /content/v2/object/all","title":"Список предметов","httpMethod":"GET","path":"/content/v2/object/all","description":"","params":[{"name":"locale","in":"query","type":"string","required":false,"description":"Язык"},{"name":"name","in":"query","type":"string","required":false,"description":"Поиск по названию"},{"name":"limit","in":"query","type":"integer","required":false,"description":"По умолчанию 30, максимум 1 000"},{"name":"offset","in":"query","type":"integer","required":false,"description":"Смещение"},{"name":"parentID","in":"query","type":"integer","required":false,"description":"Родительская категория"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"GET /content/v2/object/charcs/{subjectId}","title":"Характеристики предмета","httpMethod":"GET","path":"/content/v2/object/charcs/{subjectId}","description":"","params":[{"name":"subjectId","in":"path","type":"integer","required":true,"description":"ID предмета"},{"name":"locale","in":"query","type":"string","required":false,"description":"Язык"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"POST /api/v2/upload/task","title":"Установка цен и скидок","httpMethod":"POST","path":"/api/v2/upload/task","description":"Хост «Цены и скидки». До 1 000 товаров в запросе; цена и скидка не могут быть пустыми одновременно.","params":[{"name":"data","in":"body","type":"array","required":true,"description":"Товары с ценами и скидками"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"GET /api/v2/list/goods/filter","title":"Товары с ценами","httpMethod":"GET","path":"/api/v2/list/goods/filter","description":"","params":[{"name":"limit","in":"query","type":"integer","required":true,"description":"Максимум 1 000"},{"name":"offset","in":"query","type":"integer","required":false,"description":"Смещение"},{"name":"filterNmID","in":"query","type":"integer","required":false,"description":"Фильтр по артикулу WB"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"PUT /api/v3/stocks/{warehouseId}","title":"Обновление остатков","httpMethod":"PUT","path":"/api/v3/stocks/{warehouseId}","description":"Хост «Маркетплейс». Успех — `204`; поля с неверными именами молча игнорируются.","params":[{"name":"warehouseId","in":"path","type":"integer","required":true,"description":"ID склада продавца"},{"name":"stocks","in":"body","type":"array","required":true,"description":"Остатки, от 1 до 1 000 позиций"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"GET /api/v3/orders/new","title":"Новые сборочные задания","httpMethod":"GET","path":"/api/v3/orders/new","description":"Хост «Маркетплейс». Возвращает все новые сборочные задания (FBS). Параметров нет.","params":[],"requestExample":"","responseExample":"","docsUrl":""},{"id":"GET /api/v3/orders","title":"Сборочные задания","httpMethod":"GET","path":"/api/v3/orders","description":"Информация о заданиях без текущего статуса, не больше чем за 30 дней.","params":[{"name":"limit","in":"query","type":"integer","required":true,"description":"От 1 до 1 000"},{"name":"next","in":"query","type":"integer","required":true,"description":"Пагинация: первый запрос — 0, далее значение next из ответа"},{"name":"dateFrom","in":"query","type":"integer","required":false,"description":"Начало периода, Unix timestamp; по умолчанию 30 дней назад"},{"name":"dateTo","in":"query","type":"integer","required":false,"description":"Конец периода, Unix timestamp"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"POST /api/v3/orders/status","title":"Статусы сборочных заданий","httpMethod":"POST","path":"/api/v3/orders/status","description":"","params":[{"name":"orders","in":"body","type":"array","required":true,"description":"ID заданий, от 1 до 1 000"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"POST /api/v3/supplies","title":"Создание поставки","httpMethod":"POST","path":"/api/v3/supplies","description":"Возвращает ID поставки.","params":[{"name":"name","in":"body","type":"string","required":true,"description":"Название, 1–128 символов"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"PATCH /api/marketplace/v3/supplies/{supplyId}/orders","title":"Добавить задания в поставку","httpMethod":"PATCH","path":"/api/marketplace/v3/supplies/{supplyId}/orders","description":"Добавляет до 100 сборочных заданий к поставке и переводит их в статус `confirm`. Может перемещать задания между активными поставками.","params":[{"name":"supplyId","in":"path","type":"string","required":true,"description":"ID поставки, например WB-GI-1234567"},{"name":"orders","in":"body","type":"array","required":true,"description":"ID сборочных заданий, от 1 до 100"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"PATCH /api/v3/supplies/{supplyId}/deliver","title":"Передать поставку в доставку","httpMethod":"PATCH","path":"/api/v3/supplies/{supplyId}/deliver","description":"Закрывает поставку и переводит её задания в статус доставки.","params":[{"name":"supplyId","in":"path","type":"string","required":true,"description":"ID поставки"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"POST /api/v3/orders/stickers","title":"Стикеры сборочных заданий","httpMethod":"POST","path":"/api/v3/orders/stickers","description":"Стикеры для заданий в статусе `confirm`.","params":[{"name":"type","in":"query","type":"string","required":true,"description":"svg, zplv, zplh или png"},{"name":"width","in":"query","type":"integer","required":true,"description":"58 или 40"},{"name":"height","in":"query","type":"integer","required":true,"description":"40 или 30"},{"name":"orders","in":"body","type":"array","required":true,"description":"ID заданий, от 1 до 100"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"PATCH /api/v3/orders/{orderId}/cancel","title":"Отмена сборочного задания","httpMethod":"PATCH","path":"/api/v3/orders/{orderId}/cancel","description":"Переводит задание в статус отмены продавцом.","params":[{"name":"orderId","in":"path","type":"integer","required":true,"description":"ID сборочного задания"}],"requestExample":"","responseExample":"","docsUrl":""}],"codeExamples":[],"errors":[{"code":"200","description":"Успешно"},{"code":"204","description":"Удалено, обновлено или подтверждено"},{"code":"400","description":"Неправильный запрос"},{"code":"401","description":"Не авторизован: проверьте токен и его категорию"},{"code":"403","description":"Доступ запрещён: токен удалённого пользователя или метод заблокирован"},{"code":"404","description":"Не найдено: проверьте URL"},{"code":"409","description":"Ошибка обновления статуса или стикера"},{"code":"413","description":"Слишком большое тело запроса"},{"code":"422","description":"Ошибка обработки параметров"},{"code":"429","description":"Слишком много запросов"},{"code":"5XX","description":"Внутренняя ошибка сервиса"}],"limits":"- Контент — 100 запросов в минуту на все методы категории на аккаунт продавца.\n- Создание карточек — до 100 объединённых карточек (imtID) в запросе, до 30 nmID в карточке, до 10 МБ.\n- Цены и скидки — 10 запросов за 6 секунд; до 1 000 товаров в загрузке цен.\n- Маркетплейс — 300 запросов в минуту на продавца; добавление задания в поставку — 1 000 в минуту.\n- Новости — 10 запросов за 10 минут.","gotchas":["У каждой категории свой хост и свой токен-доступ; токен без нужной категории даёт `401`.","Лимиты работают по алгоритму token bucket: допустимы всплески, а `X-Ratelimit-Remaining` показывает, сколько запросов можно сделать без задержки.","При `429` приходят заголовки `X-Ratelimit-Retry` (через сколько секунд повторять), `X-Ratelimit-Limit` (размер всплеска) и `X-Ratelimit-Reset` (через сколько секунд всплеск восстановится). Повтор раньше `Retry` снова вернёт `429`.","В категории «Маркетплейс» ответ `409` засчитывается как 5 запросов.","Создание карточек асинхронное: успешный ответ не гарантирует создание, ошибки смотрят отдельным методом.","Обновление карточки перезаписывает её целиком."],"slug":"wildberries","version":2,"updatedAt":"2026-10-24T17:05:39.579Z","sources":[{"title":"Общая информация об API","url":"https://dev.wildberries.ru/openapi/api-information","kind":"research","addedAt":"2026-10-12T19:24:52.869Z"},{"title":"Работа с товарами","url":"https://dev.wildberries.by/en/openapi/work-with-products","kind":"research","addedAt":"2026-10-12T19:24:52.869Z"},{"title":"Сборочные задания FBS","url":"https://dev.wildberries.by/en/openapi/orders-fbs","kind":"research","addedAt":"2026-10-12T19:24:52.869Z"},{"title":"Вставленный текст","url":"","kind":"import","addedAt":"2026-10-12T19:24:52.869Z"},{"title":"scenarios-wildberries.md","url":"","kind":"import","addedAt":"2026-10-24T17:05:29.158Z"}],"logoUrl":null}