По категориям

Получение данных по товарным категориям

Товары

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
    },

    ...,

   ]
    

Описание полей:

Имя поля Тип Описание
data 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
    },
    ...,

   ]
    

Описание полей:

Имя поля Тип Описание
data 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
    },
    ...,

   ]
    

Описание полей:

Имя поля Тип Описание
data 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
    },
    ...,

   ]
    

Описание полей:

Имя поля Тип Описание
data 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 Новинка
Внимание! Пользуясь настоящим веб-сайтом, вы даете свое согласие на использование файлов cookies. Подробнее.
Понятно