General (general)
API description, authorization, seller portal news and seller information access
Wildberries API provides sellers with the opportunity to manage their store and receive operational and statistical information via the HTTP Rest API protocol. API description is provided in the Swagger (Open API) format. It can be used for the import to the other tools (such as PostMan) or the client code generation on different programming languages with the help of Swagger CodeGen. For manual API check you can use:
Technical support is provided through web chats in seller portal. When creating new support request, please select category from API group. All news and changes regarding API are being published in Wildberries news and Telegram channel.
You need API token to authenticate requests. It is valid for 180 days after creation. Add the token to the Authorization request header.
According to clause 9.8.6 of the offer, integration with the seller portal without a public (this) API is prohibited.
- Go to your seller account, click the profile name and select Settings → Access to API.
- If necessary, select the option:
- Test scope (Sandbox): the token can only be used in a test scope (sandbox).
- Read only: You can't change any data using this token, it's only for reading. The token can be used with real data and in the test scope (sandbox).
- Choose which API categories for this token.
Only select the categories you plan to work with. For example, if you will only upload product cards, select only Content category. If someone gets your token, they will not be able to gain access to the other API categories of your store.
| Category | Methods |
|---|---|
| Content | Categories, Subjects and Characteristics Products Cards Nomenclatures Tags |
| Analytics | Sales Funnel Search Queries Seller Analytics CSV Warehouses Remains Report Retention Reports Paid Reception Paid Storage Sales by Regions Share of Brand in Sales Hidden Products Goods Return Report Turnover Dynamics |
| Prices and Discounts | Prices and Discounts Promotions Calendar |
| Marketplace | FBS Orders Seller Warehouses Inventory DBS Orders |
| Statistics | Product Reports Financial Reports |
| Promotion | Campaigns Campaigns Creation Campaigns Management Finances Campaigns Parameters Media Promotion Statistics |
| Reviews and Questions | Questions Reviews Response Templates |
| Buyers Chat | Buyers Chat |
| Supplies | FBW Supplies |
| Buyers Returns | Buyers Returns |
| Documents | Documents |
| Tariffs | Tariffs |
- Click Create a token.
- Copy and save the token in some safe place. Later you can't view it in your seller account. If you lost your token, create a new one.
If you have several services (integrations) that work with different categories, create a token for each service. This will allow access to only the necessary categories, as well as more flexible and secure management of integrations.
The token is a JWT according to RFC 7519. To check if your token is valid and which categories of API methods are available with it, you can decode it.
We recommend not to view the token using online tools so no one can take it over.
Public token fields
Fields that are not in the table are service fields and can be deleted.
| Field | Type | Description |
|---|---|---|
id |
UUIDv4 |
Unique token ID |
s |
`uint` |
Token properties bitmask |
sid |
`UUIDv4' |
Wildberries seller ID |
exp |
`uint` |
Token lifetime, complies with RFC 7519: JSON Web Token (JWT) |
t |
boolean |
Test scope (sandbox) |
s field
The s field is a bitmask, an integer, each bit of which means the presence or absence of some option.
Learn more about bitmask
Bit values
| Bit position | Property (if bit is 1) |
|---|---|
| 1 | Access to Content |
| 2 | Access to Analytics |
| 3 | Access to Prices and discounts |
| 4 | Access to Marketplace |
| 5 | Access to Statistics |
| 6 | Access to Promotion |
| 7 | Access to Reviews and Questions |
| 9 | Access to Buyers chat |
| 10 | Access to Supplies |
| 11 | Access to Buyers returns |
| 12 | Access to Documents |
| 30 | Read only token |
Token decoding will allow to check if the token is valid and which categories of API methods are available. You can decode the token on the separate page.
Connection Check{{ /ping }}
Описание метода
Checks:
- Whether the request successfully reaches the WB API.
- The validity of the authorization token and request URL.
- Whether the token category matches the service.
This method is not intended to check the availability of WB services
Each service has its own version of the method depending on the domain:
| Category | Request URL |
|---|---|
| Content | https://content-api.wildberries.ru/pinghttps://content-api-sandbox.wildberries.ru/ping |
| Analytics | https://seller-analytics-api.wildberries.ru/ping |
| Prices and Discounts | https://discounts-prices-api.wildberries.ru/pinghttps://discounts-prices-api-sandbox.wildberries.ru/ping |
| Marketplace | https://marketplace-api.wildberries.ru/ping |
| Statistics | https://statistics-api.wildberries.ru/pinghttps://statistics-api-sandbox.wildberries.ru/ping |
| Promotion | https://advert-api.wildberries.ru/pinghttps://advert-api-sandbox.wildberries.ru/ping |
| Reviews and Questions | https://feedbacks-api.wildberries.ru/pinghttps://feedbacks-api-sandbox.wildberries.ru/ping |
| Buyers Chat | https://buyer-chat-api.wildberries.ru/ping |
| Supplies | https://supplies-api.wildberries.ru/ping |
| Buyers Returns | https://returns-api.wildberries.ru/ping |
| Documents | https://documents-api.wildberries.ru/ping |
| Tariffs, News | https://common-api.wildberries.ru/ping |
A maximum of 3 requests every 30 seconds. If you try to use this method programmatically, the method will be temporarily blocked. The rate limit applies individually to each instance of the method on each host
Authorizations:
HeaderApiKey
Responses
Response samples
- 200
- 401
- 429
Content type
application/json
{- "TS": "2024-08-16T11:19:05+03:00",
- "Status": "OK"
}
Seller portal news can be obtained with any token that doesn't have the Test Scope option selected.
Getting seller portal news{{ /api/communications/v2/news }}
Описание метода
The method allows getting news from the seller portal in HTML format.
To receive a successful response, one of the parameters from or fromID must be specified.
You can get up to 100 news items per request.
Maximum of 10 requests per 10 minutes per one seller's account
Authorizations:
HeaderApiKey
query Parameters
| from | string <date> Example: from=2025-02-06 Date from which to get news |
| fromID | integer <uint64> Example: fromID=7369 News ID from which to get news |
Responses
Response samples
- 200
- 401
- 429
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": "Аналитика продавца"
}
]
}
]
}Getting seller portal news{{ /api/communications/v1/news }} Deprecated
Описание метода
This method will be disabled on April 7. Use the actual method.
Authorizations:
HeaderApiKey
query Parameters
| from | string <date> Example: from=2021-11-20 Date from which to get news |
| fromID | integer <uint64> Example: fromID=1885 News ID from which to get news |
Responses
Response samples
- 200
- 401
- 429
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\">Уважаемые Продавцы! </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; 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\">Пропуск для проезда на территорию не нужен. </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"
}
]
}Get seller information{{ /api/v1/seller-info }}
Описание метода
This method allows you to obtain the seller's name and account ID.
You can use any token in request, as long as the Test Environment option is not selected.
Maximum is 1 request per minute per seller account
Authorizations:
HeaderApiKey
Responses
Response samples
- 200
- 401
- 429
Content type
application/json
{- "name": "ИП Кружинин В. Р.",
- "sid": "e8923014-e233-47q8-898e-3cc86d67ea61",
- "tradeMark": "Flax Store"
}