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

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

Товары

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 Изображение товара
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,
        "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,
        "sales": 204686,
        "revenue": 316253781,
        "avg_price": 2732.3870005868,
        "comments": 23.437757002218,
        "rating": 2.7848945721555,
        "avg_sale_price": 1545.0679626355
    },

    ...,

   ]

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

Имя поля Тип Описание
data date Дата
items number Число товаров в рейтинге
sales number Продано единиц товаров
revenue number Выручка
avg_price number Средняя цена товара в категории (все товары, среднее арифметическое)
avg_sale_price number Средняя цена состоявшейся продажи (деление выручки на число продаж)
comments number Среднее число комментариев на товар
rating 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 Изображение товара
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 Выручка за сутки

По продавцам

Получение данных по продавцам

Товары

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 Изображение товара
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 Выручка за сутки

Товарная позиция (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 Размер поставщика

Пакетные запросы

Товарные позиции (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' \
--header 'Cookie: XDEBUG_SESSION=PHPDEBUG' \
--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. Подробнее.
Понятно