Поиск

Общее (general)

Описание API, процедуры авторизации, доступ к новостям портала продавцов и информации о продавцах

Общее

Описание API, процедуры авторизации, доступ к новостям портала продавцов и информации о продавцах

Введение

Wildberries API предоставляет продавцам возможность управления магазином и получения оперативной и статистической информации по протоколу HTTP Rest API. Описание API предоставляется в формате Swagger (Open API) и может быть использовано для импорта в другие инструменты (такие как PostMan) или генерации клиентского кода на различных языках программирования с помощью Swagger CodeGen. Для ручной проверки API вы можете использовать:

Под ОС Windows - PostMan
Под ОС Linux - curl

Поддержка

Техническая поддержка осуществляется через диалоги в личном кабинете продавца. При создании нового обращения в техподдержку используйте категорию API. Новости и изменения, касающиеся API, публикуются в новостной ленте Wildberries и Telegram-канале.

Авторизация

Чтобы авторизоваться в API, вам понадобится токен. Он действует 180 дней после создания. Добавляйте токен в заголовок запроса Authorization.

По пункту 9.9.6 оферты запрещена интеграция с порталом продавца без публичного (этого) API.

Как создать токен

В личном кабинете нажмите на имя профиля и выберите Настройки → Доступ к API.
Если нужно, выберите опцию:
- Тестовый контур: с токеном можно работать только в тестовом контуре (песочнице).
- Только на чтение: с токеном нельзя ничего изменять, только получать данные. Работает для реальных данных и в тестовом контуре.
Выберите, с какими категориями API вы будете работать с этим токеном.

Категория	Методы
Контент	Категории, предметы и характеристики Создание карточек товаров Карточки товаров Медиафайлы Ярлыки
Аналитика	Воронка продаж Поисковые запросы История остатков Аналитика продавца CSV Отчёт об остатках на складах Отчёт о товарах с обязательной маркировкой Отчёты об удержаниях Платная приёмка Платное хранение Продажи по регионам Доля бренда в продажах Скрытые товары Отчёт о возвратах товаров Динамика оборачиваемости
Цены и скидки	Цены и скидки Календарь акций
Маркетплейс	Заказы FBS Склады продавца Остатки Заказы DBS Самовывоз
Статистика	Основные отчёты Финансовые отчёты
Продвижение	Кампании Создание кампаний Управление кампаниями Финансы Параметры кампаний Медиа Статистика по продвижению
Вопросы и отзывы	Вопросы Отзывы Шаблоны ответов
Чат с покупателями	Чат с покупателями
Поставки	Поставки FBW
Возвраты	Возвраты покупателями
Документы	Документы
Тарифы	Тарифы

Выбирайте только те категории, с которыми вы планируете работать. Например, если вы будете только загружать карточки товаров, выберите одну категорию — Контент. Если токен попадёт в чужие руки, по нему нельзя будет получить доступ к другим категориям API вашего магазина.

Нажмите Создать токен.
Скопируйте и сохраните токен в безопасном месте. Потом его нельзя будет посмотреть в личном кабинете. Если вы потеряли токен, создайте новый.

Если у вас несколько сервисов (интеграций) для работы с разными категориями, создайте для них отдельные токены. Это позволит предоставить доступ только к необходимым категориям, а также более гибко и безопасно управлять интеграциями.

Как устроен токен

Токен представляет собой JWT согласно RFC 7519. Чтобы проверить, действителен ли ваш токен и какие категории методов API по нему доступны, вы можете декодировать его.

Рекомендуем не просматривать токен с помощью онлайн-инструментов, чтобы он не попал в чужие руки.

Публичные поля токена

Поля, которых нет в таблице, служебные, и могут быть удалены.

Поле	Тип	Описание
id	UUIDv4	Уникальный ID токена
s	uint	Битовая маска свойств токена
sid	UUIDv4	Уникальный ID продавца на Wildberries, которому принадлежит токен
exp	uint	Время жизни токена. Соответствует стандарту RFC 7519: JSON Web Token (JWT)
t	boolean	Тестовый контур (песочница)

