Рубрикатор

Получение текущего рубрикатора

GET wb/get/categories

Пример запроса:

curl --location --request GET 'http://mpstats.io/api/wb/get/categories' \
--header 'X-Mpstats-TOKEN: 5edfe8277ff2a5.941835169784f269a9244f13350db36eedb814d1' \
--header 'Content-Type: application/json'

Пример ответа:

    
[
  {
    "url": "/catalog/premium-odezhda",
    "name": "Premium",
    "path": "Premium"
  },
  {
    "url": "/catalog/zhenshchinam/odezhda/svitshoty",
    "name": "Свитшоты",
    "path": "Женщинам/Одежда/Свитшоты"
  },
  {
    "url": "/catalog/elektronika/planshety",
    "name": "Планшеты",
    "path": "Электроника/Смартфоны и телефоны/Планшеты"
  }
]
    

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

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

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

Товары

POST wb/get/category

Параметры запроса:

Тело запроса:

{
   // Номер строки начала получения данных
   startRow: 1;
   // Номер строки конца получения данных
   endRow: 100;
   // Не более 5000 записей на один вызов запроса

   // Фильтры
   filterModel: {};
   // Сортировка
   sortModel: [];
}

Тело ответа:

{
   // Номер строки начала получения данных
   startRow: 0;
   // Номер строки конца получения данных
   endRow: 100;
   // Фильтры, которые были установлены при запросе
   filterModel: {};
   // Сортировка, которая была установлена при запросе
   sortModel: [];
   // Кол-во строк в результирующем запросе без учета пагинации
   total: 42,
   // Массив данных
   data: [...{...}]
}

    
{
   // номер строки начала получения данных
   startRow: number,

   // номер строки конца получения данных
   endRow: number,

   // Не более 5000 записей на один вызов запроса

   ... // остальные параметры
}
    

{
    sortModel: [
        { colId: 'balance', sort: 'asc' },
        { colId: 'sales', sort: 'desc' },
    ],

    ... // остальные параметры

}

    
// текстовые фильтры используют след. модель
interface TextFilterModel {
    // равен 'text'
    filterType: string;

    // один из вариантов фильтра, например «равно»
    type: string;

    // текстовое значение, связанное с фильтром.
    // это необязательно, так как фильтры могут не иметь значения
    filter?: string;
}
    

    
// числовые фильтры используют след. модель
interface NumberFilterModel {
    // равен 'number'
    filterType: string;

    // один из вариантов фильтра, например «равно»
    type: string;

    // числовые значения
    // это необязательно, так как фильтры могут не иметь значения
    // фильтр диапазона имеет два значения (от и до).
    filter?: number;
    filterTo?: number;
}
    

    
// фильтры даты используют след. модель
interface NumberFilterModel {
    // равен 'date'
    filterType: string;

    // один из вариантов фильтра, например «равно»
    type: string;

    // текстовые значения
    // это необязательно, так как фильтры могут не иметь значения
    // тип - строка, а формат - всегда ГГГГ-ММ-ДД, например. 2019-05-24
    // фильтр диапазона имеет два значения (от и до).
    filter?: string;
    filterTo?: string;
}
    

    
//числовой фильтр с одним условием
balance: {
    filterType: 'number',
    type: 'lessThan',
    filter: 35
}
    

    
//числовой фильтр с одним условием и диапазоном
balance: {
    filterType: 'number',
    type: 'inRange',
    filter: 35,
    filterTo: 40
};
    

    
// Фильтр, объединяющий два условия
// M - это либо TextFilterModel, NumberFilterModel, либо DateFilterModel
interface ICombinedSimpleModel<M> {
    // тип фильтра: date, number or text
    filterType: string;

    // одно из условий 'AND' или 'OR'
    operator: string;

    // два экземпляра модели фильтра
    condition1: M;
    condition2: M;
}
    

    
balance: {
    filterType: 'number',
    operator: 'OR'
    condition1: {
        filterType: 'number',
        type: 'equals',
        filter: 18
    },
    condition2: {
        filterType: 'number',
        type: 'equals',
        filter: 19
    }
};
    

Пример запроса:

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

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

Подкатегории

GET wb/get/category/subcategories

Параметры запроса:

Пример запроса:

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

    ...,

   ]
    

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

Бренды

GET wb/get/category/brands

Параметры запроса:

Пример запроса:

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

    ...,

   ]
    

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

