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

Base URL: https://mpstats.io/api/

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

Формат дат: YYYY-MM-DD

Лимит пагинации: не более 5000 записей на один вызов запроса (endRow - startRow)

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

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

POST ym/get/category

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

Параметры запроса (query string)

Параметр	Тип	Обязательный	Описание
`path`	string	Да	Категория, например `Авто/Шины и диски/Шины`
`d1`	date	Нет	Дата начала периода
`d2`	date	Нет	Дата окончания периода

Тело запроса (JSON)

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

Поле	Тип	Описание
`startRow`	number	Номер строки начала получения данных
`endRow`	number	Номер строки конца (не более startRow + 5000)
`filterModel`	object	Фильтры по полям
`sortModel`	array	Сортировка, например `[{"colId": "revenue", "sort": "desc"}]`

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

curl --location --request POST \
  'https://mpstats.io/api/ym/get/category?path=Авто/Шины и диски/Шины&d1=2023-12-12&d2=2023-12-25' \
  --header 'X-Mpstats-TOKEN: <ваш_токен>' \
  --header 'Content-Type: application/json' \
  --data-raw '{"startRow":0,"endRow":100,"filterModel":{},"sortModel":[]}'

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

{
  "data": [
    {
      "id": "101282740510.5339801049084621214",
      "sku": "101282740510",
      "thumb": "https://avatars.mds.yandex.net/get-mpic/96484/img_id1739963087386951088/orig",
      "name": "Белшина Artmotion 175/65 R14 82H летняя",
      "url": "https://market.yandex.ru/product/13179880?sku=101282740510",
      "category": "Авто/Шины и диски/Шины",
      "date": "2024-07-08",
      "balance": 181,
      "basic_price": 2638,
      "price": 2987,
      "color": "",
      "size": "",
      "seller": "Центр Шин",
      "brand": "Белшина",
      "sales": "2005",
      "comments": 2935,
      "rating": 4.83,
      "revenue": "5171501",
      "days_in_stock": "23",
      "revenue_potential": 6745436,
      "lost_profit": 1573935,
      "lost_profit_percent": 23.33,
      "percent_from_revenue": 1.01,
      "discount": 12,
      "final_price_min": 2441,
      "final_price_max": 2825,
      "final_price_average": 2594,
      "days_with_sales": "23",
      "average_if_in_stock": 87,
      "sales_per_day_average": 66.83,
      "graph": [44, 88, 42, 92, 94, "..."],
      "price_graph": [2651, 2584, 2481, 2549, 2577, "..."],
      "stocks_graph": [300, 286, 296, 294, 300, "..."]
    },
    "..."
  ],
  "total": 13873,
  "error": false,
  "startRow": 0,
  "endRow": 100,
  "filterModel": [],
  "sortModel": [{"colId": "revenue", "sort": "desc"}]
}

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

Имя поля	Тип	Описание
`id`	string	Внутренний идентификатор товарной позиции
`sku`	string	Идентификатор товарной позиции (SKU)
`thumb`	string	URL изображения товара
`name`	string	Название товара
`url`	string	Ссылка на товар на Яндекс Маркет
`category`	string	Категория, в которой товар находился в выдаче дольше всего
`date`	date	Дата отчёта
`balance`	number	Последний зафиксированный остаток
`basic_price`	number	Базовая цена
`price`	number	Последняя зафиксированная цена
`color`	string	Цвет товара
`size`	string	Размер товара
`seller`	string	Название продавца товара
`brand`	string	Бренд товара
`sales`	number	Количество продаж
`comments`	number	Количество комментариев
`rating`	number	Рейтинг товара
`revenue`	number	Выручка
`days_in_stock`	number	Количество дней, когда товар был в наличии на конец дня
`revenue_potential`	number	Потенциал выручки: (Выручка / Дней в наличии) * Дней в отчёте
`lost_profit`	number	Упущенная выручка
`lost_profit_percent`	number	Упущенная выручка в процентах
`percent_from_revenue`	number	Процент от выручки в категории
`discount`	number	Скидка
`final_price_min`	number	Минимальная цена за период
`final_price_max`	number	Максимальная цена за период
`final_price_average`	number	Средняя цена за период (выручка / число продаж)
`days_with_sales`	number	Количество дней с продажами
`average_if_in_stock`	number	Среднее число продаж при наличии товара на конец дня
`sales_per_day_average`	number	Среднее число продаж в день за период
`graph`	number[]	График продаж по дням
`price_graph`	number[]	График изменения цены по дням
`stocks_graph`	number[]	График остатков по дням

GET ym/get/category/categories

Список подкатегорий внутри указанной категории с агрегированными показателями.

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

Параметр	Тип	Обязательный	Описание
`path`	string	Да	Категория, например `Товары для красоты/Косметика/Макияж/Для бровей`
`d1`	date	Нет	Дата начала периода
`d2`	date	Нет	Дата окончания периода

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

curl --location --request GET \
  'https://mpstats.io/api/ym/get/category/categories?d1=2023-12-12&d2=2023-12-25&path=Товары для красоты/Косметика, парфюмерия и уход/Макияж/Для бровей' \
  --header 'X-Mpstats-TOKEN: <ваш_токен>' \
  --header 'Content-Type: application/json'

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

