WB API эндпоинты

Все эндпоинты для работы с данными Wildberries через MPStats API.

Базовый URL: https://mpstats.io/api

Аутентификация: заголовок X-Mpstats-TOKEN: <ваш_токен>

Схемы поставок: параметр fbs=1 включает данные FBS (Fulfillment by Seller); по умолчанию — только FBO.

СПП — Скидка Постоянного Покупателя (клиентская скидка WB).

---

Краткий список всех эндпоинтов

Метод	Путь	Описание
GET	wb/get/categories	Дерево всех категорий
POST	wb/get/category	Товары в категории (пагинация)
GET	wb/get/category/subcategories	Статистика подкатегорий
GET	wb/get/category/brands	Бренды в категории
GET	wb/get/category/sellers	Продавцы в категории
GET	wb/get/category/trends	Тренд категории по месяцам
GET	wb/get/category/by_date	Категория по дням/неделям/месяцам
GET	wb/get/category/price_segmentation	Ценовая сегментация категории
POST	wb/get/category/compare	Сравнение периодов для категории
GET	wb/get/category/items	Предметы/подкатегории
GET	wb/get/ds/category/yhat	AI-прогноз продаж категории
GET	wb/get/ds/category/trend	AI-тренд категории
GET	wb/get/ds/category/annual	AI-сезонность года
GET	wb/get/ds/category/weekly	AI-сезонность недели
GET	wb/get/subjects/select	Список предметов
POST	wb/get/subject	Товары по предмету
GET	wb/get/subject/categories	Категории предмета
GET	wb/get/subject/brands	Бренды предмета
GET	wb/get/subject/sellers	Продавцы предмета
GET	wb/get/subject/trends	Тренд предмета
GET	wb/get/subject/by_date	Предмет по дням/неделям/месяцам
GET	wb/get/subject/price_segmentation	Ценовая сегментация предмета
POST	wb/get/subject/compare	Сравнение периодов для предмета
GET	wb/get/subject/by_keywords	Запросы/ключевые слова предмета
GET	wb/get/subject/geography	География заказов предмета
GET	wb/get/subject/similar	Похожие предметы
GET	wb/get/subjects/promotion-analysis	Анализ промо предмета
GET	wb/get/ds/subject/yhat	AI-прогноз предмета
GET	wb/get/ds/subject/trend	AI-тренд предмета
GET	wb/get/ds/subject/annual	AI-сезонность года (предмет)
GET	wb/get/ds/subject/weekly	AI-сезонность недели (предмет)
POST	wb/get/brand	Товары бренда
GET	wb/get/brand/categories	Категории бренда
GET	wb/get/brand/sellers	Продавцы бренда
GET	wb/get/brand/trends	Тренд бренда
GET	wb/get/brand/by_date	Бренд по дням/неделям/месяцам
GET	wb/get/brand/in_warehouses	Бренд по складам
GET	wb/get/brand/price_segmentation	Ценовая сегментация бренда
POST	wb/get/brand/compare	Сравнение периодов для бренда
GET	wb/get/brand/items	Предметы бренда
POST	wb/get/seller	Товары продавца
GET	wb/get/seller/categories	Категории продавца
GET	wb/get/seller/brands	Бренды продавца
GET	wb/get/seller/trends	Тренд продавца
GET	wb/get/seller/by_date	Продавец по дням/неделям/месяцам
GET	wb/get/seller/in_warehouses	Продавец по складам
GET	wb/get/seller/price_segmentation	Ценовая сегментация продавца
POST	wb/get/seller/compare	Сравнение периодов для продавца
GET	wb/get/seller/items	Предметы продавца
POST	wb/get/identical	Похожие товары AI (по пулу)
GET	wb/get/identical/categories	Категории похожих AI
GET	wb/get/identicial/brands	Бренды похожих AI
GET	wb/get/identicial/sellers	Продавцы похожих AI
GET	wb/get/identicial/price_segmentation	Ценовая сегментация похожих AI
POST	wb/get/similar	Похожие товары WB (по пулу)
GET	wb/get/similar/categories	Категории похожих WB
GET	wb/get/similar/brands	Бренды похожих WB
GET	wb/get/similar/sellers	Продавцы похожих WB
GET	wb/get/similar/price_segmentation	Ценовая сегментация похожих WB
GET	wb/get/in_similar	Товары, в похожих которых встречается SKU
GET	wb/get/in_similar/categories	Категории пула «в похожих»
GET	wb/get/in_similar/brands	Бренды пула «в похожих»
GET	wb/get/in_similar/sellers	Продавцы пула «в похожих»
GET	wb/get/in_similar/price_segmentation	Ценовая сегментация «в похожих»
GET	wb/get/item/{sku}/sales	История продаж и остатков SKU
GET	wb/get/item/{sku}/balance_by_day	Продажи и остатки за сутки
GET	wb/get/item/{sku}/balance_by_region	Остатки по складам
GET	wb/get/item/{sku}/balance_by_size	Остатки по размерам
GET	wb/get/item/{sku}/sales_by_region	Продажи по складам
GET	wb/get/item/{sku}/sales_by_size	Продажи по размерам
GET	wb/get/item/{sku}/identical	Похожие товары AI для SKU
GET	wb/get/item/{sku}/identical_wb	Похожие товары WB AI для SKU
GET	wb/get/item/{sku}/similar	Похожие товары WB для SKU
GET	wb/get/item/{sku}/in_similar	Товары, в блоке похожих которых есть данный SKU
GET	wb/get/item/{sku}/by_category	Категории и позиции SKU в них
GET	wb/get/item/{sku}/by_keywords	Запросы и позиции SKU по ключевым словам
GET	wb/get/item/{sku}/full_page/versions	Список версий карточки
GET	wb/get/item/{sku}/full_page	Данные карточки по версии
GET	wb/get/item/{sku}/comments	История отзывов SKU

---

Рубрикатор

Дерево категорий

