> ## Documentation Index > Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt > Use this file to discover all available pages before exploring further. # Get Item Review Summary > Get a summary of all ratings and reviews associated with the specified item. Summary ratings data is cached with update data coming within 15 minutes. Allowed entity token types: title, master_player_account, title_player_account ## Error codes This operation may return the following PlayFab errors: | Error | Code | | --- | --- | | DatabaseThroughputExceeded | 1113 | | ItemNotFound | 1047 | ## OpenAPI ````yaml /services/playfab/api-references/rest/economy/economy.openapi.json post /Catalog/GetItemReviewSummary openapi: 3.0.0 info: version: '260922' title: PlayFab Economy API description: >- API methods for managing the catalog. Inventory manages in-game assets for any given entity. API methods for managing the versioned catalogs. termsOfService: https://playfab.com/terms/ contact: url: https://community.playfab.com/index.html license: name: Apache 2.0 url: https://github.com/PlayFab/API_Specs/blob/master/LICENSE servers: - url: https://{titleId}.playfabapi.com description: PlayFab title endpoint variables: titleId: default: your_title_id description: Your PlayFab title ID (hex). security: [] tags: - name: Catalog description: |- Catalog Management APIs. In general for Catalog APIs, Read APIs are limited to 100 requests in 60 seconds for Player Entities while Title Entities are limited to 10000 requests in 10 seconds. For Write APIs, Player Entities are limited to 10 requests in 30 seconds and Title Entities are limited to 1000 requests in 10 seconds. - name: Inventory description: |- Player Inventory Management APIs. Inventory operations work on an eventually consistent system against a cache of the Catalog. It can take a few moments for changes to propagate. In general for Inventory APIs, Read APIs are limited to 100 requests in 60 seconds for Player Entities while Title Entities are limited to 10000 requests in 10 seconds. For Write APIs, Player Entities are limited to 30 requests in 90 seconds and Title Entities are limited to 1000 requests in 10 seconds. - name: VersionedCatalog description: '' paths: /Catalog/GetItemReviewSummary: post: tags: - Catalog summary: Get Item Review Summary description: > Get a summary of all ratings and reviews associated with the specified item. Summary ratings data is cached with update data coming within 15 minutes. Allowed entity token types: title, master_player_account, title_player_account ## Error codes This operation may return the following PlayFab errors: | Error | Code | | --- | --- | | DatabaseThroughputExceeded | 1113 | | ItemNotFound | 1047 | operationId: GetItemReviewSummary requestBody: content: application/json: schema: $ref: '#/components/schemas/GetItemReviewSummaryRequest' responses: '200': $ref: '#/components/responses/GetItemReviewSummaryResponse' '400': $ref: '#/components/responses/ApiErrorWrapper' security: - EntityToken: [] components: schemas: GetItemReviewSummaryRequest: type: object properties: AlternateId: allOf: - $ref: '#/components/schemas/CatalogAlternateId' description: An alternate ID associated with this item. CustomTags: description: >- The optional custom tags associated with the request (e.g. build number, external trace identifiers, etc.). type: object Id: description: The unique ID of the item. type: string example: Id: dddddddd-dddd-dddd-dddd-dddddddddddd CatalogAlternateId: type: object properties: Type: description: Type of the alternate ID. type: string Value: description: Value of the alternate ID. type: string GetItemReviewSummaryResponse: type: object properties: LeastFavorableReview: allOf: - $ref: '#/components/schemas/Review' description: The least favorable review for this item. MostFavorableReview: allOf: - $ref: '#/components/schemas/Review' description: The most favorable review for this item. Rating: allOf: - $ref: '#/components/schemas/Rating' description: The summary of ratings associated with this item. ReviewsCount: description: The total number of reviews associated with this item. type: number x-actualtype: int32 required: - ReviewsCount example: Rating: Average: 3.6 TotalCount: 8 Count5Star: 1 Count4Star: 4 Count3Star: 2 Count2Star: 1 Count1Star: 0 ReviewsCount: 8 MostFavorableReview: ReviewId: 00000000-0000-0000-0000-000000000004 ItemId: 00000000-0000-0000-0000-000000000005 ReviewerEntity: Id: ABCD1234 Type: title_player_account TypeString: title_player_account ReviewerId: title_player_account!ABCD1234 ItemVersion: 2.1.4 Title: Best game ever ReviewText: I play this game every day. It's so much fun! Rating: 5 IsInstalled: true Locale: en-us HelpfulPositive: 16 HelpfulNegative: 1 Submitted: '2018-08-17T22:32:10.4729879+00:00' LeastFavorableReview: ReviewId: 00000000-0000-0000-0000-000000000006 ItemId: 00000000-0000-0000-0000-000000000005 ReviewerEntity: Id: EFGH5678 Type: title_player_account TypeString: title_player_account ReviewerId: title_player_account!EFGH5678 ItemVersion: 2.1.2 Title: It's a game ReviewText: '' Rating: 2 IsInstalled: true Locale: en-us HelpfulNegative: 10 Submitted: '2018-08-17T22:32:10.4729879+00:00' ApiErrorWrapper: description: The basic wrapper around every failed API response type: object properties: code: description: Numerical HTTP code type: integer status: description: String HTTP code type: string error: description: Playfab error code type: string errorCode: description: Numerical PlayFab error code type: integer errorMessage: description: Description for the PlayFab errorCode type: string errorDetails: description: Detailed description of individual issues with the request object type: object required: - code - errorCode Review: type: object properties: CategoryRatings: description: >- The star rating associated with each selected category in this review. type: object x-actualtype: int32 HelpfulNegative: description: The number of negative helpfulness votes for this review. type: number x-actualtype: int32 HelpfulPositive: description: The number of positive helpfulness votes for this review. type: number x-actualtype: int32 IsInstalled: description: Indicates whether the review author has the item installed. type: boolean ItemId: description: The ID of the item being reviewed. type: string ItemVersion: description: The version of the item being reviewed. type: string Locale: description: The locale for which this review was submitted in. type: string Rating: description: Star rating associated with this review. type: number x-actualtype: int32 ReviewerEntity: allOf: - $ref: '#/components/schemas/EntityKey' description: The ID of the author of the review. ReviewId: description: The ID of the review. type: string ReviewText: description: The full text of this review. type: string Submitted: description: The date and time this review was last submitted. type: string Title: description: The title of this review. type: string required: - Rating - IsInstalled - HelpfulPositive - HelpfulNegative - Submitted Rating: type: object properties: Average: description: The average rating for this item. type: number x-actualtype: float Count1Star: description: The total count of 1 star ratings for this item. type: number x-actualtype: int32 Count2Star: description: The total count of 2 star ratings for this item. type: number x-actualtype: int32 Count3Star: description: The total count of 3 star ratings for this item. type: number x-actualtype: int32 Count4Star: description: The total count of 4 star ratings for this item. type: number x-actualtype: int32 Count5Star: description: The total count of 5 star ratings for this item. type: number x-actualtype: int32 TotalCount: description: The total count of ratings for this item. type: number x-actualtype: int32 EntityKey: description: >- Combined entity type and ID structure which uniquely identifies a single entity. type: object properties: Id: description: Unique ID of the entity. type: string Type: description: >- Entity type. See https://learn.microsoft.com/gaming/playfab/features/data/entities/available-built-in-entity-types type: string required: - Id responses: GetItemReviewSummaryResponse: description: '' content: application/json: schema: type: object properties: code: type: integer description: >- The Http status code. If X-ReportErrorAsSuccess header is set to true, this will report the actual http error code. status: type: string description: The Http status code as a string. data: $ref: '#/components/schemas/GetItemReviewSummaryResponse' example: code: 200 status: OK data: Rating: Average: 3.6 TotalCount: 8 Count5Star: 1 Count4Star: 4 Count3Star: 2 Count2Star: 1 Count1Star: 0 ReviewsCount: 8 MostFavorableReview: ReviewId: 00000000-0000-0000-0000-000000000004 ItemId: 00000000-0000-0000-0000-000000000005 ReviewerEntity: Id: ABCD1234 Type: title_player_account TypeString: title_player_account ReviewerId: title_player_account!ABCD1234 ItemVersion: 2.1.4 Title: Best game ever ReviewText: I play this game every day. It's so much fun! Rating: 5 IsInstalled: true Locale: en-us HelpfulPositive: 16 HelpfulNegative: 1 Submitted: '2018-08-17T22:32:10.4729879+00:00' LeastFavorableReview: ReviewId: 00000000-0000-0000-0000-000000000006 ItemId: 00000000-0000-0000-0000-000000000005 ReviewerEntity: Id: EFGH5678 Type: title_player_account TypeString: title_player_account ReviewerId: title_player_account!EFGH5678 ItemVersion: 2.1.2 Title: It's a game ReviewText: '' Rating: 2 IsInstalled: true Locale: en-us HelpfulNegative: 10 Submitted: '2018-08-17T22:32:10.4729879+00:00' ApiErrorWrapper: description: This is the outer wrapper for all responses with errors content: application/json: schema: $ref: '#/components/schemas/ApiErrorWrapper' securitySchemes: EntityToken: type: apiKey in: header name: X-EntityToken description: >- This API requires an Entity Session Token, available from the Entity GetEntityToken method. ```` ## Related topics - [Get Item Review Summary](/services/playfab/api-references/rest/economy/catalog/get-item-review-summary.md) - [PFCatalogGetItemReviewSummaryAsync](/services/playfab/api-references/c/pfcatalog/functions/pfcataloggetitemreviewsummaryasync.md) - [PFCatalogGetItemReviewSummaryResponse](/services/playfab/api-references/c/pfcatalogtypes/structs/pfcataloggetitemreviewsummaryresponse.md) - [PFCatalogGetItemReviewSummaryRequest](/services/playfab/api-references/c/pfcatalogtypes/structs/pfcataloggetitemreviewsummaryrequest.md) - [PFCatalogGetItemReviewSummaryGetResult](/services/playfab/api-references/c/pfcatalog/functions/pfcataloggetitemreviewsummarygetresult.md)