[
  {
    "name": "Тушь и гель для бровей",
    "items": 862,
    "items_with_sells": 862,
    "items_with_sells_percent": 100.0,
    "brands": 220,
    "brands_with_sells": 220,
    "brands_with_sells_percent": 100,
    "sellers": 294,
    "sellers_with_sells": 294,
    "sellers_with_sells_percent": 100,
    "sales_per_items_average": 14.66,
    "sales_per_items_with_sells_average": 14.66,
    "sales": 12638,
    "revenue": 8177732,
    "revenue_per_items_average": 9486.93,
    "revenue_per_items_with_sells_average": 9486.93,
    "avg_price": 735,
    "comments": 111.45,
    "rating": 4.68
  },
  "..."
]

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

Имя поля	Тип	Описание
`name`	string	Название подкатегории
`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	Выручка
`avg_price`	number	Средняя цена
`comments`	number	Среднее количество отзывов
`rating`	number	Средний рейтинг
`sales_per_items_average`	number	Среднее количество продаж на один товар
`sales_per_items_with_sells_average`	number	Среднее количество продаж на один товар с продажами
`revenue_per_items_average`	number	Средняя выручка на 1 товар
`revenue_per_items_with_sells_average`	number	Средняя выручка на 1 товар с продажами

GET ym/get/category/sellers

Список продавцов в категории с агрегированными показателями. Доступен на тарифе "Профессиональный".

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

Параметр	Тип	Обязательный	Описание
`path`	string	Да	Категория, например `Товары для животных/Корма для кошек и собак`
`d1`	date	Нет	Дата начала периода
`d2`	date	Нет	Дата окончания периода

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

curl --location --request GET \
  'https://mpstats.io/api/ym/get/category/sellers?d1=2023-12-12&d2=2023-12-25&path=Товары для животных/Корма для кошек и собак' \
  --header 'X-Mpstats-TOKEN: <ваш_токен>' \
  --header 'Content-Type: application/json'

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

[
  {
    "name": "магазин Royal Canin",
    "items": 336,
    "items_with_sells": 336,
    "items_with_sells_percent": 100,
    "brands": 3,
    "brands_with_sells": 3,
    "brands_with_sells_percent": 100,
    "sales": 22178,
    "revenue": 50392589,
    "sales_per_items_average": 66.01,
    "sales_per_items_with_sells_average": 66.01,
    "revenue_per_items_average": 149977.94,
    "revenue_per_items_with_sells_average": 149977.94,
    "balance": 0,
    "balance_price": 0,
    "avg_price": 2819.12,
    "rating": 4.84,
    "comments": 491.26,
    "position": 1,
    "graph": [852, 995, 916, 902, 1045, "..."]
  },
  "..."
]

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

Имя поля	Тип	Описание
`name`	string	Название продавца
`items`	number	Число товаров
`items_with_sells`	number	Число товаров с продажами
`items_with_sells_percent`	number	Товаров с продажами, в процентах
`brands`	number	Количество брендов
`brands_with_sells`	number	Количество брендов с продажами
`brands_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	Средняя выручка на 1 товар
`revenue_per_items_with_sells_average`	number	Средняя выручка на 1 товар с продажами
`balance`	number	Остаток на конец периода
`balance_price`	number	Произведение остатка на цену продажи
`avg_price`	number	Средняя цена
`rating`	number	Средний рейтинг
`comments`	number	Среднее количество отзывов
`position`	number	Позиция в топ продавцов в категории по выручке
`graph`	number[]	График продаж по дням

GET ym/get/category/brands

Список брендов в категории с агрегированными показателями.

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

Параметр	Тип	Обязательный	Описание
`path`	string	Да	Категория, например `Товары для животных/Корма для кошек и собак`
`d1`	date	Нет	Дата начала периода
`d2`	date	Нет	Дата окончания периода

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

curl --location --request GET \
  'https://mpstats.io/api/ym/get/category/brands?d1=2023-12-12&d2=2023-12-25&path=Товары для животных/Корма для кошек и собак' \
  --header 'X-Mpstats-TOKEN: <ваш_токен>' \
  --header 'Content-Type: application/json'

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

[
  {
    "name": "Royal Canin",
    "items": 3188,
    "items_with_sells": 3188,
    "items_with_sells_percent": 100,
    "sellers": 164,
    "sellers_with_sells": 164,
    "sellers_with_sells_percent": 100,
    "sales": 43601,
    "revenue": 103908601,
    "sales_per_items_average": 13.68,
    "sales_per_items_with_sells_average": 13.68,
    "revenue_per_items_average": 32593.66,
    "revenue_per_items_with_sells_average": 32593.66,
    "balance": 0,
    "balance_price": 0,
    "avg_price": 3032.21,
    "rating": 4.84,
    "comments": 457.02,
    "position": 1,
    "graph": [1795, 2210, 1904, 1901, 2040, "..."]
  },
  "..."
]

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

