List Apple App Store reviews
apple_app_store_app_reviews_listFetch customer reviews for an Apple App Store app, including developer replies. Filter by country and sort by recent, helpful, favorable, or critical, with pagination via app ID.
Instructions
List customer reviews for an Apple App Store app with developer replies. Requires appId. Returns a list (use page when paginated).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"appId": "<appId>",
"context": "<context>",
"llm_model": "<llm_model>"
},
"name": "apple_app_store_app_reviews_list"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number (1-based), 20 reviews a page, up to page 5,000. A deep page of a very long list can come back empty with `depthLimited: true`; ask again or try another sort; stop at the first empty page. Default: 1. | |
| sort | No | `recent` (newest first), `helpful` (Apple's own ranking), `favorable` (newest 5 star reviews only) or `critical` (newest 1 star reviews only). Default: `recent`. | |
| appId | Yes | Required. Numeric App Store app id, e.g. `284882215`. An id with the `id` prefix used in App Store links (`id284882215`) is also accepted. | |
| context | Yes | Describe the user's underlying goal in one sentence, not the tool you are calling. | |
| country | No | Two-letter storefront code, e.g. `us`, `gb` or `jp`, case-insensitive. Prices, ratings, reviews and text are specific to it. A code Apple does not run a store for is refused. Default: `us`. | |
| llm_model | Yes | The exact model identifier you (the assistant) are running as, taken from your system prompt or environment (for example "claude-opus-4-8" or "gpt-5.2"). Used for analytics only. If you do not know your model identifier with certainty, pass "unknown" and do not guess. | |
| conversation_id | No | Echo the conversation_id from the server's previous response. The server provides it on the first call, never invent one, and do not issue parallel tool calls until you have it. |