Статистика групп карточек товаров по дням¶

POST /api/analytics/v3/sales-funnel/grouped/history

Метод возвращает статистику карточек товаров по дням или неделям.
Карточки товаров сгруппированы по предметам, брендам и ярлыкам.
Можно получить данные максимум за последнюю неделю.

Данные отчёта обновляются 1 раз в час.

В течение часа после события появляется большая часть данных: - о заказах - о переходах в карточку товара - о добавлениях товаров в корзину

Малая часть этих данных может появляться в течение нескольких дней.

Выкупы, отмены и возвраты отображаются в отчёте за тот день, когда товар был заказан. Например, если заказ был сделан 1 января, а покупатель вернул товар 10 января, данные об этом возврате появятся в отчёте за 1 января.
Окончательные итоги продаж вы можете отслеживать с помощью детализаций к отчётам реализации.

Параметры brandNames, subjectIds, tagIds могут быть пустыми [], тогда группировка происходит по всем карточкам продавца.

Произведение количества предметов, брендов, ярлыков в запросе может быть не больше 16. Например, 4 бренда и 4 предмета или 2 предмета, 2 ярлыка и 4 бренда.

Чтобы получать отчёты за период до года, используйте методы Аналитика продавца CSV — тип GROUPED_HISTORY_REPORT. Отчёты этого типа доступны только с подпиской Джем

Лимит запросов на один аккаунт продавца:

Тип	Период	Лимит	Интервал	Всплеск
Персональный	1 мин	3 запроса	20 сек	3 запроса
Сервисный	1 мин	3 запроса	20 сек	3 запроса
Базовый с секретом	1 мин	3 запроса	20 сек	3 запроса
Базовый	1 ч	2 запроса	30 мин	1 запрос

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

Примеры вызова¶

PythonNode.jsGoPHPRust

import os
from wildberries_sdk import analytics

token = os.getenv("WB_API_TOKEN")
api = analytics.DefaultApi(
    analytics.ApiClient(analytics.Configuration(api_key={"HeaderApiKey": token}))
)
result = api.post_sales_funnel_grouped_history(grouped_history_request=...)
print(result)

import { Configuration, DefaultApi } from 'wildberries-sdk';

const api = new DefaultApi(new Configuration({ apiKey: process.env.WB_API_TOKEN }));
const result = await api.postSalesFunnelGroupedHistory({ ... });
console.log(result);

cfg := analytics.NewConfiguration()
cfg.AddDefaultHeader("Authorization", os.Getenv("WB_API_TOKEN"))
client := analytics.NewAPIClient(cfg)
result, _, err := client.DefaultApi.PostSalesFunnelGroupedHistory(context.Background()).Execute()

<?php
$config = Wildberries\Sdk\Analytics\Configuration::getDefaultConfiguration()
    ->setApiKey('Authorization', getenv('WB_API_TOKEN'));
$api = new Wildberries\Sdk\Analytics\Api\DefaultApi(new GuzzleHttp\Client(), $config);
$result = $api->postSalesFunnelGroupedHistory(...);

use wildberries_sdk_analytics::apis::{configuration::Configuration, configuration::ApiKey, default_api};

let mut config = Configuration::new();
config.api_key = Some(ApiKey { prefix: None, key: std::env::var("WB_API_TOKEN").unwrap() });
let result = default_api::post_sales_funnel_grouped_history(&config, ...).await?;