Статистика карточек товаров за период¶

POST /api/analytics/v3/sales-funnel/products

Метод формирует отчёт о товарах, сравнивая ключевые показатели за текущий период с аналогичным прошлым.

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

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

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

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

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

Если вы указали несколько параметров, в ответе будут карточки, в которых есть одновременно все эти параметры. Если карточки не подходят по параметрам запроса, вернётся пустой ответ [].

Можно получить отчёт максимум за последние 365 дней.

В данных предыдущего периода: * Данные в pastPeriod указаны за такой же период, что и в selectedPeriod * Если дата начала pastPeriod раньше, чем год назад от текущей даты, она будет приведена к виду: pastPeriod.start = текущая дата — 365 дней

Можно использовать пагинацию.

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

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

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

Ответ: object

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

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_products(items_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.postSalesFunnelProducts({ ... });
console.log(result);

cfg := analytics.NewConfiguration()
cfg.AddDefaultHeader("Authorization", os.Getenv("WB_API_TOKEN"))
client := analytics.NewAPIClient(cfg)
result, _, err := client.DefaultApi.PostSalesFunnelProducts(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->postSalesFunnelProducts(...);

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_products(&config, ...).await?;