GET /api/wb/get/categories

Возвращает полное дерево категорий Wildberries.

Параметры: нет.

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

curl "https://mpstats.io/api/wb/get/categories" \
  -H "X-Mpstats-TOKEN: YOUR_TOKEN" \
  -H "Content-Type: application/json"

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

[
  {
    "name": "Женщинам",
    "url": "https://www.wildberries.ru/catalog/zhenshchinam/odezhda",
    "childs": [
      {
        "name": "Одежда",
        "url": "...",
        "childs": [...]
      }
    ]
  }
]

---

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

Для всех эндпоинтов этого раздела параметр path — строка пути категории, например "Одежда/Женская одежда/Платья".

Товары в категории

POST /api/wb/get/category

Получить список товаров в категории с полной аналитикой. Поддерживает пагинацию, фильтрацию и сортировку.

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

Параметр	Тип	Обязательный	Описание
path	string	Да	Путь категории (напр. "Одежда/Женская одежда/Платья")
d1	string	Да	Начальная дата (YYYY-MM-DD)
d2	string	Да	Конечная дата (YYYY-MM-DD)
startRow	int	Нет	Начальная строка пагинации (default: 0)
endRow	int	Нет	Конечная строка (default: 5000)
filterModel	object	Нет	Фильтры по полям
sortModel	array	Нет	Сортировка
fbs	int	Нет	0 = FBO (default), 1 = FBS

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

curl -X POST "https://mpstats.io/api/wb/get/category" \
  -H "X-Mpstats-TOKEN: YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "path": "Одежда/Женская одежда/Платья",
    "d1": "2026-01-01",
    "d2": "2026-02-01",
    "startRow": 0,
    "endRow": 100,
    "sortModel": [{"colId": "revenue", "sort": "desc"}]
  }'

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

{
  "data": [
    {
      "id": 148471993,
      "name": "Леггинсы утепленные в рубчик",
      "brand": "Oscar Cordoba",
      "seller": "ИП Иванов",
      "supplier_id": 12345,
      "color": "черный",
      "balance": 2675,
      "balance_fbs": 0,
      "comments": 31177,
      "rating": 5,
      "final_price": 1080,
      "final_price_max": 1095,
      "final_price_min": 1080,
      "final_price_average": 1090,
      "final_price_median": 1090,
      "basic_sale": 27,
      "basic_price": 1080,
      "promo_sale": 0,
      "client_sale": 21,
      "client_price": 853,
      "start_price": 1480,
      "sales": 7560,
      "sales_per_day_average": 244,
      "revenue": 8240400,
      "revenue_potential": 8240400,
      "revenue_average": 274680,
      "lost_profit": 0,
      "lost_profit_percent": 0,
      "days_in_stock": 30,
      "days_with_sales": 30,
      "average_if_in_stock": 244,
      "is_fbs": 0,
      "subject_id": 566,
      "subject": "Леггинсы",
      "purchase": 92,
      "purchase_after_return": 92,
      "country": "Россия",
      "gender": "Женский",
      "sku_first_date": "2021-09-01",
      "firstcommentdate": "2021-10-15",
      "picscount": 9,
      "has3d": 0,
      "hasvideo": 1,
      "commentsvaluation": 4.9,
      "cardratingval": 85,
      "categories_last_count": 8,
      "category": "Женщинам/Брюки/Леггинсы",
      "category_position": 3,
      "graph": [520, 699, 1061, 1113, 1088, 1001, 1078],
      "stocks_graph": [2675, 3180, 3848, 4874, 5949, 7011, 6359],
      "price_graph": [1080, 1095, 1095, 1095, 1095, 1095, 1095],
      "thumb": "//basket-01.wb.ru/vol148/part14847/148471993/images/c246x328/1.jpg",
      "thumb_middle": "//basket-01.wb.ru/vol148/part14847/148471993/images/c516x688/1.jpg",
      "url": "https://www.wildberries.ru/catalog/148471993/detail.aspx",
      "turnover_days": 10.9,
      "turnover_once": 2.74
    }
  ],
  "total": 15420,
  "startRow": 0,
  "endRow": 100,
  "filterModel": [],
  "sortModel": [{"sort": "desc", "colId": "revenue"}]
}

Описание полей товара:

Поле	Тип	Описание
id	number	Артикул WB
name	text	Название товара
brand	text	Бренд
seller	text	Продавец
supplier_id	number	ID продавца
color	text	Цвет
balance	number	Остаток (последний зафиксированный)
balance_fbs	number	Остаток FBS
comments	number	Количество отзывов
rating	number	Рейтинг
final_price	number	Текущая цена (со скидкой)
final_price_max	number	Максимальная цена за период
final_price_min	number	Минимальная цена за период
final_price_average	number	Средняя цена (выручка / продажи)
final_price_median	number	Медианная цена
basic_sale	number	Размер скидки, %
basic_price	number	Цена после скидки
promo_sale	number	Скидка по промокоду, %
client_sale	number	СПП, %
client_price	number	Цена с СПП
start_price	number	Базовая цена (без скидок)
sales	number	Продажи за период
sales_per_day_average	number	Среднее продаж в день
revenue	number	Выручка
revenue_potential	number	Потенциал выручки
revenue_average	number	Средняя выручка в день
lost_profit	number	Упущенная выручка
lost_profit_percent	number	Упущенная выручка, %
days_in_stock	number	Дней в наличии
days_with_sales	number	Дней с продажами
average_if_in_stock	number	Среднее продаж при наличии
is_fbs	number	Поставляется по FBS
subject_id	number	ID предмета
subject	text	Предмет
purchase	number	Процент выкупа
purchase_after_return	number	Процент выкупа с учётом возвратов
country	text	Страна производства
gender	text	Пол
sku_first_date	date	Дата первого обнаружения
firstcommentdate	date	Дата первого отзыва
picscount	number	Количество фото
has3d	number	Есть 3D фото
hasvideo	number	Есть видео
commentsvaluation	number	Рейтинг карточки (дробный)
cardratingval	number	Рейтинг по версии MPStats
categories_last_count	number	Количество категорий (последних)
category	text	Категория на последнюю дату
category_position	number	Позиция в категории
product_visibility_graph	array	График видимости по ключевым запросам
category_graph	array	График количества категорий
graph	array	График продаж
stocks_graph	array	График остатков
price_graph	array	График цены
thumb	text	Фото (246x328)
thumb_middle	text	Фото (516x688)
url	text	Ссылка на WB
turnover_days	number	Оборачиваемость (дни)
turnover_once	number	Оборачиваемость (разы/день)