Поле s

Поле s — это битовая маска, то есть целое число, каждый бит которого означает наличие или отсутствие какого-то свойства.

Подробнее про битовую маску

Значения бит

Позиция бита отсчитывается от 0, где 0 — это младший бит.

Позиция бита	Свойство (если бит равен 1)
1	Доступ к категории Контент
2	Доступ к категории Аналитика
3	Доступ к категории Цены и скидки
4	Доступ к категории Маркетплейс
5	Доступ к категории Статистика
6	Доступ к категории Продвижение
7	Доступ к категории Вопросы и отзывы
9	Доступ к категории Чат с покупателями
10	Доступ к категории Поставки
11	Доступ к категории Возвраты покупателями
12	Доступ к категории Документы
30	Токен только на чтение

Декодирование токена

Декодирование токена позволяет проверить, является ли токен действительным и к каким категориям методов API имеется доступ. Вы можете декодировать токен на отдельной странице.

Проверка подключения к WB API

Проверка подключения{{ /ping }}

Описание метода

Метод проверяет:

Успешно ли запрос доходит до WB API
Валидность токена авторизации и URL запроса
Совпадают ли категория токена и сервис

Метод не предназначен для проверки доступности сервисов WB

У каждого сервиса есть свой вариант метода в зависимости от домена:

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

Максимум 3 запроса за 30 секунд. Если попытаться автоматизировать использование метода, запросы будут временно заблокированы. Лимит действует отдельно для каждого варианта метода в зависимости от домена

Authorizations:

HeaderApiKey

Responses

Response samples

Content type

application/json

{"TS": "2024-08-16T11:19:05+03:00",
"Status": "OK"
}

API новостей

Новости портала продавцов можно получить с любым токеном, у которого не выбрана опция Тестовый контур

Получение новостей портала продавцов{{ /api/communications/v2/news }}

Описание метода

Метод позволяет получать новости портала продавцов.
Для получения успешного ответа необходимо указать один из параметров from или fromID.
За один запрос можно получить не более 100 новостей.

Максимум 10 запросов в 10 минут на один аккаунт продавца

Authorizations:

HeaderApiKey

query Parameters

from	string <date> Example: from=2025-02-06 Дата, от которой необходимо выдать новости
fromID	integer <uint64> Example: fromID=7369 ID новости, начиная с которой — включая её — нужно получить список новостей

Responses

Response samples

Content type

application/json

{"data": [{"content": "Теперь в кампаниях ВБ.Медиа вы можете размещать баннеры для пользователей, которые взаимодействовали с товарами из определённой категории: покупали, искали, добавляли в корзину и избранное. Также можно выбрать период, за который хотите учитывать эти действия.Например, вы продаёте обувь. Рекламу можно показать людям, которые добавляли в корзину или избранное товары из этой категории за последние 14 дней. Возможно, пользователи, которые попадают под этот критерий, уже совершили покупку. Поэтому вы можете уточнить настройки показа: добавить параметр «Не покупал товар из категории „Обувь“ в последние 14 дней». Так вероятность того, что ваш баннер приведёт к покупке, будет выше.Чтобы запустить рекламу, создайте в кабинете ВБ.Медиа кампанию «По показам» и на шаге 4 включите «Поведенческие параметры». Эти параметры можно комбинировать с таргетированием по предполагаемым интересам, полу, возрасту и региону.Подробнее о том, как настроить таргетинг, — в инструкции «По показам».Запустить рекламу на Wildberries ",
"date": "2025-02-05T14:10:35+03:00",
"header": "Новые настройки кампаний в ВБ.Медиа: таргетируйте рекламу в зависимости от того, как аудитория использует сервисы Wildberries",
"id": 7369,
"types": [{"id": 4,
"name": "Маркетинг"
}
]
},
{"content": "Добавили получение отчётов по текстам поисковых запросов в формате CSV. В описания методов «Создать отчёт» и «Получить отчёт» добавили описания и примеры моделей: • запросов — SearchReportTextReq, • успешных ответов (статус-код 200) — SearchReportTextRes.В ответ метода «Поисковые запросы по товару» добавили 8 полей и структуры price и medianPosition. Узнать больше можно в Журнале изменений.Эти методы доступны только с подпиской «Джем»",
"date": "2025-02-06T18:14:58+03:00",
"header": "Изменения в API «Аналитики и данных»",
"id": 7373,
"types": [{"id": 8,
"name": "API"
},
{"id": 41,
"name": "Аналитика продавца"
}
]
}
]
}

