General (general)
API description, authorization and seller portal news 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.
- 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.
Category | Methods |
---|---|
Content | Categories, Subjects and Characteristics Products Cards Nomenclatures Tags |
Analytics | Sales Funnel Sales Funnel (Jam) Search phrases Warehouses Remains Report Retention Reports Paid Reception Paid Storage Sales by Regions Share of Brand in Sales Hidden Products Goods Return Report |
Prices and Discounts | Prices and Discounts Promotions Calendar |
Marketplace | FBS Orders Inventory |
Statistics | Product Reports Financial Reports |
Promotion | Campaigns Campaigns Creation Campaigns Management Finances Campaigns Parameters Media Promotion Statistics |
Feedbacks and Questions | Questions Reviews Response Templates Questions Analytics Reviews Analytics |
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.
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.
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 Questions and feedbacks |
9 | Access to Buyers chat |
10 | Access to Supplies |
11 | Access to Buyers returns |
12 | Access to Documents |
30 | Read only token |
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.
Category | Request URL |
---|---|
Content | https://content-api.wildberries.ru/ping https://content-api-sandbox.wildberries.ru/ping |
Analytics | https://seller-analytics-api.wildberries.ru/ping |
Prices and Discounts | https://discounts-prices-api.wildberries.ru/ping https://discounts-prices-api-sandbox.wildberries.ru/ping |
Marketplace | https://marketplace-api.wildberries.ru/ping |
Statistics | https://statistics-api.wildberries.ru/ping https://statistics-api-sandbox.wildberries.ru/ping |
Promotion | https://advert-api.wildberries.ru/ping https://advert-api-sandbox.wildberries.ru/ping |
Feedbacks and Questions | https://feedbacks-api.wildberries.ru/ping https://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 |
Authorizations:
Responses
Response samples
- 200
- 401
- 429
{- "TS": "2024-08-16T11:19:05+03:00",
- "Status": "OK"
}
Getting seller portal news{{ /api/communications/v1/news }}
The method allows getting news from the seller portal in HTML format.
Any token scope is suitable for authorization - Content, Statistics, Marketplace, etc.
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.
Authorizations:
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
{- "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"
}
]
}