Пагинация (Python-пример для получения всех товаров):

import httpx

all_items = []
start = 0
batch = 5000

while True:
    resp = httpx.post(
        "https://mpstats.io/api/wb/get/category",
        headers={"X-Mpstats-TOKEN": TOKEN},
        json={
            "path": "Одежда/Женская одежда/Платья",
            "d1": "2026-01-01",
            "d2": "2026-02-01",
            "startRow": start,
            "endRow": start + batch
        }
    )
    data = resp.json().get("data", [])
    if not data:
        break
    all_items.extend(data)
    start += batch

print(f"Всего товаров: {len(all_items)}")

Фильтрация и сортировка:

{
  "filterModel": {
    "final_price": {"type": "greaterThan", "filter": 1000},
    "sales": {"type": "greaterThan", "filter": 10}
  },
  "sortModel": [
    {"colId": "revenue", "sort": "desc"}
  ]
}

---

Статистика подкатегорий

GET /api/wb/get/category/subcategories

Query-параметры:

Параметр	Тип	Обязательный	Описание
path	string	Да	Путь категории
d1	string	Да	Начальная дата
d2	string	Да	Конечная дата
fbs	int	Нет	FBS-схема

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

curl "https://mpstats.io/api/wb/get/category/subcategories?path=Одежда%2FЖенская+одежда&d1=2026-01-01&d2=2026-02-01" \
  -H "X-Mpstats-TOKEN: YOUR_TOKEN"

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

[
  {
    "name": "Платья",
    "items": 45210,
    "items_with_sells": 38400,
    "brands": 3200,
    "sellers": 8900,
    "sales": 1250000,
    "revenue": 3780000000,
    "avg_price": 3024,
    "comments": 120,
    "rating": 4.7
  }
]

---

Бренды в категории

GET /api/wb/get/category/brands

Query-параметры: path, d1, d2, fbs.

Пример:

curl "https://mpstats.io/api/wb/get/category/brands?path=Одежда%2FЖенская+одежда%2FПлатья&d1=2026-01-01&d2=2026-02-01" \
  -H "X-Mpstats-TOKEN: YOUR_TOKEN"

Ответ: массив объектов бренда с полями name, items, items_with_sells, sellers, sales, revenue, avg_price, comments, rating, position, graph.

---

Продавцы в категории

GET /api/wb/get/category/sellers

Тариф

Доступен на тарифе «Профессиональный».

Query-параметры: path, d1, d2, fbs.

Ответ: массив продавцов с полями name, supplier_id, items, items_with_sells, brands, sales, revenue, avg_price, rating, position, graph.

---

Тренд категории

GET /api/wb/get/category/trends

Query-параметры:

Параметр	Тип	Обязательный	Описание
path	string	Да	Путь категории
d1	string	Да	Начальная дата
d2	string	Да	Конечная дата
fbs	int	Нет	FBS-схема
view	string	Нет	itemsInCategory (default) или category

Ответ: массив объектов {name, items, items_with_sells, sellers, sales, revenue, avg_price, ...} по месяцам.

---

Данные по дням/неделям/месяцам

GET /api/wb/get/category/by_date

Query-параметры:

Параметр	Тип	Обязательный	Описание
path	string	Да	Путь категории
d1	string	Да	Начальная дата
d2	string	Да	Конечная дата
fbs	int	Нет	FBS-схема
groupBy	string	Нет	day (default), week, month

Ответ: массив временных точек с метриками.

---

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

GET /api/wb/get/category/price_segmentation

Query-параметры:

Параметр	Тип	Обязательный	Описание
path	string	Да	Путь категории
d1	string	Да	Начальная дата
d2	string	Да	Конечная дата
fbs	int	Нет	FBS-схема
minPrice	number	Нет	Минимальная цена диапазона
maxPrice	number	Нет	Максимальная цена диапазона
segmentsCnt	number	Нет	Количество сегментов (макс. 25)
spp	int	Нет	1 = с учётом СПП

Пример:

curl "https://mpstats.io/api/wb/get/category/price_segmentation?path=Одежда%2FЖенская+одежда%2FПлатья&d1=2026-01-01&d2=2026-02-01&segmentsCnt=10&spp=1" \
  -H "X-Mpstats-TOKEN: YOUR_TOKEN"

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

[
  {
    "range": "1000-1500",
    "items": 3200,
    "items_with_sells": 2800,
    "brands": 450,
    "brands_with_sells": 410,
    "sellers": 1200,
    "sellers_with_sells": 1050,
    "revenue": 980000000,
    "sales": 350000,
    "product_revenue": 306250,
    "min_range_price": 1000,
    "max_range_price": 1500,
    "revenue_potential": 1100000000,
    "lost_profit": 120000000,
    "lost_profit_percent": 10
  }
]

Поля ответа:

Поле	Тип	Описание
range	text	Диапазон цен
items	number	Число товаров
items_with_sells	number	Товаров с продажами
brands	number	Количество брендов
brands_with_sells	number	Брендов с продажами
sellers	number	Количество продавцов
sellers_with_sells	number	Продавцов с продажами
revenue	number	Выручка
sales	number	Единиц продано
product_revenue	number	Выручка / количество товаров
min_range_price	number	Начало диапазона
max_range_price	number	Конец диапазона
revenue_potential	number	Потенциал выручки
lost_profit	number	Упущенная прибыль
lost_profit_percent	number	Упущенная прибыль, %

