MPStats REST API

MPStats предоставляет REST API для программного доступа к аналитическим данным маркетплейсов Wildberries, Ozon и Яндекс Маркет.

125 эндпоинтов

Полная документация содержит 125 API эндпоинтов: 79 для WB, 25 для Ozon, 20 для YM и 1 для аккаунта.

Базовые параметры

Параметр	Значение
Base URL	https://mpstats.io/api/
Аутентификация	Header X-Mpstats-TOKEN
Content-Type	application/json
Формат ответа	JSON
Максимум записей	5 000 на один запрос

Аутентификация

Все запросы требуют токен в заголовке:

curl --location --request GET 'https://mpstats.io/api/wb/get/categories' \
  --header 'X-Mpstats-TOKEN: YOUR_TOKEN_HERE' \
  --header 'Content-Type: application/json'

Получение токена

1. Зарегистрироваться на mpstats.io
2. Оплатить подписку (API доступен в платных тарифах)
3. Перейти в раздел Интеграции → API
4. Скопировать токен

Проверка лимитов

curl --location --request GET 'https://mpstats.io/api/user/report_api_limit' \
  --header 'X-Mpstats-TOKEN: YOUR_TOKEN_HERE' \
  --header 'Content-Type: application/json'

Ответ:

{
  "available": 2500,
  "use": 38
}

Общие параметры запросов

Параметры дат и фильтрации

Параметр	Тип	Описание
d1	YYYY-MM-DD	Начальная дата периода
d2	YYYY-MM-DD	Конечная дата периода
path	string	Путь категории (например Женщинам/Одежда)
fbs	=0 или =1	0 = FBO (по умолчанию), 1 = FBS

Ограничения дат

Для тарифных планов «Базовый» и «Расширенный» даты d1/d2 равны датам начала и окончания периода тарифа без возможности изменения.

Пагинация данных

POST-эндпоинты поддерживают пагинацию через тело запроса:

{
  "startRow": 0,
  "endRow": 100,
  "filterModel": {},
  "sortModel": []
}

Ответ возвращает:

{
  "startRow": 0,
  "endRow": 100,
  "total": 42,
  "filterModel": {},
  "sortModel": [],
  "data": [...]
}

• Максимум 5 000 записей на один запрос
• total — общее количество записей без учёта пагинации

Сортировка данных

{
  "sortModel": [
    {"colId": "revenue", "sort": "desc"}
  ]
}

Фильтрация данных

{
  "filterModel": {
    "id": {
      "filterType": "number",
      "type": "equals",
      "filter": 13495594,
      "filterTo": null
    }
  }
}

Типы фильтров:

filterType	type	Описание
number	equals, notEqual, greaterThan, lessThan, inRange	Числовые фильтры
text	equals, notEqual, contains, notContains, startsWith, endsWith	Текстовые фильтры

Карта API эндпоинтов

Wildberries — 79 эндпоинтов

Рубрикатор:

• GET wb/get/categories — дерево категорий WB

Категории (12):

• 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 — годовая сезонность
• GET wb/get/ds/category/weekly — недельная сезонность

Предметы (Subjects) — 16:

• GET wb/get/subjects/select — список предметов
• POST api/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/category/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/trend — AI тренд
• GET wb/get/ds/subject/annual — годовая сезонность
• GET wb/get/ds/subject/weekly — недельная сезонность

Бренды (10):

• 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 get/brand/in_warehouses — по складам
• GET wb/get/category/price_segmentation — ценовая сегментация
• POST wb/get/brand/compare — сравнение периодов
• GET wb/get/brand/items — предметы бренда

Продавцы (10):

• POST wb/get/seller — товары продавца
• GET get/seller/categories — категории продавца
• GET wb/get/seller/brands — бренды продавца
• GET wb/get/seller/trends — тренд продавца
• GET wb/get/seller/by_date — по дням
• GET get/seller/in_warehouses — по складам
• GET wb/get/seller/price_segmentation — ценовая сегментация
• POST wb/get/seller/compare — сравнение периодов
• GET wb/get/seller/items — предметы продавца

Похожие товары AI (5):

• POST wb/get/identical — похожие товары (AI)
• GET wb/get/identical/categories — категории
• GET wb/get/identicial/brands — бренды
• GET wb/get/identicial/sellers — продавцы
• GET wb/get/identicial/price_segmentation — ценовая сегментация

Похожие товары WB (5):

• POST wb/get/similar — похожие товары (WB)
• GET wb/get/similar/categories — категории
• GET wb/get/similar/brands — бренды
• GET wb/get/similar/sellers — продавцы
• GET wb/get/similar/price_segmentation — ценовая сегментация

