Описание API Аналитика

Сервис предоставляет публичный API для получения аналитических данных. С помощью этих методов вы можете получать аналитические отчёты.

Воронка продаж

Таймзоны

Формат IANA, актуальный список можно посмотреть здесь.

Получение статистики КТ за выбранный период, по nmID/предметам/брендам/тегам

Получение статистики КТ за выбранный период, по nmID/предметам/брендам/тегам.
Поля brandNames,objectIDs, tagIDs, nmIDs могут быть пустыми, тогда в ответе идут все карточки продавца.
При выборе нескольких полей в ответ приходят данные по карточкам, у которых есть все выбранные поля. Работает с пагинацией.
Можно получить отчёт максимум за последний год (365 дней).
Также в данных, где предоставляется информация по предыдущему периоду:

В previousPeriod данные за такой же период, что и в selectedPeriod.
Если дата начала previousPeriod раньше, чем год назад от текущей даты, она будет приведена к виду: previousPeriod.start = текущая дата - 365 дней.

Максимум 3 запроса в минуту.

Authorizations:

HeaderApiKey

Request Body schema: application/json
required

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 Временная зона. Если не указано, то по умолчанию используется Europe/Moscow.
required	object Период
	object Параметры сортировки. Если не указано, то по умолчанию используется значение "openCard" и сортировка по убыванию. Все виды сортировки `field`: `openCard` — по открытию карточки (переход на страницу товара) `addToCart` — по добавлениям в корзину `orders` — по кол-ву заказов `avgRubPrice` — по средней цене в рублях `ordersSumRub` — по сумме заказов в рублях `stockMpQty` — по кол-ву остатков маркетплейса шт. `stockWbQty` — по кол-ву остатков на складе шт. `cancelSumRub` — сумме возвратов в рублях `cancelCount` — по кол-ву возвратов `buyoutCount` — по кол-ву выкупов `buyoutSumRub` — по сумме выкупов
page required	integer <int32> Страница

Responses

Response Schema: application/json

	object
error	boolean Флаг ошибки
errorText	string Описание ошибки
	Array of objects Дополнительные ошибки

Request samples

Payload

Content type

application/json

{"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
}

Response samples

Content type

application/json

