--- title: "Get Report" description: "Method is available by Personal token, Service token" lang: en-US source: https://valeryverkhoturov.github.io/wb-api-client-docs/en/reference/api/analytics/post-api-analytics-v2-item-rating --- # Get Report ```http POST /api/analytics/v2/item-rating ``` **Base URL:** `https://seller-analytics-api.wildberries.ru` · **Module:** [`analytics`](https://valeryverkhoturov.github.io/wb-api-client-docs/en/reference/api/analytics/) · **Section:** Item Rating · [Specification doc ↗](https://dev.wildberries.ru/en/docs/openapi/analytics#tag/itemRating/operation/postV2ItemRating) Method is [available](https://dev.wildberries.ru/openapi/api-information#tag/authorization/Rules-for-using-API-access-tokens) by **Personal** token, **Service** token The method forms a dataset for item rating. The report data is updated once an hour. [Request limit](https://dev.wildberries.ru/openapi/api-information#tag/introduction/Rate-Limits) per one seller account: | Period | Limit | Interval | Burst | | ------ | ---------- | -------- | ---------- | | 1 min | 3 requests | 20 s | 3 requests | ## Request body `application/json` — schema `ItemRatingRequest`, required - `currentPeriod` `PeriodItemRating` (required) - `start` `string` (required) — Start date of the period. No later than `end`. No earlier than 364 days from yesterday - `end` `string` (required) — End date of the period. No earlier than 364 days from yesterday - `pastPeriod` `PastPeriodItemRating` - `start` `string` (required) — Start date of the period. No later than `end`. No earlier than 364 days from yesterday - `end` `string` (required) — End date of the period. No later than the day before the start date `currentPeriod`. No earlier than 364 days from yesterday - `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 - `isNotIncludeNmsWithoutSales` `boolean` — Are items with no sales returned: - `true` — yes, the method returns only items without sales for the period specified in the `currentPeriod` object - `false` — no, the method returns all items unless other parameters are specified - `onlyShadowedNms` `boolean` — Are only hidden items returned in the response: - `true` — yes, the method returns only items hidden from catalog - `false` — no, the method returns all items unless other parameters are specified - `orderBy` `OrderByItemRating` (required) - `field` `string` = `feedbackRating` | `feedbackCount` | `fiveStar` | `fourStar` | `threeStar` | `twoStar` | `oneStar` | `disqualified` (required) — Sorting field: - `feedbackRating` — Review-based rating - `feedbackCount` — Total reviews - `fiveStar` — 5 star reviews - `fourStar` — 4 star reviews - `threeStar` — 3 star reviews - `twoStar` — 2 star reviews - `oneStar` — 1 star reviews - `disqualified` — Excluded reviews - `mode` `string` = `asc` | `desc` (required) — Sorting order: - `asc` — ascending - `desc` — descending - `limit` `integer` — Number of items in the response - `offset` `integer` (required) — How many results to skip. For example, with value `10`, the response will start with the 11 element ## Responses | Code | Description | Schema | | ----- | ----------------- | ----------------------------- | | `200` | Success | `PostV2ItemRatingResponse200` | | `400` | Bad request | `ErrorObject400` | | `401` | Unauthorized | `object` | | `402` | Payment required | `object` | | `403` | Access denied | `ErrorObject403` | | `429` | Too many requests | `object` | **Structure `200`:** - `data` `ItemRatingResponse` - `sellerRating` `TableItemFloat` - `current` `number` — Current rating - `dynamics` `number` — Dynamics compared to the previous period (%) - `feedbackIncrease` `FeedbacksIncreaseItem` - `current` `integer` — Feedback increase for the period - `total` `integer` — Total ratings - `dynamics` `integer` — Dynamics compared to the previous period (%) - `fiveStar` `object` — 5 star reviews - `current` `integer` — Feedback increase for the period - `dynamics` `integer` — Dynamics compared to the previous period (%) - `total` `integer` — Total ratings - `fourStar` `object` — 4 star reviews - `current` `integer` — Feedback increase for the period - `dynamics` `integer` — Dynamics compared to the previous period (%) - `total` `integer` — Total ratings - `threeStar` `object` — 3 star reviews - `current` `integer` — Feedback increase for the period - `dynamics` `integer` — Dynamics compared to the previous period (%) - `total` `integer` — Total ratings - `twoStar` `object` — 1 star reviews - `current` `integer` — Feedback increase for the period - `dynamics` `integer` — Dynamics compared to the previous period (%) - `total` `integer` — Total ratings - `oneStar` `object` — 1 star reviews - `current` `integer` — Feedback increase for the period - `dynamics` `integer` — Dynamics compared to the previous period (%) - `total` `integer` — Total ratings - `items` `DistributionTableItem[]` — Item data - `nmId` `integer` — WB item number - `title` `string` — Item name - `vendorCode` `string` — Seller item number - `subjectId` `integer` — Subcategory ID - `subjectName` `string` — Subcategory name - `brandName` `string` — Brand - `tagName` `string` — Label name - `tagId` `integer` — Label ID - `pinnedFeedback` `boolean` — The review is pinned - `rating` `number` — Listing rating - `feedbackRating` `object` — Feedback rating - `current` `number` — Current rating - `dynamics` `number` — Dynamics compared to the previous period (%) - `percentile` `number` — How many percent of other sellers' items of this subcategory that have a lower feedback rating - `feedbackCount` `object` — Feedback count - `current` `integer` — Feedback increase for the period - `dynamics` `integer` — Dynamics compared to the previous period (%) - `fiveStar` `object` — 5 star reviews - `current` `integer` — Feedback increase for the period - `dynamics` `integer` — Dynamics compared to the previous period (%) - `fourStar` `object` — 4 star reviews - `current` `integer` — Feedback increase for the period - `dynamics` `integer` — Dynamics compared to the previous period (%) - `threeStar` `object` — 3 star reviews - `current` `integer` — Feedback increase for the period - `dynamics` `integer` — Dynamics compared to the previous period (%) - `twoStar` `object` — 2 star reviews - `current` `integer` — Feedback increase for the period - `dynamics` `integer` — Dynamics compared to the previous period (%) - `oneStar` `object` — 1 star reviews - `current` `integer` — Feedback increase for the period - `dynamics` `integer` — Dynamics compared to the previous period (%) - `disqualified` `integer` — Excluded reviews - `isShadowed` `boolean` — Is the item hidden from catalog: - `true` — the item is hidden from catalog - `false` — the item is not hidden from catalog **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_item_rating(item_rating_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.postV2ItemRating(itemRatingRequest); 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.PostV2ItemRating(context.Background()).ItemRatingRequest(itemRatingRequest).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.postV2ItemRating(itemRatingRequest)); ``` **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->postV2ItemRating($item_rating_request)); ``` **OneScript** ```bsl #Использовать "wb-api-client" Настройки = Новый Конфигурация(); Настройки.УстановитьТокен(""); Клиент = Новый AnalyticsApi(Настройки); Сообщить(Клиент.PostV2ItemRating(Тело).Тело); ``` **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.PostV2ItemRating(itemRatingRequest)); ``` **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_item_rating(&cfg, item_rating_request).await; println!("{:#?}", result); } ```