---

Сравнение периодов для категории

POST /api/wb/get/category/compare

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

{
  "path": "Одежда/Женская одежда/Платья",
  "d11": "2025-12-01",
  "d12": "2025-12-31",
  "d21": "2026-01-01",
  "d22": "2026-01-31",
  "fbs": 0
}

Ответ: объект со сравнением метрик двух периодов.

---

Предметы/Подкатегории категории

GET /api/wb/get/category/items

Query-параметры: path, d1, d2, fbs.

Ответ: список предметов внутри категории со статистикой.

---

AI-прогноз категории

GET /api/wb/get/ds/category/yhat
GET /api/wb/get/ds/category/trend
GET /api/wb/get/ds/category/annual
GET /api/wb/get/ds/category/weekly

Query-параметры: path, d1, d2 (yhat); path, period=month12|month3 (trend); path, d1, d2, period=day|week|month (annual); path, d1, d2 (weekly).

Прогнозы основаны на модели Facebook Prophet.

---

Выбор ниши / Предметы

Для всех эндпоинтов этого раздела параметр path — числовой ID предмета (subject_id).

Список предметов

GET /api/wb/get/subjects/select

Возвращает список всех предметов с аналитикой за последние 30 дней.

Query-параметры:

Параметр	Тип	Обязательный	Описание
date	string	Да	Дата (YYYY-MM-DD)

Пример:

curl "https://mpstats.io/api/wb/get/subjects/select?date=2026-02-01" \
  -H "X-Mpstats-TOKEN: YOUR_TOKEN"

Ответ: массив предметов с полями id, name, items, items_with_sells, brands, sellers, sales, revenue, avg_price, comments, rating.

---

Товары по предмету

POST /api/wb/get/subject

Структура запроса и ответа аналогична POST /api/wb/get/category, но path — числовой ID предмета.

Пример:

curl -X POST "https://mpstats.io/api/wb/get/subject" \
  -H "X-Mpstats-TOKEN: YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "path": 566,
    "d1": "2026-01-01",
    "d2": "2026-02-01",
    "startRow": 0,
    "endRow": 100
  }'

---

Категории предмета

GET /api/wb/get/subject/categories

Query-параметры:

Параметр	Тип	Обязательный	Описание
path	int	Да	ID предмета
d1	string	Да	Начальная дата
d2	string	Да	Конечная дата
fbs	int	Нет	FBS-схема
includePromo	int	Нет	1 = включая промо-категории

---

Бренды предмета

GET /api/wb/get/subject/brands

Query-параметры: path, d1, d2, fbs.

---

Продавцы предмета

GET /api/wb/get/subject/sellers

Тариф

Доступен на тарифе «Профессиональный».

Query-параметры: path, d1, d2, fbs.

---

Тренд предмета

GET /api/wb/get/subject/trends

Query-параметры: path, d1, d2, fbs, view.

---

Данные предмета по дням/неделям/месяцам

GET /api/wb/get/subject/by_date

Query-параметры: path, d1, d2, fbs, groupBy.

---

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

GET /api/wb/get/subject/price_segmentation

Query-параметры: path, d1, d2, fbs, minPrice, maxPrice, segmentsCnt, spp.

Структура ответа аналогична ценовой сегментации категории.

---

Сравнение периодов для предмета

POST /api/wb/get/subject/compare

Тело: path (ID предмета), d11, d12, d21, d22, fbs.

---

Запросы/Ключевые слова предмета

GET /api/wb/get/subject/by_keywords

Query-параметры: path, d1, d2.

Ответ: список поисковых запросов с частотами и метриками позиций.

---

География заказов предмета

GET /api/wb/get/subject/geography

Query-параметры: path, d1, d2, fbs.

Ответ: данные по регионам и складам.

---

Похожие предметы

GET /api/wb/get/subject/similar

Query-параметры: path, d1, d2.

---

Анализ промо предмета

GET /api/wb/get/subjects/promotion-analysis

Query-параметры: path, d1, d2.

---

AI-прогнозы предмета

GET /api/wb/get/ds/subject/yhat
GET /api/wb/get/ds/subject/trend
GET /api/wb/get/ds/subject/annual
GET /api/wb/get/ds/subject/weekly

Query-параметры: аналогично AI-прогнозам для категорий, path = ID предмета.

---

Бренды

Для всех эндпоинтов этого раздела параметр path — строка названия бренда.

Товары бренда

POST /api/wb/get/brand

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

Параметр	Тип	Обязательный	Описание
path	string	Да	Название бренда
d1	string	Да	Начальная дата
d2	string	Да	Конечная дата
startRow	int	Нет	Пагинация: начальная строка
endRow	int	Нет	Пагинация: конечная строка
fbs	int	Нет	FBS-схема
newsmode	int	Нет	7, 14 или 30 — новинки за N дней

Пример:

curl -X POST "https://mpstats.io/api/wb/get/brand" \
  -H "X-Mpstats-TOKEN: YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "path": "Nike",
    "d1": "2026-01-01",
    "d2": "2026-02-01",
    "startRow": 0,
    "endRow": 100
  }'

Ответ: аналогично POST /api/wb/get/category — объект с полями data, total, startRow, endRow.

---

Категории бренда

GET /api/wb/get/brand/categories

Query-параметры: path, d1, d2, fbs.

---

Продавцы бренда

GET /api/wb/get/brand/sellers

Query-параметры: path, d1, d2, fbs.

---

Тренд бренда

GET /api/wb/get/brand/trends

Query-параметры: path, d1, d2, fbs, view.

---

Данные бренда по дням/неделям/месяцам

GET /api/wb/get/brand/by_date

Query-параметры: path, d1, d2, fbs, groupBy.

---

Бренд по складам