Имя поля	Тип	Описание
`name`	string	Название бренда
`items`	number	Число товаров
`items_with_sells`	number	Число товаров с продажами
`items_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	Средняя выручка на 1 товар
`revenue_per_items_with_sells_average`	number	Средняя выручка на 1 товар с продажами
`balance`	number	Остаток на конец периода
`balance_price`	number	Произведение остатка на цену продажи
`avg_price`	number	Средняя цена
`rating`	number	Средний рейтинг
`comments`	number	Среднее количество отзывов
`position`	number	Позиция в топ брендов в категории по выручке
`graph`	number[]	График продаж по дням

GET ym/get/category/by_date

Динамика ключевых показателей категории по дням за период.

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

Параметр	Тип	Обязательный	Описание
`path`	string	Да	Категория, например `Товары для животных/Корма для кошек и собак`
`d1`	date	Нет	Дата начала периода
`d2`	date	Нет	Дата окончания периода

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

curl --location --request GET \
  'https://mpstats.io/api/ym/get/category/by_date?d1=2023-12-12&d2=2023-12-25&path=Товары для животных/Корма для кошек и собак' \
  --header 'X-Mpstats-TOKEN: <ваш_токен>' \
  --header 'Content-Type: application/json'

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

[
  {
    "period": "2024-07-08",
    "balance": 1217627,
    "balance_price": 2471274845,
    "avg_price": 2504.71,
    "items": 4117,
    "items_with_sells": 4117,
    "brands": 228,
    "brands_with_sells": 228,
    "sellers": 383,
    "sellers_with_sells": 383,
    "sales": 10632,
    "revenue": 21128116,
    "comments": 264.36,
    "rating": 4.79,
    "avg_sale_price": 1987.22
  },
  "..."
]

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

Имя поля	Тип	Описание
`period`	date	Дата
`balance`	number	Остаток на конец периода
`balance_price`	number	Произведение остатка на цену продажи
`avg_price`	number	Средняя цена товара в категории (среднее арифметическое)
`items`	number	Число товаров в рейтинге
`items_with_sells`	number	Число товаров с продажами
`brands`	number	Количество брендов
`brands_with_sells`	number	Количество брендов с продажами
`sellers`	number	Количество продавцов
`sellers_with_sells`	number	Количество продавцов с продажами
`sales`	number	Продано единиц товаров
`revenue`	number	Выручка
`comments`	number	Среднее число комментариев на товар
`rating`	number	Средний рейтинг
`avg_sale_price`	number	Средняя цена состоявшейся продажи (выручка / число продаж)

GET ym/get/category/price_segmentation

Распределение товаров, продаж и выручки по ценовым сегментам в категории.

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

Параметр	Тип	Обязательный	Описание
`path`	string	Да	Категория, например `Строительство и ремонт/Инструменты`
`d1`	date	Нет	Дата начала периода
`d2`	date	Нет	Дата окончания периода
`fbs`	`=0` или `=1`	Нет	Включить данные по схеме FBS (по умолчанию без FBS)
`minPrice`	number	Нет	Минимальный диапазон цены
`maxPrice`	number	Нет	Максимальный диапазон цены
`segmentsCnt`	number	Нет	Количество сегментов (максимум 25)

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

curl --location --request GET \
  'https://mpstats.io/api/ym/get/category/price_segmentation?d1=2023-12-12&d2=2023-12-25&path=Товары для животных/Корма для кошек и собак' \
  --header 'X-Mpstats-TOKEN: <ваш_токен>' \
  --header 'Content-Type: application/json'

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

[
  {
    "range": "1-239",
    "items": 1116,
    "items_with_sells": 1116,
    "brands": 111,
    "brands_with_sells": 111,
    "sellers": 133,
    "sellers_with_sells": 133,
    "revenue": 3951357,
    "sales": 27236,
    "product_revenue": 3540,
    "min_range_price": 1,
    "max_range_price": 239,
    "revenue_potential": 36694784,
    "lost_profit": 32890092,
    "lost_profit_percent": 89
  },
  "..."
]

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

Имя поля	Тип	Описание
`range`	string	Диапазон цен в сегменте
`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 ym/get/category/compare

Сравнение показателей товаров категории между двумя периодами.

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

Параметр	Тип	Обязательный	Описание
`path`	string	Да	Категория, например `Товары для животных/Корма для кошек и собак`
`d1`	date	Нет	Дата начала периода (может не использоваться, даты задаются в теле)
`d2`	date	Нет	Дата окончания периода

Тело запроса (JSON)

{
  "startRow": 0,
  "endRow": 100,
  "filterModel": {},
  "sortModel": [],
  "d11": "2023-10-18",
  "d12": "2023-10-19",
  "d21": "2023-10-19",
  "d22": "2023-10-20"
}

Поле	Тип	Описание
`d11`	date	Начальная дата первого периода
`d12`	date	Конечная дата первого периода
`d21`	date	Начальная дата второго периода
`d22`	date	Конечная дата второго периода

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

curl --location --request POST \
  'https://mpstats.io/api/ym/get/category/compare?path=Товары для животных/Корма для кошек и собак' \
  --header 'X-Mpstats-TOKEN: <ваш_токен>' \
  --header 'Content-Type: application/json' \
  --data-raw '{"startRow":0,"endRow":100,"filterModel":{},"sortModel":[{"colId":"revenue","sort":"desc"}]}'

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

