MPStats API Гайд

Пошаговая инструкция по работе с API для выгрузки данных Wildberries

1. Что такое API?

Простая аналогия

Представьте ресторан. Вы (программа) сидите за столиком. Кухня (сервер MPStats) готовит блюда (данные). Вы не можете зайти на кухню сами — вам нужен официант (API).

💻

Вы (Hoppscotch)

→

🤝

API (официант)

→

🍳

Сервер (кухня)

Вы отправляете запрос (например: «дай мне все подкатегории раздела Здоровье»), а API возвращает ответ — данные в формате JSON.

Что такое JSON?

JSON — это просто текст, структурированный в пары «ключ: значение». Вот пример:

{
  "name": "Компрессионные чулки",
  "revenue": 180900882,
  "sales": 129102,
  "items": 37382,
  "rating": 4.86
}

Это читается так: ниша «Компрессионные чулки», выручка 180.9M, продаж 129K, товаров 37K, рейтинг 4.86.

Зачем нужен API?

⚡

Скорость

Выгрузка 100K+ товаров за секунды

📊

Массовый анализ

Все бренды, продавцы, отзывы разом

🤖

Автоматизация

Можно загрузить данные в Claude для AI-анализа

📈

Исторические данные

Тренды ниши за 5 лет

2. Как получить API-ключ MPStats

1Зайдите на mpstats.io и авторизуйтесь

2Откройте Настройки аккаунта (иконка профиля → Настройки)

3Найдите раздел API и нажмите "Получить API-токен"

4Скопируйте токен — это строка вида 69a694...ffe2d

Важно: API-ключ — это как пароль. Никому не показывайте и не публикуйте его. Нужна платная подписка MPStats с доступом к API.

3. Инструменты для работы с API

Hoppscotch

Бесплатно

4. Первый запрос — Пошаговый туториал

Откройте Hoppscotch

Зайдите на hoppscotch.io в браузере

Метод: GET

Убедитесь что выбран метод GET (по умолчанию)

Вставьте URL

https://mpstats.io/api/wb/get/category/subcategories?d1=2026-02-01&d2=2026-03-01&path=Здоровье

Добавьте заголовок авторизации

Вкладка Headers → добавьте:

X-Mpstats-TOKEN	ваш_api_ключ_из_mpstats
Content-Type	application/json

Нажмите Send

Получите JSON с подкатегориями раздела «Здоровье» — выручка, товары, бренды, продавцы по каждой.

5. Эндпоинты: Анализ ниши

Эти запросы помогут понять нишу целиком: размер, тренды, конкуренты.

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

Возвращает все подкатегории с метриками: товары, продажи, выручка, бренды, продавцы, средняя цена.

GET /wb/get/category/subcategories
  d1=2026-02-01
  d2=2026-03-01
  path=Здоровье

d1 — Начало периода

d2 — Конец периода

path — Путь категории (например: Здоровье, Здоровье/Ортопедия)

Когда использовать: Первый шаг — найти перспективные подкатегории внутри большого раздела.

2Тренды ниши (до 5 лет)GET

Помесячные данные: выручка, товары, продажи, средняя цена. Показывает рост или падение ниши.

GET /wb/get/category/trends
  d1=2024-01-01
  d2=2026-03-01
  path=Здоровье/Ортопедия

d1 — Начало (можно с 2020 года)

d2 — Конец

path — Путь категории

Когда использовать: Проверить: ниша растёт или умирает? Есть ли сезонность?

3Ценовые сегментыGET

Разбивка ниши по ценовым диапазонам: сколько товаров, выручка, упущенная прибыль в каждом сегменте.

GET /wb/get/category/price_segmentation
  d1=2026-02-01
  d2=2026-03-01
  path=Здоровье/Ортопедия

d1 — Начало

d2 — Конец

path — Путь категории

Когда использовать: Определить в каком ценовом сегменте больше денег и меньше конкуренции.

4ТОП бренды в нишеGET

Все бренды в нише с выручкой, продажами, количеством товаров и рейтингом.

GET /wb/get/category/brands
  d1=2026-02-01
  d2=2026-03-01
  path=Здоровье/Ортопедия

d1 — Начало

d2 — Конец

path — Путь категории

Когда использовать: Узнать кто лидеры рынка, какая доля у 'безбрендовых' товаров.

5ТОП продавцы в нишеGET

Все продавцы: выручка, количество товаров, бренды, % товаров с продажами.

GET /wb/get/category/sellers
  d1=2026-02-01
  d2=2026-03-01
  path=Здоровье/Ортопедия

d1 — Начало

d2 — Конец

path — Путь категории

Когда использовать: Изучить конкурентов: сколько зарабатывают, сколько SKU держат.

6Дневные метрики категорииGET

Ежедневная статистика категории: остатки, цена, товары, продажи, выручка, рейтинг.

GET /wb/get/category/by_date
  d1=2026-02-01
  d2=2026-03-01
  path=Здоровье/Ортопедия

d1 — Начало

d2 — Конец

path — Путь категории

Когда использовать: Увидеть ежедневную динамику: пики продаж, влияние акций.