{"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 запроса в минуту.

Authorizations:

HeaderApiKey

Request Body schema: application/json
required

objectIDs	Array of integers <int32> [ items <int32 > ] Идентификатор предмета
brandNames	Array of strings Название бренда
tagIDs	Array of integers <int32> [ items <int32 > ] Идентификатор тега
timezone	string Временная зона. Если не указано, то по умолчанию используется Europe/Moscow.
required	object Период
	object Параметры сортировки. Если не указано, то по умолчанию используется значение "openCard" и сортировка по убыванию. Все виды сортировки `field`: `openCard` — по открытию карточки (переход на страницу товара) `addToCart` — по добавлениям в корзину `orders` — по кол-ву заказов `avgRubPrice` — по средней цене в рублях `ordersSumRub` — по сумме заказов в рублях `stockMpQty` — по кол-ву остатков маркетплейса шт. `stockWbQty` — по кол-ву остатков на складе шт.
page required	integer <int32> Страница

Responses

Response Schema: application/json

	object
error	boolean Флаг ошибки
errorText	string Описание ошибки
	Array of objects Дополнительные ошибки

Request samples

Payload

Content type

application/json

{"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
}

Response samples

Content type

application/json

{"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

Получение статистики КТ по дням по выбранным nmID. Можно получить отчёт максимум за последнюю неделю. Чтобы получать отчёты за период до года, подпишитесь на расширенную аналитику Джем.
Максимум 3 запроса в минуту.

Authorizations:

HeaderApiKey

Request Body schema: application/json
required

nmIDs required	Array of integers <int32> [ items <int32 > ] Артикул Wildberries (максимум 20)
required	object Период
timezone	string Временная зона. Если не указано, то по умолчанию используется Europe/Moscow.
aggregationLevel	string Тип агрегации. Если не указано, то по умолчанию используется агрегация по дням. Доступные уровни агрегации `day`, `week`

Responses

Response Schema: application/json

	Array of objects
error	boolean Флаг ошибки
errorText	string Описание ошибки
	Array of objects Дополнительные ошибки

Request samples

Payload

Content type

application/json

{"nmIDs": [1234567
],
"period": {"begin": "2023-06-20",
"end": "2023-06-22"
},
"timezone": "Europe/Moscow",
"aggregationLevel": "day"
}

Response samples

Content type

application/json

{"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 запроса в минуту.

Authorizations:

HeaderApiKey

Request Body schema: application/json
required

objectIDs	Array of integers <int32> [ items <int32 > ] Идентификатор предмета
brandNames	Array of strings Название бренда
tagIDs	Array of integers <int32> [ items <int32 > ] Идентификатор тега
required	object Период
timezone	string Временная зона. Если не указано, то по умолчанию используется Europe/Moscow.
aggregationLevel	string Тип агрегации. Если не указано, то по умолчанию используется агрегация по дням. Доступные уровни агрегации `day`, `week`

Responses

Response Schema: application/json

	Array of objects
error	boolean Флаг ошибки
errorText	string Описание ошибки
	Array of objects Дополнительные ошибки

Request samples

Payload

Content type

application/json

{"objectIDs": [358
],
"brandNames": ["Some"
],
"tagIDs": [123
],
"period": {"begin": "2023-06-21",
"end": "2023-06-23"
},
"timezone": "Europe/Moscow",
"aggregationLevel": "day"
}

Response samples

Content type

application/json

{"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"
}
]
}

Воронка продаж (Джем)

Вы можете использовать эти методы только с подпиской Джем.

Чтобы получить отчёт:

Сгенерируйте его с помощью метода метода Создать отчёт.
Дождитесь, когда отчёт будет готов. Готовность можно узнать с помощью метода Получить список отчётов. Готовый отчёт хранится 48 часов, потом его нельзя будет получить.
Если вы получили статус FAILED, сгенерируйте отчёт повторно
Получите отчёт.

Создать отчёт

Вы можете создать отчёт с группировкой:

по артикулам Wildberries (nmID);
по категориям, брендам и тегам.

В каждом из этих отчётов можно сгруппировать данные по дням, неделям или месяцам.

Максимум 3 запроса в минуту, при этом в сутки можно сгенерировать максимум 20 отчётов (считаются только успешные генерации).

Authorizations:

HeaderApiKey

Request Body schema: application/json

One of

id required	string <uuid> Идентификатор отчёта в UUID-формате. Генерируется продавцом самостоятельно
reportType required	string Тип отчёта — `DETAIL_HISTORY_REPORT`
userReportName	string Название отчёта (если не указано, сформируется автоматически)
	object Параметры отчёта

Responses

Response Schema: application/json

data	string Уведомление, что началась генерация отчёта
error	boolean Флаг ошибки
errorText	string Описание ошибки
	Array of objects Дополнительные ошибки

Request samples

Payload

Content type

application/json

Example

BySelectedNmID

По артикулам 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
}
}

Response samples

Content type

application/json

{"data": "Началось формирование файла/отчёта",
"error": false,
"errorText": "",
"additionalErrors": null
}

Получить список отчётов

Максимум 3 запроса в минуту

Authorizations:

HeaderApiKey

query Parameters

filter[downloadIds]

Array of strings <uuid> [ items <uuid > ]

ID отчёта

Responses

Response Schema: application/json

	Array of objects
error	boolean Флаг ошибки
errorText	string Текст ошибки
	Array of objects

Response samples

Content type

application/json

{"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 запроса в минуту

Authorizations:

HeaderApiKey

Request Body schema: application/json
required

downloadId

string <uuid>

ID отчёта

Responses

Response Schema: application/json

data	string Уведомление, что началась повторная генерация отчёта
error	boolean Флаг ошибки
errorText	string Описание ошибки
	Array of objects Дополнительные ошибки

Request samples

Payload

Content type

application/json

{"downloadId": "06eea887-9d9f-491f-b16a-bb1766fcb8d2"
}

Response samples

Content type

application/json

{"data": "Началось переформирование файла/отчёта",
"error": false,
"errorText": "",
"additionalErrors": null
}

Получить отчёт

Можно получить отчёт, который сгенерирован в последние 48 часов.
Отчёт будет загружен внутри архива ZIP в формате CSV.

Максимум 3 запроса в минуту.

Authorizations:

HeaderApiKey

path Parameters

downloadId

required

string <uuid>

ID отчёта

Responses

Response Schema: text/csv

string <binary>

Описание полей в файле 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	Процент выкупа, % (Какой процент посетителей, заказавших товар, его выкупили. Без учёта товаров, которые еще доставляются покупателю)

Response samples

Content type

text/csv

Example

BySelectedNmIDRes

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 запроса в минуту.

Authorizations:

HeaderApiKey

Request Body schema: application/json
required

required	object (Period) Текущий период
	object (pastPeriod) Прошлый период для сравнения. Количество дней - меньше или равно `currentPeriod`
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" Кластер для позиционирования элементов в отчёте `all` — все `firstHundred` — от 1 до 100 `secondHundred` — от 101 до 200 `below` — от 201 и ниже
required	object (OrderBy) Параметры сортировки

Responses

Response Schema: application/json

required

object

Request samples

Payload

Content type

application/json

{"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"
}
}

