Рубрикатор
Получение текущего рубрикатора
GET wb/get/categories
Пример запроса:
curl --location --request GET 'http://mpstats.io/api/wb/get/categories' \
--header 'X-Mpstats-TOKEN: 5edfe8277ff2a5.941835169784f269a9244f13350db36eedb814d1' \
--header 'Content-Type: application/json'
Пример ответа:
[
{
"url": "/catalog/premium-odezhda",
"name": "Premium",
"path": "Premium"
},
{
"url": "/catalog/zhenshchinam/odezhda/svitshoty",
"name": "Свитшоты",
"path": "Женщинам/Одежда/Свитшоты"
},
{
"url": "/catalog/elektronika/planshety",
"name": "Планшеты",
"path": "Электроника/Смартфоны и телефоны/Планшеты"
}
]
Описание полей:
Имя поля | Тип | Описание |
---|---|---|
url | text | Url на Wildberries |
name | text | Название категории |
path | text | Путь по категориям каталога Wildberries |
По категориям
Получение данных по товарным категориям
Товары
POST wb/get/category
Параметры запроса:
Параметр | Тип | Обязательный | Описание | Значение по умолчанию |
---|---|---|---|---|
path | Строка | Да | Категория, например Женщинам/Одежда | Нет |
d1 | Дата в формате YYYY-MM-DD | Нет | Дата начала периода | Для тарифных планов "Базовый", "Расширенный" равна дате начала периода согласно условиям тарифа без возможности изменения. |
d2 | Дата в формате YYYY-MM-DD | Нет | Дата окончания периода | Для тарифных планов "Базовый", "Расширенный" равна дате окончания периода согласно условиям тарифа без возможности изменения. |
Тело запроса:
{
// Номер строки начала получения данных
startRow: 1;
// Номер строки конца получения данных
endRow: 100;
// Не более 5000 записей на один вызов запроса
// Фильтры
filterModel: {};
// Сортировка
sortModel: [];
}
Тело ответа:
{
// Номер строки начала получения данных
startRow: 0;
// Номер строки конца получения данных
endRow: 100;
// Фильтры, которые были установлены при запросе
filterModel: {};
// Сортировка, которая была установлена при запросе
sortModel: [];
// Кол-во строк в результирующем запросе без учета пагинации
total: 42,
// Массив данных
data: [...{...}]
}
Пример запроса:
curl --location --request POST 'http://mpstats.io/api/wb/get/category?d1=2020-07-13&d2=2020-08-11&path=%D0%96%D0%B5%D0%BD%D1%89%D0%B8%D0%BD%D0%B0%D0%BC/%D0%9E%D0%B4%D0%B5%D0%B6%D0%B4%D0%B0' \
--header 'X-Mpstats-TOKEN: 5edfe8277ff2a5.941835169784f269a9244f13350db36eedb814d1' \
--header 'Content-Type: application/json' \
--data-raw '{"startRow":0,"endRow":100,"filterModel":{"id":{"filterType":"number","type":"equals","filter":13495594,"filterTo":null}},"sortModel":[{"colId":"revenue","sort":"desc"}]}'
Пример ответа:
{
"data": [
{
"id": 13495594,
"name": "Велосипедки",
"brand": "Classic Promo",
"seller": "Канкулова Саида Амдуловна ИП",
"category": "Женщинам/Одежда/Брюки и шорты/Велосипедки",
"color": "",
"balance": 763,
"comments": 503,
"rating": 4,
"final_price": 480,
"final_price_max": 592,
"final_price_min": 480,
"final_price_average": 510.31767337807605,
"basic_sale": 70,
"basic_price": 600,
"promo_sale": 20,
"client_sale": 0,
"client_price": 480,
"start_price": 2000,
"sales": 894,
"revenue": 456224,
"revenue_potential": 456224,
"lost_profit": 0,
"days_in_stock": 30,
"days_with_sales": 30,
"average_if_in_stock": 29.8,
"thumb": "https://img1.wbstatic.net/tm/new/13490000/13495594-1.jpg",
"graph": [
...,
123,
230,
224
]
}
],
"total": 1,
"startRow": 0,
"endRow": 100,
"filterModel": {
"id": {
"filterType": "number",
"type": "equals",
"filter": 13495594,
"filterTo": null
}
},
"sortModel": [
{
"colId": "revenue",
"sort": "desc"
}
]
}
Описание полей:
Имя поля | Тип | Описание |
---|---|---|
thumb | text | Изображение товара |
thumb_middle | text | Изображение товара (среднее) |
id | number | Идентификатор товарной позиции |
name | text | Название товара |
color | text | Цвет товара |
category | text | Категория товара |
brand | text | Название бренда |
seller | text | Название продавца |
balance | number | Последний зафиксированный остаток на складе |
comments | number | Количество комментариев |
rating | number | Рейтинг товара |
final_price | number | Последняя зафиксированная цена |
final_price_min | number | Минимальная цена за период |
final_price_max | number | Максимальная цена за период |
final_price_average | number | Средняя цена за период (выручка / число продаж) |
start_price | number | Базовая цена товара |
basic_sale | number | Размер скидки |
basic_price | number | Цена после применения скидки |
promo_sale | number | Размер скидки по промокоду |
client_sale | number | Размер Скидки Постоянного Покупателя |
client_price | number | Итоговая цена для посетителя, с учетом СПП |
revenue_potential | number | Потенциал выручки (выручка / число дней в наличии) * дней в отчете |
lost_profit | number | Упущенная выручка (Потенциал - Выручка) |
days_in_stock | number | Количество дней, когда товар был в наличии на конец дня |
days_with_sales | number | Количество дней, когда были продажи |
average_if_in_stock | number | Среднее число продаж, при наличии товара на конец дня |
sales | number | Количество проданных единиц товара за период |
revenue | number | Выручка за период |
graph | array<number> | График продаж |
Подкатегории
GET wb/get/category/subcategories
Параметры запроса:
Параметр | Тип | Обязательный | Описание | Значение по умолчанию |
---|---|---|---|---|
path | Строка | Да | Категория, например Женщинам/Одежда | Нет |
d1 | Дата в формате YYYY-MM-DD | Нет | Дата начала периода | Для тарифных планов "Базовый", "Расширенный" равна дате начала периода согласно условиям тарифа без возможности изменения. |
d2 | Дата в формате YYYY-MM-DD | Нет | Дата окончания периода | Для тарифных планов "Базовый", "Расширенный" равна дате окончания периода согласно условиям тарифа без возможности изменения. |
Пример запроса:
curl --location --request GET 'https://mpstats.io/api/wb/get/category/subcategories?d1=2020-07-13&d2=2020-08-11&path=%D0%96%D0%B5%D0%BD%D1%89%D0%B8%D0%BD%D0%B0%D0%BC/%D0%9E%D0%B4%D0%B5%D0%B6%D0%B4%D0%B0' \
--header 'X-Mpstats-TOKEN: 5edfe8277ff2a5.941835169784f269a9244f13350db36eedb814d1' \
--header 'Content-Type: application/json'
Пример ответа:
[
{
"name": "Текущая категория",
"items": 457729,
"sales": 5539502,
"revenue": 2147483647,
"comments": 19.3,
"rating": 4.4
},
{
"name": "Платья",
"items": 264799,
"sales": 1088663,
"revenue": 2111870363,
"comments": 14.2,
"rating": 4.3
},
...,
]
Описание полей:
Имя поля | Тип | Описание |
---|---|---|
name | text | Вложенная рубрика |
rating | number | Средний рейтинг |
comments | number | Среднее число комментариев |
items | number | Число товаров |
sales | number | Число зафиксированных продаж (единицы) |
revenue | number | Сумма произведений числа проданных товаров на их стоимость |
Бренды
GET wb/get/category/brands
Параметры запроса:
Параметр | Тип | Обязательный | Описание | Значение по умолчанию |
---|---|---|---|---|
path | Строка | Да | Категория, например Женщинам/Одежда | Нет |
d1 | Дата в формате YYYY-MM-DD | Нет | Дата начала периода | Для тарифных планов "Базовый", "Расширенный" равна дате начала периода согласно условиям тарифа без возможности изменения. |
d2 | Дата в формате YYYY-MM-DD | Нет | Дата окончания периода | Для тарифных планов "Базовый", "Расширенный" равна дате окончания периода согласно условиям тарифа без возможности изменения. |
Пример запроса:
curl --location --request GET 'https://mpstats.io/api/wb/get/category/brands?d1=2020-07-13&d2=2020-08-11&path=%D0%96%D0%B5%D0%BD%D1%89%D0%B8%D0%BD%D0%B0%D0%BC/%D0%9E%D0%B4%D0%B5%D0%B6%D0%B4%D0%B0' \
--header 'X-Mpstats-TOKEN: 5edfe8277ff2a5.941835169784f269a9244f13350db36eedb814d1' \
--header 'Content-Type: application/json'
Пример ответа:
[
{
"name": "Mango",
"position": 1,
"items": 3716,
"sales": 220084,
"revenue": 383685869,
"comments": 28.9,
"rating": 3.8
},
{
"name": "ТВОЕ",
"position": 2,
"items": 6229,
"sales": 583701,
"revenue": 262756296,
"comments": 53.1,
"rating": 4.2
},
...,
]
Описание полей:
Имя поля | Тип | Описание |
---|---|---|
position | number | Позиция в рейтинге |
name | text | Название бренда |
rating | number | Средний рейтинг |
comments | number | Среднее число комментариев |
items | number | Число товаров |
sales | number | Число зафиксированных продаж (единицы) |
revenue | number | Сумма произведений числа проданных товаров на их стоимость |
Продавцы
GET wb/get/category/sellers
Параметры запроса:
Параметр | Тип | Обязательный | Описание | Значение по умолчанию |
---|---|---|---|---|
path | Строка | Да | Категория, например Женщинам/Одежда | Нет |
d1 | Дата в формате YYYY-MM-DD | Нет | Дата начала периода | Для тарифных планов "Базовый", "Расширенный" равна дате начала периода согласно условиям тарифа без возможности изменения. |
d2 | Дата в формате YYYY-MM-DD | Нет | Дата окончания периода | Для тарифных планов "Базовый", "Расширенный" равна дате окончания периода согласно условиям тарифа без возможности изменения. |
Пример запроса:
curl --location --request GET 'https://mpstats.io/api/wb/get/category/sellers?d1=2020-07-13&d2=2020-08-11&path=%D0%96%D0%B5%D0%BD%D1%89%D0%B8%D0%BD%D0%B0%D0%BC/%D0%9E%D0%B4%D0%B5%D0%B6%D0%B4%D0%B0' \
--header 'X-Mpstats-TOKEN: 5edfe8277ff2a5.941835169784f269a9244f13350db36eedb814d1' \
--header 'Content-Type: application/json'
Пример ответа:
[
{
"name": "ВАЙЛДБЕРРИЗ ООО",
"position": 1,
"items": 256904,
"sales": 790815,
"revenue": 1855897134,
"comments": 16.2,
"rating": 4.2
},
{
"name": "Мэлон Фэшн Груп АО",
"position": 2,
"items": 13360,
"sales": 402517,
"revenue": 446899706,
"comments": 68.5,
"rating": 4.4
},
...,
]
Описание полей:
Имя поля | Тип | Описание |
---|---|---|
name | text | Название продавца |
rating | number | Средний рейтинг |
comments | number | Среднее число комментариев |
items | number | Число товаров |
sales | number | Число зафиксированных продаж (единицы) |
revenue | number | Сумма произведений числа проданных товаров на их стоимость |
Тренд
GET wb/get/category/trends
Параметры запроса:
Параметр | Тип | Обязательный | Описание | Значение по умолчанию |
---|---|---|---|---|
path | Строка | Да | Категория, например Женщинам/Одежда | Нет |
d1 | Дата в формате YYYY-MM-DD | Нет | Дата начала периода | Для тарифных планов "Базовый", "Расширенный" равна дате начала периода согласно условиям тарифа без возможности изменения. |
d2 | Дата в формате YYYY-MM-DD | Нет | Дата окончания периода | Для тарифных планов "Базовый", "Расширенный" равна дате окончания периода согласно условиям тарифа без возможности изменения. |
Пример запроса:
curl --location --request GET 'https://mpstats.io/api/wb/get/category/trends?d1=2020-07-13&d2=2020-08-11&path=%D0%96%D0%B5%D0%BD%D1%89%D0%B8%D0%BD%D0%B0%D0%BC/%D0%9E%D0%B4%D0%B5%D0%B6%D0%B4%D0%B0' \
--header 'X-Mpstats-TOKEN: 5edfe8277ff2a5.941835169784f269a9244f13350db36eedb814d1' \
--header 'Content-Type: application/json'
Пример ответа:
[
{
"week": "2020-01-27",
"sales": 1075711,
"revenue": 2147483647,
"product_revenue": 4347,
"items": 495488,
"brands": 7157,
"sellers": 4157
},
{
"week": "2020-02-03",
"sales": 1116105,
"revenue": 2147483647,
"product_revenue": 4648,
"items": 502820,
"brands": 7226,
"sellers": 4057
},
...,
]
Описание полей:
Имя поля | Тип | Описание |
---|---|---|
week | date | Дата начала недели |
sales | number | Число продаж |
revenue | number | Суммарная выручка в рубрике |
items | number | Число товаров в рубрике на указанной неделе |
brands | number | Число брендов в рубрике на указанной неделе |
sellers | number | Число продавцов в рубрике на указанной неделе |
product_revenue | number | Сумма выручки категории, разделенная на число товаров |
По дням
GET wb/get/category/by_date
Параметры запроса:
Параметр | Тип | Обязательный | Описание | Значение по умолчанию |
---|---|---|---|---|
path | Строка | Да | Категория, например Женщинам/Одежда | Нет |
d1 | Дата в формате YYYY-MM-DD | Нет | Дата начала периода | Для тарифных планов "Базовый", "Расширенный" равна дате начала периода согласно условиям тарифа без возможности изменения. |
d2 | Дата в формате YYYY-MM-DD | Нет | Дата окончания периода | Для тарифных планов "Базовый", "Расширенный" равна дате окончания периода согласно условиям тарифа без возможности изменения. |
Пример запроса:
curl --location --request GET 'https://mpstats.io/api/wb/get/category/by_date?d1=2020-07-13&d2=2020-08-11&path=%D0%96%D0%B5%D0%BD%D1%89%D0%B8%D0%BD%D0%B0%D0%BC/%D0%9E%D0%B4%D0%B5%D0%B6%D0%B4%D0%B0' \
--header 'X-Mpstats-TOKEN: 5edfe8277ff2a5.941835169784f269a9244f13350db36eedb814d1' \
--header 'Content-Type: application/json'
Пример ответа:
[
{
"data": "2020-08-11",
"items": 946273,
"brands": 218481,
"sellers": 218481,
"sales": 218481,
"revenue": 342156208,
"avg_price": 2724.6350735993,
"comments": 23.532922317344,
"rating": 2.8010087997861,
"avg_sale_price": 1566.0684819275
},
{
"data": "2020-08-10",
"items": 944058,
"brands": 218481,
"sellers": 218481,
"sales": 204686,
"revenue": 316253781,
"avg_price": 2732.3870005868,
"comments": 23.437757002218,
"rating": 2.7848945721555,
"avg_sale_price": 1545.0679626355
},
...,
]
Описание полей:
Имя поля | Тип | Описание |
---|---|---|
period | date | Дата |
items | number | Число товаров в рейтинге |
brands | number | Кол-во брендов |
sellers | number | Кол-во продавцов |
sales | number | Продано единиц товаров |
revenue | number | Выручка |
avg_price | number | Средняя цена товара в категории (все товары, среднее арифметическое) |
avg_sale_price | number | Средняя цена состоявшейся продажи (деление выручки на число продаж) |
comments | number | Среднее число комментариев на товар |
rating | number | Средний рейтинг |
Ценовая сегментация
GET wb/get/category/price_segmentation
Параметры запроса:
Параметр | Тип | Обязательный | Описание | Значение по умолчанию |
---|---|---|---|---|
path | Строка | Да | Категория, например Женщинам/Одежда | Нет |
d1 | Дата в формате YYYY-MM-DD | Нет | Дата начала периода | Для тарифных планов "Базовый", "Расширенный" равна дате начала периода согласно условиям тарифа без возможности изменения. |
d2 | Дата в формате YYYY-MM-DD | Нет | Дата окончания периода | Для тарифных планов "Базовый", "Расширенный" равна дате окончания периода согласно условиям тарифа без возможности изменения. |
Пример запроса:
curl --location --request GET 'https://mpstats.io/api/wb/get/category/price_segmentation?d1=2020-07-13&d2=2020-08-11&path=%D0%96%D0%B5%D0%BD%D1%89%D0%B8%D0%BD%D0%B0%D0%BC/%D0%9E%D0%B4%D0%B5%D0%B6%D0%B4%D0%B0' \
--header 'X-Mpstats-TOKEN: 5edfe8277ff2a5.941835169784f269a9244f13350db36eedb814d1' \
--header 'Content-Type: application/json'
Пример ответа:
[
{
"range": "5-463",
"items": 37945,
"brands": 1928,
"brands_with_sells": 1788,
"sellers": 1224,
"sellers_with_sells": 1168,
"revenue": 317864027,
"sales": 915522,
"product_revenue": 8376,
"min_range_price": 5,
"max_range_price": 463
},
{
"range": "463-595",
"items": 38053,
"brands": 2304,
"brands_with_sells": 2042,
"sellers": 1431,
"sellers_with_sells": 1329,
"revenue": 273844531,
"sales": 531891,
"product_revenue": 7196,
"min_range_price": 464,
"max_range_price": 595
},
...,
]
Описание полей:
Имя поля | Тип | Описание |
---|---|---|
range | text | Диапазон цен |
min_range_price | number | Цена в диапазоне от |
max_range_price | number | Цена в диапазоне до |
sales | number | Число продаж |
revenue | number | Суммарная выручка в диапазоне |
items | number | Число товаров в диапазоне |
brands | number | Число брендов в диапазоне |
sellers | number | Число продавцов в диапазоне |
brands_with_sells | number | Число брендов в диапазоне с продажами больше 0 |
sellers_with_sells | number | Число продавцов в диапазоне с продажами больше 0 |
product_revenue | number | Сумма выручки диапазона, разделенная на число товаров в нем |
По брендам
Получение данных по брендам
Товары
POST wb/get/brand
Параметры запроса:
Параметр | Тип | Обязательный | Описание | Значение по умолчанию |
---|---|---|---|---|
path | Строка | Да | Название бренда, например Mango | Нет |
d1 | Дата в формате YYYY-MM-DD | Нет | Дата начала периода | Для тарифных планов "Базовый", "Расширенный" равна дате начала периода согласно условиям тарифа без возможности изменения. |
d2 | Дата в формате YYYY-MM-DD | Нет | Дата окончания периода | Для тарифных планов "Базовый", "Расширенный" равна дате окончания периода согласно условиям тарифа без возможности изменения. |
Тело запроса:
{
// Номер строки начала получения данных
startRow: 1;
// Номер строки конца получения данных
endRow: 100;
// Не более 5000 записей на один вызов запроса
// Фильтры
filterModel: {};
// Сортировка
sortModel: [];
}
Тело ответа:
{
// Номер строки начала получения данных
startRow: 0;
// Номер строки конца получения данных
endRow: 100;
// Фильтры, которые были установлены при запросе
filterModel: {};
// Сортировка, которая была установлена при запросе
sortModel: [];
// Кол-во строк в результирующем запросе без учета пагинации
total: 42,
// Массив данных
data: [...{...}]
}
Пример запроса:
curl --location --request POST 'https://mpstats.io/api/wb/get/brand?d1=2020-07-13&d2=2020-08-11&path=Mango' \
--header 'X-Mpstats-TOKEN: 5edfe8277ff2a5.941835169784f269a9244f13350db36eedb814d1' \
--header 'Content-Type: application/json' \
--data-raw '{"startRow":0,"endRow":100,"filterModel":{"id":{"filterType":"number","type":"equals","filter":11299559,"filterTo":null}},"sortModel":[{"colId":"revenue","sort":"desc"}]}'
Пример ответа:
{"data":[{"id":11299559,"name":"Джинсы - REGINA","brand":"Mango","seller":"ВАЙЛДБЕРРИЗ ООО","category":"Женщинам\/Одежда\/Джинсы\/Джинсы","color":"","balance":2376,"comments":819,"rating":5,"final_price":1999,"sales":2605,"revenue":5579395,"days_in_stock":25,"thumb":"https:\/\/img1.wbstatic.net\/tm\/new\/11290000\/11299559-1.jpg","graph":[0,25,69,36,31,29,80,73,42,44,27,226,292,169,169,157,187,162,277,83,18,24,44,20,20,18,23,22,18,83,137]}],"total":1,"startRow":0,"endRow":100,"filterModel":{"id":{"filterType":"number","type":"equals","filter":11299559,"filterTo":null}},"sortModel":[{"colId":"revenue","sort":"desc"}]}
Описание полей:
Имя поля | Тип | Описание |
---|---|---|
thumb | text | Изображение товара |
thumb_middle | text | Изображение товара (среднее) |
id | number | Идентификатор товарной позиции |
name | text | Название товара |
color | text | Цвет товара |
category | text | Категория товара |
brand | text | Название бренда |
seller | text | Название продавца |
balance | number | Последний зафиксированный остаток на складе |
comments | number | Количество комментариев |
rating | number | Рейтинг товара |
final_price | number | Последняя зафиксированная цена |
final_price_min | number | Минимальная цена за период |
final_price_max | number | Максимальная цена за период |
final_price_average | number | Средняя цена за период (выручка / число продаж) |
start_price | number | Базовая цена товара |
basic_sale | number | Размер скидки |
basic_price | number | Цена после применения скидки |
promo_sale | number | Размер скидки по промокоду |
client_sale | number | Размер Скидки Постоянного Покупателя |
client_price | number | Итоговая цена для посетителя, с учетом СПП |
revenue_potential | number | Потенциал выручки (выручка / число дней в наличии) * дней в отчете |
lost_profit | number | Упущенная выручка (Потенциал - Выручка) |
days_in_stock | number | Количество дней, когда товар был в наличии на конец дня |
days_with_sales | number | Количество дней, когда были продажи |
average_if_in_stock | number | Среднее число продаж, при наличии товара на конец дня |
sales | number | Количество проданных единиц товара за период |
revenue | number | Выручка за период |
graph | array<number> | График продаж |
Категории
GET wb/get/brand/categories
Параметры запроса:
Параметр | Тип | Обязательный | Описание | Значение по умолчанию |
---|---|---|---|---|
path | Строка | Да | Название бренда, например Mango | Нет |
d1 | Дата в формате YYYY-MM-DD | Нет | Дата начала периода | Для тарифных планов "Базовый", "Расширенный" равна дате начала периода согласно условиям тарифа без возможности изменения. |
d2 | Дата в формате YYYY-MM-DD | Нет | Дата окончания периода | Для тарифных планов "Базовый", "Расширенный" равна дате окончания периода согласно условиям тарифа без возможности изменения. |
Пример запроса:
curl --location --request GET 'https://mpstats.io/api/wb/get/brand/categories?d1=2020-07-13&d2=2020-08-11&path=Mango' \
--header 'X-Mpstats-TOKEN: 5edfe8277ff2a5.941835169784f269a9244f13350db36eedb814d1' \
--header 'Content-Type: application/json'
Пример ответа:
[
{
"name": "Женщинам/Одежда/Джинсы/Джинсы",
"items": 203,
"sales": 45773,
"revenue": 84030901,
"comments": 109.6,
"rating": 4.1
},
{
"name": "Женщинам/Одежда/Платья/Платья-миди",
"items": 502,
"sales": 17291,
"revenue": 43536241,
"comments": 18.9,
"rating": 3.9
},
...,
]
Описание полей:
Имя поля | Тип | Описание |
---|---|---|
name | text | Вложенная рубрика |
rating | number | Средний рейтинг |
comments | number | Среднее число комментариев |
items | number | Число товаров |
sales | number | Число зафиксированных продаж (единицы) |
revenue | number | Сумма произведений числа проданных товаров на их стоимость |
Продавцы
GET wb/get/brand/sellers
Параметры запроса:
Параметр | Тип | Обязательный | Описание | Значение по умолчанию |
---|---|---|---|---|
path | Строка | Да | Название бренда, например Mango | Нет |
d1 | Дата в формате YYYY-MM-DD | Нет | Дата начала периода | Для тарифных планов "Базовый", "Расширенный" равна дате начала периода согласно условиям тарифа без возможности изменения. |
d2 | Дата в формате YYYY-MM-DD | Нет | Дата окончания периода | Для тарифных планов "Базовый", "Расширенный" равна дате окончания периода согласно условиям тарифа без возможности изменения. |
Пример запроса:
curl --location --request GET 'https://mpstats.io/api/wb/get/brand/sellers?d1=2020-07-13&d2=2020-08-11&path=Mango' \
--header 'X-Mpstats-TOKEN: 5edfe8277ff2a5.941835169784f269a9244f13350db36eedb814d1' \
--header 'Content-Type: application/json'
Пример ответа:
[
{
"name": "Продавец не указан",
"items": 3,
"sales": 3,
"revenue": 3077,
"comments": 23,
"rating": 4
},
{
"name": "ВАЙЛДБЕРРИЗ ООО",
"items": 7970,
"sales": 237007,
"revenue": 408498380,
"comments": 41.5,
"rating": 4.3
}
...,
]
Описание полей:
Имя поля | Тип | Описание |
---|---|---|
name | text | Название продавца |
rating | number | Средний рейтинг |
comments | number | Среднее число комментариев |
items | number | Число товаров |
sales | number | Число зафиксированных продаж (единицы) |
revenue | number | Сумма произведений числа проданных товаров на их стоимость |
По дням
GET wb/get/brand/by_date
Параметры запроса:
Параметр | Тип | Обязательный | Описание | Значение по умолчанию |
---|---|---|---|---|
path | Строка | Да | Название бренда, например Mango | Нет |
d1 | Дата в формате YYYY-MM-DD | Нет | Дата начала периода | Для тарифных планов "Базовый", "Расширенный" равна дате начала периода согласно условиям тарифа без возможности изменения. |
d2 | Дата в формате YYYY-MM-DD | Нет | Дата окончания периода | Для тарифных планов "Базовый", "Расширенный" равна дате окончания периода согласно условиям тарифа без возможности изменения. |
Пример запроса:
curl --location --request GET 'https://mpstats.io/api/wb/get/brand/by_date?d1=2020-07-13&d2=2020-08-11&path=Mango' \
--header 'X-Mpstats-TOKEN: 5edfe8277ff2a5.941835169784f269a9244f13350db36eedb814d1' \
--header 'Content-Type: application/json'
Пример ответа:
[
{
"data": "2020-08-11",
"items": 7974,
"comments": 38.1,
"rating": 3.9,
"balance": 324768,
"balance_price": 651436220,
"avg_price": 1877,
"avg_sale_price": 1707,
"sales": 7362,
"revenue": 12569639
},
{
"data": "2020-08-10",
"items": 7947,
"comments": 37.9,
"rating": 3.9,
"balance": 324222,
"balance_price": 644563216,
"avg_price": 1874,
"avg_sale_price": 1727,
"sales": 7587,
"revenue": 13110040
},
...,
]
Описание полей:
Имя поля | Тип | Описание |
---|---|---|
period | date | Дата |
comments | number | Среднее число комментариев на товар |
rating | number | Средний рейтинг |
items | number | Число позиций |
balance | number | Число товаров, числящихся в наличии |
balance_price | number | Произведение остатка на цену продажи |
avg_price | number | Средняя цена товара у бренда (все товары, среднее арифметическое) |
avg_sale_price | number | Средняя цена состоявшейся продажи (деление выручки на число продаж) |
sales | number | Число продаж единиц товара |
revenue | number | Выручка за сутки |
Ценовая сегментация
GET wb/get/brand/price_segmentation
Параметры запроса:
Параметр | Тип | Обязательный | Описание | Значение по умолчанию |
---|---|---|---|---|
path | Строка | Да | Название бренда, например Mango | Нет |
d1 | Дата в формате YYYY-MM-DD | Нет | Дата начала периода | Для тарифных планов "Базовый", "Расширенный" равна дате начала периода согласно условиям тарифа без возможности изменения. |
d2 | Дата в формате YYYY-MM-DD | Нет | Дата окончания периода | Для тарифных планов "Базовый", "Расширенный" равна дате окончания периода согласно условиям тарифа без возможности изменения. |
Пример запроса:
curl --location --request GET 'https://mpstats.io/api/wb/get/brand/price_segmentation?d1=2020-07-13&d2=2020-08-11&path=Mango' \
--header 'X-Mpstats-TOKEN: 5edfe8277ff2a5.941835169784f269a9244f13350db36eedb814d1' \
--header 'Content-Type: application/json'
Пример ответа:
[
{
"range": "5-463",
"items": 37945,
"brands": 1928,
"brands_with_sells": 1788,
"sellers": 1224,
"sellers_with_sells": 1168,
"revenue": 317864027,
"sales": 915522,
"product_revenue": 8376,
"min_range_price": 5,
"max_range_price": 463
},
{
"range": "463-595",
"items": 38053,
"brands": 2304,
"brands_with_sells": 2042,
"sellers": 1431,
"sellers_with_sells": 1329,
"revenue": 273844531,
"sales": 531891,
"product_revenue": 7196,
"min_range_price": 464,
"max_range_price": 595
},
...,
]
Описание полей:
Имя поля | Тип | Описание |
---|---|---|
range | text | Диапазон цен |
min_range_price | number | Цена в диапазоне от |
max_range_price | number | Цена в диапазоне до |
sales | number | Число продаж |
revenue | number | Суммарная выручка в диапазоне |
items | number | Число товаров в диапазоне |
brands | number | Число брендов в диапазоне |
sellers | number | Число продавцов в диапазоне |
brands_with_sells | number | Число брендов в диапазоне с продажами больше 0 |
sellers_with_sells | number | Число продавцов в диапазоне с продажами больше 0 |
product_revenue | number | Сумма выручки диапазона, разделенная на число товаров в нем |
По продавцам
Получение данных по продавцам
Товары
POST wb/get/seller
Параметры запроса:
Параметр | Тип | Обязательный | Описание | Значение по умолчанию |
---|---|---|---|---|
path | Строка | Да | Название бренда, например ВАЙЛДБЕРРИЗ ООО | Нет |
d1 | Дата в формате YYYY-MM-DD | Нет | Дата начала периода | Для тарифных планов "Базовый", "Расширенный" равна дате начала периода согласно условиям тарифа без возможности изменения. |
d2 | Дата в формате YYYY-MM-DD | Нет | Дата окончания периода | Для тарифных планов "Базовый", "Расширенный" равна дате окончания периода согласно условиям тарифа без возможности изменения. |
Тело запроса:
{
// Номер строки начала получения данных
startRow: 1;
// Номер строки конца получения данных
endRow: 100;
// Не более 5000 записей на один вызов запроса
// Фильтры
filterModel: {};
// Сортировка
sortModel: [];
}
Тело ответа:
{
// Номер строки начала получения данных
startRow: 0;
// Номер строки конца получения данных
endRow: 100;
// Фильтры, которые были установлены при запросе
filterModel: {};
// Сортировка, которая была установлена при запросе
sortModel: [];
// Кол-во строк в результирующем запросе без учета пагинации
total: 42,
// Массив данных
data: [...{...}]
}
Пример запроса:
curl --location --request POST 'https://mpstats.io/api/wb/get/seller?d1=2020-07-13&d2=2020-08-11&path=ВАЙЛДБЕРРИЗ ООО' \
--header 'X-Mpstats-TOKEN: 5edfe8277ff2a5.941835169784f269a9244f13350db36eedb814d1' \
--header 'Content-Type: application/json' \
--data-raw '{"startRow":0,"endRow":100,"filterModel":{"id":{"filterType":"number","type":"equals","filter":11299559,"filterTo":null}},"sortModel":[{"colId":"revenue","sort":"desc"}]}'
Пример ответа:
{"data":[{"id":11299559,"name":"Джинсы - REGINA","brand":"Mango","seller":"ВАЙЛДБЕРРИЗ ООО","category":"Женщинам\/Одежда\/Джинсы\/Джинсы","color":"","balance":2376,"comments":819,"rating":5,"final_price":1999,"sales":2605,"revenue":5579395,"days_in_stock":25,"thumb":"https:\/\/img1.wbstatic.net\/tm\/new\/11290000\/11299559-1.jpg","graph":[0,25,69,36,31,29,80,73,42,44,27,226,292,169,169,157,187,162,277,83,18,24,44,20,20,18,23,22,18,83,137]}],"total":1,"startRow":0,"endRow":100,"filterModel":{"id":{"filterType":"number","type":"equals","filter":11299559,"filterTo":null}},"sortModel":[{"colId":"revenue","sort":"desc"}]}
Описание полей:
Имя поля | Тип | Описание |
---|---|---|
thumb | text | Изображение товара |
thumb_middle | text | Изображение товара (среднее) |
id | number | Идентификатор товарной позиции |
name | text | Название товара |
color | text | Цвет товара |
category | text | Категория товара |
brand | text | Название бренда |
seller | text | Название продавца |
balance | number | Последний зафиксированный остаток на складе |
comments | number | Количество комментариев |
rating | number | Рейтинг товара |
final_price | number | Последняя зафиксированная цена |
final_price_min | number | Минимальная цена за период |
final_price_max | number | Максимальная цена за период |
final_price_average | number | Средняя цена за период (выручка / число продаж) |
start_price | number | Базовая цена товара |
basic_sale | number | Размер скидки |
basic_price | number | Цена после применения скидки |
promo_sale | number | Размер скидки по промокоду |
client_sale | number | Размер Скидки Постоянного Покупателя |
client_price | number | Итоговая цена для посетителя, с учетом СПП |
revenue_potential | number | Потенциал выручки (выручка / число дней в наличии) * дней в отчете |
lost_profit | number | Упущенная выручка (Потенциал - Выручка) |
days_in_stock | number | Количество дней, когда товар был в наличии на конец дня |
days_with_sales | number | Количество дней, когда были продажи |
average_if_in_stock | number | Среднее число продаж, при наличии товара на конец дня |
sales | number | Количество проданных единиц товара за период |
revenue | number | Выручка за период |
graph | array<number> | График продаж |
Категории
GET wb/get/seller/categories
Параметры запроса:
Параметр | Тип | Обязательный | Описание | Значение по умолчанию |
---|---|---|---|---|
path | Строка | Да | Название бренда, например ВАЙЛДБЕРРИЗ ООО | Нет |
d1 | Дата в формате YYYY-MM-DD | Нет | Дата начала периода | Для тарифных планов "Базовый", "Расширенный" равна дате начала периода согласно условиям тарифа без возможности изменения. |
d2 | Дата в формате YYYY-MM-DD | Нет | Дата окончания периода | Для тарифных планов "Базовый", "Расширенный" равна дате окончания периода согласно условиям тарифа без возможности изменения. |
Пример запроса:
curl --location --request GET 'https://mpstats.io/api/wb/get/seller/categories?d1=2020-07-13&d2=2020-08-11&path=ВАЙЛДБЕРРИЗ ООО' \
--header 'X-Mpstats-TOKEN: 5edfe8277ff2a5.941835169784f269a9244f13350db36eedb814d1' \
--header 'Content-Type: application/json'
Пример ответа:
[
{
"name": "Женщинам/Одежда/Джинсы/Джинсы",
"items": 203,
"sales": 45773,
"revenue": 84030901,
"comments": 109.6,
"rating": 4.1
},
{
"name": "Женщинам/Одежда/Платья/Платья-миди",
"items": 502,
"sales": 17291,
"revenue": 43536241,
"comments": 18.9,
"rating": 3.9
},
...,
]
Описание полей:
Имя поля | Тип | Описание |
---|---|---|
name | text | Вложенная рубрика |
rating | number | Средний рейтинг |
comments | number | Среднее число комментариев |
items | number | Число товаров |
sales | number | Число зафиксированных продаж (единицы) |
revenue | number | Сумма произведений числа проданных товаров на их стоимость |
Бренды
GET wb/get/seller/brands
Параметры запроса:
Параметр | Тип | Обязательный | Описание | Значение по умолчанию |
---|---|---|---|---|
path | Строка | Да | Название бренда, например ВАЙЛДБЕРРИЗ ООО | Нет |
d1 | Дата в формате YYYY-MM-DD | Нет | Дата начала периода | Для тарифных планов "Базовый", "Расширенный" равна дате начала периода согласно условиям тарифа без возможности изменения. |
d2 | Дата в формате YYYY-MM-DD | Нет | Дата окончания периода | Для тарифных планов "Базовый", "Расширенный" равна дате окончания периода согласно условиям тарифа без возможности изменения. |
Пример запроса:
curl --location --request GET 'https://mpstats.io/api/wb/get/seller/brands?d1=2020-07-13&d2=2020-08-11&path=ВАЙЛДБЕРРИЗ ООО' \
--header 'X-Mpstats-TOKEN: 5edfe8277ff2a5.941835169784f269a9244f13350db36eedb814d1' \
--header 'Content-Type: application/json'
Пример ответа:
[
{
"name": "SLUBAN",
"items": 3,
"sales": 3,
"revenue": 3077,
"comments": 23,
"rating": 4
},
{
"name": "Zilmer",
"items": 7970,
"sales": 237007,
"revenue": 408498380,
"comments": 41.5,
"rating": 4.3
}
...,
]
Описание полей:
Имя поля | Тип | Описание |
---|---|---|
name | text | Название бренда |
rating | number | Средний рейтинг |
comments | number | Среднее число комментариев |
items | number | Число товаров |
sales | number | Число зафиксированных продаж (единицы) |
revenue | number | Сумма произведений числа проданных товаров на их стоимость |
По дням
GET wb/get/seller/by_date
Параметры запроса:
Параметр | Тип | Обязательный | Описание | Значение по умолчанию |
---|---|---|---|---|
path | Строка | Да | Название бренда, например ВАЙЛДБЕРРИЗ ООО | Нет |
d1 | Дата в формате YYYY-MM-DD | Нет | Дата начала периода | Для тарифных планов "Базовый", "Расширенный" равна дате начала периода согласно условиям тарифа без возможности изменения. |
d2 | Дата в формате YYYY-MM-DD | Нет | Дата окончания периода | Для тарифных планов "Базовый", "Расширенный" равна дате окончания периода согласно условиям тарифа без возможности изменения. |
Пример запроса:
curl --location --request GET 'https://mpstats.io/api/wb/get/seller/by_date?d1=2020-07-13&d2=2020-08-11&path=ВАЙЛДБЕРРИЗ ООО' \
--header 'X-Mpstats-TOKEN: 5edfe8277ff2a5.941835169784f269a9244f13350db36eedb814d1' \
--header 'Content-Type: application/json'
Пример ответа:
[
{
"data": "2020-08-11",
"items": 7974,
"comments": 38.1,
"rating": 3.9,
"balance": 324768,
"balance_price": 651436220,
"avg_price": 1877,
"avg_sale_price": 1707,
"sales": 7362,
"revenue": 12569639
},
{
"data": "2020-08-10",
"items": 7947,
"comments": 37.9,
"rating": 3.9,
"balance": 324222,
"balance_price": 644563216,
"avg_price": 1874,
"avg_sale_price": 1727,
"sales": 7587,
"revenue": 13110040
},
...,
]
Описание полей:
Имя поля | Тип | Описание |
---|---|---|
period | date | Дата |
comments | number | Среднее число комментариев на товар |
rating | number | Средний рейтинг |
items | number | Число позиций |
balance | number | Число товаров, числящихся в наличии |
balance_price | number | Произведение остатка на цену продажи |
avg_price | number | Средняя цена товара у продавца (все товары, среднее арифметическое) |
avg_sale_price | number | Средняя цена состоявшейся продажи (деление выручки на число продаж) |
sales | number | Число продаж единиц товара |
revenue | number | Выручка за сутки |
Ценовая сегментация
GET wb/get/seller/price_segmentation
Параметры запроса:
Параметр | Тип | Обязательный | Описание | Значение по умолчанию |
---|---|---|---|---|
path | Строка | Да | Название бренда, например ВАЙЛДБЕРРИЗ ООО | Нет |
d1 | Дата в формате YYYY-MM-DD | Нет | Дата начала периода | Для тарифных планов "Базовый", "Расширенный" равна дате начала периода согласно условиям тарифа без возможности изменения. |
d2 | Дата в формате YYYY-MM-DD | Нет | Дата окончания периода | Для тарифных планов "Базовый", "Расширенный" равна дате окончания периода согласно условиям тарифа без возможности изменения. |
Пример запроса:
curl --location --request GET 'https://mpstats.io/api/wb/get/seller/price_segmentation?d1=2020-07-13&d2=2020-08-11&path=ВАЙЛДБЕРРИЗ ООО' \
--header 'X-Mpstats-TOKEN: 5edfe8277ff2a5.941835169784f269a9244f13350db36eedb814d1' \
--header 'Content-Type: application/json'
Пример ответа:
[
{
"range": "5-463",
"items": 37945,
"brands": 1928,
"brands_with_sells": 1788,
"sellers": 1224,
"sellers_with_sells": 1168,
"revenue": 317864027,
"sales": 915522,
"product_revenue": 8376,
"min_range_price": 5,
"max_range_price": 463
},
{
"range": "463-595",
"items": 38053,
"brands": 2304,
"brands_with_sells": 2042,
"sellers": 1431,
"sellers_with_sells": 1329,
"revenue": 273844531,
"sales": 531891,
"product_revenue": 7196,
"min_range_price": 464,
"max_range_price": 595
},
...,
]
Описание полей:
Имя поля | Тип | Описание |
---|---|---|
range | text | Диапазон цен |
min_range_price | number | Цена в диапазоне от |
max_range_price | number | Цена в диапазоне до |
sales | number | Число продаж |
revenue | number | Суммарная выручка в диапазоне |
items | number | Число товаров в диапазоне |
brands | number | Число брендов в диапазоне |
sellers | number | Число продавцов в диапазоне |
brands_with_sells | number | Число брендов в диапазоне с продажами больше 0 |
sellers_with_sells | number | Число продавцов в диапазоне с продажами больше 0 |
product_revenue | number | Сумма выручки диапазона, разделенная на число товаров в нем |
Похожие товары
Товары, которые отображаются в блоке Похожие товары на Wildberries (не только те товары, которые ВБ показывает как похожие на просматриваемый, но и «похожие на похожие»).
Товары
POST wb/get/similar
Параметры запроса:
Параметр | Тип | Обязательный | Описание | Значение по умолчанию |
---|---|---|---|---|
path | Строка | Да | SKU товарной позиции, например 15514538 | Нет |
d1 | Дата в формате YYYY-MM-DD | Нет | Дата начала периода | Для тарифных планов "Базовый", "Расширенный" равна дате начала периода согласно условиям тарифа без возможности изменения. |
d2 | Дата в формате YYYY-MM-DD | Нет | Дата окончания периода | Для тарифных планов "Базовый", "Расширенный" равна дате окончания периода согласно условиям тарифа без возможности изменения. |
Тело запроса:
{
// Номер строки начала получения данных
startRow: 1;
// Номер строки конца получения данных
endRow: 100;
// Не более 5000 записей на один вызов запроса
// Фильтры
filterModel: {};
// Сортировка
sortModel: [];
}
Тело ответа:
{
// Номер строки начала получения данных
startRow: 0;
// Номер строки конца получения данных
endRow: 100;
// Фильтры, которые были установлены при запросе
filterModel: {};
// Сортировка, которая была установлена при запросе
sortModel: [];
// Кол-во строк в результирующем запросе без учета пагинации
total: 42,
// Массив данных
data: [...{...}]
}
Пример запроса:
curl --location --request POST 'https://mpstats.io/api/wb/get/similar?path=6302018&d1=2020-07-13&d2=2020-08-11' \
--header 'X-Mpstats-TOKEN: 5edfe8277ff2a5.941835169784f269a9244f13350db36eedb814d1' \
--header 'Content-Type: application/json' \
--data-raw '{"startRow":0,"endRow":100,"filterModel":{"id":{"filterType":"number","type":"equals","filter":14797654}},"sortModel":[{"colId":"revenue","sort":"desc"}]}'
Пример ответа:
{"data":[{"id":14797654,"name":"Ботинки","brand":"DI MARINELLI","seller":"Аракелян Диана Самвеловна ИП","category":"Обувь\/Женская\/Ботинки и полуботинки\/Челси","color":"","balance":61,"comments":172,"rating":5,"final_price":4161,"final_price_max":4161,"final_price_min":3536,"final_price_average":3844.094064949608,"basic_sale":40,"basic_price":438000,"promo_sale":5,"client_sale":8,"client_price":3828,"start_price":7300,"sales":893,"revenue":3432776,"revenue_potential":3814195,"lost_profit":381419,"days_in_stock":27,"days_with_sales":30,"average_if_in_stock":28.14814814814815,"thumb":"https:\/\/img1.wbstatic.net\/tm\/new\/14790000\/14797654-1.jpg","thumb_middle":"https:\/\/img1.wbstatic.net\/c252x336\/new\/14790000\/14797654-1.jpg","graph":[25,12,7,6,7,6,25,20,9,39,53,75,54,42,25,9,8,11,61,36,28,22,11,9,25,66,50,96,8,48]}],"total":1,"startRow":0,"endRow":100,"rowGroupCols":[],"valueCols":[],"pivotCols":[],"pivotMode":false,"groupKeys":[],"filterModel":{"id":{"filterType":"number","type":"equals","filter":14797654}},"sortModel":[{"sort":"desc","colId":"revenue"}]}
Описание полей:
Имя поля | Тип | Описание |
---|---|---|
thumb | text | Изображение товара |
thumb_middle | text | Изображение товара (среднее) |
id | number | Идентификатор товарной позиции |
name | text | Название товара |
color | text | Цвет товара |
category | text | Категория товара |
brand | text | Название бренда |
seller | text | Название продавца |
balance | number | Последний зафиксированный остаток на складе |
comments | number | Количество комментариев |
rating | number | Рейтинг товара |
final_price | number | Последняя зафиксированная цена |
final_price_min | number | Минимальная цена за период |
final_price_max | number | Максимальная цена за период |
final_price_average | number | Средняя цена за период (выручка / число продаж) |
start_price | number | Базовая цена товара |
basic_sale | number | Размер скидки |
basic_price | number | Цена после применения скидки |
promo_sale | number | Размер скидки по промокоду |
client_sale | number | Размер Скидки Постоянного Покупателя |
client_price | number | Итоговая цена для посетителя, с учетом СПП |
revenue_potential | number | Потенциал выручки (выручка / число дней в наличии) * дней в отчете |
lost_profit | number | Упущенная выручка (Потенциал - Выручка) |
days_in_stock | number | Количество дней, когда товар был в наличии на конец дня |
days_with_sales | number | Количество дней, когда были продажи |
average_if_in_stock | number | Среднее число продаж, при наличии товара на конец дня |
sales | number | Количество проданных единиц товара за период |
revenue | number | Выручка за период |
graph | array<number> | График продаж |
Категории
GET wb/get/similar/categories
Параметры запроса:
Параметр | Тип | Обязательный | Описание | Значение по умолчанию |
---|---|---|---|---|
path | Строка | Да | SKU товарной позиции, например 15514538 | Нет |
d1 | Дата в формате YYYY-MM-DD | Нет | Дата начала периода | Для тарифных планов "Базовый", "Расширенный" равна дате начала периода согласно условиям тарифа без возможности изменения. |
d2 | Дата в формате YYYY-MM-DD | Нет | Дата окончания периода | Для тарифных планов "Базовый", "Расширенный" равна дате окончания периода согласно условиям тарифа без возможности изменения. |
Пример запроса:
curl --location --request GET 'https://mpstats.io/api/wb/get/similar/categories?d1=2020-07-13&d2=2020-08-11&path=6302018' \
--header 'X-Mpstats-TOKEN: 5edfe8277ff2a5.941835169784f269a9244f13350db36eedb814d1' \
--header 'Content-Type: application/json'
Пример ответа:
[
{
comments: 69.1
items: 66
name: "Обувь/Женская/Ботинки и полуботинки/Ботинки"
rating: 4.6
revenue: 29511139
sales: 6628
},
{
comments: 72.2
items: 52
name: "Обувь/Женская/Ботинки и полуботинки/Кожаные"
rating: 4.5
revenue: 25447024
sales: 5246
},
...,
]
Описание полей:
Имя поля | Тип | Описание |
---|---|---|
name | text | Вложенная рубрика |
rating | number | Средний рейтинг |
comments | number | Среднее число комментариев |
items | number | Число товаров |
sales | number | Число зафиксированных продаж (единицы) |
revenue | number | Сумма произведений числа проданных товаров на их стоимость |
Бренды
GET wb/get/similar/brands
Параметры запроса:
Параметр | Тип | Обязательный | Описание | Значение по умолчанию |
---|---|---|---|---|
path | Строка | Да | SKU товарной позиции, например 15514538 | Нет |
d1 | Дата в формате YYYY-MM-DD | Нет | Дата начала периода | Для тарифных планов "Базовый", "Расширенный" равна дате начала периода согласно условиям тарифа без возможности изменения. |
d2 | Дата в формате YYYY-MM-DD | Нет | Дата окончания периода | Для тарифных планов "Базовый", "Расширенный" равна дате окончания периода согласно условиям тарифа без возможности изменения. |
Пример запроса:
curl --location --request GET 'https://mpstats.io/api/wb/get/similar/brands?d1=2020-07-13&d2=2020-08-11&path=6302018' \
--header 'X-Mpstats-TOKEN: 5edfe8277ff2a5.941835169784f269a9244f13350db36eedb814d1' \
--header 'Content-Type: application/json'
Пример ответа:
[
{
comments: 62.2
items: 5
name: "DI MARINELLI"
rating: 4.6
revenue: 4854213
sales: 1199
},
{
comments: 147.6
items: 5
name: "BERG"
rating: 4.8
revenue: 4374039
sales: 697
}
...,
]
Описание полей:
Имя поля | Тип | Описание |
---|---|---|
position | number | Позиция в рейтинге |
name | text | Название бренда |
rating | number | Средний рейтинг |
comments | number | Среднее число комментариев |
items | number | Число товаров |
sales | number | Число зафиксированных продаж (единицы) |
revenue | number | Сумма произведений числа проданных товаров на их стоимость |
Продавцы
GET wb/get/similar/sellers
Параметры запроса:
Параметр | Тип | Обязательный | Описание | Значение по умолчанию |
---|---|---|---|---|
path | Строка | Да | SKU товарной позиции, например 15514538 | Нет |
d1 | Дата в формате YYYY-MM-DD | Нет | Дата начала периода | Для тарифных планов "Базовый", "Расширенный" равна дате начала периода согласно условиям тарифа без возможности изменения. |
d2 | Дата в формате YYYY-MM-DD | Нет | Дата окончания периода | Для тарифных планов "Базовый", "Расширенный" равна дате окончания периода согласно условиям тарифа без возможности изменения. |
Пример запроса:
curl --location --request GET 'https://mpstats.io/api/wb/get/similar/sellers?d1=2020-07-13&d2=2020-08-11&path=6302018' \
--header 'X-Mpstats-TOKEN: 5edfe8277ff2a5.941835169784f269a9244f13350db36eedb814d1' \
--header 'Content-Type: application/json'
Пример ответа:
[
{
comments: 147.6
items: 5
name: "МОСКОВСКАЯ ОБУВНАЯ ФАБРИКА ООО"
rating: 4.8
revenue: 4374039
sales: 697
},
{
comments: 73.2
items: 6
name: "ВАЙЛДБЕРРИЗ ООО"
rating: 4.8
revenue: 1867505
sales: 490
}
...,
]
Описание полей:
Имя поля | Тип | Описание |
---|---|---|
name | text | Название продавца |
rating | number | Средний рейтинг |
comments | number | Среднее число комментариев |
items | number | Число товаров |
sales | number | Число зафиксированных продаж (единицы) |
revenue | number | Сумма произведений числа проданных товаров на их стоимость |
По дням
GET wb/get/similar/by_date
Параметры запроса:
Параметр | Тип | Обязательный | Описание | Значение по умолчанию |
---|---|---|---|---|
path | Строка | Да | SKU товарной позиции, например 15514538 | Нет |
d1 | Дата в формате YYYY-MM-DD | Нет | Дата начала периода | Для тарифных планов "Базовый", "Расширенный" равна дате начала периода согласно условиям тарифа без возможности изменения. |
d2 | Дата в формате YYYY-MM-DD | Нет | Дата окончания периода | Для тарифных планов "Базовый", "Расширенный" равна дате окончания периода согласно условиям тарифа без возможности изменения. |
Пример запроса:
curl --location --request GET 'https://mpstats.io/api/wb/get/similar/by_date?d1=2020-07-13&d2=2020-08-11&path=6302018' \
--header 'X-Mpstats-TOKEN: 5edfe8277ff2a5.941835169784f269a9244f13350db36eedb814d1' \
--header 'Content-Type: application/json'
Пример ответа:
[
{
"data": "2020-08-11",
"items": 7974,
"comments": 38.1,
"rating": 3.9,
"balance": 324768,
"balance_price": 651436220,
"avg_price": 1877,
"avg_sale_price": 1707,
"sales": 7362,
"revenue": 12569639
},
{
"data": "2020-08-10",
"items": 7947,
"comments": 37.9,
"rating": 3.9,
"balance": 324222,
"balance_price": 644563216,
"avg_price": 1874,
"avg_sale_price": 1727,
"sales": 7587,
"revenue": 13110040
},
...,
]
Описание полей:
Имя поля | Тип | Описание |
---|---|---|
period | date | Дата |
items | number | Число товаров в рейтинге |
sales | number | Продано единиц товаров |
revenue | number | Выручка |
avg_price | number | Средняя цена товара в категории (все товары, среднее арифметическое) |
avg_sale_price | number | Средняя цена состоявшейся продажи (деление выручки на число продаж) |
comments | number | Среднее число комментариев на товар |
rating | number | Средний рейтинг |
Товарная позиция (SKU)
Получение данных по товару
GET wb/get/item/{sku}
Пример запроса:
curl --location --request GET 'https://mpstats.io/api/wb/get/item/3867317' \
--header 'X-Mpstats-TOKEN: 5f344c39f1bed8.86604437950c9cc0893508080fc8cef256d5a983' \
--header 'Content-Type: application/json'
Пример ответа:
{
"item": {
"id": "3867317",
"name": "Шлепанцы",
"full_name": "Шлепанцы",
"link": "https://www.wildberries.ru/catalog/3867317/detail.aspx",
"brand": "CROCS",
"seller": "ВАЙЛДБЕРРИЗ ООО",
"rating": 5,
"comments": 4075,
"price": 2899,
"final_price": 2899,
"discount": 0,
"updated": "2020-08-13 17:14:20",
"is_new": 0
},
"photos": [
{
"f": "https://img2.wbstatic.net/big/new/3860000/3867317-1.jpg",
"t": "https://img1.wbstatic.net/tm/new/3860000/3867317-1.jpg"
},
{
"f": "https://img2.wbstatic.net/big/new/3860000/3867317-2.jpg",
"t": "https://img1.wbstatic.net/tm/new/3860000/3867317-2.jpg"
}
]
}
Описание полей:
Имя поля | Тип | Описание |
---|---|---|
id | number | Идентификатор товара (SKU) |
name | text | Название |
full_name | text | Полное название |
link | text | Ссылка на площадке |
brand | text | Бренд |
seller | text | Продавец |
rating | number | Рейтинг |
comments | number | Комментариев |
price | number | Цена |
final_price | number | Цена с учетом скидки |
discount | number | Скидка |
updated | date | Обновлено |
first_date | date | Впервые обнаружен |
is_new | number | Новинка |
Продажи и остатки
GET wb/get/item/{sku}/sales
Параметры запроса:
Параметр | Тип | Обязательный | Описание | Значение по умолчанию |
---|---|---|---|---|
d1 | Дата в формате YYYY-MM-DD | Нет | Дата начала периода | Для тарифных планов "Базовый", "Расширенный" равна дате начала периода согласно условиям тарифа без возможности изменения. |
d2 | Дата в формате YYYY-MM-DD | Нет | Дата окончания периода | Для тарифных планов "Базовый", "Расширенный" равна дате окончания периода согласно условиям тарифа без возможности изменения. |
Пример запроса:
curl --location --request GET 'https://mpstats.io/api/wb/get/item/3867317/sales?d1=2020-07-13&d2=2020-08-11' \
--header 'X-Mpstats-TOKEN: 5f356bf2a55695.18670170077856385aaba91fb0b6b76bb7533b52' \
--header 'Content-Type: application/json'
Пример ответа:
[
{
"no_data": 0,
"data": "2020-08-11",
"balance": 5473,
"sales": 20,
"rating": 5,
"price": 2899,
"final_price": 2899,
"is_new": 0,
"comments": 4069
},
{
"no_data": 0,
"data": "2020-08-10",
"balance": 5480,
"sales": 13,
"rating": 5,
"price": 2899,
"final_price": 2899,
"is_new": 0,
"comments": 4064
},
...,
]
Описание полей:
Имя поля | Тип | Описание |
---|---|---|
no_data | number | 0: OK, 1: Продаж и остатков не зафиксировано |
data | date | Дата |
sales | number | Продажи |
balance | number | Остаток |
price | number | Цена |
final_price | number | Со скидкой |
sales_amount | number | Сумма продаж |
comments | number | Комментариев |
rating | number | Рейтинг |
Продажи и остатки за сутки
GET wb/get/item/{sku}/balance_by_day
Параметр | Тип | Обязательный | Описание | Значение по умолчанию |
---|---|---|---|---|
d | Дата в формате YYYY-MM-DD | Да | Дата проверки | Нет |
Пример запроса:
curl --location --request GET 'https://mpstats.io/api/wb/get/item/3867317/balance_by_day?d=2020-08-13' \
--header 'X-Mpstats-TOKEN: 5f356bf2a55695.18670170077856385aaba91fb0b6b76bb7533b52' \
--header 'Content-Type: application/json'
Пример ответа:
[
{
"tm": "02:15",
"comments": 4075,
"rating": 5,
"balance": 5470,
"sales": 0,
"price": 2899,
"final_price": 2899
},
{
"tm": "03:20",
"comments": 4075,
"rating": 5,
"balance": 5470,
"sales": 0,
"price": 2899,
"final_price": 2899
},
...,
]
Описание полей:
Имя поля | Тип | Описание |
---|---|---|
tm | time | Время |
price | number | Цена |
final_price | number | Со скидкой |
comments | number | Комментариев |
rating | number | Рейтинг |
balance | number | Остаток |
sales | number | Продаж |
История позиций по категориям
GET wb/get/item/{sku}/by_category
Параметры запроса:
Параметр | Тип | Обязательный | Описание | Значение по умолчанию |
---|---|---|---|---|
d1 | Дата в формате YYYY-MM-DD | Нет | Дата начала периода | Для тарифных планов "Базовый", "Расширенный" равна дате начала периода согласно условиям тарифа без возможности изменения. |
d2 | Дата в формате YYYY-MM-DD | Нет | Дата окончания периода | Для тарифных планов "Базовый", "Расширенный" равна дате окончания периода согласно условиям тарифа без возможности изменения. |
Пример запроса:
curl --location --request GET 'https://mpstats.io/api/wb/get/item/3867317/by_category?d1=2020-07-15&d2=2020-08-13' \
--header 'X-Mpstats-TOKEN: 5f356bf2a55695.18670170077856385aaba91fb0b6b76bb7533b52' \
--header 'Content-Type: application/json'
Пример ответа:
{
balance: [0, 0, 8757, 8597, 8436, 8285, 8094, 7925, 7774, 7549, 7275, 7043, 6701, 6419, 6201, 6011, 5788, 5606,…]
categories: {,…}
Женщинам/Белье: ["NaN", "NaN", 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 2, 2, 2, 2, 2, 2, 2, 2, 1]
Женщинам/Белье/Колготки и чулки: ["NaN", "NaN", 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1]
Женщинам/Белье/Колготки и чулки/Носки: ["NaN", "NaN", 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1]
days: ["14.07", "15.07", "16.07", "17.07", "18.07", "19.07", "20.07", "21.07", "22.07", "23.07", "24.07",…]
final_price: [0, 0, 498, 498, 498, 439, 439, 439, 439, 439, 439, 439, 439, 439, 439, 439, 439, 439, 439, 439, 439,…]
sales: [0, 0, 144, 160, 161, 151, 192, 169, 151, 225, 274, 232, 342, 282, 219, 190, 223, 182, 163, 166, 153,…]
}
Описание полей:
Имя поля | Тип | Описание |
---|---|---|
final_price | array<number> | Цена со скидкой |
categories | object{[string]: array<string|number>} | Категория и позиции в ней. NaN: Позиция не определена |
days | array<string> | Дни |
balance | array<number> | Остаток |
sales | array<number> | Продаж |
История заказов и остатков по складам
GET wb/get/item/{sku}/orders_by_region
Параметры запроса:
Параметр | Тип | Обязательный | Описание | Значение по умолчанию |
---|---|---|---|---|
d1 | Дата в формате YYYY-MM-DD | Нет | Дата начала периода | Для тарифных планов "Базовый", "Расширенный" равна дате начала периода согласно условиям тарифа без возможности изменения. |
d2 | Дата в формате YYYY-MM-DD | Нет | Дата окончания периода | Для тарифных планов "Базовый", "Расширенный" равна дате окончания периода согласно условиям тарифа без возможности изменения. |
Пример запроса:
curl --location --request GET 'https://mpstats.io/api/wb/get/item/10160519/orders_by_region?d1=2020-06-30&d2=2020-08-28' \
--header 'X-Mpstats-TOKEN: 5f356bf2a55695.18670170077856385aaba91fb0b6b76bb7533b52' \
--header 'Content-Type: application/json'
Пример ответа:
{
"2020-08-08": {
"Подольск": {
"sales": 46,
"balance": 7396
},
"Новосибирск": {
"sales": 3,
"balance": 0
},
"Краснодар": {
"sales": 18,
"balance": 1481
},
"Екатеринбург": {
"sales": 21,
"balance": 1156
},
"Санкт-Петербург": {
"sales": 8,
"balance": 822
},
"Казань": {
"sales": 8,
"balance": 765
},
"unknown 117501": {
"sales": "NaN",
"balance": "NaN"
}
},
...,
}
Описание полей:
Имя поля | Тип | Описание |
---|---|---|
balance | number | Остаток |
sales | number | Заказы |
История заказов и остатков по размерам
GET wb/get/item/{sku}/orders_by_size
Параметры запроса:
Параметр | Тип | Обязательный | Описание | Значение по умолчанию |
---|---|---|---|---|
d1 | Дата в формате YYYY-MM-DD | Нет | Дата начала периода | Для тарифных планов "Базовый", "Расширенный" равна дате начала периода согласно условиям тарифа без возможности изменения. |
d2 | Дата в формате YYYY-MM-DD | Нет | Дата окончания периода | Для тарифных планов "Базовый", "Расширенный" равна дате окончания периода согласно условиям тарифа без возможности изменения. |
Пример запроса:
curl --location --request GET 'https://mpstats.io/api/wb/get/item/3867317/orders_by_size?d1=2020-06-30&d2=2020-08-28' \
--header 'X-Mpstats-TOKEN: 5f356bf2a55695.18670170077856385aaba91fb0b6b76bb7533b52' \
--header 'Content-Type: application/json'
Пример ответа:
{
"2020-08-08": {
"35 (35/5)": {
"sales": 0,
"balance": 314,
"size_name": "35",
"size_origin": "35/5"
},
"36 (36/6)": {
"sales": 0,
"balance": 924,
"size_name": "36",
"size_origin": "36/6"
},
"37 (37/7)": {
"sales": 5,
"balance": 475,
"size_name": "37",
"size_origin": "37/7"
},
"38 (38/8)": {
"sales": 5,
"balance": 229,
"size_name": "38",
"size_origin": "38/8"
},
...,
},
...,
}
Описание полей:
Имя поля | Тип | Описание |
---|---|---|
balance | number | Остаток |
sales | number | Заказы |
size_name | text | Размер |
size_origin | text | Размер поставщика |
Похожие товары
Товары, которые отображаются в блоке Похожие товары на Wildberries (не только те товары, которые ВБ показывает как похожие на просматриваемый, но и «похожие на похожие»).
GET wb/get/item/{sku}/similar
Параметры запроса:
Параметр | Тип | Обязательный | Описание | Значение по умолчанию |
---|---|---|---|---|
d1 | Дата в формате YYYY-MM-DD | Нет | Дата начала периода | Для тарифных планов "Базовый", "Расширенный" равна дате начала периода согласно условиям тарифа без возможности изменения. |
d2 | Дата в формате YYYY-MM-DD | Нет | Дата окончания периода | Для тарифных планов "Базовый", "Расширенный" равна дате окончания периода согласно условиям тарифа без возможности изменения. |
Пример запроса:
curl --location --request GET 'https://mpstats.io/api/wb/get/item/3867317/similar?d1=2020-06-30&d2=2020-08-28' \
--header 'X-Mpstats-TOKEN: 5f356bf2a55695.18670170077856385aaba91fb0b6b76bb7533b52' \
--header 'Content-Type: application/json'
Пример ответа:
[
{
balance: 1663
brand: "CROCS"
comments: 213
final_price: 2309
graph: [22, 5, 21, 10, 11, 1, 4, 4, 14, 2, 5, 5, 1, 8, 6, 1, 1, 2, 3, 3, 10, 15, 41, 28, 12, 25, 23, 22, 22,…]
id: 17976257
name: "Шлепанцы"
rating: 5
revenue: 2280391
sales: 1092
seller: "ВАЙЛДБЕРРИЗ ООО"
thumb: "https://img1.wbstatic.net/tm/new/17970000/17976257-1.jpg"
thumb_middle: "https://img1.wbstatic.net/c252x336/new/17970000/17976257-1.jpg"
},
...,
]
Описание полей:
Имя поля | Тип | Описание |
---|---|---|
thumb | text | Изображение товара |
thumb_middle | text | Изображение товара (среднее) |
name | text | Название товара |
brand | text | Название бренда |
seller | text | Название продавца |
balance | number | Последний зафиксированный остаток на складе |
comments | number | Количество комментариев |
rating | number | Рейтинг товара |
final_price | number | Последняя зафиксированная цена |
sales | number | Количество проданных единиц товара за период |
revenue | number | Выручка за период |
graph | array<number> | График продаж |
Пакетные запросы
Товарные позиции (SKUs)
Получение данных по товарам
POST wb/get/items/batch
Тело запроса:
{
// Массив sku товаров, не более 200 в одном запросе
ids: [];
}
Пример запроса:
curl --location --request POST 'https://mpstats.io/api/wb/get/items/batch' \
--header 'X-Mpstats-TOKEN: 5f356bf2a55695.18670170077856385aaba91fb0b6b76bb7533b52' \
--header 'Content-Type: application/json' \
--data-raw '{"ids":[3867317, 12808436]}'
Пример ответа:
[
{
"item": {
"id": "3867317",
"name": "Шлепанцы",
"full_name": "Шлепанцы",
"link": "https://www.wildberries.ru/catalog/3867317/detail.aspx",
"brand": "CROCS",
"seller": "ВАЙЛДБЕРРИЗ ООО",
"rating": 5,
"comments": 4075,
"price": 2899,
"final_price": 2899,
"discount": 0,
"updated": "2020-08-13 17:14:20",
"is_new": 0
},
"photos": [
{
"f": "https://img2.wbstatic.net/big/new/3860000/3867317-1.jpg",
"t": "https://img1.wbstatic.net/tm/new/3860000/3867317-1.jpg"
},
{
"f": "https://img2.wbstatic.net/big/new/3860000/3867317-2.jpg",
"t": "https://img1.wbstatic.net/tm/new/3860000/3867317-2.jpg"
}
]
},
...,
]
Описание полей:
Имя поля | Тип | Описание |
---|---|---|
id | number | Идентификатор товара (SKU) |
name | text | Название |
full_name | text | Полное название |
link | text | Ссылка на площадке |
brand | text | Бренд |
seller | text | Продавец |
rating | number | Рейтинг |
comments | number | Комментариев |
price | number | Цена |
final_price | number | Цена с учетом скидки |
discount | number | Скидка |
updated | date | Обновлено |
first_date | date | Впервые обнаружен |
is_new | number | Новинка |