Сервис предоставляет публичный API для получения аналитических данных. С помощью этих методов вы можете получать аналитические отчёты.
Таймзоны
Формат IANA, актуальный список можно посмотреть здесь.
Получение статистики КТ за выбранный период, по nmID/предметам/брендам/тегам.
Поля brandNames
,objectIDs
, tagIDs
, nmIDs
могут быть пустыми, тогда в ответе идут все карточки продавца.
При выборе нескольких полей в ответ приходят данные по карточкам, у которых есть все выбранные поля. Работает с пагинацией.
Можно получить отчёт максимум за последний год (365 дней).
Также в данных, где предоставляется информация по предыдущему периоду:
previousPeriod
данные за такой же период, что и в selectedPeriod
.previousPeriod
раньше, чем год назад от текущей даты, она будет приведена к виду: previousPeriod.start = текущая дата - 365 дней.
Максимум 3 запроса в минуту.
brandNames | Array of strings Название бренда |
objectIDs | Array of integers <int32> [ items <int32 > ] Идентификатор предмета |
tagIDs | Array of integers <int32> [ items <int32 > ] Идентификатор тега |
nmIDs | Array of integers <int32> [ items <int32 > ] Артикул WB |
timezone | string Временная зона. |
required | object Период |
object Параметры сортировки. Если не указано, то по умолчанию используется значение "openCard" и сортировка по убыванию.
| |
page required | integer <int32> Страница |
object | |
error | boolean Флаг ошибки |
errorText | string Описание ошибки |
Array of objects Дополнительные ошибки |
{- "brandNames": [
- "Some"
], - "objectIDs": [
- 358
], - "tagIDs": [
- 123
], - "nmIDs": [
- 1234567
], - "timezone": "Europe/Moscow",
- "period": {
- "begin": "2023-06-01 20:05:32",
- "end": "2024-03-01 20:05:32"
}, - "orderBy": {
- "field": "ordersSumRub",
- "mode": "asc"
}, - "page": 1
}
{- "data": {
- "page": 1,
- "isNextPage": true,
- "cards": [
- {
- "nmID": 1234567,
- "vendorCode": "supplierVendor",
- "brandName": "Some",
- "tags": [
- {
- "id": 123,
- "name": "Sale"
}
], - "object": {
- "id": 447,
- "name": "Кондиционеры для волос"
}, - "statistics": {
- "selectedPeriod": {
- "begin": "2023-06-01 20:05:32",
- "end": "2024-03-01 20:05:32",
- "openCardCount": 0,
- "addToCartCount": 0,
- "ordersCount": 0,
- "ordersSumRub": 0,
- "buyoutsCount": 0,
- "buyoutsSumRub": 0,
- "cancelCount": 0,
- "cancelSumRub": 0,
- "avgPriceRub": 0,
- "avgOrdersCountPerDay": 0,
- "conversions": {
- "addToCartPercent": 0,
- "cartToOrderPercent": 0,
- "buyoutsPercent": 0
}
}, - "previousPeriod": {
- "begin": "2023-05-07 20:05:31",
- "end": "2023-06-01 20:05:31",
- "openCardCount": 0,
- "addToCartCount": 0,
- "ordersCount": 1,
- "ordersSumRub": 1262,
- "buyoutsCount": 1,
- "buyoutsSumRub": 1262,
- "cancelCount": 0,
- "cancelSumRub": 0,
- "avgPriceRub": 1262,
- "avgOrdersCountPerDay": 0.04,
- "conversions": {
- "addToCartPercent": 0,
- "cartToOrderPercent": 0,
- "buyoutsPercent": 100
}
}, - "periodComparison": {
- "openCardDynamics": 0,
- "addToCartDynamics": 0,
- "ordersCountDynamics": -100,
- "ordersSumRubDynamics": -100,
- "buyoutsCountDynamics": -100,
- "buyoutsSumRubDynamics": -100,
- "cancelCountDynamics": 0,
- "cancelSumRubDynamics": 0,
- "avgOrdersCountPerDayDynamics": 0,
- "avgPriceRubDynamics": -100,
- "conversions": {
- "addToCartPercent": 0,
- "cartToOrderPercent": 0,
- "buyoutsPercent": -100
}
}
}, - "stocks": {
- "stocksMp": 0,
- "stocksWb": 0
}
}
]
}, - "error": true,
- "errorText": "",
- "additionalErrors": [
- {
- "field": "string",
- "description": "string"
}
]
}
Получение статистики КТ за период, сгруппированный по предметам, брендам и тегам.
Поля brandNames
, objectIDs
, tagIDs
могут быть пустыми, тогда группировка происходит по всем карточкам продавца.
Можно получить отчёт максимум за последний год (365 дней).
Также в данных, где предоставляется информация по предыдущему периоду:
previousPeriod
данные за такой же период, что и в selectedPeriod
.previousPeriod
раньше, чем год назад от текущей даты, она будет приведена к виду: previousPeriod.start = текущая дата - 365 дней.
Максимум 3 запроса в минуту.
objectIDs | Array of integers <int32> [ items <int32 > ] Идентификатор предмета |
brandNames | Array of strings Название бренда |
tagIDs | Array of integers <int32> [ items <int32 > ] Идентификатор тега |
timezone | string Временная зона. |
required | object Период |
object Параметры сортировки. Если не указано, то по умолчанию используется значение "openCard" и сортировка по убыванию.
| |
page required | integer <int32> Страница |
object | |
error | boolean Флаг ошибки |
errorText | string Описание ошибки |
Array of objects Дополнительные ошибки |
{- "objectIDs": [
- 358
], - "brandNames": [
- "Some"
], - "tagIDs": [
- 123
], - "timezone": "Europe/Moscow",
- "period": {
- "begin": "2023-10-04 20:05:32",
- "end": "2024-03-01 20:05:32"
}, - "orderBy": {
- "field": "ordersSumRub",
- "mode": "asc"
}, - "page": 1
}
{- "data": {
- "page": 1,
- "isNextPage": true,
- "groups": [
- {
- "brandName": "Some",
- "tags": [
- {
- "id": 123,
- "name": "Sale"
}
], - "object": {
- "id": 1668,
- "name": "Воски для волос"
}, - "statistics": {
- "selectedPeriod": {
- "begin": "2023-10-04 20:05:32",
- "end": "2024-03-01 20:05:32",
- "openCardCount": 0,
- "addToCartCount": 0,
- "ordersCount": 0,
- "ordersSumRub": 0,
- "buyoutsCount": 0,
- "buyoutsSumRub": 0,
- "cancelCount": 0,
- "cancelSumRub": 0,
- "avgPriceRub": 0,
- "avgOrdersCountPerDay": 0,
- "conversions": {
- "addToCartPercent": 0,
- "cartToOrderPercent": 0,
- "buyoutsPercent": 0
}
}, - "previousPeriod": {
- "begin": "2023-11-04 20:05:31",
- "end": "2024-03-01 20:05:31",
- "openCardCount": 466,
- "addToCartCount": 72,
- "ordersCount": 84,
- "ordersSumRub": 127060.42,
- "buyoutsCount": 69,
- "buyoutsSumRub": 104898.42,
- "cancelCount": 13,
- "cancelSumRub": 0,
- "avgPriceRub": 1562.65,
- "avgOrdersCountPerDay": 0.72,
- "conversions": {
- "addToCartPercent": 15.5,
- "cartToOrderPercent": 116.7,
- "buyoutsPercent": 84.1
}
}, - "periodComparison": {
- "openCardDynamics": -100,
- "addToCartDynamics": -100,
- "ordersCountDynamics": -100,
- "ordersSumRubDynamics": -100,
- "buyoutsCountDynamics": -100,
- "buyoutsSumRubDynamics": -100,
- "cancelCountDynamics": 0,
- "cancelSumRubDynamics": 0,
- "avgOrdersCountPerDayDynamics": 0,
- "avgPriceRubDynamics": -100,
- "conversions": {
- "addToCartPercent": -100,
- "cartToOrderPercent": -100,
- "buyoutsPercent": -100
}
}
}
}
]
}, - "error": true,
- "errorText": "",
- "additionalErrors": [
- {
- "field": "string",
- "description": "string"
}
]
}
Получение статистики КТ по дням по выбранным nmID
.
Можно получить отчёт максимум за последнюю неделю.
Чтобы получать отчёты за период до года, подпишитесь на расширенную аналитику Джем.
Максимум 3 запроса в минуту.
nmIDs required | Array of integers <int32> [ items <int32 > ] Артикул Wildberries (максимум 20) |
required | object Период |
timezone | string Временная зона. |
aggregationLevel | string Тип агрегации. Если не указано, то по умолчанию используется агрегация по дням. |
Array of objects | |
error | boolean Флаг ошибки |
errorText | string Описание ошибки |
Array of objects Дополнительные ошибки |
{- "nmIDs": [
- 1234567
], - "period": {
- "begin": "2023-06-20",
- "end": "2023-06-22"
}, - "timezone": "Europe/Moscow",
- "aggregationLevel": "day"
}
{- "data": [
- {
- "nmID": 1234567,
- "imtName": "Наименование КТ",
- "vendorCode": "supplierVendor",
- "history": [
- {
- "dt": "2023-06-20",
- "openCardCount": 26,
- "addToCartCount": 1,
- "ordersCount": 0,
- "ordersSumRub": 0,
- "buyoutsCount": 0,
- "buyoutsSumRub": 0,
- "buyoutPercent": 0,
- "addToCartConversion": 3.8,
- "cartToOrderConversion": 0
}
]
}
], - "error": true,
- "errorText": "",
- "additionalErrors": [
- {
- "field": "string",
- "description": "string"
}
]
}
Получение статистики КТ по дням за период, сгруппированный по предметам, брендам и тегам.
Поля brandNames
, objectIDs
, tagIDs
могут быть пустыми, тогда группировка происходит по всем карточкам продавца.
В запросе произведение количества предметов, брендов, тегов не должно быть больше 16.
Можно получить отчёт максимум за последнюю неделю.
Чтобы получать отчёты за период до года, подпишитесь на расширенную аналитику Джем.
Максимум 3 запроса в минуту.
objectIDs | Array of integers <int32> [ items <int32 > ] Идентификатор предмета |
brandNames | Array of strings Название бренда |
tagIDs | Array of integers <int32> [ items <int32 > ] Идентификатор тега |
required | object Период |
timezone | string Временная зона. |
aggregationLevel | string Тип агрегации. Если не указано, то по умолчанию используется агрегация по дням. |
Array of objects | |
error | boolean Флаг ошибки |
errorText | string Описание ошибки |
Array of objects Дополнительные ошибки |
{- "objectIDs": [
- 358
], - "brandNames": [
- "Some"
], - "tagIDs": [
- 123
], - "period": {
- "begin": "2023-06-21",
- "end": "2023-06-23"
}, - "timezone": "Europe/Moscow",
- "aggregationLevel": "day"
}
{- "data": [
- {
- "object": {
- "id": 358,
- "name": "Шампуни"
}, - "brandName": "Some",
- "tag": {
- "id": 123,
- "name": "Sale"
}, - "history": [
- {
- "dt": "2023-06-21",
- "openCardCount": 0,
- "addToCartCount": 0,
- "ordersCount": 0,
- "ordersSumRub": 0,
- "buyoutsCount": 0,
- "buyoutsSumRub": 0,
- "buyoutPercent": 0,
- "addToCartConversion": 0,
- "cartToOrderConversion": 0
}
]
}
], - "error": true,
- "errorText": "",
- "additionalErrors": [
- {
- "field": "string",
- "description": "string"
}
]
}
Вы можете использовать эти методы только с подпиской Джем.
Чтобы получить отчёт:
Вы можете создать отчёт с группировкой:
nmID
);В каждом из этих отчётов можно сгруппировать данные по дням, неделям или месяцам.
Максимум 3 запроса в минуту, при этом в сутки можно сгенерировать максимум 20 отчётов (считаются только успешные генерации).
id required | string <uuid> Идентификатор отчёта в UUID-формате. Генерируется продавцом самостоятельно |
reportType required | string Тип отчёта — |
userReportName | string Название отчёта (если не указано, сформируется автоматически) |
object Параметры отчёта |
data | string Уведомление, что началась генерация отчёта |
error | boolean Флаг ошибки |
errorText | string Описание ошибки |
Array of objects Дополнительные ошибки |
По артикулам Wildberries (nmID
)
{- "id": "06eae887-9d9f-491f-b16a-bb1766fcb8d2",
- "reportType": "DETAIL_HISTORY_REPORT",
- "userReportName": "Card report",
- "params": {
- "nmIDs": [
- 1234567
], - "subjectIDs": [
- 1234567
], - "brandNames": [
- "Name"
], - "tagIDs": [
- 1234567
], - "startDate": "2023-06-21",
- "endDate": "2023-06-23",
- "timezone": "Europe/Moscow",
- "aggregationLevel": "day",
- "skipDeletedNm": false
}
}
{- "data": "Началось формирование файла/отчёта",
- "error": false,
- "errorText": "",
- "additionalErrors": null
}
Максимум 3 запроса в минуту
filter[downloadIds] | Array of strings <uuid> [ items <uuid > ] ID отчёта |
Array of objects | |
error | boolean Флаг ошибки |
errorText | string Текст ошибки |
Array of objects |
{- "data": [
- {
- "id": "06eae887-9d9f-491f-b16a-bb1766fcb8d2",
- "createdAt": "2023-06-26 20:05:32",
- "status": "SUCCESS",
- "name": "Card report",
- "size": 123,
- "startDate": "2023-06-21",
- "endDate": "2023-06-23"
}
], - "error": false,
- "errorText": "string",
- "additionalErrors": null
}
Максимум 3 запроса в минуту
downloadId | string <uuid> ID отчёта |
data | string Уведомление, что началась повторная генерация отчёта |
error | boolean Флаг ошибки |
errorText | string Описание ошибки |
Array of objects Дополнительные ошибки |
{- "downloadId": "06eea887-9d9f-491f-b16a-bb1766fcb8d2"
}
{- "data": "Началось переформирование файла/отчёта",
- "error": false,
- "errorText": "",
- "additionalErrors": null
}
Можно получить отчёт, который сгенерирован в последние 48 часов.
Отчёт будет загружен внутри архива ZIP в формате CSV.
Максимум 3 запроса в минуту.
downloadId required | string <uuid> ID отчёта |
Описание полей в файле CSV:
name | type | format | description |
---|---|---|---|
nmID (только для DETAIL_HISTORY_REPORT ) |
integer | int32 | Артикул Wildberries |
dt | string | date | Дата |
openCardCount | integer | int32 | Переходы в карточку товара |
addToCartCount | integer | int32 | Положили в корзину, шт. |
ordersCount | integer | int32 | Заказали товаров, шт. |
ordersSumRub | integer | int32 | Заказали на сумму, ₽ |
buyoutsCount | integer | int32 | Выкупили товаров, шт. |
buyoutsSumRub | integer | int32 | Выкупили на сумму, ₽ |
cancelCount | integer | int32 | Отменили товаров, шт. |
cancelSumRub | integer | int32 | Отменили на сумму, ₽ |
addToCartConversion | number | int32 | Конверсия в корзину, % (Какой процент посетителей, открывших карточку товара, добавили товар в корзину) |
cartToOrderConversion | integer | int32 | Конверсия в заказ, % (Какой процент посетителей, добавивших товар в корзину, сделали заказ) |
buyoutPercent | integer | int32 | Процент выкупа, % (Какой процент посетителей, заказавших товар, его выкупили. Без учёта товаров, которые еще доставляются покупателю) |
nmID, dt, openCardCount, addToCartCount, ordersCount, ordersSumRub, buyoutsCount, buyoutsSumRub, cancelCount, cancelSumRub, addToCartConversion, cartToOrderConversion, buyoutPercent 70027655,2023-12-21,1,0,0,0,0,0,0,0,0,0,0 ... ... 150317666,2023-12-21,2,0,0,0,0,0,0,0,0,0,0
Формирует набор данных для основной страницы отчёта с:
Для получения дополнительных данных в таблице используйте отдельный запрос для:
Дополнительные параметры выбора списка товаров в таблице:
positionCluster
— средняя позиция в поиске
Максимум 3 запроса в минуту.
required | object (Period) Текущий период |
object (pastPeriod) Прошлый период для сравнения. Количество дней - меньше или равно | |
nmIds | Array of integers <int32> [ items <int32 > ] Список артикулов WB для фильтрации |
subjectIds | Array of integers <int32> [ items <int32 > ] Список ID предметов для фильтрации |
brandNames | Array of strings Список названий брендов для фильтрации |
tagIds | Array of integers <int64> [ items <int64 > ] Список ID тегов для фильтрации |
positionCluster required | string (PositionCluster) Enum: "all" "firstHundred" "secondHundred" "below" Кластер для позиционирования элементов в отчёте
|
required | object (OrderBy) Параметры сортировки |
required | object |
{- "currentPeriod": {
- "start": "2024-02-10",
- "end": "2024-02-10"
}, - "pastPeriod": {
- "start": "2024-02-08",
- "end": "2024-02-08"
}, - "nmIds": [
- 162579635,
- 166699779
], - "subjectIds": [
- 32,
- 64
], - "brandNames": [
- "Adidas",
- "Nike"
], - "tagIds": [
- 3,
- 5,
- 6
], - "positionCluster": "all",
- "orderBy": {
- "field": "avgPosition",
- "mode": "asc"
}
}
{- "data": {
- "commonInfo": {
- "supplierRating": {
- "current": 5.3,
- "dynamics": 5.4
}, - "advertisedProducts": {
- "current": 5,
- "dynamics": 50
}, - "totalProducts": 150
}, - "positionInfo": {
- "average": {
- "current": 5,
- "dynamics": 50
}, - "median": {
- "current": 5,
- "dynamics": 50
}, - "chartItems": [
- {
- "dt": "2024-10-19",
- "average": 1,
- "median": 1
}
], - "clusters": {
- "firstHundred": {
- "current": 5,
- "dynamics": 50
}, - "secondHundred": {
- "current": 5,
- "dynamics": 50
}, - "below": {
- "current": 5,
- "dynamics": 50
}
}
}, - "visibilityInfo": {
- "visibility": {
- "current": 5,
- "dynamics": 50
}, - "openCard": {
- "current": 5,
- "dynamics": 50
}, - "byDay": [
- {
- "dt": "2024-02-10",
- "visibility": 100,
- "open": 124
}
], - "byWeek": [
- {
- "dt": "2024-02-10",
- "visibility": 100,
- "open": 124
}
], - "byMonth": [
- {
- "dt": "2024-02-10",
- "visibility": 100,
- "open": 124
}
]
}, - "groups": [
- {
- "subjectName": "Phones",
- "subjectId": 50,
- "brandName": "Apple",
- "tagName": "phones",
- "tagId": 65,
- "metrics": {
- "avgPosition": {
- "current": 5,
- "dynamics": 50
}, - "openCard": {
- "current": 5,
- "dynamics": 50
}, - "addToCart": {
- "current": 5,
- "dynamics": 50
}, - "openToCart": {
- "current": 5,
- "dynamics": 50
}, - "orders": {
- "current": 5,
- "dynamics": 50
}, - "cartToOrder": {
- "current": 5,
- "dynamics": 50
}, - "visibility": {
- "current": 5,
- "dynamics": 50
}
}, - "items": [
- {
- "nmId": 268913787,
- "name": "iPhone 13 256 ГБ Серебристый",
- "vendorCode": "wb3ha2668w",
- "subjectName": "Смартфоны",
- "brandName": "Apple",
- "isAdvertised": false,
- "isCardRated": true,
- "rating": 6,
- "feedbackRating": 1,
- "price": {
- "minPrice": 150,
- "maxPrice": 300
}, - "avgPosition": {
- "current": 5,
- "dynamics": 50
}, - "openCard": {
- "current": 5,
- "dynamics": 50
}, - "addToCart": {
- "current": 5,
- "dynamics": 50
}, - "openToCart": {
- "current": 5,
- "dynamics": 50
}, - "orders": {
- "current": 5,
- "dynamics": 50
}, - "cartToOrder": {
- "current": 5,
- "dynamics": 50
}, - "visibility": {
- "current": 5,
- "dynamics": 50
}
}
]
}
]
}
}
Пагинация по группам в отчёте. Возможна только при наличии фильтра по бренду, предмету или тегу.
Дополнительные параметры выбора списка товаров в таблице:
positionCluster
— средняя позиция в поиске
Максимум 3 запроса в минуту.
required | object (Period) Текущий период |
object (pastPeriod) Прошлый период для сравнения. Количество дней - меньше или равно | |
nmIds | Array of integers <int32> [ items <int32 > ] Список артикулов WB для фильтрации |
subjectIds | Array of integers <int32> [ items <int32 > ] Список ID предметов для фильтрации |
brandNames | Array of strings Список названий брендов для фильтрации |
tagIds | Array of integers <int64> [ items <int64 > ] Список ID тегов для фильтрации |
required | object (OrderBy) Параметры сортировки |
positionCluster required | string (PositionCluster) Enum: "all" "firstHundred" "secondHundred" "below" Кластер для позиционирования элементов в отчёте
|
limit required | integer <uint32> <= 1000 Количество запрашиваемых групп товаров |
offset required | integer <uint32> После какого элемента выдавать данные |
required | object |
{- "currentPeriod": {
- "start": "2024-02-10",
- "end": "2024-02-10"
}, - "pastPeriod": {
- "start": "2024-02-08",
- "end": "2024-02-08"
}, - "nmIds": [
- 162579635,
- 166699779
], - "subjectIds": [
- 64,
- 334
], - "brandNames": [
- "nike",
- "adidas"
], - "tagIds": [
- 32,
- 53
], - "orderBy": {
- "field": "avgPosition",
- "mode": "asc"
}, - "positionCluster": "all",
- "limit": 130,
- "offset": 50
}
{- "data": {
- "groups": [
- {
- "subjectName": "Phones",
- "subjectId": 50,
- "brandName": "Apple",
- "tagName": "phones",
- "tagId": 65,
- "metrics": {
- "avgPosition": {
- "current": 5,
- "dynamics": 50
}, - "openCard": {
- "current": 5,
- "dynamics": 50
}, - "addToCart": {
- "current": 5,
- "dynamics": 50
}, - "openToCart": {
- "current": 5,
- "dynamics": 50
}, - "orders": {
- "current": 5,
- "dynamics": 50
}, - "cartToOrder": {
- "current": 5,
- "dynamics": 50
}, - "visibility": {
- "current": 5,
- "dynamics": 50
}
}, - "items": [
- {
- "nmId": 268913787,
- "name": "iPhone 13 256 ГБ Серебристый",
- "vendorCode": "wb3ha2668w",
- "subjectName": "Смартфоны",
- "brandName": "Apple",
- "isAdvertised": false,
- "isCardRated": true,
- "rating": 6,
- "feedbackRating": 1,
- "price": {
- "minPrice": 150,
- "maxPrice": 300
}, - "avgPosition": {
- "current": 5,
- "dynamics": 50
}, - "openCard": {
- "current": 5,
- "dynamics": 50
}, - "addToCart": {
- "current": 5,
- "dynamics": 50
}, - "openToCart": {
- "current": 5,
- "dynamics": 50
}, - "orders": {
- "current": 5,
- "dynamics": 50
}, - "cartToOrder": {
- "current": 5,
- "dynamics": 50
}, - "visibility": {
- "current": 5,
- "dynamics": 50
}
}
]
}
]
}
}
Пагинация по товарам в группе. Возможна независимо от наличия фильтров.
Фильтры для пагинации по товарам в группе или без фильтров::
subjectId
,brandName
,tagId
— фильтр для группыnmIds
— фильтр по номенклатуреДополнительные параметры выбора списка товаров:
positionCluster
— средняя позиция в поиске
Максимум 3 запроса в минуту.
required | object (Period) Текущий период |
object (pastPeriod) Прошлый период для сравнения. Количество дней - меньше или равно | |
subjectId | integer <int32> ID предмета |
brandName | string Название товара |
tagId | integer <int64> ID тега |
nmIds | Array of integers <uint64> [ items <uint64 > ] Список артикулов WB |
required | object (OrderBy) Параметры сортировки |
positionCluster required | string Enum: "all" "firstHundred" "secondHundred" "below" Кластер для позиционирования элементов в отчёте
|
limit required | integer <uint32> <= 1000 Количество запрашиваемых товаров |
offset required | integer <uint32> После какого элемента выдавать данные |
required | object |
{- "currentPeriod": {
- "start": "2024-02-10",
- "end": "2024-02-10"
}, - "pastPeriod": {
- "start": "2024-02-08",
- "end": "2024-02-08"
}, - "subjectId": 123,
- "brandName": "Apple",
- "tagId": 45,
- "nmIds": [
- 162579635,
- 166699779
], - "orderBy": {
- "field": "avgPosition",
- "mode": "asc"
}, - "positionCluster": "all",
- "limit": 150,
- "offset": 100
}
{- "data": {
- "products": [
- {
- "nmId": 268913787,
- "name": "iPhone 13 256 ГБ Серебристый",
- "vendorCode": "wb3ha2668w",
- "subjectName": "Смартфоны",
- "brandName": "Apple",
- "isAdvertised": false,
- "isCardRated": true,
- "rating": 6,
- "feedbackRating": 1,
- "price": {
- "minPrice": 150,
- "maxPrice": 300
}, - "avgPosition": {
- "current": 5,
- "dynamics": 50
}, - "openCard": {
- "current": 5,
- "dynamics": 50
}, - "addToCart": {
- "current": 5,
- "dynamics": 50
}, - "openToCart": {
- "current": 5,
- "dynamics": 50
}, - "orders": {
- "current": 5,
- "dynamics": 50
}, - "cartToOrder": {
- "current": 5,
- "dynamics": 50
}, - "visibility": {
- "current": 5,
- "dynamics": 50
}
}
]
}
}
Формирует топ поисковых запросов по товару.
Параметр выбора поисковых запросов:
limit
— количество запросов (максимум 30)topOrderBy
— способ выбора топа запросов
Максимум 3 запроса в минуту.
required | object (Period) Текущий период |
object (pastPeriod) Прошлый период для сравнения. Количество дней - меньше или равно | |
nmId required | integer <uint64> Артикул WB |
topOrderBy required | string Enum: "openCard" "addToCart" "openToCart" "orders" "cartToOrder" Сортировка по полю поискового запроса
|
required | object (OrderBy) Параметры сортировки |
limit required | integer <uint64> (TextLimit) [ 1 .. 30 ] Количество поисковых запросов по товару |
required | object |
{- "currentPeriod": {
- "start": "2024-02-10",
- "end": "2024-02-10"
}, - "pastPeriod": {
- "start": "2024-02-08",
- "end": "2024-02-08"
}, - "nmId": 162579635,
- "topOrderBy": "openToCart",
- "orderBy": {
- "field": "avgPosition",
- "mode": "asc"
}, - "limit": 20
}
{- "data": {
- "items": [
- {
- "text": "костюм",
- "frequency": {
- "current": 5,
- "dynamics": 50
}, - "weekFrequency": 140,
- "avgPosition": {
- "current": 5,
- "dynamics": 50
}, - "openCard": {
- "current": 5,
- "dynamics": 50,
- "percentile": 50
}, - "addToCart": {
- "current": 5,
- "dynamics": 50,
- "percentile": 50
}, - "openToCart": {
- "current": 5,
- "dynamics": 50,
- "percentile": 50
}, - "orders": {
- "current": 5,
- "dynamics": 50,
- "percentile": 50
}, - "cartToOrder": {
- "current": 5,
- "dynamics": 50,
- "percentile": 50
}, - "visibility": {
- "current": 5,
- "dynamics": 50
}
}
]
}
}
Формирует данные для таблицы по количеству заказов и позиций по запросам. Данные указываются в рамках периода для определённого товара.
Максимум 3 запроса в минуту.
required | object (PeriodOrdersRequest) Текущий период. Не более 7 суток |
nmId required | integer <uint64> Артикул WB |
searchTexts required | Array of strings [ 1 .. 30 ] items Поисковые запросы |
required | object |
{- "period": {
- "start": "2024-02-10",
- "end": "2024-02-10"
}, - "nmId": 211131895,
- "searchTexts": "костюм"
}
{- "data": {
- "total": [
- {
- "dt": "2024-02-10",
- "avgPosition": 10,
- "orders": 20
}
], - "items": [
- {
- "text": "string",
- "frequency": 0,
- "dateItems": [
- {
- "dt": "2024-02-10",
- "avgPosition": 10,
- "orders": 20
}
]
}
]
}
}
Остатки на складах WB
Чтобы получить отчёт:
Создаёт задание на генерацию отчёта. Параметры groupBy
и filter
можно задать в любой комбинации — аналогично версии в личном кабинете.
Максимум 1 запрос в минуту
locale | string Default: "ru" Example: locale=ru Язык полей ответа
|
groupByBrand | boolean Default: "false" Example: groupByBrand=true Разбивка по брендам |
groupBySubject | boolean Default: "false" Example: groupBySubject=true Разбивка по предметам |
groupBySa | boolean Default: "false" Example: groupBySa=true Разбивка по артикулам продавца |
groupByNm | boolean Default: "false" Example: groupByNm=true Разбивка по артикулам WB. Если |
groupByBarcode | boolean Default: "false" Example: groupByBarcode=true Разбивка по баркодам |
groupBySize | boolean Default: "false" Example: groupBySize=true Разбивка по размерам |
filterPics | integer Default: "0" Example: filterPics=1 Фильтр по фото:
|
filterVolume | integer Default: "0" Example: filterVolume=3 Фильтр по объёму:
|
object (CreateTaskResponseData) |
{- "data": {
- "taskId": "219eaecf-e532-4bd8-9f15-8036ec1b042d"
}
}
Возвращает статус задания на генерацию. Максимум 1 запрос в 5 секунд
task_id required | string Example: 06e06887-9d9f-491f-b16a-bb1766fcb8d2 ID задания на генерацию |
object (GetTasksResponseData) |
{- "data": {
- "id": "cad56ec5-91ec-43a2-b5e8-efcf244cf309",
- "status": "done"
}
}
Возвращает отчёт по ID задания. Максимум 1 запрос в минуту
task_id required | string Example: 06e06887-9d9f-491f-b16a-bb1766fcb8d2 ID задания на генерацию |
brand | string Бренд |
subjectName | string Название предмета |
vendorCode | string Артикул продавца |
nmId | integer Артикул WB |
barcode | string Баркод |
techSize | string Размер |
volume | number Объём, л |
inWayToClient | integer В пути к клиенту |
inWayFromClient | integer В пути от клиента |
quantityWarehousesFull | integer Итоговые остатки по всем складам (сумма |
Array of objects Склады. Склад будет в ответе только при ненулевом остатке |
[- {
- "brand": "Wonderful",
- "subjectName": "Фотоальбомы",
- "vendorCode": "41058/прозрачный",
- "nmId": 183804172,
- "barcode": "2037031652319",
- "techSize": "0",
- "volume": 1.33,
- "inWayToClient": 31,
- "inWayFromClient": 24,
- "quantityWarehousesFull": 134,
- "warehouses": [
- {
- "warehouseName": "Невинномысск",
- "quantity": 134
}
]
}
]
Возвращает операции по маркируемым товарам. Максимум 10 запросов за 5 часов.
dateFrom required | string Начало отчётного периода в формате RFC3339. Можно передать дату или дату со временем. Примеры:
|
dateTo required | string Конец отчётного периода в формате RFC3339. Можно передать дату или дату со временем. Примеры:
|
countries | Array of strings Items Enum: "AM" "BY" "KG" "KZ" "RU" "UZ" Код стран по стандарту ISO 3166-2. Чтобы получить данные по всем странам, оставьте параметр пустым |
object (models.ExciseReportResponse) |
{- "countries": [
- "AM",
- "RU"
]
}
{- "response": {
- "data": [
- {
- "name": "Россия",
- "price": 100,
- "currency_name_short": "руб",
- "excise_short": "0102900254680370215_Re/=lSbNiGD",
- "barcode": 2038893425820,
- "nm_id": 169085355,
- "operation_type_id": 1,
- "fiscal_doc_number": 12345678,
- "fiscal_dt": "2024-01-01",
- "fiscal_drive_number": "string",
- "rid": 606217433440,
- "srid": "7513432034713632943.1.0"
}
]
}
}
Чтобы получить отчёт:
Создаёт задание на генерацию отчёта. Можно получить отчёт максимум за 8 дней. Максимум 1 запрос в минуту
dateFrom required | string Example: dateFrom=2022-01-01 Начало отчётного периода в формате RFC3339. Можно передать дату или дату со временем. Примеры:
|
dateTo required | string Example: dateTo=2022-01-09 Конец отчётного периода в формате RFC3339. Можно передать дату или дату со временем. Примеры:
|
object (CreateTaskResponseData) |
{- "data": {
- "taskId": "219eaecf-e532-4bd8-9f15-8036ec1b042d"
}
}
Возвращает статус задания на генерацию. Максимум 1 запрос в 5 секунд
task_id required | string Example: 06e06887-9d9f-491f-b16a-bb1766fcb8d2 ID задания на генерацию |
object (GetTasksResponseData) |
{- "data": {
- "id": "cad56ec5-91ec-43a2-b5e8-efcf244cf309",
- "status": "done"
}
}
Возвращает отчёт по ID задания. Максимум 1 запрос в минуту
task_id required | string Example: 06e06887-9d9f-491f-b16a-bb1766fcb8d2 ID задания на генерацию |
date | string Дата, за которую был расчёт или перерасчёт |
logWarehouseCoef | number Коэффициент логистики и хранения |
officeId | integer ID склада |
warehouse | string Название склада |
warehouseCoef | number Коэффициент склада |
giId | integer ID поставки |
chrtId | integer Идентификатор размера для этого артикула Wildberries |
size | string Размер ( |
barcode | string Баркод |
subject | string Предмет |
brand | string Бренд |
vendorCode | string Артикул продавца |
nmId | integer Артикул Wildberries |
volume | number Объём товара |
calcType | string Способ расчёта |
warehousePrice | number Сумма хранения |
barcodesCount | integer Количество единиц товара (штук), подлежащих тарифицированию за расчётные сутки |
palletPlaceCode | integer Код паллетоместа |
palletCount | number Количество паллет |
originalDate | string Если был перерасчёт, это дата первоначального расчёта. Если перерасчёта не было, совпадает с |
loyaltyDiscount | number Скидка программы лояльности, ₽ |
tariffFixDate | string Дата фиксации тарифа |
tariffLowerDate | string Дата понижения тарифа |
[- {
- "date": "2023-10-01",
- "logWarehouseCoef": 1,
- "officeId": 507,
- "warehouse": "Коледино",
- "warehouseCoef": 1.7,
- "giId": 123456,
- "chrtId": 1234567,
- "size": "0",
- "barcode": "",
- "subject": "Маски одноразовые",
- "brand": "1000 Каталог",
- "vendorCode": "567383",
- "nmId": 1234567,
- "volume": 12,
- "calcType": "короба: без габаритов",
- "warehousePrice": 7.65,
- "barcodesCount": 1,
- "palletPlaceCode": 0,
- "palletCount": 0,
- "originalDate": "2023-03-01",
- "loyaltyDiscount": 10,
- "tariffFixDate": "2023-10-01",
- "tariffLowerDate": "2023-11-01"
}
]
Возвращает даты и стоимость приёмки. Можно получить отчёт максимум за 31 день.
Максимум 1 запрос в минуту
dateFrom required | string Example: dateFrom=2023-12-01 Начало отчётного периода, |
dateTo required | string Example: dateTo=2023-12-15 Конец отчётного периода, |
Array of objects |
{- "report": [
- {
- "count": 40,
- "giCreateDate": "2023-08-23",
- "incomeId": 11834106,
- "nmID": 123456789,
- "shkСreateDate": "2023-04-10",
- "subjectName": "Добавки пищевые",
- "sum": 200,
- "total": 200.5
}
]
}
Возвращает отчёт по удержаниям за самовыкупы. Отчёт формируется каждую неделю по средам, до 7:00 по московскому времени, и содержит данные за одну неделю. Также можно получить отчёт за всё время с августа 2023.
Удержание за самовыкуп — это 30% от стоимости товаров. Минимальная сумма всех удержаний — 100 000 ₽, если за неделю в ПВЗ привезли больше ваших товаров, чем на 100 000 ₽.
Максимум 10 запросов за 100 минут.
date | string Example: date=2023-12-01 Дата, которая входит в отчётный период, |
Array of objects |
{- "details": [
- {
- "nmID": 123456789,
- "sum": 3540,
- "currency": "RUB",
- "dateFrom": "2023-08-23",
- "dateTo": "2023-08-29"
}
]
}
Возвращает отчёт об удержаниях за отправку не тех товаров, пустых коробок или коробок без товара, но с посторонними предметами. В таких случаях удерживается 100% от стоимости заказа.
Можно получить отчёт максимум за 31 день, доступны данные с июня 2023.
Максимум 1 запрос в минуту.
dateFrom required | string Example: dateFrom=2023-12-01 Начало отчётного периода, |
dateTo required | string Example: dateTo=2023-12-15 Конец отчётного периода, |
Array of objects |
{- "report": [
- {
- "amount": 24514.5,
- "date": "2023-12-15",
- "lostReason": "Подмена. Вместо большой железной дороги поступила маленькая коробка.",
- "nmID": 123456789,
- "shkID": 14555724540
}
]
}
Возвращает коэффициенты логистики и хранения. Они рассчитываются на неделю (с понедельника по воскресенье).
Можно получить данные с 31.10.2022.
Максимум 1 запрос в минуту.
Как это работает
В начале каждой недели для продавца рассчитывается новый коэффициент логистики и хранения. Затем стоимость логистики и хранения умножается на коэффициент этой недели.
Как считается коэффициент
На основе расхождения фактических и заявленных габаритов упаковки товара:
Измеряем товары.
Работники склада измеряют по одному товару каждого наименования, с учётом упаковки (кроме товаров меньше 2 л). Для расчёта используются измерения за 30 дней до начала текущей недели.
Считаем коэффициент для товара.Результаты измерений сравниваются с габаритами из карточки товара. В зависимости от разницы каждому наименованию присваивается коэффициент по товару.
Считаем коэффициент логистики и хранения.Коэффициент логистики и хранения — это средний коэффициент по товарам.
Коэффициент логистики и хранения равен 1, если
Для продавцов с коэффициентом 1 стоимость логистики и хранения не увеличится.
date | string Example: date=2023-12-01 Дата, которая входит в отчётный период, |
Array of objects |
{- "report": [
- {
- "actualHeight": 6,
- "actualLength": 39,
- "actualVolume": 7.02,
- "actualWidth": 30,
- "date": "2023-04-11T12:21:19Z",
- "dimensionDifference": 101.74,
- "height": 10,
- "length": 30,
- "logWarehouseCoef": 1,
- "nmID": 123456789,
- "title": "Сухой корм для крупных собак ассорти мясное, 10 кг",
- "volume": 6.9,
- "width": 23
}
]
}
Возвращает отчёт о штрафах за отсутствие обязательной маркировки товаров.
В отчёте представлены фотографии товаров, на которых маркировка отсутствует либо не считывается.
Можно получить данные максимум за 31 день, начиная с марта 2024.
Максимум 10 запросов за 10 минут
dateFrom required | string <date> Example: dateFrom=2024-04-01 Начало отчётного периода, |
dateTo required | string <date> Example: dateTo=2024-04-30 Конец отчётного периода, |
Array of objects |
{- "report": [
- {
- "amount": 1500,
- "date": "2024-03-26T01:00:00Z",
- "incomeId": 18484008,
- "nmID": 49434732,
- "photoUrls": [
], - "shkID": 17346434621,
- "sku": "4630153500834"
}
]
}
Возвращает отчёт об удержаниях за смену характеристик товара. Если товары после приёмки не соответствуют заявленным цветам и размерам, и на складе их перемаркировали с правильными характеристиками, по таким товарам назначается штраф.
Можно получить отчёт максимум за 31 день, доступны данные с 28 декабря 2021.
Максимум 10 запросов за 10 минут
dateFrom required | string <date> Example: dateFrom=2024-04-01 Начало отчётного периода, |
dateTo required | string <date> Example: dateTo=2024-04-30 Конец отчётного периода, |
Array of objects |
{- "report": [
- {
- "amount": 135890,
- "date": "2024-03-01T01:00:00Z",
- "newBarcode": "22222222222222",
- "newColor": "темно-синий,голубой",
- "newSa": "hjt13/темно-синий,голубой",
- "newShkID": 44444444444,
- "newSize": "80",
- "nmID": 123654789,
- "oldBarcode": "111111111111111",
- "oldColor": "темно-синий,голубой",
- "oldSa": "hjt13/темно-синий,голубой",
- "oldShkID": 333333333,
- "oldSize": "43"
}
]
}
Возвращает данные продаж, сгруппированные по регионам стран. Можно получить отчёт максимум за 31 день.
Максимум 1 запрос в 10 секунд
dateFrom required | string Example: dateFrom=2023-12-01 Начало отчётного периода, |
dateTo required | string Example: dateTo=2023-12-15 Конец отчётного периода, |
Array of objects |
{- "report": [
- {
- "cityName": "деревня Суханово",
- "countryName": "Россия",
- "foName": "Центральный федеральный округ",
- "nmID": 177974431,
- "regionName": "Московская область",
- "sa": "112233445566778899",
- "saleInvoiceCostPrice": 592.11,
- "saleInvoiceCostPricePerc": 43.0547333297454,
- "saleItemInvoiceQty": 4
}
]
}
С помощью этих методов можно получать отчёт по доле бренда продавца в продажах
Чтобы получить отчёт:
Можно получить отчёт максимум за год.
Возвращает список заблокированных карточек
Максимум 1 запрос в 10 секунд
sort required | string Enum: "brand" "nmId" "title" "vendorCode" "reason" Example: sort=nmId Сортировка
|
order required | string Enum: "desc" "asc" Example: order=asc Порядок выдачи
|
Array of objects Отчёт |
{- "report": [
- {
- "brand": "Тест22",
- "nmId": 82722944,
- "title": "Гуминовые кислоты - биоактивный противовирусный комплекс на",
- "vendorCode": "пкdeир76",
- "reason": "Контактные данные Продавца и ссылки на иные сайты/группы/сообщества на фотографиях Товара"
}
]
}
Возвращает список товаров, скрытых из каталога
Максимум 1 запрос в 10 секунд
sort required | string Enum: "brand" "nmId" "title" "vendorCode" "nmRating" Example: sort=title Сортировка
|
order required | string Enum: "desc" "asc" Example: order=desc Порядок выдачи
|
Array of objects Отчёт |
{- "report": [
- {
- "brand": "Трикотаж",
- "nmId": 166658151,
- "title": "ВАЗ",
- "vendorCode": "DP02/черный",
- "nmRating": 3.1
}
]
}
Возвращает перечень возвратов товаров продавцу. Одним запросом можно получить отчёт максимум за 31 день.
Максимум 1 запрос в минуту
dateFrom required | string <date> Example: dateFrom=2024-08-13 Дата начала отчётного периода |
dateTo required | string <date> Example: dateTo=2024-08-27 Дата окончания отчётного периода |
Array of objects Отчёт |
{- "report": [
- {
- "barcode": "1680063403480",
- "brand": "dub",
- "dstOfficeAddress": "Жуковский Улица Маяковского 19",
- "dstOfficeId": 310105,
- "isStatusActive": 0,
- "nmId": 12862181,
- "orderDt": "2024-08-26",
- "returnType": "Возврат заблокированного товара",
- "shkId": 23411783472,
- "srid": "f4f02193-289d-4303-aead-73b5b6d40dd9.99",
- "status": "В пути в пвз",
- "stickerId": "33811984302",
- "subjectName": "Багажные бирки",
- "techSize": "0"
}
]
}