Response samples

Content type

application/json

{"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",
"mainPhoto": "https://basket-12.wbbasket.ru/vol1788/part178840/178840836/images/c246x328/1.webp",
"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 запроса в минуту.

Authorizations:

HeaderApiKey

Request Body schema: application/json
required

required	object (Period) Текущий период
	object (pastPeriod) Прошлый период для сравнения. Количество дней - меньше или равно `currentPeriod`
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" Кластер для позиционирования элементов в отчёте `all` — все `firstHundred` — от 1 до 100 `secondHundred` — от 101 до 200 `below` — от 201 и ниже
limit required	integer <uint32> <= 1000 Количество запрашиваемых групп товаров
offset required	integer <uint32> После какого элемента выдавать данные

Responses

Response Schema: application/json

required

object

Request samples

Payload

Content type

application/json

{"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
}

Response samples

Content type

application/json

{"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",
"mainPhoto": "https://basket-12.wbbasket.ru/vol1788/part178840/178840836/images/c246x328/1.webp",
"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 запроса в минуту.

Authorizations:

HeaderApiKey

Request Body schema: application/json
required

required	object (Period) Текущий период
	object (pastPeriod) Прошлый период для сравнения. Количество дней - меньше или равно `currentPeriod`
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" Кластер для позиционирования элементов в отчёте `all` — все `firstHundred` — от 1 до 100 `secondHundred` — от 101 до 200 `below` — от 201 и ниже
limit required	integer <uint32> <= 1000 Количество запрашиваемых товаров
offset required	integer <uint32> После какого элемента выдавать данные

Responses

Response Schema: application/json

required

object

Request samples

Payload

Content type

application/json

{"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
}

Response samples

Content type

application/json

{"data": {"products": [{"nmId": 268913787,
"name": "iPhone 13 256 ГБ Серебристый",
"vendorCode": "wb3ha2668w",
"subjectName": "Смартфоны",
"brandName": "Apple",
"mainPhoto": "https://basket-12.wbbasket.ru/vol1788/part178840/178840836/images/c246x328/1.webp",
"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 запроса в минуту.

Authorizations:

HeaderApiKey

Request Body schema: application/json
required

required	object (Period) Текущий период
	object (pastPeriod) Прошлый период для сравнения. Количество дней - меньше или равно `currentPeriod`
nmId required	integer <uint64> Артикул WB
topOrderBy required	string Enum: "openCard" "addToCart" "openToCart" "orders" "cartToOrder" Сортировка по полю поискового запроса `openCard` - Перешли в карточку из поиска `addToCart` - Добавили в корзину из поиска `openToCart` - Конверсия в корзину из поиска `orders` - Заказали товаров из поиска `cartToOrder` - Конверсия в заказ из поиска
required	object (OrderBy) Параметры сортировки
limit required	integer <uint64> (TextLimit) [ 1 .. 30 ] Количество поисковых запросов по товару

Responses

Response Schema: application/json

required

object

Request samples

Payload

Content type

application/json

{"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
}

Response samples

Content type

application/json

{"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 запроса в минуту.

Authorizations:

HeaderApiKey

Request Body schema: application/json
required

required	object (PeriodOrdersRequest) Текущий период. Не более 7 суток
nmId required	integer <uint64> Артикул WB
searchTexts required	Array of strings [ 1 .. 30 ] items Поисковые запросы

Responses

Response Schema: application/json

required

object

Request samples

Payload

Content type

application/json

{"period": {"start": "2024-02-10",
"end": "2024-02-10"
},
"nmId": 211131895,
"searchTexts": "костюм"
}

Response samples

Content type

application/json

{"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
Чтобы получить отчёт:

Создайте его с помощью метода Создать отчёт.
Дождитесь, когда отчёт будет готов. Готовность можно узнать с помощью метода Проверить статус. Готовый отчёт хранится 2 часа, после его нельзя будет получить.
Загрузите отчёт с помощью метода Получить отчёт.

Создать отчёт

Создаёт задание на генерацию отчёта. Параметры groupBy и filter можно задать в любой комбинации — аналогично версии в личном кабинете. Максимум 1 запрос в минуту

Authorizations:

HeaderApiKey

query Parameters

locale	string Default: "ru" Example: locale=ru Язык полей ответа `subjectName` и `warehouseName`: `ru` — русский `en` — английский `zh` — китайский. Значения `warehouseName` на английском
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. Если `groupByNm=true`, в ответе будет поле `volume`
groupByBarcode	boolean Default: "false" Example: groupByBarcode=true Разбивка по баркодам
groupBySize	boolean Default: "false" Example: groupBySize=true Разбивка по размерам
filterPics	integer Default: "0" Example: filterPics=1 Фильтр по фото: `-1` — без фото `0` — не применять фильтр `1` — с фото
filterVolume	integer Default: "0" Example: filterVolume=3 Фильтр по объёму: `-1` — без габаритов `0` — не применять фильтр `3` — свыше трёх литров

Responses

Response Schema: application/json

object (CreateTaskResponseData)

Response samples

200
400
401
429

Content type

application/json

{"data": {"taskId": "219eaecf-e532-4bd8-9f15-8036ec1b042d"
}
}

Проверить статус

Возвращает статус задания на генерацию. Максимум 1 запрос в 5 секунд

Authorizations:

HeaderApiKey

path Parameters

task_id

required

string

Example: 06e06887-9d9f-491f-b16a-bb1766fcb8d2

ID задания на генерацию

Responses

Response Schema: application/json

object (GetTasksResponseData)

Response samples

200
400
401
429

Content type

application/json

{"data": {"id": "cad56ec5-91ec-43a2-b5e8-efcf244cf309",
"status": "done"
}
}

Получить отчёт

Возвращает отчёт по ID задания. Максимум 1 запрос в минуту

Authorizations:

HeaderApiKey

path Parameters

task_id

required

string

Example: 06e06887-9d9f-491f-b16a-bb1766fcb8d2

ID задания на генерацию

Responses

Response Schema: application/json

Array

brand	string Бренд
subjectName	string Название предмета
vendorCode	string Артикул продавца
nmId	integer Артикул WB
barcode	string Баркод
techSize	string Размер
volume	number Объём, л
inWayToClient	integer В пути к клиенту
inWayFromClient	integer В пути от клиента
quantityWarehousesFull	integer Итоговые остатки по всем складам (сумма `quantity`)
	Array of objects Склады. Склад будет в ответе только при ненулевом остатке

Response samples

200
400
401
429

Content type

application/json

[{"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 часов.

Authorizations:

HeaderApiKey

query Parameters

dateFrom required	string Начало отчётного периода в формате RFC3339. Можно передать дату или дату со временем. Примеры: `2023-12-01` `2023-12-01T23:59:59` `2023-12-01T00:00:00.12345` `2023-12-01T00:00:00`
dateTo required	string Конец отчётного периода в формате RFC3339. Можно передать дату или дату со временем. Примеры: `2023-12-01` `2023-12-01T23:59:59` `2023-12-01T00:00:00.12345` `2023-12-01T00:00:00`

Request Body schema: application/json
optional

countries

Array of strings

Items Enum: "AM" "BY" "KG" "KZ" "RU" "UZ"

Код стран по стандарту ISO 3166-2. Чтобы получить данные по всем странам, оставьте параметр пустым

Responses

Response Schema: application/json

object (models.ExciseReportResponse)

Request samples

Payload

Content type

application/json

{"countries": ["AM",
"RU"
]
}

Response samples

200
400
401
429

Content type

application/json

{"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"
}
]
}
}

Платное хранение

Чтобы получить отчёт:

Создайте его с помощью метода Создать отчёт.
Дождитесь, когда отчёт будет готов. Готовность можно узнать с помощью метода Проверить статус. Готовый отчёт хранится 2 часа, после его нельзя будет получить.
Загрузите отчёт с помощью метода Получить отчёт.

Создать отчёт

Создаёт задание на генерацию отчёта. Можно получить отчёт максимум за 8 дней. Максимум 1 запрос в минуту

Authorizations:

HeaderApiKey

query Parameters

dateFrom required	string Example: dateFrom=2022-01-01 Начало отчётного периода в формате RFC3339. Можно передать дату или дату со временем. Примеры: `2019-06-20` `2019-06-20T23:59:59` `2019-06-20T00:00:00.12345` `2017-03-25T00:00:00`
dateTo required	string Example: dateTo=2022-01-09 Конец отчётного периода в формате RFC3339. Можно передать дату или дату со временем. Примеры: `2019-06-20` `2019-06-20T23:59:59` `2019-06-20T00:00:00.12345` `2017-03-25T00:00:00`

Responses

Response Schema: application/json

object (CreateTaskResponseData)

Response samples

200
400
401
429

Content type

application/json

{"data": {"taskId": "219eaecf-e532-4bd8-9f15-8036ec1b042d"
}
}

Проверить статус

Возвращает статус задания на генерацию. Максимум 1 запрос в 5 секунд

Authorizations:

HeaderApiKey

path Parameters

task_id

required

string

Example: 06e06887-9d9f-491f-b16a-bb1766fcb8d2

ID задания на генерацию

Responses

Response Schema: application/json

object (GetTasksResponseData)

Response samples

200
400
401
429

Content type

application/json

{"data": {"id": "cad56ec5-91ec-43a2-b5e8-efcf244cf309",
"status": "done"
}
}

Получить отчёт

Возвращает отчёт по ID задания. Максимум 1 запрос в минуту

Authorizations:

HeaderApiKey

path Parameters

task_id

required

string

Example: 06e06887-9d9f-491f-b16a-bb1766fcb8d2

ID задания на генерацию

Responses

Response Schema: application/json

Array

date	string Дата, за которую был расчёт или перерасчёт
logWarehouseCoef	number Коэффициент логистики и хранения
officeId	integer ID склада
warehouse	string Название склада
warehouseCoef	number Коэффициент склада
giId	integer ID поставки
chrtId	integer Идентификатор размера для этого артикула Wildberries
size	string Размер (`techSize` в карточке товара)
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 Если был перерасчёт, это дата первоначального расчёта. Если перерасчёта не было, совпадает с `date`
loyaltyDiscount	number Скидка программы лояльности, ₽
tariffFixDate	string Дата фиксации тарифа
tariffLowerDate	string Дата понижения тарифа

Response samples

200
400
401
429

Content type

application/json

[{"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 запрос в минуту

Authorizations:

HeaderApiKey

query Parameters

dateFrom required	string Example: dateFrom=2023-12-01 Начало отчётного периода, `ГГГГ-ММ-ДД`
dateTo required	string Example: dateTo=2023-12-15 Конец отчётного периода, `ГГГГ-ММ-ДД`

Responses

Response Schema: application/json

Array of objects

Response samples

200
400
401
429
500

Content type

application/json

{"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 минут.

Authorizations:

HeaderApiKey

query Parameters

date	string Example: date=2023-12-01 Дата, которая входит в отчётный период, `ГГГГ-ММ-ДД`. Чтобы получить данные за всё время с августа 2023, не указывайте этот параметр

Responses

Response Schema: application/json

Array of objects

Response samples

200
400
401
429

Content type

application/json

{"details": [{"nmID": 123456789,
"sum": 3540,
"currency": "RUB",
"dateFrom": "2023-08-23",
"dateTo": "2023-08-29"
}
]
}

Подмена товара

Возвращает отчёт об удержаниях за отправку не тех товаров, пустых коробок или коробок без товара, но с посторонними предметами. В таких случаях удерживается 100% от стоимости заказа.

Можно получить отчёт максимум за 31 день, доступны данные с июня 2023.

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

Authorizations:

HeaderApiKey

query Parameters

dateFrom required	string Example: dateFrom=2023-12-01 Начало отчётного периода, `ГГГГ-ММ-ДД`
dateTo required	string Example: dateTo=2023-12-15 Конец отчётного периода, `ГГГГ-ММ-ДД`

Responses

Response Schema: application/json

Array of objects

Response samples

200
400
401
429

Content type

application/json

{"report": [{"amount": 24514.5,
"date": "2023-12-15",
"lostReason": "Подмена. Вместо большой железной дороги поступила маленькая коробка.",
"nmID": 123456789,
"photoUrl": "https://mstatic.wbstatic.net/writeoff_to_the_seller/12345678911-2023-06-21T12:13:37.768Z-1.png",
"shkID": 14555724540
}
]
}

Коэффициент логистики и хранения

Возвращает коэффициенты логистики и хранения. Они рассчитываются на неделю (с понедельника по воскресенье).

Можно получить данные с 31.10.2022.

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

Как это работает

В начале каждой недели для продавца рассчитывается новый коэффициент логистики и хранения. Затем стоимость логистики и хранения умножается на коэффициент этой недели.

Как считается коэффициент

На основе расхождения фактических и заявленных габаритов упаковки товара:

Измеряем товары.
Работники склада измеряют по одному товару каждого наименования, с учётом упаковки (кроме товаров меньше 2 л). Для расчёта используются измерения за 30 дней до начала текущей недели.
Считаем коэффициент для товара.
Результаты измерений сравниваются с габаритами из карточки товара. В зависимости от разницы каждому наименованию присваивается коэффициент по товару.
Считаем коэффициент логистики и хранения.
Коэффициент логистики и хранения — это средний коэффициент по товарам.

Коэффициент логистики и хранения равен 1, если

По товарам продавца сделано меньше 10 уникальных измерений.
Средняя разница в габаритах не больше 10%.

Для продавцов с коэффициентом 1 стоимость логистики и хранения не увеличится.

Authorizations:

HeaderApiKey

query Parameters

date	string Example: date=2023-12-01 Дата, которая входит в отчётный период, `ГГГГ-ММ-ДД`

Responses

Response Schema: application/json

Array of objects

Response samples

200
400
401
429
500

Content type

application/json

{"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,
"photoUrls": ["https://photos.wbstatic.net/handheld-goods-measurements-photo/123456789_73984211-e6c3-44e2-66af-0d44d2620308.jpg",
"https://photos.wbstatic.net/handheld-goods-measurements-photo/123456789_8ee5ff5e-c6bb-426c-7d12-c2dd228c0f62.jpg"
],
"title": "Сухой корм для крупных собак ассорти мясное, 10 кг",
"volume": 6.9,
"width": 23
}
]
}

Маркировка товара

Возвращает отчёт о штрафах за отсутствие обязательной маркировки товаров.
В отчёте представлены фотографии товаров, на которых маркировка отсутствует либо не считывается.
Можно получить данные максимум за 31 день, начиная с марта 2024.
Максимум 10 запросов за 10 минут

Authorizations:

HeaderApiKey

query Parameters

dateFrom required	string <date> Example: dateFrom=2024-04-01 Начало отчётного периода, `ГГГГ-ММ-ДД`
dateTo required	string <date> Example: dateTo=2024-04-30 Конец отчётного периода, `ГГГГ-ММ-ДД`

Responses

Response Schema: application/json

Array of objects

Response samples

200
400
401
429

Content type

application/json

{"report": [{"amount": 1500,
"date": "2024-03-26T01:00:00Z",
"incomeId": 18484008,
"nmID": 49434732,
"photoUrls": ["https://static-basket-03.wildberries.ru/vol54/photo-fixation-violation-shk-excise/12345678900-1811460999-1.jpg",
"https://static-basket-03.wildberries.ru/vol54/photo-fixation-violation-shk-excise/12345678900-1811461000-2.jpg",
"https://static-basket-03.wildberries.ru/vol54/photo-fixation-violation-shk-excise/12345678900-1811461001-3.jpg"
],
"shkID": 17346434621,
"sku": "4630153500834"
}
]
}

Смена характеристик

Возвращает отчёт об удержаниях за смену характеристик товара. Если товары после приёмки не соответствуют заявленным цветам и размерам, и на складе их перемаркировали с правильными характеристиками, по таким товарам назначается штраф.
Можно получить отчёт максимум за 31 день, доступны данные с 28 декабря 2021.
Максимум 10 запросов за 10 минут

Authorizations:

HeaderApiKey

query Parameters

dateFrom required	string <date> Example: dateFrom=2024-04-01 Начало отчётного периода, `ГГГГ-ММ-ДД`
dateTo required	string <date> Example: dateTo=2024-04-30 Конец отчётного периода, `ГГГГ-ММ-ДД`

Responses

Response Schema: application/json

Array of objects

Response samples

200
400
401
429

Content type

application/json

{"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 секунд

Authorizations:

HeaderApiKey

query Parameters

dateFrom required	string Example: dateFrom=2023-12-01 Начало отчётного периода, `ГГГГ-ММ-ДД`
dateTo required	string Example: dateTo=2023-12-15 Конец отчётного периода, `ГГГГ-ММ-ДД`

Responses

Response Schema: application/json

Array of objects

Response samples

200
400
401
429

Content type

application/json

{"report": [{"cityName": "деревня Суханово",
"countryName": "Россия",
"foName": "Центральный федеральный округ",
"nmID": 177974431,
"regionName": "Московская область",
"sa": "112233445566778899",
"saleInvoiceCostPrice": 592.11,
"saleInvoiceCostPricePerc": 43.0547333297454,
"saleItemInvoiceQty": 4
}
]
}

Доля бренда в продажах

С помощью этих методов можно получать отчёт по доле бренда продавца в продажах

Чтобы получить отчёт:

Можно получить отчёт максимум за год.

Бренды продавца

Возвращает список брендов продавца.

Можно получить только бренды, которые:

продавались за последние 90 дней
есть на складе WB

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

Authorizations:

HeaderApiKey

Responses

Response Schema: application/json

data	Array of strings Список брендов

Response samples

200
401
429

Content type

application/json

{"data": ["1000 | Каталог",
"1000 Каталог",
"AndBerries",
"H&M",
"Mirtex",
"PlayToday",
"Test1",
"WOW",
"[\"Colambetta\"]",
"dubs",
"test",
"Бест Трикотаж",
"Тест"
]
}

Родительские категории бренда

Возвращает родительские категории бренда.

Можно получить данные с 1 ноября 2022 года, максимум за 365 дней.

Максимум 1 запрос в 5 секунд

Authorizations:

HeaderApiKey

query Parameters

locale	string Default: "ru" Example: locale=ru Язык поля ответа `parentName`: `ru` — русский `en` — английский `zh` — китайский
brand required	string Example: brand=H%26M Бренд
dateFrom required	string Example: dateFrom=2023-12-01 Начало отчётного периода, `ГГГГ-ММ-ДД`
dateTo required	string Example: dateTo=2023-12-15 Конец отчётного периода, `ГГГГ-ММ-ДД`

Responses

Response Schema: application/json

Array of objects

Категории бренда

Response samples

200
400
401
429

Content type

application/json

{"data": [{"parentId": 3,
"parentName": "Аксессуары"
},
{"parentId": 7,
"parentName": "Игрушки"
},
{"parentId": 1,
"parentName": "Одежда"
},
{"parentId": 239,
"parentName": "Спортивный товар"
}
]
}

Получить отчёт

Возвращает отчёт по доле бренда в продажах.

Можно получить данные с 1 ноября 2022 года, максимум за 365 дней.

Максимум 1 запрос в 5 секунд

Authorizations:

HeaderApiKey

query Parameters

parentId required	integer Example: parentId=1 ID родительской категории
brand required	string Example: brand=H%26M Бренд
dateFrom required	string Example: dateFrom=2023-12-01 Начало отчётного периода, `ГГГГ-ММ-ДД`
dateTo required	string Example: dateTo=2023-12-15 Конец отчётного периода, `ГГГГ-ММ-ДД`

Responses

Response Schema: application/json

Array of objects

Отчёт

Response samples

200
400
401
429

Content type

application/json

{"report": [{"applyDate": "2023-10-31",
"brandRating": 5,
"pricePercent": 0.68,
"qtyPercent": 1
},
{"applyDate": "2023-11-01",
"brandRating": 5,
"pricePercent": 0.65,
"qtyPercent": 0.99
},
{"applyDate": "2023-11-02",
"brandRating": 4,
"pricePercent": 0.74,
"qtyPercent": 1.23
},
{"applyDate": "2023-11-03",
"brandRating": 2,
"pricePercent": 0.76,
"qtyPercent": 1.39
}
]
}

Скрытые товары

Заблокированные карточки

Возвращает список заблокированных карточек

Максимум 1 запрос в 10 секунд

Authorizations:

HeaderApiKey

query Parameters

sort

required

string

Enum: "brand" "nmId" "title" "vendorCode" "reason"

Example: sort=nmId

Сортировка

brand — по бренду
nmId — по артикулу WB
title — по наименованию товара
vendorCode — по артикулу продавца
reason — по причине блокировки

order

required

string

Enum: "desc" "asc"

Example: order=asc

Порядок выдачи

desc — от наибольшего числового значения к наименьшему, от последнего по алфавиту значения к первому
asc — от наименьшего числового значения к наибольшему, от первого по алфавиту значения к последнему

Responses

Response Schema: application/json

Array of objects

Отчёт

Response samples

200
400
401
429

Content type

application/json

{"report": [{"brand": "Тест22",
"nmId": 82722944,
"title": "Гуминовые кислоты - биоактивный противовирусный комплекс на",
"vendorCode": "пкdeир76",
"reason": "Контактные данные Продавца и ссылки на иные сайты/группы/сообщества на фотографиях Товара"
}
]
}

Скрытые из каталога

Возвращает список товаров, скрытых из каталога

Максимум 1 запрос в 10 секунд

Authorizations:

HeaderApiKey

query Parameters

sort

required

string

Enum: "brand" "nmId" "title" "vendorCode" "nmRating"

Example: sort=title

Сортировка

brand — по бренду
nmId — по артикулу WB
title — по наименованию товара
vendorCode — по артикулу продавца
nmRating — по рейтингу товара

order

required

string

Enum: "desc" "asc"

Example: order=desc

Порядок выдачи

desc — от наибольшего числового значения к наименьшему, от последнего по алфавиту значения к первому
asc — от наименьшего числового значения к наибольшему, от первого по алфавиту значения к последнему

Responses

Response Schema: application/json

Array of objects

Отчёт

Response samples

200
400
401
429

Content type

application/json

{"report": [{"brand": "Трикотаж",
"nmId": 166658151,
"title": "ВАЗ",
"vendorCode": "DP02/черный",
"nmRating": 3.1
}
]
}

Отчёт по возвратам товаров

Получить отчёт

Возвращает перечень возвратов товаров продавцу. Одним запросом можно получить отчёт максимум за 31 день.

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

Authorizations:

HeaderApiKey

query Parameters

dateFrom required	string <date> Example: dateFrom=2024-08-13 Дата начала отчётного периода
dateTo required	string <date> Example: dateTo=2024-08-27 Дата окончания отчётного периода

Responses

Response Schema: application/json

Array of objects

Отчёт

Response samples

200
400
401
429

Content type

application/json

{"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"
}
]
}

Описание API Аналитика

Воронка продаж

Получение статистики КТ за выбранный период, по nmID/предметам/брендам/тегам

Authorizations:

Request Body schema: application/jsonrequired

Responses

Response Schema: application/json

Request samples

Response samples

Получение статистики КТ за период, сгруппированный по предметам, брендам и тегам

Authorizations:

Request Body schema: application/jsonrequired

Responses

Response Schema: application/json

Request samples

Response samples

Получение статистики КТ по дням по выбранным nmID

Authorizations:

Request Body schema: application/jsonrequired

Responses

Response Schema: application/json

Request samples

Response samples

Получение статистики КТ по дням за период, сгруппированный по предметам, брендам и тегам

Authorizations:

Request Body schema: application/jsonrequired

Responses

Response Schema: application/json

Request samples

Response samples

Воронка продаж (Джем)

Создать отчёт

Authorizations:

Request Body schema: application/json

Responses

Response Schema: application/json

Request samples

Response samples

Получить список отчётов

Authorizations:

query Parameters

Responses

Response Schema: application/json

Response samples

Сгенерировать отчёт повторно

Authorizations:

Request Body schema: application/jsonrequired

Responses

Response Schema: application/json

Request samples

Response samples

Получить отчёт

Authorizations:

path Parameters

Responses

Response Schema: text/csv

Response samples

Поисковые запросы

Основная страница

Authorizations:

Request Body schema: application/jsonrequired

Responses

Response Schema: application/json

Request samples

Response samples

Пагинация по группам

Authorizations:

Request Body schema: application/jsonrequired

Responses

Response Schema: application/json

Request samples

Response samples

Пагинация по товарам в группе

Authorizations:

Request Body schema: application/jsonrequired

Responses

Response Schema: application/json

Request samples

Response samples

Поисковые запросы по товару

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
optional