{
  "data": [
    {
      "id": "101388093390.1460276430438095995",
      "sku": "101388093390",
      "name": "Влажный полнорационный корм Perfect Fit с говядиной 28 шт. х 75 г",
      "url": "https://market.yandex.ru/product/1729649030?sku=101388093390",
      "brand": "Perfect Fit",
      "seller": "ЗооОптТорг",
      "sales_count_1": 0,
      "sales_count_2": 1,
      "revenue_1": 0,
      "revenue_2": 1075,
      "thumb": "https://avatars.mds.yandex.net/...",
      "pricefinal_1": 0,
      "pricefinal_2": 1075,
      "avg_pricefinal_1": 0,
      "avg_pricefinal_2": 1075,
      "days_in_stock_1": "0",
      "days_in_stock_2": "1",
      "sales_count_diff": 1,
      "revenue_diff": 1075,
      "pricefinal_diff": "1075",
      "avg_pricefinal_diff": 1075,
      "days_in_stock_diff": "1"
    },
    "..."
  ],
  "total": 50674,
  "pinnedBottom": {
    "sales_count_1": 284909,
    "sales_count_2": 315747,
    "revenue_1": 546278933,
    "revenue_2": 621903663,
    "sales_count_diff": 30838,
    "revenue_diff": 75624730
  }
}

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

Имя поля	Тип	Описание
`id`	string	Внутренний идентификатор товарной позиции
`sku`	string	Идентификатор товарной позиции (SKU)
`name`	string	Название товара
`url`	string	Ссылка на товар на Яндекс Маркет
`brand`	string	Бренд
`seller`	string	Продавец
`thumb`	string	URL изображения товара
`sales_count_1`	number	Количество продаж в первом периоде
`sales_count_2`	number	Количество продаж во втором периоде
`revenue_1`	number	Выручка в первом периоде
`revenue_2`	number	Выручка во втором периоде
`pricefinal_1`	number	Цена в первом периоде
`pricefinal_2`	number	Цена во втором периоде
`avg_pricefinal_1`	number	Средняя цена в первом периоде
`avg_pricefinal_2`	number	Средняя цена во втором периоде
`days_in_stock_1`	string	Дней в наличии в первом периоде
`days_in_stock_2`	string	Дней в наличии во втором периоде
`sales_count_diff`	number	Разница продаж между двумя периодами
`revenue_diff`	number	Разница выручки между двумя периодами
`pricefinal_diff`	string	Разница цен между двумя периодами
`avg_pricefinal_diff`	number	Разница средней цены между двумя периодами
`days_in_stock_diff`	string	Разница дней в наличии между двумя периодами
`pinnedBottom.sales_count_1`	number	Суммарные продажи по категории в первом периоде
`pinnedBottom.sales_count_2`	number	Суммарные продажи по категории во втором периоде
`pinnedBottom.revenue_1`	number	Суммарная выручка в первом периоде
`pinnedBottom.revenue_2`	number	Суммарная выручка во втором периоде
`pinnedBottom.sales_count_diff`	number	Разница суммарных продаж
`pinnedBottom.revenue_diff`	number	Разница суммарной выручки

По брендам

Получение данных по брендам Яндекс Маркета.

POST ym/get/brand

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

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

Параметр	Тип	Обязательный	Описание
`path`	string	Да	Название бренда, например `Royal Canin`
`d1`	date	Нет	Дата начала периода
`d2`	date	Нет	Дата окончания периода

Тело запроса (JSON)

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

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

curl --location --request POST \
  'https://mpstats.io/api/ym/get/brand?path=Royal Canin' \
  --header 'X-Mpstats-TOKEN: <ваш_токен>' \
  --header 'Content-Type: application/json' \
  --data-raw '{"startRow":0,"endRow":100,"filterModel":{},"sortModel":[]}'

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

{
  "data": [
    {
      "id": "101283012613.3411835894272085079",
      "sku": "101283012613",
      "thumb": "https://avatars.mds.yandex.net/...",
      "name": "Корм для взрослых собак Royal Canin Hypoallergenic DR 21 Canine, 14 кг",
      "url": "https://market.yandex.ru/product/13230299?sku=101283012613",
      "category": "Товары для животных/Корма для кошек и собак/Корма для собак",
      "date": "2024-07-08",
      "balance": 13,
      "basic_price": 14589,
      "price": 15437,
      "color": "",
      "size": "",
      "seller": "магазин Royal Canin",
      "brand": "Royal Canin",
      "sales": "106",
      "comments": 470,
      "rating": 4.79,
      "revenue": "1537623",
      "days_in_stock": "21",
      "revenue_potential": 2196604,
      "lost_profit": 658981,
      "lost_profit_percent": 30,
      "percent_from_revenue": 1.82,
      "discount": 5,
      "final_price_min": 14194,
      "final_price_max": 14736,
      "final_price_average": 14524,
      "days_with_sales": "21",
      "average_if_in_stock": 5,
      "sales_per_day_average": 3.53,
      "graph": [6, 6, 3, 5, 0, "..."],
      "price_graph": [14371, 14542, 14371, 14567, 0, "..."],
      "stocks_graph": [55, 50, 48, 43, 0, "..."]
    },
    "..."
  ],
  "total": 3188,
  "error": false,
  "startRow": 0,
  "endRow": 100,
  "filterModel": [],
  "sortModel": [{"colId": "revenue", "sort": "desc"}]
}

Поля ответа идентичны POST ym/get/category — см. описание полей выше.

GET ym/get/brand/categories

Список категорий, в которых присутствует бренд, с агрегированными показателями.

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

Параметр	Тип	Обязательный	Описание
`path`	string	Да	Название бренда, например `Samsung`
`d1`	date	Нет	Дата начала периода
`d2`	date	Нет	Дата окончания периода

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

