Аналитика и данные (analytics)
Анализ данных по вопросам, отзывам, финансовым кампаниям, статистика по продвижению, воронки продаж
Анализ данных по вопросам, отзывам, финансовым кампаниям, статистика по продвижению, воронки продаж
Получение вопросов в формате XLSX{{ /api/v1/questions/report }}
Возвращает файл с вопросами в формате XLSX в кодировке base64
Authorizations:
query Parameters
isAnswered required | boolean Example: isAnswered=false Обработанные вопросы ( |
Responses
Response samples
- 200
- 400
- 401
- 403
- 429
{- "data": {
- "fileName": "report.xlsx",
- "file": "UEsDBBQAC ... CAADMdQAAAAA=",
- "contentType": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"
}, - "error": false,
- "errorText": "",
- "additionalErrors": null
}
Количество вопросов{{ /api/v1/questions/count }}
Возвращает количество вопросов за заданный период
Authorizations:
query Parameters
dateFrom | integer Example: dateFrom=1688465092 Дата начала периода в формате Unix timestamp |
dateTo | integer Example: dateTo=1688465092 Дата конца периода в формате Unix timestamp |
isAnswered | boolean Example: isAnswered=false Обработанные вопросы ( |
Responses
Response samples
- 200
- 401
- 403
- 429
{- "data": 77,
- "error": false,
- "errorText": "",
- "additionalErrors": null
}
Часто спрашиваемые товары{{ /api/v1/questions/products/rating }}
Возвращает товары, про которые спрашивают чаще всего
Authorizations:
query Parameters
size required | integer Example: size=1 Количество запрашиваемых товаров (max. 100) |
Responses
Response samples
- 200
- 400
- 401
- 403
- 429
{- "data": {
- "products": [
- {
- "nmId": 21573649,
- "imtId": 15384080,
- "productName": "Чехол для телефона iPhone 11",
- "brandName": "Case",
- "questionsCount": 11
}
]
}, - "error": false,
- "errorText": "",
- "additionalErrors": null
}
Получение отзывов в формате XLSX{{ /api/v1/feedbacks/report }}
Возвращает файл с отзывами в формате XLSX в кодировке base64 Можно получить максимум 5000 отзывов в одном ответе
Authorizations:
query Parameters
isAnswered required | boolean Enum: true false Необработанный( |
skip | integer Example: skip=1 Параметр пагинации, указывает сколько отзывов пропустить (max. 20 000) |
dateFrom | integer Example: dateFrom=1696226971 Дата начала периода в формате Unix timestamp |
dateTo | integer Example: dateTo=1698916171 Дата конца периода в формате Unix timestamp |
order | string Example: order=dateDesc Сортировка отзывов по дате (dateAsc/dateDesc) |
Responses
Response samples
- 200
- 400
- 401
- 403
- 429
{- "data": {
- "fileName": "report.xlsx",
- "file": "UEsDBBQA ... ACAADxGgAAAAA=",
- "contentType": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"
}, - "error": false,
- "errorText": "",
- "additionalErrors": null
}
Количество отзывов{{ /api/v1/feedbacks/count }}
Возвращает количество отзывов
Authorizations:
query Parameters
dateFrom | integer Example: dateFrom=1688465092 Дата начала периода в формате Unix timestamp |
dateTo | integer Example: dateTo=1688465092 Дата конца периода в формате Unix timestamp |
isAnswered | boolean Example: isAnswered=false Обработанные отзывы( |
Responses
Response samples
- 200
- 401
- 403
- 429
{- "data": 724583,
- "error": false,
- "errorText": "",
- "additionalErrors": null
}
Средняя оценка товара по артикулу WB{{ /api/v1/feedbacks/products/rating/nmid }}
Возвращает среднюю оценку товара по его артикулу WB
Authorizations:
query Parameters
nmId required | integer Example: nmId=14917842 Артикул WB |
Responses
Response samples
- 200
- 400
- 401
- 403
- 429
{- "data": {
- "valuation": "4.3",
- "feedbacksCount": 16
}, - "error": false,
- "errorText": "",
- "additionalErrors": null
}
Родительские категории товаров{{ /api/v1/parent-subjects }}
Возвращает список родительских категорий товаров продавца
Authorizations:
Responses
Response samples
- 200
- 400
- 401
- 403
- 429
{- "data": [
- {
- "subjectId": 1162,
- "subjectName": "Строительные инструменты"
}
], - "error": false,
- "errorText": "",
- "additionalErrors": null
}
Получить список оценок{{ /api/v1/supplier-valuations }}
Возвращает список значений для оценки отзыва/товара.
Authorizations:
header Parameters
X-Locale | string Example: ru Выбор языка значений полей ответа ( |
Responses
Response samples
- 200
- 401
- 429
{- "data": {
- "feedbackValuations": {
- "1": "Отзыв не относится к товару",
- "2": "Отзыв оставили конкуренты",
- "3": "Спам",
- "4": "Нецензурное содержимое в фото",
- "5": "Нецензурная лексика",
- "6": "Фото не имеет отношения к товару",
- "7": "Отзыв с политическим контекстом"
}, - "productValuations": {
- "1": "Повредили при доставке",
- "2": "Товар подменили",
- "3": "Случайно отправил не тот товар и хочу его вернуть",
- "4": "Товар вернули после эксплуатации"
}
}, - "error": false,
- "errorText": "",
- "additionalErrors": null
}
Список архивных отзывов{{ /api/v1/feedbacks/archive }}
Возвращает список архивных отзывов. Отзыв становится архивным, если:
- На отзыв получен ответ
- Ответ на отзыв не получен в течение 30 дней
- В отзыве нет текста и фото
Authorizations:
query Parameters
nmId | integer Example: nmId=14917842 Артикул WB |
take required | integer Example: take=1 Количество отзывов (max. 5 000) |
skip required | integer Example: skip=0 Количество отзывов для пропуска |
order | string Enum: "dateAsc" "dateDesc" Сортировка отзывов по дате (dateAsc/dateDesc) |
Responses
Response samples
- 200
- 400
- 401
- 403
- 429
{- "data": {
- "feedbacks": [
- {
- "id": "YX52RZEBhH9mrcYdEJuD",
- "text": "Спасибо, всё подошло",
- "pros": "Удобный",
- "cons": "Нет",
- "productValuation": 5,
- "createdDate": "2024-09-26T10:20:48+03:00",
- "answer": {
- "text": "Пожалуйста. Ждём вас снова!",
- "state": "wbRu",
- "editable": false
}, - "state": "wbRu",
- "productDetails": {
- "imtId": 123456789,
- "nmId": 987654321,
- "productName": "ВАЗ",
- "supplierArticle": "DP02/черный",
- "supplierName": "ГП Реклама и услуги",
- "brandName": "Бест Трикотаж",
- "size": "0"
}, - "video": {
- "durationSec": 10
}, - "wasViewed": true,
- "photoLinks": [
], - "userName": "Николай",
- "matchingSize": "ok",
- "isAbleSupplierFeedbackValuation": false,
- "supplierFeedbackValuation": 1,
- "isAbleSupplierProductValuation": false,
- "supplierProductValuation": 2,
- "isAbleReturnProductOrders": false,
- "returnProductOrdersDate": "2024-08-20T16:39:49Z",
- "bables": [
- "цена"
], - "lastOrderShkId": 123456789,
- "lastOrderCreatedAt": "2024-08-12T10:20:48+03:00",
- "color": "colorless",
- "subjectId": 219,
- "subjectName": "Футболки-поло",
- "parentFeedbackId": null,
- "childFeedbackId": "bIjTCZDvJni7NGnLbUlf"
}
]
}, - "error": false,
- "errorText": "",
- "additionalErrors": null
}
Товары с наибольшей и наименьшей средней оценкой по родительской категории{{ /api/v1/feedbacks/products/rating/top }}
Возвращает список из двух товаров: с наибольшей и наименьшей средней оценкой по родительской категории
Authorizations:
query Parameters
subjectId required | integer Example: subjectId=3109 id категории товара |
Responses
Response samples
- 200
- 400
- 401
- 403
- 429
{- "data": {
- "productMaxRating": {
- "nmId": 14917842,
- "imtId": 11157265,
- "subjectId": 5135,
- "valuationsSum": 1260,
- "feedbacksCount": 252,
- "valuation": 5,
- "productName": "Кофе",
- "supplierArticle": "123401",
- "brandName": "Nescafe"
}, - "productMinRating": {
- "nmId": 14917846,
- "imtId": 11157269,
- "subjectId": 5134,
- "valuationsSum": 4,
- "feedbacksCount": 2,
- "valuation": 2,
- "productName": "Кофе",
- "supplierArticle": "425501",
- "brandName": "Nescafe"
}
}, - "error": false,
- "errorText": "",
- "additionalErrors": null
}
Средняя оценка товаров по родительской категории{{ /api/v1/feedbacks/products/rating }}
Возвращает среднюю оценку товаров по родительской категории
Authorizations:
query Parameters
subjectId required | integer Example: subjectId=3109 ID категории товара |
Responses
Response samples
- 200
- 400
- 401
- 403
- 429
{- "data": {
- "valuation": "4.8",
- "feedbacksCount": 277
}, - "error": false,
- "errorText": "",
- "additionalErrors": null
}
Получение истории затрат{{ /adv/v1/upd }}
Возвращает историю затрат
Authorizations:
query Parameters
from required | string <date> Example: from=2023-07-31 Начало интервала |
to required | string <date> Example: to=2023-08-02 Конец интервала. |
Responses
Response samples
- 200
- 400
- 401
- 429
[- {
- "updNum": 0,
- "updTime": "2023-07-31T12:12:54.060536+03:00",
- "updSum": 24,
- "advertId": 3355881,
- "campName": "лук лучок",
- "advertType": 6,
- "paymentType": "Баланс",
- "advertStatus": 9
}, - {
- "updNum": 0,
- "updTime": null,
- "updSum": 107,
- "advertId": 3366882,
- "campName": "золотая луковица",
- "advertType": 8,
- "paymentType": "Счет",
- "advertStatus": 11
}
]
Получение истории пополнений счёта{{ /adv/v1/payments }}
Возвращает историю пополнений счёта
Authorizations:
query Parameters
from | string <date> Example: from=2023-07-31 Начало интервала |
to | string <date> Example: to=2023-08-02 Конец интервала. |
Responses
Response samples
- 200
- 400
- 401
- 429
[- {
- "id": 1036666,
- "date": "2022-02-04T09:06:47.985843Z",
- "sum": 600,
- "type": 0,
- "statusId": 1,
- "cardStatus": ""
}, - {
- "id": 55261296,
- "date": "2023-04-13T10:07:42",
- "sum": 1500,
- "type": 3,
- "statusId": 1,
- "cardStatus": "succeeded"
}
]
Статистика кампаний{{ /adv/v2/fullstats }}
Возвращает статистику кампаний. Данные вернутся для кампаний в статусах:
7
— завершено9
— приостановлена продавцом11
— пауза по расходу бюджета
dates
либо параметр interval
, но не оба.Можно отправить запрос только с ID кампании. При этом вернутся данные за последние сутки, но не за весь период существования кампании.
Authorizations:
Request Body schema: application/jsonrequired
id | integer ID кампании |
dates | Array of strings <date> [ items <date > ] Даты, за которые необходимо выдать информацию. |
Responses
Request samples
- Payload
Запрос с датами
[- {
- "id": 8960367,
- "dates": [
- "2023-10-07",
- "2023-10-06"
]
}, - {
- "id": 9876543,
- "dates": [
- "2023-10-07",
- "2023-12-06"
]
}
]
Response samples
- 200
- 400
- 401
- 429
Ответ при запросе с полем date
[- {
- "views": 1052,
- "clicks": 2,
- "ctr": 0.19,
- "cpc": 0.09,
- "sum": 177.7,
- "atbs": 0,
- "orders": 0,
- "cr": 0,
- "shks": 0,
- "sum_price": 0,
- "dates": [
- "2023-10-07",
- "2023-10-06"
], - "days": [
- {
- "date": "2023-10-06T03:00:00+03:00",
- "views": 414,
- "clicks": 1,
- "ctr": 0.24,
- "cpc": 70,
- "sum": 70,
- "atbs": 0,
- "orders": 0,
- "cr": 0,
- "shks": 0,
- "sum_price": 0,
- "apps": [
- {
- "views": 228,
- "clicks": 0,
- "ctr": 0,
- "cpc": 0,
- "sum": 38.71,
- "atbs": 0,
- "orders": 0,
- "cr": 0,
- "shks": 0,
- "sum_price": 0,
- "nm": [
- {
- "views": 25,
- "clicks": 0,
- "ctr": 0,
- "cpc": 0,
- "sum": 4,
- "atbs": 0,
- "orders": 0,
- "cr": 0,
- "shks": 0,
- "sum_price": 0,
- "name": "Тапочки",
- "nmId": 111111111111
}
], - "appType": 1
}
]
}
], - "boosterStats": [
- {
- "date": "2023-10-07T00:00:00Z",
- "nm": 170095908,
- "avg_position": 348
}
], - "advertId": 10524818
}
]
Статистика медиакампаний{{ /adv/v1/stats }}
Возвращает статистику медиакампаний
Authorizations:
Request Body schema: application/jsonrequired
id | integer ID кампании |
dates | Array of strings <date> [ items <date > ] Даты, за которые необходимо выдать информацию. |
Responses
Request samples
- Payload
Запрос с датами
[- {
- "id": 8960367,
- "dates": [
- "2023-10-07",
- "2023-10-06"
]
}, - {
- "id": 9876543,
- "dates": [
- "2023-10-07",
- "2023-12-06"
]
}
]
Response samples
- 200
- 401
- 429
Ответ при запросе с интервалами
[- {
- "interval": {
- "begin": "2023-10-21",
- "end": "2023-10-25"
}, - "stats": [
- {
- "item_id": 62237,
- "item_name": "Gloria Jeans",
- "category_name": "Детям",
- "advert_type": 1,
- "place": 2,
- "views": 11849,
- "clicks": 209,
- "cr": 0.48,
- "ctr": 1.76,
- "date_from": "2023-10-21T00:00:00+03:00",
- "date_to": "2023-10-27T23:59:59+03:00",
- "subject_name": "Одежда",
- "atbs": 4,
- "orders": 1,
- "price": 175000,
- "cpc": 837.32,
- "status": 6,
- "daily_stats": [
- {
- "date": "2023-10-21T00:00:00+03:00",
- "app_type_stats": [
- {
- "app_type": 1,
- "stats": [
- {
- "views": 2017,
- "clicks": 27,
- "atbs": 1,
- "ctr": 1.34
}
]
}
]
}
], - "expenses": 175000,
- "cr1": 1.91,
- "cr2": 25
}
]
}
]
Статистика автоматической кампании по кластерам фраз{{ /adv/v2/auto/stat-words }}
Возвращает кластеры ключевых (наборы похожих) фраз, по которым показывались товары в кампании, и количество показов по ним. В ответ метода попадают только те фразы, по которым товары показывались хотя бы один раз. Информация обновляется раз в 15 минут
Authorizations:
query Parameters
id required | integer Example: id=1234 ID кампании |
Responses
Response samples
- 200
- 400
- 401
- 429
{- "excluded": [
- "Samsung",
- "Xiaomi"
], - "clusters": [
- {
- "cluster": "Телефон",
- "count": 100,
- "keywords": [
- "Телефон",
- "Мобильный телефон"
]
}
]
}
Статистика поисковой кампании по ключевым фразам{{ /adv/v1/stat/words }}
Возвращает статистику поисковой кампании по ключевым фразам.
Информация обновляется каждые 30 минут
Authorizations:
query Parameters
id required | integer Example: id=1 ID кампании |
Responses
Response samples
- 200
- 401
- 429
{- "words": {
- "phrase": [ ],
- "strong": [ ],
- "excluded": [ ],
- "pluse": [
- "детское постельное белье для мальчика 1.5"
], - "keywords": [
- {
- "keyword": "постельное белье 1.5",
- "count": 772
}
], - "fixed": true
}, - "stat": [
- {
- "advertId": 7703570,
- "keyword": "Всего по кампании",
- "advertName": "",
- "campaignName": "Бельё",
- "begin": "2023-07-03T15:15:38.287441+03:00",
- "end": "2023-07-03T15:15:38.287441+03:00",
- "views": 1846,
- "clicks": 73,
- "frq": 1.03,
- "ctr": 3.95,
- "cpc": 7.88,
- "duration": 769159,
- "sum": 575.6
}, - {
- "advertId": 7703570,
- "keyword": "постельное белье 1.5 детское",
- "advertName": "",
- "campaignName": "Бельё",
- "begin": "2023-07-03T15:15:38.287441+03:00",
- "end": "2023-07-03T15:15:38.287441+03:00",
- "views": 1846,
- "clicks": 73,
- "frq": 1.03,
- "ctr": 3.95,
- "cpc": 7.88,
- "duration": 769159,
- "sum": 575.6
}
]
}
Статистика по ключевым фразам для Автоматических кампаний и Аукциона{{ /adv/v0/stats/keywords }}
Возвращает статистику по ключевым фразам за каждый день, когда кампания была активна.
Можно получить данные максимум за 7 дней в одном запросе.
Информация обновляется раз в час.
Authorizations:
query Parameters
advert_id required | integer Example: advert_id=123456789 ID кампании |
from required | string <date> Example: from=2024-08-10 Начало периода |
to required | string <date> Example: to=2024-08-12 Конец периода |
Responses
Response samples
- 200
- 400
- 401
- 429
{- "keywords": [
- {
- "date": "2024-08-12",
- "stats": [
- {
- "clicks": 68,
- "ctr": 3.73,
- "keyword": "светильники",
- "sum": 565.75,
- "views": 1825
}
]
}
]
}
Получение статистики карточек товаров за выбранный период по nmID/предметам/брендам/тегам{{ /api/v2/nm-report/detail }}
Возвращает статистику карточек товаров за выбранный период по nmID/предметам/брендам/тегам.
Поля brandNames
,objectIDs
, tagIDs
, nmIDs
могут быть пустыми, тогда в ответе возвращаются все карточки продавца.
При выборе нескольких полей в ответ приходят данные по карточкам, у которых есть все выбранные поля.
Можно получить отчёт максимум за последний год (365 дней).
В данных, где предоставляется информация о предыдущем периоде:
- В
previousPeriod
данные за такой же период, что и вselectedPeriod
. - Если дата начала
previousPeriod
раньше, чем год назад от текущей даты, она будет приведена к виду:previousPeriod.start = текущая дата - 365 дней.
Authorizations:
Request Body schema: application/jsonrequired
brandNames | Array of strings Название бренда |
objectIDs | Array of integers <int32> [ items <int32 > ] ID предмета |
tagIDs | Array of integers <int32> [ items <int32 > ] ID тега |
nmIDs | Array of integers <int32> [ items <int32 > ] Артикул WB |
timezone | string Временная зона. |
required | object Период |
object Параметры сортировки. Если не указано, то по умолчанию используется значение "openCard" и сортировка по убыванию.
| |
page required | integer <int32> Страница |
Responses
Request samples
- Payload
{- "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
- 200
- 400
- 401
- 403
- 429
{- "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"
}
]
}
Получение статистики карточек товаров за период с группировкой по предметам, брендам и тегам{{ /api/v2/nm-report/grouped }}
Возвращает статистику карточек товаров за период с группировкой по предметам, брендам и тегам.
Поля brandNames
, objectIDs
, tagIDs
могут быть пустыми, тогда группировка происходит по всем карточкам продавца.
Можно получить отчёт максимум за последний год (365 дней).
В данных, где предоставляется информация о предыдущем периоде:
- В
previousPeriod
данные за такой же период, что и вselectedPeriod
. - Если дата начала
previousPeriod
раньше, чем год назад от текущей даты, она будет приведена к виду:previousPeriod.start = текущая дата - 365 дней.
Authorizations:
Request Body schema: application/jsonrequired
objectIDs | Array of integers <int32> [ items <int32 > ] ID предмета |
brandNames | Array of strings Название бренда |
tagIDs | Array of integers <int32> [ items <int32 > ] ID тега |
timezone | string Временная зона. |
required | object Период |
object Параметры сортировки. Если не указано, то по умолчанию используется значение "openCard" и сортировка по убыванию.
| |
page required | integer <int32> Страница |
Responses
Request samples
- Payload
{- "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
- 200
- 400
- 401
- 403
- 429
{- "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{{ /api/v2/nm-report/detail/history }}
Возвращает статистику карточки товара по дням по выбранным nmID
.
Можно получить отчёт максимум за последнюю неделю.
Чтобы получать отчёты за период до года, подпишитесь на расширенную аналитику Джем
Authorizations:
Request Body schema: application/jsonrequired
nmIDs required | Array of integers <int32> [ items <int32 > ] Артикул WB (максимум 20) |
required | object Период |
timezone | string Временная зона. |
aggregationLevel | string Тип агрегации. Если не указано, то по умолчанию используется агрегация по дням. |
Responses
Request samples
- Payload
{- "nmIDs": [
- 1234567
], - "period": {
- "begin": "2023-06-20",
- "end": "2023-06-22"
}, - "timezone": "Europe/Moscow",
- "aggregationLevel": "day"
}
Response samples
- 200
- 400
- 401
- 403
- 429
{- "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"
}
]
}
Получение статистики карточки товара по дням за период с группировкой по предметам, брендам и тегам{{ /api/v2/nm-report/grouped/history }}
Возвращает статистику карточки товара по дням за период с группировкой по предметам, брендам и тегам.
Поля brandNames
, objectIDs
, tagIDs
могут быть пустыми, тогда группировка происходит по всем карточкам продавца.
Произведение количества предметов, брендов, тегов в запросе не должно быть больше 16.
Можно получить отчёт максимум за последнюю неделю.
Чтобы получать отчёты за период до года, подпишитесь на расширенную аналитику Джем
Authorizations:
Request Body schema: application/jsonrequired
objectIDs | Array of integers <int32> [ items <int32 > ] ID предмета |
brandNames | Array of strings Название бренда |
tagIDs | Array of integers <int32> [ items <int32 > ] ID тега |
required | object Период |
timezone | string Временная зона. |
aggregationLevel | string Тип агрегации. Если не указано, то по умолчанию используется агрегация по дням. |
Responses
Request samples
- Payload
{- "objectIDs": [
- 358
], - "brandNames": [
- "Some"
], - "tagIDs": [
- 123
], - "period": {
- "begin": "2023-06-21",
- "end": "2023-06-23"
}, - "timezone": "Europe/Moscow",
- "aggregationLevel": "day"
}
Response samples
- 200
- 400
- 401
- 403
- 429
{- "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
, сгенерируйте отчёт повторно - Получите отчёт.
Можно получить отчёт максимум за год.
Максимальное количество отчётов, генерируемых в сутки — 20
Создать отчёт{{ /api/v2/nm-report/downloads }}
Создает отчёт с расширенной аналитикой.
Вы можете создать отчёт с группировкой:
- по артикулам WB (
nmID
); - по категориям, брендам и тегам.
В каждом из этих отчётов можно сгруппировать данные по дням, неделям или месяцам
Authorizations:
Request Body schema: application/json
id required | string <uuid> ID отчёта в UUID-формате. Генерируется продавцом самостоятельно |
reportType required | string Тип отчёта — |
userReportName | string Название отчёта (если не указано, сформируется автоматически) |
object Параметры отчёта |
Responses
Request samples
- Payload
По артикулам WB (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
- 200
- 400
- 401
- 403
- 429
{- "data": "Началось формирование файла/отчета",
- "error": false,
- "errorText": "",
- "additionalErrors": null
}
Получить список отчётов{{ /api/v2/nm-report/downloads }}
Authorizations:
query Parameters
filter[downloadIds] | Array of strings <uuid> [ items <uuid > ] ID отчёта |
Responses
Response samples
- 200
- 400
- 401
- 403
- 429
{- "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
}
Сгенерировать отчёт повторно{{ /api/v2/nm-report/downloads/retry }}
Authorizations:
Request Body schema: application/jsonrequired
downloadId | string <uuid> ID отчёта |
Responses
Request samples
- Payload
{- "downloadId": "06eea887-9d9f-491f-b16a-bb1766fcb8d2"
}
Response samples
- 200
- 400
- 401
- 403
- 429
{- "data": "Началось переформирование файла/отчета",
- "error": false,
- "errorText": "",
- "additionalErrors": null
}
Получить отчёт{{ /api/v2/nm-report/downloads/file/{downloadId} }}
Получить отчёт с расширенной аналитикой.
Можно получить отчёт, который сгенерирован за последние 48 часов.
Отчет будет загружен внутри архива ZIP в формате CSV
Authorizations:
path Parameters
downloadId required | string <uuid> ID отчёта |
Responses
Response samples
- 200
- 400
- 401
- 403
- 429
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
Основная страница{{ /api/v2/search-report/report }}
Формирует набор данных для основной страницы отчёта с:
- общей информацией
- позициями товаров
- данными по видимости и переходам в карточку
- данными для таблицы по группам
Для получения дополнительных данных в таблице используйте отдельный запрос для:
- пагинации по группам
- получения по товарам в группе
Дополнительные параметры выбора списка товаров в таблице:
positionCluster
— средняя позиция в поиске
Authorizations:
Request Body schema: application/jsonrequired
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) Параметры сортировки |
limit required | integer <uint32> <= 1000 Количество запрашиваемых групп товаров |
offset required | integer <uint32> После какого элемента выдавать данные |
Responses
Request samples
- Payload
{- "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"
}, - "limit": 130,
- "offset": 50
}
Response samples
- 200
- 400
- 401
- 403
- 429
{- "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
}
}
]
}
]
}
}
Пагинация по группам{{ /api/v2/search-report/table/groups }}
Пагинация по группам в отчёте. Возможна только при наличии фильтра по бренду, предмету или тегу.
Дополнительные параметры выбора списка товаров в таблице:
positionCluster
— средняя позиция в поиске
Authorizations:
Request Body schema: application/jsonrequired
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> После какого элемента выдавать данные |
Responses
Request samples
- Payload
{- "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
- 200
- 400
- 401
- 403
- 429
{- "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
}
}
]
}
]
}
}
Пагинация по товарам в группе{{ /api/v2/search-report/table/details }}
Пагинация по товарам в группе. Возможна независимо от наличия фильтров.
Фильтры для пагинации по товарам в группе или без фильтров::
- кортеж
subjectId
,brandName
,tagId
— фильтр для группы nmIds
— фильтр по номенклатуре
Дополнительные параметры выбора списка товаров:
positionCluster
— средняя позиция в поиске
Authorizations:
Request Body schema: application/jsonrequired
required | object (Period) Текущий период |
object (pastPeriod) Прошлый период для сравнения. Количество дней - меньше или равно | |
subjectId | integer <int32> ID предмета |
brandName | string Название товара |
tagId | integer <int64> ID тега |
nmIds | Array of integers <uint64> <= 50 items [ items <uint64 > ] Список артикулов WB |
required | object (OrderBy) Параметры сортировки |
positionCluster required | string Enum: "all" "firstHundred" "secondHundred" "below" Кластер для позиционирования элементов в отчёте
|
limit required | integer <uint32> <= 1000 Количество запрашиваемых товаров |
offset required | integer <uint32> После какого элемента выдавать данные |
Responses
Request samples
- Payload
{- "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
- 200
- 400
- 401
- 403
- 429
{- "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
}
}
]
}
}
Поисковые запросы по товару{{ /api/v2/search-report/product/search-texts }}
Формирует топ поисковых запросов по товару.
Параметр выбора поисковых запросов:
limit
— количество запросов (максимум 30)topOrderBy
— способ выбора топа запросов
Authorizations:
Request Body schema: application/jsonrequired
required | object (Period) Текущий период |
object (pastPeriod) Прошлый период для сравнения. Количество дней - меньше или равно | |
nmIds required | Array of integers <uint64> <= 50 items [ items <uint64 > ] Список артикулов WB |
topOrderBy required | string Enum: "openCard" "addToCart" "openToCart" "orders" "cartToOrder" Сортировка по полю поискового запроса:
|
required | object (OrderBy) Параметры сортировки |
limit required | integer <uint64> (TextLimit) [ 1 .. 30 ] Количество поисковых запросов по товару |
Responses
Request samples
- Payload
{- "currentPeriod": {
- "start": "2024-02-10",
- "end": "2024-02-10"
}, - "pastPeriod": {
- "start": "2024-02-08",
- "end": "2024-02-08"
}, - "nmIds": [
- 162579635,
- 166699779
], - "topOrderBy": "openToCart",
- "orderBy": {
- "field": "avgPosition",
- "mode": "asc"
}, - "limit": 20
}
Response samples
- 200
- 400
- 401
- 403
- 429
{- "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
}
}
]
}
}
Заказы и позиции по поисковым запросам товара{{ /api/v2/search-report/product/orders }}
Формирует данные для таблицы по количеству заказов и позиций по запросам. Данные указываются в рамках периода для определённого товара
Authorizations:
Request Body schema: application/jsonrequired
required | object (PeriodOrdersRequest) Текущий период. Не более 7 суток |
nmId required | integer <uint64> Артикул WB |
searchTexts required | Array of strings [ 1 .. 30 ] items Поисковые запросы |
Responses
Request samples
- Payload
{- "period": {
- "start": "2024-02-10",
- "end": "2024-02-10"
}, - "nmId": 211131895,
- "searchTexts": "костюм"
}
Response samples
- 200
- 400
- 401
- 403
- 429
{- "data": {
- "total": [
- {
- "dt": "2024-02-10",
- "avgPosition": 10,
- "orders": 20
}
], - "items": [
- {
- "text": "string",
- "frequency": 0,
- "dateItems": [
- {
- "dt": "2024-02-10",
- "avgPosition": 10,
- "orders": 20
}
]
}
]
}
}