GET /api/wb/get/brand/in_warehouses

Query-параметры: path, d1, d2, fbs.

Ответ: разбивка остатков и продаж по складам WB.

---

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

GET /api/wb/get/brand/price_segmentation

Query-параметры: path, d1, d2, fbs, minPrice, maxPrice, segmentsCnt, spp.

---

Сравнение периодов для бренда

POST /api/wb/get/brand/compare

Тело: path (название бренда), d11, d12, d21, d22, fbs.

---

Предметы бренда

GET /api/wb/get/brand/items

Query-параметры: path, d1, d2, fbs.

---

Продавцы

Для всех эндпоинтов этого раздела параметр path — строка названия продавца.

Тариф

Большинство эндпоинтов раздела «Продавцы» доступны на тарифах «Профессиональный» и «Корпоративный».

Товары продавца

POST /api/wb/get/seller

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

Параметр	Тип	Обязательный	Описание
path	string	Да	Название продавца
d1	string	Да	Начальная дата
d2	string	Да	Конечная дата
startRow	int	Нет	Пагинация: начальная строка
endRow	int	Нет	Пагинация: конечная строка
fbs	int	Нет	FBS-схема
newsmode	int	Нет	Новинки за N дней (7, 14, 30)

Пример:

curl -X POST "https://mpstats.io/api/wb/get/seller" \
  -H "X-Mpstats-TOKEN: YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "path": "ООО Ромашка",
    "d1": "2026-01-01",
    "d2": "2026-02-01",
    "startRow": 0,
    "endRow": 100
  }'

Ответ: аналогично категории — объект с data, total, startRow, endRow.

---

Категории продавца

GET /api/wb/get/seller/categories

Query-параметры: path, d1, d2, fbs.

---

Бренды продавца

GET /api/wb/get/seller/brands

Query-параметры: path, d1, d2, fbs.

---

Тренд продавца

GET /api/wb/get/seller/trends

Query-параметры: path, d1, d2, fbs, view.

---

Данные продавца по дням/неделям/месяцам

GET /api/wb/get/seller/by_date

Query-параметры: path, d1, d2, fbs, groupBy.

---

Продавец по складам

GET /api/wb/get/seller/in_warehouses

Query-параметры: path, d1, d2, fbs.

---

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

GET /api/wb/get/seller/price_segmentation

Query-параметры: path, d1, d2, fbs, minPrice, maxPrice, segmentsCnt, spp.

---

Сравнение периодов для продавца

POST /api/wb/get/seller/compare

Тело: path (название продавца), d11, d12, d21, d22, fbs.

---

Предметы продавца

GET /api/wb/get/seller/items

Query-параметры: path, d1, d2, fbs.

---

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

Эндпоинты этого раздела принимают path = SKU товара или URL карточки на WB.

Общие поля ответа «пулов»

Следующие эндпоинты (POST wb/get/identical, POST wb/get/similar) возвращают список товаров со стандартной схемой (см. поля в разделе «Товары в категории»). Также у каждого пула есть дочерние эндпоинты для агрегированной статистики (categories, brands, sellers, price_segmentation).

---

Похожие товары AI (по пулу)

POST /api/wb/get/identical

AI-определённые похожие товары для указанного SKU или группы SKU.

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

Параметр	Тип	Обязательный	Описание
path	string	Да	SKU или URL товара
d1	string	Да	Начальная дата
d2	string	Да	Конечная дата
startRow	int	Нет	Пагинация
endRow	int	Нет	Пагинация
fbs	int	Нет	FBS-схема

Пример:

curl -X POST "https://mpstats.io/api/wb/get/identical" \
  -H "X-Mpstats-TOKEN: YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"path": "148471993", "d1": "2026-01-01", "d2": "2026-02-01"}'

Ответ: объект с data (массив товаров), total, startRow, endRow. Каждый товар имеет все стандартные поля плюс distance — степень схожести (0–100).

---

Категории / Бренды / Продавцы / Ценовая сегментация похожих AI

GET /api/wb/get/identical/categories
GET /api/wb/get/identicial/brands
GET /api/wb/get/identicial/sellers
GET /api/wb/get/identicial/price_segmentation

Написание URL

В официальном API присутствует опечатка: /identical/categories (правильно) против /identicial/brands (с опечаткой). Используйте URLs точно как указано выше.

Query-параметры: path, d1, d2, fbs (для price_segmentation дополнительно: minPrice, maxPrice, segmentsCnt, spp).

Ответ для /categories:

[
  {
    "name": "Женщинам/Брюки/Леггинсы",
    "items": 450,
    "items_with_sells": 380,
    "items_with_sells_percent": 84.4,
    "brands": 120,
    "brands_with_sells": 105,
    "brands_with_sells_percent": 87.5,
    "sellers": 280,
    "sellers_with_sells": 240,
    "sellers_with_sells_percent": 85.7,
    "sales_per_items_average": 320,
    "sales_per_items_with_sells_average": 378,
    "sales": 143640,
    "revenue": 156647880,
    "revenue_per_items_average": 348106,
    "revenue_per_items_with_sells_average": 412231,
    "avg_price": 1090,
    "comments": 1850,
    "rating": 4.8
  }
]

---

Похожие товары WB (по пулу)

POST /api/wb/get/similar

Товары из блока «Похожие товары» на WB для указанного SKU.

Тело запроса: аналогично POST /api/wb/get/identical.

Ответ: аналогично — массив товаров с полной схемой.

---

Категории / Бренды / Продавцы / Ценовая сегментация похожих WB

GET /api/wb/get/similar/categories
GET /api/wb/get/similar/brands
GET /api/wb/get/similar/sellers
GET /api/wb/get/similar/price_segmentation

Query-параметры: path, d1, d2, fbs.

---

Товары, в похожих которых встречается SKU

GET /api/wb/get/in_similar

Показывает товары, в блоке «Похожие» которых присутствует данный SKU.

Query-параметры:

Параметр	Тип	Обязательный	Описание
path	string	Да	SKU или URL
d1	string	Нет	Начальная дата
d2	string	Нет	Конечная дата
fbs	int	Нет	FBS-схема
startRow	int	Нет	Пагинация
endRow	int	Нет	Пагинация

Пример:

curl "https://mpstats.io/api/wb/get/in_similar?path=148471993&d1=2026-01-01&d2=2026-02-01" \
  -H "X-Mpstats-TOKEN: YOUR_TOKEN"

Ответ: объект с data (массив товаров со стандартной схемой), total, startRow, endRow.

---

Категории / Бренды / Продавцы / Ценовая сегментация пула «в похожих»

GET /api/wb/get/in_similar/categories
GET /api/wb/get/in_similar/brands
GET /api/wb/get/in_similar/sellers
GET /api/wb/get/in_similar/price_segmentation

Query-параметры: path, d1, d2, fbs (для price_segmentation дополнительно: minPrice, maxPrice, segmentsCnt, spp).

Пример:

curl "https://mpstats.io/api/wb/get/in_similar/categories?d1=2023-11-19&d2=2023-11-25&path=72124874&fbs=1" \
  -H "X-Mpstats-TOKEN: YOUR_TOKEN"

Пример ответа /in_similar/categories:

[
  {
    "name": "Мужчинам/Белье/Трусы",
    "items": 22,
    "items_with_sells": 22,
    "items_with_sells_percent": 100,
    "brands": 15,
    "brands_with_sells": 15,
    "brands_with_sells_percent": 100,
    "sellers": 19,
    "sellers_with_sells": 19,
    "sellers_with_sells_percent": 100,
    "sales_per_items_average": 2503.1,
    "sales_per_items_with_sells_average": 2503.1,
    "sales": 55069,
    "revenue": 41666185,
    "revenue_per_items_average": 1893917,
    "revenue_per_items_with_sells_average": 1893917,
    "avg_price": 731,
    "comments": 14223,
    "rating": 5
  }
]

Поля ответа (категории/бренды/продавцы):

Поле	Тип	Описание
name	text	Название
items	number	Число товаров
items_with_sells	number	Товаров с продажами
items_with_sells_percent	number	Товаров с продажами, %
brands	number	Количество брендов
brands_with_sells	number	Брендов с продажами
brands_with_sells_percent	number	Брендов с продажами, %
sellers	number	Количество продавцов
sellers_with_sells	number	Продавцов с продажами
sellers_with_sells_percent	number	Продавцов с продажами, %
sales	number	Продажи
revenue	number	Выручка
sales_per_items_average	number	Продаж на товар (среднее)
sales_per_items_with_sells_average	number	Продаж на товар с продажами
revenue_per_items_average	number	Выручка на товар
revenue_per_items_with_sells_average	number	Выручка на товар с продажами
avg_price	number	Средняя цена
comments	number	Среднее отзывов
rating	number	Средний рейтинг
position	number	Позиция в топе (только бренды/продавцы)
graph	array	График продаж (только бренды/продавцы)
supplier_id	number	ID продавца (только продавцы)

---

Товарная позиция (SKU)

Все эндпоинты этого раздела принимают артикул WB в пути URL: wb/get/item/{sku}/...

История продаж и остатков

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

Ежедневная история продаж, остатков, цен и видимости SKU.

Query-параметры:

Параметр	Тип	Обязательный	Описание
d1	string	Нет	Начальная дата
d2	string	Нет	Конечная дата
fbs	int	Нет	FBS-схема

Пример:

curl "https://mpstats.io/api/wb/get/item/148471993/sales?d1=2026-01-01&d2=2026-02-01&fbs=1" \
  -H "X-Mpstats-TOKEN: YOUR_TOKEN"

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

[
  {
    "no_data": 0,
    "data": "2023-12-01",
    "balance": "2675",
    "sales": 520,
    "rating": 5,
    "price": 1480,
    "final_price": 1080,
    "is_new": 0,
    "comments": 31177,
    "discount": 27,
    "basic_sale": 27,
    "basic_price": 1080,
    "promo_sale": 0,
    "client_sale": 21,
    "client_price": 853,
    "categories_cnt": "8",
    "visibility": 1291,
    "position": 22
  }
]

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

Поле	Тип	Описание
no_data	number	0 = OK, 1 = нет данных
data	date	Дата
balance	number	Остаток
sales	number	Продажи
rating	number	Рейтинг
price	number	Цена
final_price	number	Цена со скидкой
is_new	number	Новинка
comments	number	Отзывов
discount	number	Скидка
basic_sale	number	Базовая скидка
basic_price	number	Цена после скидки
promo_sale	number	Скидка по промокоду
client_sale	number	СПП
client_price	number	Итоговая цена с СПП
categories_cnt	number	Число категорий
visibility	number	Запросов, по которым товар на первой странице
position	number	Средняя позиция по запросам

---

Продажи и остатки за сутки (почасово)

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

Почасовые данные за конкретный день.

Query-параметры:

Параметр	Тип	Обязательный	Описание
d	string	Да	Дата (YYYY-MM-DD)

Пример:

curl "https://mpstats.io/api/wb/get/item/148471993/balance_by_day?d=2026-01-15" \
  -H "X-Mpstats-TOKEN: YOUR_TOKEN"

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

[
  {
    "tm": "02:31",
    "comments": 30829,
    "rating": 5,
    "balance": 3159,
    "balancefbs": 0,
    "sales": 21,
    "salesfbs": 0,
    "price": 1480,
    "final_price": 1095
  }
]

Поля: tm (время), comments, rating, balance, balancefbs, sales, salesfbs, price, final_price.

---

Остатки по складам

GET /api/wb/get/item/{sku}/balance_by_region

Query-параметры:

Параметр	Тип	Обязательный	Описание
d	string	Да	Дата (YYYY-MM-DD)
fbs	int	Нет	FBS-схема