curl --location --request GET \
  'https://mpstats.io/api/ym/get/brand/categories?d1=2023-12-12&d2=2023-12-25&path=Samsung' \
  --header 'X-Mpstats-TOKEN: <ваш_токен>' \
  --header 'Content-Type: application/json'

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

[
  {
    "name": "Электроника/Телефоны/Мобильные телефоны",
    "items": 7599,
    "items_with_sells": 7599,
    "items_with_sells_percent": 100,
    "brands": 1,
    "brands_with_sells": 1,
    "brands_with_sells_percent": 100,
    "sellers": 675,
    "sellers_with_sells": 675,
    "sellers_with_sells_percent": 100,
    "sales_per_items_average": 5.35,
    "sales_per_items_with_sells_average": 5.35,
    "sales": 40657,
    "revenue": 1627908405,
    "revenue_per_items_average": 214226.66,
    "revenue_per_items_with_sells_average": 214226.66,
    "avg_price": 42916.2,
    "comments": 1252.52,
    "rating": 4.79
  },
  "..."
]

Поля ответа идентичны GET ym/get/category/categories — см. описание полей выше.

GET ym/get/brand/sellers

Список продавцов, реализующих товары бренда. Доступен на тарифе "Профессиональный".

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

Параметр	Тип	Обязательный	Описание
`path`	string	Да	Название бренда, например `Samsung`
`d1`	date	Нет	Дата начала периода
`d2`	date	Нет	Дата окончания периода

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

curl --location --request GET \
  'https://mpstats.io/api/ym/get/brand/sellers?path=Samsung&d1=2023-12-12&d2=2023-12-25' \
  --header 'X-Mpstats-TOKEN: <ваш_токен>' \
  --header 'Content-Type: application/json'

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

[
  {
    "name": "Digital Planet",
    "items": 26,
    "items_with_sells": 26,
    "items_with_sells_percent": 100,
    "brands": 1,
    "brands_with_sells": 1,
    "brands_with_sells_percent": 100,
    "sales": 3206,
    "revenue": 69271014,
    "sales_per_items_average": 123.31,
    "sales_per_items_with_sells_average": 123.31,
    "revenue_per_items_average": 2664269.77,
    "revenue_per_items_with_sells_average": 2664269.77,
    "balance": 0,
    "balance_price": 0,
    "avg_price": 18675.4,
    "rating": 4.87,
    "comments": 1033.7,
    "position": 1,
    "graph": [204, 233, 267, 188, 154, "..."]
  },
  "..."
]

Поля ответа идентичны GET ym/get/category/sellers — см. описание полей выше.

GET ym/get/brand/by_date

Динамика ключевых показателей бренда по дням за период.

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

Параметр	Тип	Обязательный	Описание
`path`	string	Да	Название бренда, например `Samsung`
`d1`	date	Нет	Дата начала периода
`d2`	date	Нет	Дата окончания периода

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

curl --location --request GET \
  'https://mpstats.io/api/ym/get/brand/by_date?d1=2023-12-12&d2=2023-12-25&path=Samsung' \
  --header 'X-Mpstats-TOKEN: <ваш_токен>' \
  --header 'Content-Type: application/json'

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

[
  {
    "period": "2024-07-08",
    "balance": 46431,
    "balance_price": 971693942,
    "avg_price": 32034.79,
    "items": 1645,
    "items_with_sells": 1645,
    "brands": 1,
    "brands_with_sells": 1,
    "sellers": 516,
    "sellers_with_sells": 516,
    "sales": 3180,
    "revenue": 92139312,
    "comments": 985.76,
    "rating": 4.78,
    "avg_sale_price": 28974.63
  },
  "..."
]

Поля ответа идентичны GET ym/get/category/by_date — см. описание полей выше.

GET ym/get/brand/price_segmentation

Распределение товаров бренда по ценовым сегментам.

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

Параметр	Тип	Обязательный	Описание
`path`	string	Да	Название бренда, например `Samsung`
`d1`	date	Нет	Дата начала периода
`d2`	date	Нет	Дата окончания периода
`minPrice`	number	Нет	Минимальный диапазон цены
`maxPrice`	number	Нет	Максимальный диапазон цены
`segmentsCnt`	number	Нет	Количество сегментов (максимум 25)

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

curl --location --request GET \
  'https://mpstats.io/api/ym/get/brand/price_segmentation?d1=2023-12-12&d2=2023-12-25&path=Samsung' \
  --header 'X-Mpstats-TOKEN: <ваш_токен>' \
  --header 'Content-Type: application/json'

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

[
  {
    "range": "1-604",
    "items": 584,
    "items_with_sells": 584,
    "brands": 1,
    "brands_with_sells": 1,
    "sellers": 180,
    "sellers_with_sells": 180,
    "revenue": 638254,
    "sales": 1554,
    "product_revenue": 1092,
    "min_range_price": 1,
    "max_range_price": 604,
    "revenue_potential": 7075557,
    "lost_profit": 6481067,
    "lost_profit_percent": 91
  },
  "..."
]

Поля ответа идентичны GET ym/get/category/price_segmentation — см. описание полей выше.

POST ym/get/brand/compare

Сравнение показателей товаров бренда между двумя периодами.

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

