--- title: "Pagination by Groups" description: "Pagination by groups in the report. It is possible only if there is a filter by brand, subcategory, or label. Additional parameters for selecting the list of…" lang: en-US source: https://valeryverkhoturov.github.io/wb-api-client-docs/en/reference/api/analytics/post-api-v2-search-report-table-groups --- # Pagination by Groups ```http POST /api/v2/search-report/table/groups ``` **Base URL:** `https://seller-analytics-api.wildberries.ru` · **Module:** [`analytics`](https://valeryverkhoturov.github.io/wb-api-client-docs/en/reference/api/analytics/) · **Section:** Search Queries for Your Items · [Specification doc ↗](https://dev.wildberries.ru/en/docs/openapi/analytics#tag/searchQueriesForYourItems/operation/postV2SearchReportTableGroups) Pagination by groups in the report. It is possible only if there is a filter by brand, subcategory, or label. Additional parameters for selecting the list of items in the table: - `positionCluster` — average position in search The parameters `includeSubstitutedSKUs` and `includeSearchTexts` cannot both be set to `false`. The report data is updated once every 2 hours. [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 | 1 request | 1 h | 1 request | ## Request body `application/json` — schema `TableGroupRequest`, required - `currentPeriod` `Period` (required) - `start` `string` (required) — Start date of the period. No later than `end`. No earlier than 365 days from today - `end` `string` (required) — End date of the period. No earlier than 365 days from today - `pastPeriod` `pastPeriod` - `start` `string` (required) — Start date of the period. No later than `end`. No earlier than 365 days from today - `end` `string` (required) — End date of the period. No later than the day before the start date `currentPeriod`. No earlier than 365 days from today - `nmIds` `integer[]` — List of WB item numbers for filtering - `subjectIds` `integer[]` — List of subcategory IDs for filtering - `brandNames` `string[]` — List of brands for filtering - `tagIds` `integer[]` — List of label IDs for filtering - `orderBy` `OrderByGrTe` (required) - `field` `string` = `avgPosition` | `openCard` | `addToCart` | `openToCart` | `orders` | `cartToOrder` | `visibility` (required) — Field for sorting: - `avgPosition` — by average position - `addToCart` — by adds-to-Cart - `openCard` — by click-throughs - `orders` — by number of items ordered - `cartToOrder` — by conversion to order from search - `openToCart` — by conversion to cart from search - `visibility` — by item visibility - `mode` `string` = `asc` | `desc` (required) — Order of sorting: - `asc` — ascending - `desc` — descending - `positionCluster` `PositionCluster` (required) - `includeSubstitutedSKUs` `boolean` — Show data for direct queries with [promo items](https://seller.wildberries.ru/help-center/article/A-524) - `includeSearchTexts` `boolean` — Show data for search queries without promo items - `limit` `integer` (required) — Number of item groups in the response - `offset` `integer` (required) — From which element to start outputting data ## Responses | Code | Description | Schema | | ----- | ----------------- | ------------------------------------------ | | `200` | Success | `PostV2SearchReportTableGroupsResponse200` | | `400` | Bad request | `ErrorObject400` | | `401` | Unauthorized | `object` | | `402` | Payment required | `object` | | `403` | Access denied | `ErrorObject403` | | `429` | Too many requests | `object` | **Structure `200`:** - `data` `TableGroupResponse` - `groups` `TableGroupItem[]` — List of item groups for the table - `subjectName` `string` — Subcategory name - `subjectId` `integer` — Subcategory ID - `brandName` `string` — Brand - `tagName` `string` — Label name - `tagId` `integer` — Label ID - `metrics` `object` — Item metrics in the table - `avgPosition` `object` — Average item position in search results - `current` `integer` — Current average position - `dynamics` `integer` — Dynamics compared to the previous period (%) - `openCard` `object` — Click-throughs from search - `current` `integer` — Current click-throughs - `dynamics` `integer` — Dynamics compared to the previous period (%) - `addToCart` `object` — Adds-to-Cart from search - `current` `integer` — Current number - `dynamics` `integer` — Dynamics compared to the previous period (%) - `openToCart` `object` — Conversion to cart from search — the ratio of item additions to the cart compared to all transitions to the listing from the search - `current` `integer` — Current conversion - `dynamics` `integer` — Dynamics compared to the previous period (%) - `orders` `object` — Items ordered from search - `current` `integer` — Current number - `dynamics` `integer` — Dynamics compared to the previous period (%) - `cartToOrder` `object` — Conversion to order from search — the ratio of items ordered to all additions of the item from search to the cart - `current` `integer` — Current conversion - `dynamics` `integer` — Dynamics compared to the previous period (%) - `visibility` `object` — Item visibility percent in search results - `current` `integer` — Current visibility percent - `dynamics` `integer` — Dynamics compared to the previous period (%) - `items` `TableItem[]` — List of the group items - `nmId` `integer` — WB item number - `name` `string` — Item name - `vendorCode` `string` — Seller item number - `subjectName` `string` — Subcategory name - `brandName` `string` — Brand - `mainPhoto` `string` — URL of the main photo of the listing - `isAdvertised` `boolean` — Is the item being promoted in search results - `isSubstitutedSKU` `boolean` — If the item was searched by the promo item. The field will be in the response if the request contains `includeSubstitutedSKUs` and/or `includeSearchTexts` - `isCardRated` `boolean` — If the listing has a rating - `rating` `number` — Listing rating - `feedbackRating` `number` — Feedbacks rating - `price` `object` — Price - `minPrice` `integer` — Minimal price - `maxPrice` `integer` — Maximal price - `avgPosition` `object` — Average item position in search results - `current` `integer` — Current average position - `dynamics` `integer` — Dynamics compared to the previous period (%) - `openCard` `object` — Click-throughs from search - `current` `integer` — Current click-throughs - `dynamics` `integer` — Dynamics compared to the previous period (%) - `addToCart` `object` — Adds-to-Cart from search - `current` `integer` — Current number - `dynamics` `integer` — Dynamics compared to the previous period (%) - `openToCart` `object` — Conversion to cart from search — the ratio of item additions to the cart compared to all transitions to the listing from the search - `current` `integer` — Current conversion - `dynamics` `integer` — Dynamics compared to the previous period (%) - `orders` `object` — Items ordered from search - `current` `integer` — Current number - `dynamics` `integer` — Dynamics compared to the previous period (%) - `cartToOrder` `object` — Conversion to order from search — the ratio of items ordered to all additions of the item from search to the cart - `current` `integer` — Current conversion - `dynamics` `integer` — Dynamics compared to the previous period (%) - `visibility` `object` — Item visibility percent in search results - `current` `integer` — Current visibility percent - `dynamics` `integer` — Dynamics compared to the previous period (%) - `currency` `Currency` **Structure `400`:** - `title` `string` — Error title - `detail` `string` — Error details - `requestId` `string` — Unique request ID - `origin` `string` — Internal WB 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` — Internal WB 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_v2_search_report_table_groups(table_group_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.postV2SearchReportTableGroups(tableGroupRequest); 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.PostV2SearchReportTableGroups(context.Background()).TableGroupRequest(tableGroupRequest).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.postV2SearchReportTableGroups(tableGroupRequest)); ``` **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->postV2SearchReportTableGroups($table_group_request)); ``` **OneScript** ```bsl #Использовать "wb-api-client" Настройки = Новый Конфигурация(); Настройки.УстановитьТокен(""); Клиент = Новый AnalyticsApi(Настройки); Сообщить(Клиент.PostV2SearchReportTableGroups(Тело).Тело); ``` **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.PostV2SearchReportTableGroups(tableGroupRequest)); ``` **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_v2_search_report_table_groups(&cfg, table_group_request).await; println!("{:#?}", result); } ```