Пример:

curl "https://mpstats.io/api/wb/get/item/148471993/balance_by_region?d=2026-01-15" \
  -H "X-Mpstats-TOKEN: YOUR_TOKEN"

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

[
  {"store": "Электросталь WB", "balance": 1879},
  {"store": "Алексин WB", "balance": 791},
  {"store": "Коледино WB", "balance": 2}
]

---

Остатки по размерам

GET /api/wb/get/item/{sku}/balance_by_size

Query-параметры:

Параметр	Тип	Обязательный	Описание
d	string	Да	Дата (YYYY-MM-DD)
fbs	int	Нет	FBS-схема

Пример:

curl "https://mpstats.io/api/wb/get/item/148471993/balance_by_size?d=2026-01-15" \
  -H "X-Mpstats-TOKEN: YOUR_TOKEN"

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

[
  {"size_name": "40-42", "size_origin": "S", "balance": 2671},
  {"size_name": "42-44", "size_origin": "M", "balance": 3},
  {"size_name": "44-46", "size_origin": "L", "balance": 1}
]

Поля: size_name (размер), size_origin (размер поставщика), balance (остаток).

---

Продажи по складам

GET /api/wb/get/item/{sku}/sales_by_region

Query-параметры:

Параметр	Тип	Обязательный	Описание
d1	string	Нет	Начальная дата
d2	string	Нет	Конечная дата
fbs	int	Нет	FBS-схема

Пример:

curl "https://mpstats.io/api/wb/get/item/148471993/sales_by_region?d1=2026-01-01&d2=2026-02-01" \
  -H "X-Mpstats-TOKEN: YOUR_TOKEN"

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

[
  {"store": "Алексин WB", "sales": 4749},
  {"store": "Электросталь WB", "sales": 1338},
  {"store": "Коледино WB", "sales": 1118}
]

---

Продажи по размерам

GET /api/wb/get/item/{sku}/sales_by_size

Query-параметры: d1, d2, fbs.

Пример:

curl "https://mpstats.io/api/wb/get/item/148471993/sales_by_size?d1=2026-01-01&d2=2026-02-01" \
  -H "X-Mpstats-TOKEN: YOUR_TOKEN"

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

[
  {"size_name": "42-44", "size_origin": "M", "sales": 2853},
  {"size_name": "40-42", "size_origin": "S", "sales": 2278},
  {"size_name": "44-46", "size_origin": "L", "sales": 1780}
]

---

Похожие товары AI для SKU

GET /api/wb/get/item/{sku}/identical

AI-определённые похожие товары непосредственно для данного SKU.

Query-параметры:

Параметр	Тип	Обязательный	Описание
d1	string	Нет	Начальная дата
d2	string	Нет	Конечная дата
fbs	int	Нет	FBS-схема

Пример:

curl "https://mpstats.io/api/wb/get/item/126951/identical?d1=2026-01-01&d2=2026-02-01&fbs=1" \
  -H "X-Mpstats-TOKEN: YOUR_TOKEN"

Ответ: массив товаров с полной схемой (см. поля в разделе «Товары в категории»). Дополнительное поле:

Поле	Тип	Описание
distance	number	Степень схожести товаров (0–100)
warehouses_count	number	Количество складов

---

Похожие товары WB AI для SKU

GET /api/wb/get/item/{sku}/identical_wb

Похожие товары, определённые алгоритмом WB, с аналитикой MPStats.

Query-параметры: d1, d2, fbs.

Пример:

curl "https://mpstats.io/api/wb/get/item/126951/identical_wb?d1=2026-01-01&d2=2026-02-01&fbs=1" \
  -H "X-Mpstats-TOKEN: YOUR_TOKEN"

Ответ: массив товаров с полной схемой плюс поле warehouses_count.

---

Похожие товары WB для SKU

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

Товары из блока «Похожие товары» WB для данного SKU.

Query-параметры: d1, d2, fbs.

Пример:

curl "https://mpstats.io/api/wb/get/item/126951/similar?d1=2026-01-01&d2=2026-02-01&fbs=1" \
  -H "X-Mpstats-TOKEN: YOUR_TOKEN"

Ответ: массив товаров с полной схемой плюс warehouses_count.

---

Товары, в блоке похожих которых есть данный SKU

GET /api/wb/get/item/{sku}/in_similar

Query-параметры: d1, d2, fbs.

Пример:

curl "https://mpstats.io/api/wb/get/item/126951/in_similar?d1=2026-01-01&d2=2026-02-01&fbs=1" \
  -H "X-Mpstats-TOKEN: YOUR_TOKEN"

Ответ: массив товаров с полной схемой плюс warehouses_count.

---

Категории и позиции SKU в них

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

История позиций товара по каждой категории, в которой он присутствовал.

Query-параметры:

Параметр	Тип	Обязательный	Описание
d1	string	Нет	Начальная дата
d2	string	Нет	Конечная дата

Пример:

curl "https://mpstats.io/api/wb/get/item/148471993/by_category?d1=2026-01-01&d2=2026-02-01" \
  -H "X-Mpstats-TOKEN: YOUR_TOKEN"

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

{
  "categories": {
    "Женщинам/Брюки/Леггинсы": {
      "auto": [0, 0, 0, 0, 0, 0, 0],
      "pos": [0, 0, 77, 43, 77, 59, 45]
    },
    "Спорт/Для женщин/Одежда/Брюки и шорты/Леггинсы": {
      "auto": [0, 0, 0, 0, 0, 0, 0],
      "pos": [0, 0, 58, 52, 15, 80, 40]
    }
  },
  "days": ["01.01", "02.01", "03.01", "04.01", "05.01", "06.01", "07.01"],
  "sales": [1078, 1001, 1088, 1113, 1061, 699, 520],
  "balance": [6359, 7011, 5949, 4874, 3848, 3180, 2675],
  "final_price": [1095, 1095, 1095, 1095, 1095, 1095, 1080]
}

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