Получение новостей портала продавцов{{ /api/communications/v1/news }} Deprecated

Описание метода

Метод будет отключён 7 апреля. Используйте актуальный метод.

Authorizations:

HeaderApiKey

query Parameters

from	string <date> Example: from=2021-11-20 Дата, от которой необходимо выдать новости
fromID	integer <uint64> Example: fromID=1885 ID новости, от которой необходимо выдать новости

Responses

Response samples

Content type

application/json

{"data": [{"id": 1668,
"header": "Новые пункты приёма Маркетплейс",
"text": "<p style=\"margin-bottom: 0px; font-stretch: normal; line-height: normal;\"><font size=\"4\" style=\"\" face=\"Arial\">Уважаемые Продавцы!&nbsp;</font></p>\n<p style=\"margin-bottom: 0px; font-stretch: normal; line-height: normal; min-height: 15px;\"><font size=\"4\" face=\"Arial\"><br></font></p>\n<p style=\"margin-bottom: 0px; font-stretch: normal; line-height: normal;\"><font size=\"4\" face=\"Arial\">Рады сообщить, что по схеме «<b>Продажа со склада Продавца</b>» открыты пункты приёма в следующих городах:&nbsp;</font></p>\n<p style=\"margin-bottom: 0px; font-stretch: normal; line-height: normal; min-height: 15px;\"><font size=\"4\" face=\"Arial\"><br></font></p>\n<p style=\"margin-bottom: 0px; font-stretch: normal; line-height: normal;\"><font size=\"4\" face=\"Arial\"><b>Омск</b></font></p>\n<p style=\"margin-bottom: 0px; font-stretch: normal; line-height: normal;\"><font size=\"4\" face=\"Arial\">Раздольная улица, 1А</font></p>\n<p style=\"margin-bottom: 0px; font-stretch: normal; line-height: normal;\"><font size=\"4\" face=\"Arial\">Омск, Россия, 644105</font></p>\n<p style=\"margin-bottom: 0px; font-stretch: normal; line-height: normal;\"><font size=\"4\" face=\"Arial\">Координаты:</font></p>\n<p style=\"margin-bottom: 0px; font-stretch: normal; line-height: normal;\"><font size=\"4\" face=\"Arial\">55.012114, 73.456130</font></p>\n<p style=\"margin-bottom: 0px; font-stretch: normal; line-height: normal; min-height: 15px;\"><font size=\"4\" face=\"Arial\"><br></font></p>\n<p style=\"margin-bottom: 0px; font-stretch: normal; line-height: normal;\"><font size=\"4\" face=\"Arial\"><b>Саратов</b></font></p>\n<p style=\"margin-bottom: 0px; font-stretch: normal; line-height: normal;\"><font size=\"4\" face=\"Arial\">Дорожная улица, 1</font></p>\n<p style=\"margin-bottom: 0px; font-stretch: normal; line-height: normal;\"><font size=\"4\" face=\"Arial\">поселок Зоринский, Саратовский район, Россия</font></p>\n<p style=\"margin-bottom: 0px; font-stretch: normal; line-height: normal;\"><font size=\"4\" face=\"Arial\">Координаты:</font></p>\n<p style=\"margin-bottom: 0px; font-stretch: normal; line-height: normal;\"><font size=\"4\" face=\"Arial\">51.645721, 45.999510<br>\n<br><b>\nАстрахань</b></font></p>\n<p style=\"margin-bottom: 0px; font-stretch: normal; line-height: normal;\"><font size=\"4\" face=\"Arial\">улица Рождественского, 17</font></p>\n<p style=\"margin-bottom: 0px; font-stretch: normal; line-height: normal;\"><font size=\"4\" face=\"Arial\">Астрахань, Россия, 414057</font></p>\n<p style=\"margin-bottom: 0px; font-stretch: normal; line-height: normal;\"><font size=\"4\" face=\"Arial\">Координаты:</font></p>\n<p style=\"margin-bottom: 0px; font-stretch: normal; line-height: normal;\"><font size=\"4\" face=\"Arial\">46.311839, 48.056589</font></p>\n<p style=\"margin-bottom: 0px; font-stretch: normal; line-height: normal; min-height: 15px;\"><font size=\"4\" face=\"Arial\"><br></font></p>\n<p style=\"margin-bottom: 0px; font-stretch: normal; line-height: normal;\"><font size=\"4\" face=\"Arial\"><b>Барнаул</b></font></p>\n<p style=\"margin-bottom: 0px; font-stretch: normal; line-height: normal;\"><font size=\"4\" face=\"Arial\">улица Чкалова, 251Б</font></p>\n<p style=\"margin-bottom: 0px; font-stretch: normal; line-height: normal;\"><font size=\"4\" face=\"Arial\">Барнаул, Алтайский край, Россия, 656049</font></p>\n<p style=\"margin-bottom: 0px; font-stretch: normal; line-height: normal;\"><font size=\"4\" face=\"Arial\">Координаты:</font></p>\n<p style=\"margin-bottom: 0px; font-stretch: normal; line-height: normal;\"><font size=\"4\" face=\"Arial\">53.330849, 83.752431</font></p>\n<p style=\"margin-bottom: 0px; font-stretch: normal; line-height: normal; min-height: 15px;\"><font size=\"4\" face=\"Arial\"><br></font></p>\n<p style=\"margin-bottom: 0px; font-stretch: normal; line-height: normal;\"><font size=\"4\" face=\"Arial\"><b>Брянск</b></font></p>\n<p style=\"margin-bottom: 0px; font-stretch: normal; line-height: normal;\"><font size=\"4\" face=\"Arial\">Московский проезд, 81</font></p>\n<p style=\"margin-bottom: 0px; font-stretch: normal; line-height: normal;\"><font size=\"4\" face=\"Arial\">Брянск, Россия, 241020</font></p>\n<p style=\"margin-bottom: 0px; font-stretch: normal; line-height: normal;\"><font size=\"4\" face=\"Arial\">Координаты:</font></p>\n<p style=\"margin-bottom: 0px; font-stretch: normal; line-height: normal;\"><font size=\"4\" face=\"Arial\">53.222837, 34.429766</font></p>\n<p style=\"margin-bottom: 0px; font-stretch: normal; line-height: normal; min-height: 15px;\"><font size=\"4\" face=\"Arial\"><br></font></p>\n<p style=\"margin-bottom: 0px; font-stretch: normal; line-height: normal;\"><font size=\"4\" face=\"Arial\"><b>Кемерово</b></font></p>\n<p style=\"margin-bottom: 0px; font-stretch: normal; line-height: normal;\"><font size=\"4\" face=\"Arial\">улица Тухачевского, 100к3</font></p>\n<p style=\"margin-bottom: 0px; font-stretch: normal; line-height: normal;\"><font size=\"4\" face=\"Arial\">Кемерово, Россия</font></p>\n<p style=\"margin-bottom: 0px; font-stretch: normal; line-height: normal;\"><font size=\"4\" face=\"Arial\">Координаты:</font></p>\n<p style=\"margin-bottom: 0px; font-stretch: normal; line-height: normal;\"><font size=\"4\" face=\"Arial\">55.317871, 86.141429</font></p>\n<p style=\"margin-bottom: 0px; font-stretch: normal; line-height: normal; min-height: 15px;\"><font size=\"4\" face=\"Arial\"><br></font></p>\n<p style=\"margin-bottom: 0px; font-stretch: normal; line-height: normal;\"><font size=\"4\" face=\"Arial\"><b>Киров</b></font></p>\n<p style=\"margin-bottom: 0px; font-stretch: normal; line-height: normal;\"><font size=\"4\" face=\"Arial\">Власовская улица, 2/3</font></p>\n<p style=\"margin-bottom: 0px; font-stretch: normal; line-height: normal;\"><font size=\"4\" face=\"Arial\">слобода Лянгасы, Киров, Россия</font></p>\n<p style=\"margin-bottom: 0px; font-stretch: normal; line-height: normal;\"><font size=\"4\" face=\"Arial\">Координаты:</font></p>\n<p style=\"margin-bottom: 0px; font-stretch: normal; line-height: normal;\"><font size=\"4\" face=\"Arial\">58.638221, 49.587597</font></p>\n<p style=\"margin-bottom: 0px; font-stretch: normal; line-height: normal; min-height: 15px;\"><font size=\"4\" face=\"Arial\"><br></font></p>\n<p style=\"margin-bottom: 0px; font-stretch: normal; line-height: normal;\"><font size=\"4\" face=\"Arial\"><b>Махачкала</b></font></p>\n<p style=\"margin-bottom: 0px; font-stretch: normal; line-height: normal;\"><font size=\"4\" face=\"Arial\">улица Плешакова, 9Ж</font></p>\n<p style=\"margin-bottom: 0px; font-stretch: normal; line-height: normal;\"><font size=\"4\" face=\"Arial\">Махачкала, Республика Дагестан, Россия</font></p>\n<p style=\"margin-bottom: 0px; font-stretch: normal; line-height: normal;\"><font size=\"4\" face=\"Arial\">Координаты:</font></p>\n<p style=\"margin-bottom: 0px; font-stretch: normal; line-height: normal;\"><font size=\"4\" face=\"Arial\">43.017959, 47.434883</font></p>\n<p style=\"margin-bottom: 0px; font-stretch: normal; line-height: normal; min-height: 15px;\"><font size=\"4\" face=\"Arial\"><br></font></p>\n<p style=\"margin-bottom: 0px; font-stretch: normal; line-height: normal;\"><font size=\"4\" face=\"Arial\"><b>Новокузнецк</b></font></p>\n<p style=\"margin-bottom: 0px; font-stretch: normal; line-height: normal;\"><font size=\"4\" face=\"Arial\">Автотранспортная улица, 3/4</font></p>\n<p style=\"margin-bottom: 0px; font-stretch: normal; line-height: normal;\"><font size=\"4\" face=\"Arial\">Новокузнецк, Кемеровская область, Россия, 654038</font></p>\n<p style=\"margin-bottom: 0px; font-stretch: normal; line-height: normal;\"><font size=\"4\" face=\"Arial\">Координаты:</font></p>\n<p style=\"margin-bottom: 0px; font-stretch: normal; line-height: normal;\"><font size=\"4\" face=\"Arial\">53.857061, 87.216937</font></p>\n<p style=\"margin-bottom: 0px; font-stretch: normal; line-height: normal; min-height: 15px;\"><font size=\"4\" face=\"Arial\"><br></font></p>\n<p style=\"margin-bottom: 0px; font-stretch: normal; line-height: normal;\"><font size=\"4\" face=\"Arial\"><b>Пенза</b></font></p>\n<p style=\"margin-bottom: 0px; font-stretch: normal; line-height: normal;\"><font size=\"4\" face=\"Arial\">Ульяновская улица, 85А</font></p>\n<p style=\"margin-bottom: 0px; font-stretch: normal; line-height: normal;\"><font size=\"4\" face=\"Arial\">Пенза, Россия, 440047</font></p>\n<p style=\"margin-bottom: 0px; font-stretch: normal; line-height: normal;\"><font size=\"4\" face=\"Arial\">Координаты:</font></p>\n<p style=\"margin-bottom: 0px; font-stretch: normal; line-height: normal;\"><font size=\"4\" face=\"Arial\">53.234341, 44.905937</font></p>\n<p style=\"margin-bottom: 0px; font-stretch: normal; line-height: normal; min-height: 15px;\"><font size=\"4\" face=\"Arial\"><br></font></p>\n<p style=\"margin-bottom: 0px; font-stretch: normal; line-height: normal;\"><font size=\"4\" face=\"Arial\"><b>Севастополь</b></font></p>\n<p style=\"margin-bottom: 0px; font-stretch: normal; line-height: normal;\"><font size=\"4\" face=\"Arial\">Отрадная улица, 23</font></p>\n<p style=\"margin-bottom: 0px; font-stretch: normal; line-height: normal;\"><font size=\"4\" face=\"Arial\">Гагаринский муниципальный округ, Севастополь, Россия</font></p>\n<p style=\"margin-bottom: 0px; font-stretch: normal; line-height: normal;\"><font size=\"4\" face=\"Arial\">Координаты:</font></p>\n<p style=\"margin-bottom: 0px; font-stretch: normal; line-height: normal;\"><font size=\"4\" face=\"Arial\">44.575159, 33.490209</font></p>\n<p style=\"margin-bottom: 0px; font-stretch: normal; line-height: normal; min-height: 15px;\"><font size=\"4\" face=\"Arial\"><br></font></p>\n<p style=\"margin-bottom: 0px; font-stretch: normal; line-height: normal;\"><font size=\"4\" face=\"Arial\"><b>Томск</b></font></p>\n<p style=\"margin-bottom: 0px; font-stretch: normal; line-height: normal;\"><font size=\"4\" face=\"Arial\">Нижне-Луговая улица, 87/2с3</font></p>\n<p style=\"margin-bottom: 0px; font-stretch: normal; line-height: normal;\"><font size=\"4\" face=\"Arial\">микрорайон Черемошники, Томск, Россия</font></p>\n<p style=\"margin-bottom: 0px; font-stretch: normal; line-height: normal;\"><font size=\"4\" face=\"Arial\">Координаты:</font></p>\n<p style=\"margin-bottom: 0px; font-stretch: normal; line-height: normal;\"><font size=\"4\" face=\"Arial\">56.521040, 84.923736</font></p>\n<p style=\"margin-bottom: 0px; font-stretch: normal; line-height: normal; min-height: 15px;\"><font size=\"4\" face=\"Arial\"><br></font></p>\n<p style=\"margin-bottom: 0px; font-stretch: normal; line-height: normal;\"><font size=\"4\" face=\"Arial\">Время работы: 24 часа 7 дней в неделю</font></p>\n<p style=\"margin-bottom: 0px; font-stretch: normal; line-height: normal;\"><font size=\"4\" face=\"Arial\">Пропуск для проезда на территорию не нужен.&nbsp;</font></p>\n<p style=\"margin-bottom: 0px; font-stretch: normal; line-height: normal; min-height: 15px;\"><font size=\"4\" face=\"Arial\"><br></font></p>\n<p style=\"margin-bottom: 0px; font-stretch: normal; line-height: normal;\"><font size=\"4\" style=\"\" face=\"Arial\">Выбрать склад и загрузить на него остатки Вы можете в разделе «Мои склады».</font></p>",
"date": "2021-11-22T03:00:00+03:00"
}
]
}

Информация о продавце

Получение информации о продавце{{ /api/v1/seller-info }}

Описание метода

Метод позволяет получать наименование продавца и ID его аккаунта.
В запросе можно использовать любой токен, у которого не выбрана опция Тестовый контур.

Максимум 1 запрос в минуту на один аккаунт продавца

Authorizations:

HeaderApiKey

Responses

Response samples

Content type

application/json

{"name": "ИП Кружинин В. Р.",
"sid": "e8923014-e233-47q8-898e-3cc86d67ea61",
"tradeMark": "Flax Store"
}