Customer Reviews

Overview

The customerReviews resource represents the ratings and reviews that customers write for your app that the App Store displays. Customers can provide reviews for your app in the App Store, or when your app requests a review. For more information about reviews, see Ratings, Reviews, and Responses.

Use this API to read the customer reviews for your app as follows:

• Call the List All Customer Reviews for an App endpoint to get all customer reviews for your app. Filter the reviews by territory and rating, and sort them by date or rating. You can also get a list of the reviews with or without published responses.

• Call the List All Customer Reviews for an App Store Version endpoint to get the customer reviews for a specific app version.

• Call the Read Customer Review Information endpoint using the resource ID of the review to read the details of a specific review.

To manage your responses to the customers reviews, use the endpoints in Customer Review Responses. For example, call Get a Customer Review Response using the resource ID of the customer review to read your response to that review.

Topics

Getting customer reviews for an app or app version

• List All Customer Reviews for an App
• GET /v1/apps/{id}/relationships/customerReviews
• List All Customer Reviews for an App Store Version

Reading customer reviews

• Read Customer Review Information

Reading review summariztions

• Read customer review summarizations

Objects

• CustomerReviewsResponse
• CustomerReviewResponse
• CustomerReview
• AppCustomerReviewsLinkagesResponse
• CustomerReviewSummarization
• CustomerReviewSummarizationsResponse

See Also

Customer Reviews and Responses

• Customer Review Responses