List Customer Reviews
asc_list_customer_reviewsRetrieve customer reviews for any app from App Store Connect. Filter by rating, territory, or sort order, with pagination support.
Instructions
List customer reviews for an app.
Args:
appId (string, required): The App Store Connect app ID
sort (string): 'createdDate' | '-createdDate' (default) | 'rating' | '-rating'
territory (string, optional): ISO 3166-1 alpha-3 territory code filter (e.g. 'USA', 'JPN')
rating (number, optional): Filter by star rating, 1-5
limit (number): Maximum number of reviews to return (default 20, max 200)
nextUrl (string, optional): Pagination URL returned by a previous call
Returns: { "count": number, "items": [ { "id": string, "rating": number, // 1-5 "title": string, "body": string, "reviewerNickname": string, "createdDate": string, // ISO 8601 "territory": string // ISO 3166-1 alpha-3 } ], "nextUrl": string | undefined }
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | Sort order: 'createdDate' (oldest first), '-createdDate' (newest first, default), 'rating' (lowest first), '-rating' (highest first). | -createdDate |
| appId | Yes | The App Store Connect app ID to list customer reviews for. | |
| limit | No | Maximum number of items to return (default 20, max 200). | |
| rating | No | Filter by star rating (1-5). | |
| nextUrl | No | The nextUrl value returned by a previous call to this tool. Pass it back unchanged to fetch the next page. Omit for the first page. | |
| territory | No | Filter by ISO 3166-1 alpha-3 territory code (e.g. 'USA', 'JPN'). |