Параметр	Тип	Обязательный	Описание
`path`	string	Да	Название бренда, например `Samsung`
`d1`	date	Нет	Дата начала периода
`d2`	date	Нет	Дата окончания периода

Тело запроса (JSON)

{
  "startRow": 0,
  "endRow": 100,
  "filterModel": {},
  "sortModel": [],
  "d11": "2023-10-18",
  "d12": "2023-10-19",
  "d21": "2023-10-19",
  "d22": "2023-10-20"
}

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

curl --location --request POST \
  'https://mpstats.io/api/ym/get/brand/compare?path=Samsung' \
  --header 'X-Mpstats-TOKEN: <ваш_токен>' \
  --header 'Content-Type: application/json' \
  --data-raw '{"startRow":0,"endRow":100,"filterModel":{},"sortModel":[]}'

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

{
  "data": [
    {
      "id": "491324046.6733358744250024465",
      "sku": "491324046",
      "name": "Аккумулятор Samsung EB425161LU 1500 мАч для Samsung Galaxy Ace 2",
      "url": "https://market.yandex.ru/product/1777946258?sku=491324046",
      "brand": "Samsung",
      "seller": "ZAVR",
      "sales_count_1": 1,
      "sales_count_2": 0,
      "revenue_1": 312,
      "revenue_2": 0,
      "thumb": "https://avatars.mds.yandex.net/...",
      "pricefinal_1": 312,
      "pricefinal_2": 0,
      "avg_pricefinal_1": 312,
      "avg_pricefinal_2": 0,
      "days_in_stock_1": "1",
      "days_in_stock_2": "0",
      "sales_count_diff": -1,
      "revenue_diff": -312,
      "pricefinal_diff": "-312",
      "avg_pricefinal_diff": -312,
      "days_in_stock_diff": "-1"
    },
    "..."
  ],
  "total": 22718,
  "pinnedBottom": {
    "sales_count_1": 65508,
    "sales_count_2": 80300,
    "revenue_1": 1781157071,
    "revenue_2": 2227320766,
    "sales_count_diff": 14792,
    "revenue_diff": 446163695
  }
}

Поля ответа идентичны POST ym/get/category/compare — см. описание полей выше.

По продавцам

Получение данных по продавцам Яндекс Маркета.

POST ym/get/seller

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

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

Параметр	Тип	Обязательный	Описание
`path`	string	Да	Название продавца, например `Эльдорадо`
`d1`	date	Нет	Дата начала периода
`d2`	date	Нет	Дата окончания периода

Тело запроса (JSON)

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

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

curl --location --request POST \
  'https://mpstats.io/api/ym/get/seller?path=Эльдорадо&d1=2023-12-12&d2=2023-12-25' \
  --header 'X-Mpstats-TOKEN: <ваш_токен>' \
  --header 'Content-Type: application/json' \
  --data-raw '{"startRow":0,"endRow":100,"filterModel":{},"sortModel":[]}'

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

{
  "data": [
    {
      "id": "102836341921.8950573971179059427",
      "sku": "102836341921",
      "thumb": "https://avatars.mds.yandex.net/...",
      "name": "Умная сплит-система Rapid RAM-07HJ/N1/Wi-Fi",
      "url": "https://market.yandex.ru/product/79478631?sku=102836341921",
      "category": "Бытовая техника/Климатическая техника/Кондиционеры",
      "date": "2024-07-08",
      "balance": 32,
      "basic_price": 21999,
      "price": 21999,
      "color": "белый",
      "size": "",
      "seller": "ЭЛЬДОРАДО",
      "brand": "Rapid",
      "sales": "580",
      "comments": 129,
      "rating": 4.78,
      "revenue": "10240994",
      "days_in_stock": "23",
      "revenue_potential": 13357818,
      "lost_profit": 3116824,
      "lost_profit_percent": 23.33,
      "percent_from_revenue": 2.07,
      "discount": 0,
      "final_price_min": 15762,
      "final_price_max": 21999,
      "final_price_average": 18373,
      "days_with_sales": "23",
      "average_if_in_stock": 25,
      "sales_per_day_average": 19.33,
      "graph": [72, 55, 66, 27, 28, "..."],
      "price_graph": [16036, 16149, 15762, 18131, 18047, "..."],
      "stocks_graph": [873, 658, 1069, 303, 136, "..."]
    },
    "..."
  ],
  "total": 4550,
  "error": false,
  "startRow": 0,
  "endRow": 100,
  "filterModel": [],
  "sortModel": [{"colId": "revenue", "sort": "desc"}]
}

Поля ответа идентичны POST ym/get/category — см. описание полей выше.

GET ym/get/seller/categories

Список категорий, в которых продаёт указанный продавец.

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

Параметр	Тип	Обязательный	Описание
`path`	string	Да	Название продавца, например `Эльдорадо`
`d1`	date	Нет	Дата начала периода
`d2`	date	Нет	Дата окончания периода

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

curl --location --request GET \
  'https://mpstats.io/api/ym/get/seller/categories?d1=2023-12-12&d2=2023-12-25&path=Эльдорадо' \
  --header 'X-Mpstats-TOKEN: <ваш_токен>' \
  --header 'Content-Type: application/json'

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

