--- title: "Listings Statistics per Period" description: "The method generates a report on items by comparing key metrics for the current period with a similar past one." lang: en-US source: https://valeryverkhoturov.github.io/wb-api-client-docs/en/reference/api/analytics/post-api-analytics-v3-sales-funnel-products --- # Listings Statistics per Period ```http POST /api/analytics/v3/sales-funnel/products ``` **Base URL:** `https://seller-analytics-api.wildberries.ru` · **Module:** [`analytics`](https://valeryverkhoturov.github.io/wb-api-client-docs/en/reference/api/analytics/) · **Section:** Sales Funnel · [Specification doc ↗](https://dev.wildberries.ru/en/docs/openapi/analytics#tag/salesFunnel/operation/postV3SalesFunnelProducts) The method generates a report on items by comparing key metrics for the current period with a similar past one. The report data is updated once every 2 hours. Most of the data appears within an hour of the event: - orders - click-throughs - adds-to-Cart A small part of this data may appear within a few days. Purchases, cancellations, and returns are displayed in report for the day an item was ordered. For example, if an order was placed on January 1, and the customer returned the item on January 10, data about this return will appear in the report for January 1. You can track the final sales results using [details for the realization reports](https://dev.wildberries.ru/openapi/documents-and-accounting#tag/financialReports). The `brandNames`, `subjectIds`, `tagIds`, and `nmIds` parameters can be empty `[]`, in which case the response will return all of the seller listings. If you specify multiple parameters, the response will include listings that match all of these parameters simultaneously. If no listings match the request parameters, an empty response `[]` will be returned. You can get a report for a maximum of the last 365 days. In the previous period's data: \* The data in `pastPeriod` covers the same duration as in `selectedPeriod` \* If the `pastPeriod` start date is more than a year before the current date, it will be adjusted to: `pastPeriod.start = current date - 365 days` Pagination can be used. [Request limit](https://dev.wildberries.ru/openapi/api-information#tag/introduction/Rate-Limits) per one seller account: | Type | Period | Limit | Interval | Burst | | ---------------- | ------ | ---------- | -------- | ---------- | | Personal | 1 min | 3 requests | 20 s | 3 requests | | Service | 1 min | 3 requests | 20 s | 3 requests | | Base with secret | 1 min | 3 requests | 20 s | 3 requests | | Base | 1 h | 2 requests | 30 min | 1 request | ## Request body `application/json` — schema `ItemsRequest`, required - `selectedPeriod` `object` (required) - `start` `string` — Period start - `end` `string` — Period end - `pastPeriod` `object` - `start` `string` — Period start - `end` `string` — Period end - `nmIds` `integer[]` — WB item numbers to include in the report. Leave empty to get a report for all items - `brandNames` `string[]` — List of brands for filtering - `subjectIds` `integer[]` — List of subcategory IDs for filtering - `tagIds` `integer[]` — List of label IDs for filtering - `skipDeletedNm` `boolean` — Skip deleted items - `orderBy` `OrderBy` - `field` `string` = `openCard` | `addToCart` | `orderCount` | `orderSum` | `buyoutCount` | `buyoutSum` | `cancelCount` | `cancelSum` | `avgPrice` | `stockMpQty` | `stockWbQty` | `shareOrderPercent` | `addToWishlist` | `timeToReady` | `localizationPercent` | `wbClub.orderCount` | `wbClub.orderSum` | `wbClub.buyoutSum` | `wbClub.cancelSum` | `wbClub.buyoutCount` | `wbClub.avgPrice` | `wbClub.buyoutPercent` | `wbClub.avgOrderCountPerDay` | `wbClub.cancelCount` (required) — Sort field: - `openCard` — Click-throughs - `addToCart` — Adds-to-Cart - `orderCount` — Items ordered - `orderSum` — Total order value - `buyoutCount` — Items purchased - `buyoutSum` — Total purchase value - `cancelCount` — Items canceled and returned - `cancelSum` — Canceled and returned item value - `avgPrice` — Average item price - `stockMpQty` — Seller warehouse inventory - `stockWbQty` — WB warehouse inventory - `shareOrderPercent` — Share in revenue - `addToWishlist` — Adds-to-Favorites - `timeToReady` — Average delivery time - `localizationPercent` — Local orders within the same region - `wbClub.orderCount` — Items ordered (WB Club) - `wbClub.orderSum` — Total order value (WB Club) - `wbClub.buyoutSum` — Total purchase value (WB Club) - `wbClub.buyoutCount` — Items purchased (WB Club) - `wbClub.cancelSum` — Canceled and returned item value (WB Club) - `wbClub.avgPrice` — Average item price (WB Club) - `wbClub.buyoutPercent` — Purchase rate (WB Club) - `wbClub.avgOrderCountPerDay` — Average daily orders (WB Club) - `wbClub.cancelCount` — Items canceled and returned (WB Club) - `mode` `string` = `asc` | `desc` (required) — Sorting order: - `asc` — ascending - `desc` — descending - `limit` `integer` — Number of listings in the response - `offset` `integer` — How many results to skip. For example, with value `10`, the response will start with the 11 element ## Responses | Code | Description | Schema | | ----- | ----------------- | -------------------------------------- | | `200` | Success | `PostV3SalesFunnelProductsResponse200` | | `400` | Bad request | `ErrorObject` | | `401` | Unauthorized | `object` | | `402` | Payment required | `object` | | `403` | Access denied | `ErrorObject` | | `429` | Too many requests | `object` | **Structure `200`:** - `data` `object` - `products` `object[]` — List of listings - `product` `object` - `nmId` `integer` — WB item number - `title` `string` — Listing name - `vendorCode` `string` — Seller item number - `brandName` `string` — Brand - `subjectId` `integer` — Subcategory ID - `subjectName` `string` — Subcategory name - `tags` `Tag[]` — Labels - `id` `integer` — Label ID - `name` `string` — Label name - `productRating` `number` — Item rating - `feedbackRating` `number` — Feedback rating - `stocks` `object` — Inventory - `wb` `integer` — WB warehouse inventory for the current day - `mp` `integer` — Seller warehouse inventory for the current day - `balanceSum` `integer` — Warehouse inventory value for the current day - `statistic` `object` - `selected` `object` - `period` `object` - `start` `string` — Period start - … - `end` `string` — Period end - … - `openCount` `integer` — Click-throughs - `cartCount` `integer` — Adds-to-Cart - `orderCount` `integer` — Items ordered - `orderSum` `integer` — Total order value - `buyoutCount` `integer` — Items purchased - `buyoutSum` `integer` — Total purchase value - `cancelCount` `integer` — Items canceled and returned - `cancelSum` `integer` — Canceled and returned item value - `avgPrice` `integer` — Average item price - `avgOrdersCountPerDay` `number` — Average daily orders - `shareOrderPercent` `number` — Share in revenue - `addToWishlist` `integer` — Adds-to-Favorites - `timeToReady` `object` - `days` `integer` — Days - … - `hours` `integer` — Hours - … - `mins` `integer` — Minutes - … - `localizationPercent` `integer` — Local orders within the same region. [At the moment](https://dev.wildberries.ru/en/release-notes?id=570), there can only be `100` - `wbClub` `object` - `orderCount` `integer` — Items ordered (WB Club) - … - `orderSum` `integer` — Total order value (WB Club) - … - `buyoutSum` `integer` — Total purchase value (WB Club) - … - `buyoutCount` `integer` — Items purchased (WB Club) - … - `cancelSum` `integer` — Canceled and returned item value (WB Club) - … - `cancelCount` `integer` — Items canceled and returned (WB Club) - … - `avgPrice` `integer` — Average item price (WB Club) - … - `buyoutPercent` `integer` — Purchase rate (WB Club) - … - `avgOrderCountPerDay` `number` — Average daily orders (WB Club) - … - `conversions` `object` - `addToCartPercent` `integer` — Conversion to cart. What percentage of visitors who opened the listing, added the item to the cart, % - … - `cartToOrderPercent` `integer` — Conversion to order. What percentage of visitors who added the item to the cart, placed an order, % - … - `buyoutPercent` `integer` — Buyout Percentage. Percentage of visitors who ordered a item and successfully completed the purchase. Excludes items still in transit to the buyer, % - … - `past` `object` - `period` `object` - `start` `string` — Period start - … - `end` `string` — Period end - … - `openCount` `integer` — Click-throughs - `cartCount` `integer` — Adds-to-Cart - `orderCount` `integer` — Items ordered - `orderSum` `integer` — Total order value - `buyoutCount` `integer` — Items purchased - `buyoutSum` `integer` — Total purchase value - `cancelCount` `integer` — Items canceled and returned - `cancelSum` `integer` — Canceled and returned item value - `avgPrice` `integer` — Average item price - `avgOrdersCountPerDay` `number` — Average daily orders - `shareOrderPercent` `number` — Share in revenue - `addToWishlist` `integer` — Adds-to-Favorites - `timeToReady` `object` - `days` `integer` — Days - … - `hours` `integer` — Hours - … - `mins` `integer` — Minutes - … - `localizationPercent` `integer` — Local orders within the same region. [At the moment](https://dev.wildberries.ru/en/release-notes?id=570), there can only be `100` - `wbClub` `object` - `orderCount` `integer` — Items ordered (WB Club) - … - `orderSum` `integer` — Total order value (WB Club) - … - `buyoutSum` `integer` — Total purchase value (WB Club) - … - `buyoutCount` `integer` — Items purchased (WB Club) - … - `cancelSum` `integer` — Canceled and returned item value (WB Club) - … - `cancelCount` `integer` — Items canceled and returned (WB Club) - … - `avgPrice` `integer` — Average item price (WB Club) - … - `buyoutPercent` `integer` — Purchase rate (WB Club) - … - `avgOrderCountPerDay` `number` — Average daily orders (WB Club) - … - `conversions` `object` - `addToCartPercent` `integer` — Conversion to cart. What percentage of visitors who opened the listing, added the item to the cart, % - … - `cartToOrderPercent` `integer` — Conversion to order. What percentage of visitors who added the item to the cart, placed an order, % - … - `buyoutPercent` `integer` — Buyout Percentage. Percentage of visitors who ordered a item and successfully completed the purchase. Excludes items still in transit to the buyer, % - … - `comparison` `object` - `openCountDynamic` `integer` — Dynamics of click-throughs - `cartCountDynamic` `integer` — Dynamics of adds-to-Cart - `orderCountDynamic` `integer` — Dynamics of items ordered - `orderSumDynamic` `integer` — Order value dynamics - `buyoutCountDynamic` `integer` — Dynamics of items purchased - `buyoutSumDynamic` `integer` — Dynamics of total purchase value - `cancelCountDynamic` `integer` — Dynamics of items canceled and returned - `cancelSumDynamic` `integer` — Dynamics of canceled and returned item value - `avgOrdersCountPerDayDynamic` `integer` — Dynamics of average daily orders - `avgPriceDynamic` `integer` — Dynamics of average item price. Discounts for promos are taken into account - `shareOrderPercentDynamic` `integer` — Dynamics of share in revenue - `addToWishlistDynamic` `integer` — Dynamics of adds-to-Favorites - `timeToReadyDynamic` `object` - `days` `integer` — Days - … - `hours` `integer` — Hours - … - `mins` `integer` — Minutes - … - `localizationPercentDynamic` `integer` — Dynamics of local orders within the same region. [At the moment](https://dev.wildberries.ru/en/release-notes?id=570), there can only be `0` - `wbClubDynamic` `object` - `orderCount` `integer` — Dynamics of items ordered (WB Club) - … - `orderSum` `integer` — Order value dynamics (WB Club) - … - `buyoutSum` `integer` — Dynamics of total purchase value (WB Club) - … - `buyoutCount` `integer` — Dynamics of items purchased (WB Club) - … - `cancelSum` `integer` — Dynamics of canceled and returned item value (WB Club) - … - `cancelCount` `integer` — Dynamics of items canceled and returned (WB Club) - … - `avgPrice` `integer` — Dynamics of average item price (WB Club) - … - `buyoutPercent` `integer` — Dynamics of purchase rate (WB Club) - … - `avgOrderCountPerDay` `number` — Dynamics of average daily orders (WB Club) - … - `conversions` `object` - `addToCartPercent` `integer` — Conversion to cart. What percentage of visitors who opened the listing, added the item to the cart, % - … - `cartToOrderPercent` `integer` — Conversion to order. What percentage of visitors who added the item to the cart, placed an order, % - … - `buyoutPercent` `integer` — Buyout Percentage. Percentage of visitors who ordered a item and successfully completed the purchase. Excludes items still in transit to the buyer, % - … - `currency` `Currency` **Structure `400`:** - `title` `string` — Error title - `detail` `string` — Error details - `requestId` `string` — Unique request ID - `origin` `string` — WB internal service ID **Structure `401`:** - `title` `string` — Error title - `detail` `string` — Error details - `code` `string` — Internal error code - `requestId` `string` — Unique request ID - `origin` `string` — WB internal service ID - `status` `number` — HTTP status code - `statusText` `string` — Text of the HTTP status code - `timestamp` `string` — Request date and time **Structure `402`:** - `title` `string` — Error title - `detail` `string` — Error details. The error is only returned to services from the [Solutions for business Catalog](https://dev.wildberries.ru/business-solutions) **Structure `403`:** - `title` `string` — Error title - `detail` `string` — Error details - `requestId` `string` — Unique request ID - `origin` `string` — WB internal service ID **Structure `429`:** - `title` `string` — Error title - `detail` `string` — Error details - `code` `string` — Internal error code - `requestId` `string` — Unique request ID - `origin` `string` — WB internal service ID - `status` `number` — HTTP status code - `statusText` `string` — Text of the HTTP status code - `timestamp` `string` — Request date and time ## Call examples Arguments are shown as parameter names — substitute your own values. Languages whose client does not expose this operation are omitted. **Python** ```python from wb_api_client.analytics import Configuration, ApiClient from wb_api_client.analytics.api import AnalyticsApi cfg = Configuration(access_token="") api = AnalyticsApi(ApiClient(cfg)) result = api.post_v3_sales_funnel_products(items_request=...) print(result) ``` **TypeScript** ```ts import { Configuration, AnalyticsApi, } from "@valeryverkhoturov/wb-api-client/analytics"; const cfg = new Configuration({}); cfg.setAccessToken(""); const api = new AnalyticsApi(cfg); const { data } = await api.postV3SalesFunnelProducts(itemsRequest); console.log(data); ``` **Go** ```go import ( "context" "fmt" wbanalytics "github.com/ValeryVerkhoturov/wb-api-client-go/analytics" ) cfg := wbanalytics.NewConfiguration() cfg.SetAccessToken("") client := wbanalytics.NewAPIClient(cfg) result, _, err := client.AnalyticsAPI.PostV3SalesFunnelProducts(context.Background()).ItemsRequest(itemsRequest).Execute() if err != nil { panic(err) } fmt.Printf("%+v\n", result) ``` **Java** ```java import io.github.valeryverkhoturov.wbapi.analytics.ApiClient; import io.github.valeryverkhoturov.wbapi.analytics.SecretString; import io.github.valeryverkhoturov.wbapi.analytics.api.AnalyticsApi; ApiClient client = new ApiClient(); client.setAccessToken(new SecretString("")); AnalyticsApi api = new AnalyticsApi(client); System.out.println(api.postV3SalesFunnelProducts(itemsRequest)); ``` **PHP** ```php use ValeryVerkhoturov\WbApiClient\Analytics\Configuration; use ValeryVerkhoturov\WbApiClient\Analytics\SecretString; use ValeryVerkhoturov\WbApiClient\Analytics\Api\AnalyticsApi; use GuzzleHttp\Client; $config = (new Configuration()) ->setAccessTokenSecret(new SecretString('')); $api = new AnalyticsApi(new Client(), $config); print_r($api->postV3SalesFunnelProducts($items_request)); ``` **OneScript** ```bsl #Использовать "wb-api-client" Настройки = Новый Конфигурация(); Настройки.УстановитьТокен(""); Клиент = Новый AnalyticsApi(Настройки); Сообщить(Клиент.PostV3SalesFunnelProducts(Тело).Тело); ``` **C#** ```csharp using ValeryVerkhoturov.WbApiClient.Analytics.Api; using ValeryVerkhoturov.WbApiClient.Analytics.Client; var config = new Configuration(); config.AccessTokenSecret = new SecretString(""); var api = new AnalyticsApi(config); Console.WriteLine(api.PostV3SalesFunnelProducts(itemsRequest)); ``` **Rust** ```rust use wb_api_client::analytics::apis::{configuration::Configuration, analytics_api}; #[tokio::main] async fn main() { let mut cfg = Configuration::new(); cfg.set_access_token(""); let result = analytics_api::post_v3_sales_funnel_products(&cfg, items_request).await; println!("{:#?}", result); } ```