В похожих товарах WB (5):

• 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 — ценовая сегментация

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

• GET wb/get/item/{sku}/sales — продажи и остатки
• 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
• GET wb/get/item/{SKU}/identical_wb — похожие товары WB AI
• GET wb/get/item/{SKU}/similar — похожие товары WB
• GET wb/get/item/{SKU}/in_similar — в похожих товарах WB
• GET wb/get/item/{sku}/by_category — категории и позиции
• GET wb/get/item/{sku}/by_keywords — запросы и позиции
• GET wb/get/item/{SKU}/full_page/versions — история версий карточки
• GET wb/get/item/{SKU}/full_page?version=... — данные по версии
• GET wb/get/item/{SKU}/comments — история отзывов

Подробнее: WB API эндпоинты

---

Ozon — 25 эндпоинтов

Рубрикатор:

• GET oz/get/categories — дерево категорий Ozon

Категории (7):

• POST oz/get/category — товары по категории
• GET oz/get/category/subcategories — подкатегории
• GET oz/get/category/sellers — продавцы
• GET oz/get/category/brands — бренды
• GET oz/get/category/by_date — по дням
• GET oz/get/category/price_segmentation — ценовая сегментация
• POST oz/get/category/compare — сравнение периодов

Бренды (7):

• POST oz/get/brands — товары бренда
• GET oz/get/brand/categories — категории
• GET oz/get/brand/sellers — продавцы
• GET oz/get/brand/by_date — по дням
• GET oz/get/brand/price_segmentation — ценовая сегментация
• POST oz/get/brand/compare — сравнение периодов

Продавцы (7):

• POST oz/get/seller — товары продавца
• GET oz/get/seller/categories — категории
• GET oz/get/seller/brands — бренды
• GET oz/get/seller/by_date — по дням
• GET oz/get/seller/price_segmentation — ценовая сегментация
• POST oz/get/seller/compare — сравнение периодов

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

• GET oz/get/item/{sku}/sales — продажи и остатки
• GET oz/get/item/{sku}/by_category — категории и позиции
• GET oz/get/item/{SKU}/comments — история отзывов

Подробнее: Ozon API эндпоинты

---

Яндекс Маркет — 20 эндпоинтов

Категории (7):

• POST ym/get/category — товары по категории
• GET ym/get/category/categories — подкатегории
• GET ym/get/category/sellers — продавцы
• GET ym/get/category/brands — бренды
• GET ym/get/category/by_date — по дням
• GET ym/get/category/price_segmentation — ценовая сегментация
• POST ym/get/category/compare — сравнение периодов

Бренды (6):

• POST ym/get/brand — товары бренда
• GET ym/get/brand/categories — категории
• GET ym/get/brand/sellers — продавцы
• GET ym/get/brand/by_date — по дням
• GET ym/get/brand/price_segmentation — ценовая сегментация
• POST ym/get/brand/compare — сравнение периодов

Продавцы (6):

• POST ym/get/seller — товары продавца
• GET ym/get/seller/categories — категории
• GET ym/get/seller/brands — бренды
• GET ym/get/seller/by_date — по дням
• GET ym/get/seller/price_segmentation — ценовая сегментация
• POST ym/get/seller/compare — сравнение периодов

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

• GET ym/get/item/{id}/sales — продажи и остатки

Подробнее: Яндекс Маркет API эндпоинты

---

Аккаунт — 1 эндпоинт

• GET user/report_api_limit — остатки лимитов по отчётам

Коды ответов сервера

Код	Описание
200	Успешный запрос
400	Некорректный запрос
401	Ошибка авторизации (невалидный токен)
403	Доступ запрещён (нет подписки на модуль)
405	Метод не разрешён (GET вместо POST или наоборот)
429	Превышен лимит запросов
500	Внутренняя ошибка сервера

Интеграции

Помимо прямого API, MPStats интегрируется с:

• Albato — 37 готовых действий (no-code)
• n8n — HTTP Request ноды
• 1С — выгрузка данных
• Google Sheets — автоматические отчёты

Подробнее: Инструменты интеграции

Известные проблемы

HTTP 405 на некоторых эндпоинтах

Некоторые эндпоинты принимают только GET или только POST. При ошибке 405 проверьте правильность HTTP метода.

Источник: n8n community

Пагинация больших результатов

Для категорий с большим количеством товаров необходимо использовать startRow/endRow. Максимум 5 000 записей на один запрос.