[
  {
    "name": "Электроника/Телефоны/Мобильные телефоны",
    "items": 394,
    "items_with_sells": 394,
    "items_with_sells_percent": 100,
    "brands": 15,
    "brands_with_sells": 15,
    "brands_with_sells_percent": 100,
    "sellers": 1,
    "sellers_with_sells": 1,
    "sellers_with_sells_percent": 100,
    "sales_per_items_average": 10.8,
    "sales_per_items_with_sells_average": 10.8,
    "sales": 4254,
    "revenue": 102714294,
    "revenue_per_items_average": 260696.18,
    "revenue_per_items_with_sells_average": 260696.18,
    "avg_price": 25866.36,
    "comments": 1609.88,
    "rating": 4.81
  },
  "..."
]

Поля ответа идентичны GET ym/get/category/categories — см. описание полей выше.

GET ym/get/seller/brands

Список брендов, которые продаёт указанный продавец. Доступен на тарифе "Профессиональный".

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

Параметр	Тип	Обязательный	Описание
`path`	string	Да	Название продавца, например `Эльдорадо`
`d1`	date	Нет	Дата начала периода
`d2`	date	Нет	Дата окончания периода

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

curl --location --request GET \
  'https://mpstats.io/api/ym/get/seller/brands?d1=2023-12-12&d2=2023-12-25&path=Эльдорадо' \
  --header 'X-Mpstats-TOKEN: <ваш_токен>' \
  --header 'Content-Type: application/json'

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

[
  {
    "name": "HUAWEI",
    "items": 161,
    "items_with_sells": 161,
    "items_with_sells_percent": 100,
    "sellers": 1,
    "sellers_with_sells": 1,
    "sellers_with_sells_percent": 100,
    "sales": 1964,
    "revenue": 53172307,
    "sales_per_items_average": 12.2,
    "sales_per_items_with_sells_average": 12.2,
    "revenue_per_items_average": 330262.78,
    "revenue_per_items_with_sells_average": 330262.78,
    "balance": 0,
    "balance_price": 0,
    "avg_price": 23093.15,
    "rating": 4.84,
    "comments": 644.44,
    "position": 1,
    "graph": [130, 129, 102, 69, 112, "..."]
  },
  "..."
]

Поля ответа идентичны GET ym/get/category/sellers — см. описание полей выше.

GET ym/get/seller/by_date

Динамика ключевых показателей продавца по дням за период.

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

Параметр	Тип	Обязательный	Описание
`path`	string	Да	Название продавца, например `Эльдорадо`
`d1`	date	Нет	Дата начала периода
`d2`	date	Нет	Дата окончания периода

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

curl --location --request GET \
  'https://mpstats.io/api/ym/get/seller/by_date?d1=2023-12-12&d2=2023-12-25&path=Эльдорадо' \
  --header 'X-Mpstats-TOKEN: <ваш_токен>' \
  --header 'Content-Type: application/json'

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

[
  {
    "period": "2024-07-08",
    "balance": 8037,
    "balance_price": 99079179,
    "avg_price": 14978.31,
    "items": 648,
    "items_with_sells": 648,
    "brands": 166,
    "brands_with_sells": 166,
    "sellers": 1,
    "sellers_with_sells": 1,
    "sales": 1135,
    "revenue": 18800873,
    "comments": 1064.66,
    "rating": 4.74,
    "avg_sale_price": 16564.65
  },
  "..."
]

Поля ответа идентичны GET ym/get/category/by_date — см. описание полей выше.

GET ym/get/seller/price_segmentation

Распределение товаров продавца по ценовым сегментам.

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

Параметр	Тип	Обязательный	Описание
`path`	string	Да	Название продавца, например `Эльдорадо`
`d1`	date	Нет	Дата начала периода
`d2`	date	Нет	Дата окончания периода
`minPrice`	number	Нет	Минимальный диапазон цены
`maxPrice`	number	Нет	Максимальный диапазон цены
`segmentsCnt`	number	Нет	Количество сегментов (максимум 25)

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

curl --location --request GET \
  'https://mpstats.io/api/ym/get/seller/price_segmentation?d1=2023-12-12&d2=2023-12-25&path=Эльдорадо' \
  --header 'X-Mpstats-TOKEN: <ваш_токен>' \
  --header 'Content-Type: application/json'

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

[
  {
    "range": "99-499",
    "items": 191,
    "items_with_sells": 191,
    "brands": 83,
    "brands_with_sells": 83,
    "sellers": 1,
    "sellers_with_sells": 1,
    "revenue": 211868,
    "sales": 534,
    "product_revenue": 1109,
    "min_range_price": 99,
    "max_range_price": 499,
    "revenue_potential": 2647106,
    "lost_profit": 2453174,
    "lost_profit_percent": 92
  },
  "..."
]

Поля ответа идентичны GET ym/get/category/price_segmentation — см. описание полей выше.

POST ym/get/seller/compare

Сравнение показателей товаров продавца между двумя периодами.

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

Параметр	Тип	Обязательный	Описание
`path`	string	Да	Название продавца, например `Эльдорадо`
`d1`	date	Нет	Дата начала периода
`d2`	date	Нет	Дата окончания периода

Тело запроса (JSON)

{
  "startRow": 0,
  "endRow": 100,
  "filterModel": {},
  "sortModel": [],
  "d11": "2023-10-18",
  "d12": "2023-10-19",
  "d21": "2023-10-19",
  "d22": "2023-10-20"
}

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