Продавцы

GET wb/get/category/sellers

Параметры запроса:

Пример запроса:

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

    ...,

   ]
    

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

Тренд

GET wb/get/category/trends

Параметры запроса:

Пример запроса:

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

    ...,

   ]
    

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

По дням

GET wb/get/category/by_date

Параметры запроса:

Пример запроса:

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

    ...,

   ]
    

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

Ценовая сегментация

GET wb/get/category/price_segmentation

Параметры запроса:

Пример запроса:

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

    ...,

   ]
    

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

По брендам

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

Товары

POST wb/get/brand

Параметры запроса:

Тело запроса:

{
   // Номер строки начала получения данных
   startRow: 1;
   // Номер строки конца получения данных
   endRow: 100;
   // Не более 5000 записей на один вызов запроса

   // Фильтры
   filterModel: {};
   // Сортировка
   sortModel: [];
}

Тело ответа:

{
   // Номер строки начала получения данных
   startRow: 0;
   // Номер строки конца получения данных
   endRow: 100;
   // Фильтры, которые были установлены при запросе
   filterModel: {};
   // Сортировка, которая была установлена при запросе
   sortModel: [];
   // Кол-во строк в результирующем запросе без учета пагинации
   total: 42,
   // Массив данных
   data: [...{...}]
}

    
{
   // номер строки начала получения данных
   startRow: number,

   // номер строки конца получения данных
   endRow: number,

   // Не более 5000 записей на один вызов запроса

   ... // остальные параметры
}
    

{
    sortModel: [
        { colId: 'balance', sort: 'asc' },
        { colId: 'sales', sort: 'desc' },
    ],

    ... // остальные параметры

}

    
// текстовые фильтры используют след. модель
interface TextFilterModel {
    // равен 'text'
    filterType: string;

    // один из вариантов фильтра, например «равно»
    type: string;

    // текстовое значение, связанное с фильтром.
    // это необязательно, так как фильтры могут не иметь значения
    filter?: string;
}
    

    
// числовые фильтры используют след. модель
interface NumberFilterModel {
    // равен 'number'
    filterType: string;

    // один из вариантов фильтра, например «равно»
    type: string;

    // числовые значения
    // это необязательно, так как фильтры могут не иметь значения
    // фильтр диапазона имеет два значения (от и до).
    filter?: number;
    filterTo?: number;
}
    

    
// фильтры даты используют след. модель
interface NumberFilterModel {
    // равен 'date'
    filterType: string;

    // один из вариантов фильтра, например «равно»
    type: string;

    // текстовые значения
    // это необязательно, так как фильтры могут не иметь значения
    // тип - строка, а формат - всегда ГГГГ-ММ-ДД, например. 2019-05-24
    // фильтр диапазона имеет два значения (от и до).
    filter?: string;
    filterTo?: string;
}
    

    
//числовой фильтр с одним условием
balance: {
    filterType: 'number',
    type: 'lessThan',
    filter: 35
}
    

    
//числовой фильтр с одним условием и диапазоном
balance: {
    filterType: 'number',
    type: 'inRange',
    filter: 35,
    filterTo: 40
};
    

    
// Фильтр, объединяющий два условия
// M - это либо TextFilterModel, NumberFilterModel, либо DateFilterModel
interface ICombinedSimpleModel<M> {
    // тип фильтра: date, number or text
    filterType: string;

    // одно из условий 'AND' или 'OR'
    operator: string;

    // два экземпляра модели фильтра
    condition1: M;
    condition2: M;
}
    

    
balance: {
    filterType: 'number',
    operator: 'OR'
    condition1: {
        filterType: 'number',
        type: 'equals',
        filter: 18
    },
    condition2: {
        filterType: 'number',
        type: 'equals',
        filter: 19
    }
};
    

Пример запроса:

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

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

Категории

GET wb/get/brand/categories

Параметры запроса:

Пример запроса:

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

    ...,

   ]
    

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

Продавцы

GET wb/get/brand/sellers

Параметры запроса:

Пример запроса:

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

   ]
    

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

По дням

GET wb/get/brand/by_date

Параметры запроса:

Пример запроса:

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

   ]
    

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

Ценовая сегментация

GET wb/get/brand/price_segmentation

Параметры запроса:

Пример запроса:

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

    ...,

   ]
    

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

По продавцам

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

Товары

POST wb/get/seller

Параметры запроса:

Тело запроса:

{
   // Номер строки начала получения данных
   startRow: 1;
   // Номер строки конца получения данных
   endRow: 100;
   // Не более 5000 записей на один вызов запроса

   // Фильтры
   filterModel: {};
   // Сортировка
   sortModel: [];
}

Тело ответа:

{
   // Номер строки начала получения данных
   startRow: 0;
   // Номер строки конца получения данных
   endRow: 100;
   // Фильтры, которые были установлены при запросе
   filterModel: {};
   // Сортировка, которая была установлена при запросе
   sortModel: [];
   // Кол-во строк в результирующем запросе без учета пагинации
   total: 42,
   // Массив данных
   data: [...{...}]
}

    
{
   // номер строки начала получения данных
   startRow: number,

   // номер строки конца получения данных
   endRow: number,

   // Не более 5000 записей на один вызов запроса

   ... // остальные параметры
}
    

{
    sortModel: [
        { colId: 'balance', sort: 'asc' },
        { colId: 'sales', sort: 'desc' },
    ],

    ... // остальные параметры

}

    
// текстовые фильтры используют след. модель
interface TextFilterModel {
    // равен 'text'
    filterType: string;

    // один из вариантов фильтра, например «равно»
    type: string;

    // текстовое значение, связанное с фильтром.
    // это необязательно, так как фильтры могут не иметь значения
    filter?: string;
}
    

    
// числовые фильтры используют след. модель
interface NumberFilterModel {
    // равен 'number'
    filterType: string;

    // один из вариантов фильтра, например «равно»
    type: string;

    // числовые значения
    // это необязательно, так как фильтры могут не иметь значения
    // фильтр диапазона имеет два значения (от и до).
    filter?: number;
    filterTo?: number;
}
    

    
// фильтры даты используют след. модель
interface NumberFilterModel {
    // равен 'date'
    filterType: string;

    // один из вариантов фильтра, например «равно»
    type: string;

    // текстовые значения
    // это необязательно, так как фильтры могут не иметь значения
    // тип - строка, а формат - всегда ГГГГ-ММ-ДД, например. 2019-05-24
    // фильтр диапазона имеет два значения (от и до).
    filter?: string;
    filterTo?: string;
}
    

    
//числовой фильтр с одним условием
balance: {
    filterType: 'number',
    type: 'lessThan',
    filter: 35
}
    

    
//числовой фильтр с одним условием и диапазоном
balance: {
    filterType: 'number',
    type: 'inRange',
    filter: 35,
    filterTo: 40
};
    

    
// Фильтр, объединяющий два условия
// M - это либо TextFilterModel, NumberFilterModel, либо DateFilterModel
interface ICombinedSimpleModel<M> {
    // тип фильтра: date, number or text
    filterType: string;

    // одно из условий 'AND' или 'OR'
    operator: string;

    // два экземпляра модели фильтра
    condition1: M;
    condition2: M;
}
    

    
balance: {
    filterType: 'number',
    operator: 'OR'
    condition1: {
        filterType: 'number',
        type: 'equals',
        filter: 18
    },
    condition2: {
        filterType: 'number',
        type: 'equals',
        filter: 19
    }
};
    

Пример запроса:

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

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

Категории

GET wb/get/seller/categories

Параметры запроса:

Пример запроса:

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

    ...,

   ]
    

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

Бренды

GET wb/get/seller/brands

Параметры запроса:

Пример запроса:

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

   ]
    

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

По дням

GET wb/get/seller/by_date

Параметры запроса:

Пример запроса:

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

   ]
    

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

Ценовая сегментация

GET wb/get/seller/price_segmentation

Параметры запроса:

Пример запроса:

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

    ...,

   ]
    

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

Похожие товары

Товары, которые отображаются в блоке Похожие товары на Wildberries (не только те товары, которые ВБ показывает как похожие на просматриваемый, но и «похожие на похожие»).

Товары

POST wb/get/similar

Параметры запроса:

Тело запроса:

{
   // Номер строки начала получения данных
   startRow: 1;
   // Номер строки конца получения данных
   endRow: 100;
   // Не более 5000 записей на один вызов запроса

   // Фильтры
   filterModel: {};
   // Сортировка
   sortModel: [];
}

Тело ответа:

{
   // Номер строки начала получения данных
   startRow: 0;
   // Номер строки конца получения данных
   endRow: 100;
   // Фильтры, которые были установлены при запросе
   filterModel: {};
   // Сортировка, которая была установлена при запросе
   sortModel: [];
   // Кол-во строк в результирующем запросе без учета пагинации
   total: 42,
   // Массив данных
   data: [...{...}]
}

    
{
   // номер строки начала получения данных
   startRow: number,

   // номер строки конца получения данных
   endRow: number,

   // Не более 5000 записей на один вызов запроса

   ... // остальные параметры
}
    

{
    sortModel: [
        { colId: 'balance', sort: 'asc' },
        { colId: 'sales', sort: 'desc' },
    ],

    ... // остальные параметры

}

    
// текстовые фильтры используют след. модель
interface TextFilterModel {
    // равен 'text'
    filterType: string;

    // один из вариантов фильтра, например «равно»
    type: string;

    // текстовое значение, связанное с фильтром.
    // это необязательно, так как фильтры могут не иметь значения
    filter?: string;
}
    

    
// числовые фильтры используют след. модель
interface NumberFilterModel {
    // равен 'number'
    filterType: string;

    // один из вариантов фильтра, например «равно»
    type: string;

    // числовые значения
    // это необязательно, так как фильтры могут не иметь значения
    // фильтр диапазона имеет два значения (от и до).
    filter?: number;
    filterTo?: number;
}
    

    
// фильтры даты используют след. модель
interface NumberFilterModel {
    // равен 'date'
    filterType: string;

    // один из вариантов фильтра, например «равно»
    type: string;

    // текстовые значения
    // это необязательно, так как фильтры могут не иметь значения
    // тип - строка, а формат - всегда ГГГГ-ММ-ДД, например. 2019-05-24
    // фильтр диапазона имеет два значения (от и до).
    filter?: string;
    filterTo?: string;
}
    

    
//числовой фильтр с одним условием
balance: {
    filterType: 'number',
    type: 'lessThan',
    filter: 35
}
    

    
//числовой фильтр с одним условием и диапазоном
balance: {
    filterType: 'number',
    type: 'inRange',
    filter: 35,
    filterTo: 40
};
    

    
// Фильтр, объединяющий два условия
// M - это либо TextFilterModel, NumberFilterModel, либо DateFilterModel
interface ICombinedSimpleModel<M> {
    // тип фильтра: date, number or text
    filterType: string;

    // одно из условий 'AND' или 'OR'
    operator: string;

    // два экземпляра модели фильтра
    condition1: M;
    condition2: M;
}
    

    
balance: {
    filterType: 'number',
    operator: 'OR'
    condition1: {
        filterType: 'number',
        type: 'equals',
        filter: 18
    },
    condition2: {
        filterType: 'number',
        type: 'equals',
        filter: 19
    }
};
    

Пример запроса:

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

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

Категории

GET wb/get/similar/categories

Параметры запроса:

Пример запроса:

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

    ...,

   ]
    

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

Бренды

GET wb/get/similar/brands

Параметры запроса:

Пример запроса:

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

   ]
    

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

Продавцы

GET wb/get/similar/sellers

Параметры запроса:

Пример запроса:

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

   ]
    

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

По дням

GET wb/get/similar/by_date

Параметры запроса:

Пример запроса:

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

   ]
    

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

Товарная позиция (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"
        }
    ]
}
    

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

Продажи и остатки

GET wb/get/item/{sku}/sales

Параметры запроса:

Пример запроса:

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

]
    

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

Продажи и остатки за сутки

GET wb/get/item/{sku}/balance_by_day

Пример запроса:

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

]
    

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

История позиций по категориям

GET wb/get/item/{sku}/by_category

Параметры запроса:

Пример запроса:

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

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

История заказов и остатков по складам

GET wb/get/item/{sku}/orders_by_region

Параметры запроса:

Пример запроса:

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

    ...,

}
    

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

История заказов и остатков по размерам

GET wb/get/item/{sku}/orders_by_size

Параметры запроса:

Пример запроса:

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

        ...,

    },

    ...,

}
    

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

Похожие товары

Товары, которые отображаются в блоке Похожие товары на Wildberries (не только те товары, которые ВБ показывает как похожие на просматриваемый, но и «похожие на похожие»).

GET wb/get/item/{sku}/similar

Параметры запроса:

Пример запроса:

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

    ]

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

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

Товарные позиции (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"
            }
        ]
    },
    ...,
]
    

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