6. Товары в нише

7Все товары в категорииGET

Выгрузка ВСЕХ товаров в категории с выручкой, продажами, ценой, рейтингом, отзывами, брендом и продавцом.

GET /wb/get/category
  d1=2026-02-01
  d2=2026-03-01
  path=Здоровье/Ортопедия

d1 — Начало

d2 — Конец

path — Путь категории

Когда использовать: Найти ТОП-товары в нише по выручке. Получить артикулы (SKU) для детального анализа.

7. Анализ конкретного товара

Замените 40435840 на артикул нужного товара (SKU из предыдущего шага).

8Информация о товареGET

Полная информация: название, бренд, продавец, цена, рейтинг, количество отзывов, скидки.

GET /wb/get/item/40435840

Когда использовать: Быстро узнать всё о конкретном товаре-конкуренте.

9Продажи и остатки по днямGET

Ежедневные данные: продажи, остатки, цена, скидки, позиция в поиске, позиция в категории.

GET /wb/get/item/40435840/sales
  d1=2026-02-01
  d2=2026-03-01

d1 — Начало

d2 — Конец

Когда использовать: Понять сколько штук в день продаёт конкурент и как меняется его цена.

10ВСЕ отзывы товараGET

Полная выгрузка всех отзывов: текст, оценка (1-5), дата, наличие фото. Главный эндпоинт для анализа в Claude.

GET /wb/get/item/40435840/comments

Когда использовать: Выгрузить отзывы → загрузить JSON в Claude → получить анализ болей покупателей и стратегию улучшения товара.

11Похожие товары-конкурентыGET

Товары, которые WB считает конкурентами: название, бренд, цена, продажи, выручка.

GET /wb/get/item/40435840/similar

Когда использовать: Найти прямых конкурентов товара и сравнить их цены и продажи.

8. Практические сценарии

Сценарий 1: Найти ТОП-товар и выгрузить отзывы для Claude

Нахождение ниши

Выберите нишу через WB Analyzer или MPStats → Внешняя аналитика → Выбор ниши

ТОП товар

Отправьте запрос #7 (Все товары в категории) → найдите ТОП-товар по выручке → запомните его SKU

Отзывы

Отправьте запрос #10 (Все отзывы) с этим SKU → получите JSON со всеми отзывами

Сохранение

Скопируйте JSON ответ → сохраните как файл reviews.json

Анализ

Загрузите reviews.json в проект Claude → вставьте промпт анализа (см. секцию 9)

Сценарий 2: Проверить тренд ниши

Отправьте запрос #2 (Тренды) с периодом 2 года. Если выручка стабильно растёт — ниша перспективная. Если падает — лучше не заходить.

Сценарий 3: Сравнить конкурентов

Запрос #5 (Продавцы) покажет всех продавцов с выручкой. Посмотрите: сколько продавцов, как распределена выручка, есть ли монополист.

9. Загрузка данных в Claude

Как сохранить данные из Hoppscotch

1Отправьте запрос в Hoppscotch и получите ответ

2В окне ответа нажмите кнопку Copy (скопировать весь JSON)

3Откройте текстовый редактор (Блокнот) → вставьте → сохраните как .json файл

4Загрузите файл в проект Claude (Projects → загрузить файл)

Промпт для Claude

Скопируйте этот промпт и вставьте в Claude вместе с загруженными файлами:

Ты — старший аналитик маркетплейсов с 10-летним опытом
в e-commerce и product development. Твоя задача — провести
глубокий анализ ниши и товарных позиций на Wildberries
на основе загруженных данных.

## Что я загружаю:

1. JSON/Excel с метриками ниши — выгрузка из MPStats API
2. JSON с отзывами — выгрузка через /wb/get/item/{sku}/comments

## Что нужно сделать:

### ЧАСТЬ 1: Анализ ниши (по метрикам)
Оцени по критериям (🟢 хорошо / 🟡 нормально / 🔴 плохо):
- Объём рынка, Конкуренция, Входной барьер
- Ликвидность, Упущенная выручка, Сезонность

### ЧАСТЬ 2: Анализ отзывов
- ТОП-5 жалоб из негативных отзывов + цитаты
- ТОП-5 плюсов из позитивных
- Скрытые инсайты: чего хотят, но нет

### ЧАСТЬ 3: Стратегия выхода
- Продуктовая стратегия (что исправить)
- Ценовая стратегия
- Карточка товара (УТП, боли)
- Риски + План на первый месяц

10. Скачать готовую коллекцию для Hoppscotch

11 готовых запросов к MPStats API — импортируйте в Hoppscotch и сразу начинайте работать.

Скачать коллекцию MPStats API

Как импортировать

1Скачайте файл mpstats-hoppscotch.json

2Откройте hoppscotch.io → Collections (левая панель)

3Нажмите Import → выберите скачанный файл

4Замените <YOUR_TOKEN> на ваш API-ключ в каждом запросе

5Готово! Все 11 запросов доступны в коллекции

← Инструкция WB Analyzer WB Niche Analyzer →