curl --location --request POST \
  'https://mpstats.io/api/ym/get/seller/compare?path=Эльдорадо' \
  --header 'X-Mpstats-TOKEN: <ваш_токен>' \
  --header 'Content-Type: application/json' \
  --data-raw '{"startRow":0,"endRow":100,"filterModel":{},"sortModel":[]}'

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

{
  "data": [
    {
      "id": "100338130326.8950573971179059427",
      "sku": "100338130326",
      "name": "Сетевой адаптер TP-LINK TL-WN725N, черный",
      "url": "https://market.yandex.ru/product/8353972?sku=100338130326",
      "brand": "TP-LINK",
      "seller": "ЭЛЬДОРАДО",
      "sales_count_1": 18,
      "sales_count_2": 19,
      "revenue_1": 12231,
      "revenue_2": 12132,
      "thumb": "https://avatars.mds.yandex.net/...",
      "pricefinal_1": 699,
      "pricefinal_2": 639,
      "avg_pricefinal_1": 699,
      "avg_pricefinal_2": 639,
      "days_in_stock_1": "11",
      "days_in_stock_2": "14",
      "sales_count_diff": 1,
      "revenue_diff": -99,
      "pricefinal_diff": "-60",
      "avg_pricefinal_diff": -60,
      "days_in_stock_diff": "3"
    },
    "..."
  ],
  "total": 6729,
  "pinnedBottom": {
    "sales_count_1": 39529,
    "sales_count_2": 49188,
    "revenue_1": 495391354,
    "revenue_2": 597552362,
    "sales_count_diff": 9659,
    "revenue_diff": 102161008
  }
}

Поля ответа идентичны POST ym/get/category/compare — см. описание полей выше.

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

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

GET ym/get/item/{id}/sales

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

Параметры пути

Параметр	Тип	Обязательный	Описание
`id`	string	Да	Идентификатор товара в формате `{sku}.{seller_id}`, например `101802913969.16655922462941091655`

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

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

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

curl --location --request GET \
  'https://mpstats.io/api/ym/get/item/101802913969.16655922462941091655/sales?d1=2023-12-12&d2=2023-12-25' \
  --header 'X-Mpstats-TOKEN: <ваш_токен>' \
  --header 'Content-Type: application/json'

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

[
  {
    "data": "2024-07-15",
    "no_data": 1,
    "balance": 0,
    "sales": 0,
    "rating": 0,
    "price": 0,
    "final_price": 0,
    "is_new": 0,
    "comments": 0
  },
  {
    "data": "2024-07-14",
    "no_data": 0,
    "balance": 145,
    "sales": 12,
    "rating": 4.82,
    "price": 3200,
    "final_price": 2880,
    "is_new": 0,
    "comments": 342
  },
  "..."
]

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

Имя поля	Тип	Описание
`data`	date	Дата записи
`no_data`	number	`0` — данные есть; `1` — продаж и остатков не зафиксировано
`balance`	number	Остаток на конец дня
`sales`	number	Продажи за день
`rating`	number	Рейтинг товара на дату
`price`	number	Базовая цена на дату
`final_price`	number	Цена со скидкой на дату
`is_new`	number	Признак новинки (`1` — новинка)
`comments`	number	Количество комментариев на дату

Общие замечания

Модель пагинации

Все эндпоинты POST (товарные листинги) поддерживают пагинацию через startRow / endRow в теле запроса:

Максимум 5000 записей за один вызов (endRow - startRow)
Ответ содержит поле total — общее количество строк без учёта пагинации
Для получения всех данных: делайте последовательные запросы, увеличивая startRow на размер страницы

Модель фильтрации

Поле filterModel позволяет фильтровать результаты по любому числовому полю:

{
  "filterModel": {
    "revenue": {
      "filterType": "number",
      "type": "greaterThan",
      "filter": 100000,
      "filterTo": null
    }
  }
}

Модель сортировки

Поле sortModel задаёт порядок строк:

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

Доступность по тарифам

Тариф	Ограничения
Базовый	Фиксированные даты согласно условиям тарифа
Расширенный	Фиксированные даты согласно условиям тарифа
Профессиональный	Свободный выбор дат; доступ к эндпоинтам `/sellers` по бренду/категории

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

POST ym/get/category​

Параметры запроса (query string)​

Тело запроса (JSON)​

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

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

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

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​

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

Тело запроса (JSON)​

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

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

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

По брендам​

POST ym/get/brand​

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

Тело запроса (JSON)​

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

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

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​

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

Тело запроса (JSON)​

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

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

По продавцам​

POST ym/get/seller​

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

Тело запроса (JSON)​

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

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

GET ym/get/seller/categories​

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

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

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

GET ym/get/seller/brands​

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

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

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

GET ym/get/seller/by_date​

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

POST ym/get/category

Параметры запроса (query string)

Тело запроса (JSON)

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

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

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

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

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

Тело запроса (JSON)

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

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

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

По брендам

POST ym/get/brand

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

Тело запроса (JSON)

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

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

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

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

Тело запроса (JSON)

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

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

По продавцам

POST ym/get/seller

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

Тело запроса (JSON)

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

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

GET ym/get/seller/categories

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

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

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

GET ym/get/seller/brands

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

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

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

GET ym/get/seller/by_date