Поле	Тип	Описание
categories	object	Словарь {путь_категории: {auto, pos}}
auto	array	Позиция при авторекламе по дням
pos	array	Позиция в категории по дням
days	array	Даты (ДД.ММ)
sales	array	Продажи по дням
balance	array	Остатки по дням
final_price	array	Цена на конец дня

---

Запросы и позиции SKU по ключевым словам

GET /api/wb/get/item/{sku}/by_keywords

Позиции товара по каждому поисковому запросу.

Query-параметры:

Параметр	Тип	Обязательный	Описание
d1	string	Нет	Начальная дата
d2	string	Нет	Конечная дата

Пример:

curl "https://mpstats.io/api/wb/get/item/148471993/by_keywords?d1=2026-01-01&d2=2026-02-01" \
  -H "X-Mpstats-TOKEN: YOUR_TOKEN"

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

{
  "words": {
    "леггинсы в рубчик женские": {
      "pos": [47, 63, 0, 2, 2, 5, 1],
      "auto": [0, 0, 0, 0, 0, 0, 0],
      "count": 0,
      "wb_count": 2330,
      "total": 2453,
      "avgPos": 20,
      "norm_query": "в_рубчик для_женщина леггинсы"
    }
  },
  "days": ["01.01", "02.01", "03.01", "04.01", "05.01", "06.01", "07.01"],
  "sales": [1078, 1001, 1088, 1113, 1061, 699, 520],
  "balance": [6359, 7011, 5949, 4874, 3848, 3180, 2675],
  "final_price": [1095, 1095, 1095, 1095, 1095, 1095, 1080],
  "comments": [28329, 28872, 29328, 29788, 30291, 30760, 31177],
  "rating": [5, 5, 5, 5, 5, 5, 5]
}

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

Поле	Тип	Описание
pos	array	Позиция в выдаче по дням
auto	array	Позиция при авторекламе по дням
count	number	Частота запроса
wb_count	number	Частота по WB
total	number	Всего результатов по запросу
avgPos	number	Средняя позиция
norm_query	text	Кластер WB (нормализованный запрос)

---

Список версий карточки

GET /api/wb/get/item/{sku}/full_page/versions

История изменений карточки товара (версии).

Параметры: нет (только SKU в пути).

Пример:

curl "https://mpstats.io/api/wb/get/item/148471993/full_page/versions" \
  -H "X-Mpstats-TOKEN: YOUR_TOKEN"

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

[
  {"date": 1701291600, "version": "da58a28a829fb81ef89009bcfa1f0dd9"},
  {"date": 1700514000, "version": "2cbf3c1755926460967ae6127d86ab50"},
  {"date": 1697749200, "version": "7fba9f25f1c765a083bdedafbef2d0be"}
]

Поля: date (Unixtime), version (хэш версии).

---

Данные карточки по версии

GET /api/wb/get/item/{sku}/full_page?version={version_hash}

Содержимое карточки товара на указанную дату (версию).

Query-параметры:

Параметр	Тип	Обязательный	Описание
version	string	Да	Хэш версии из /full_page/versions

Пример:

curl "https://mpstats.io/api/wb/get/item/148471993/full_page?version=7fba9f25f1c765a083bdedafbef2d0be" \
  -H "X-Mpstats-TOKEN: YOUR_TOKEN"

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

{
  "color": "черный",
  "brand": "Oscar Cordoba",
  "consist": "полиэстер 88%; эластан 12%",
  "country": "Россия",
  "param_names": [
    "Фактура материала",
    "Размер на модели",
    "Страна производства",
    "Тип посадки",
    "Утеплитель"
  ],
  "param_values": [
    "в рубчик",
    "S",
    "Россия",
    "высокая",
    "флис"
  ],
  "description": "Леггинсы утепленные в рубчик",
  "full_name": "Леггинсы утепленные в рубчик",
  "images_count": 9
}

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

Поле	Тип	Описание
color	text	Цвет
brand	text	Бренд
consist	text	Состав материала
country	text	Страна производства
param_names	array	Названия характеристик
param_values	array	Значения характеристик
description	text	Описание товара
full_name	text	Полное наименование
images_count	number	Количество изображений

---

История отзывов SKU

GET /api/wb/get/item/{sku}/comments

Все отзывы покупателей на товар с ответами продавца.

Параметры: нет (только SKU в пути).

Пример:

curl "https://mpstats.io/api/wb/get/item/148471993/comments" \
  -H "X-Mpstats-TOKEN: YOUR_TOKEN"

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

{
  "last_request": 1701343032,
  "comments": [
    {
      "date": "2023-11-30",
      "valuation": 5,
      "text": "Очень классные леггинсы! Размер L на 46р сел отлично!",
      "answer": ""
    },
    {
      "date": "2023-11-30",
      "valuation": 3,
      "text": "Надела 3 раза — на попе катышки, между ног всё скаталось",
      "answer": ""
    }
  ]
}

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

Поле	Тип	Описание
last_request	number	Дата последнего запроса (Unixtime)
comments[].date	date	Дата отзыва
comments[].valuation	number	Оценка (1–5)
comments[].text	text	Текст отзыва
comments[].answer	text	Ответ продавца

---

Ограничения тарифов

Тариф	Ограничения
Базовый	Фиксированный диапазон дат (d1/d2 заданы тарифом)
Расширенный	Расширенный диапазон дат
Профессиональный	Полный доступ к эндпоинтам продавцов, данные о конкурентах
Корпоративный	Расширенный API, персональные выгрузки

---

Коды ошибок

HTTP-код	Описание
200	Успешный ответ
401	Неверный или отсутствующий токен
403	Доступ запрещён (недостаточный тариф)
404	Товар / категория / бренд не найдены
429	Превышен лимит запросов
500	Внутренняя ошибка сервера

---

Связанные страницы

• Примеры запросов
• Введение и аутентификация