List Apple App Store charts
apple_app_store_charts_listRetrieve Apple App Store chart rankings with full app records, filtered by country, chart type, platform, genre, and result limit. Use it to analyze top free, paid, grossing, or new apps.
Instructions
List Apple App Store charts with full app records. Optional inputs: country, chart, platform, genre and limit. Returns a list.
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": {
"context": "<context>",
"llm_model": "<llm_model>"
},
"name": "apple_app_store_charts_list"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| chart | No | `top-free`, `top-paid`, `top-grossing`, `new`, `new-free` or `new-paid`. `top-grossing` is available on iPhone and iPad; the `new` charts on iPhone only. Default: `top-free`. | |
| genre | No | Genre id to rank within, e.g. `6014` for Games or `6005` for Social Networking. Default: `36`, all apps. | |
| limit | No | Ranks to return, 1-200 (1-100 for top-grossing and the new charts). Default: 100. | |
| 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`. | |
| platform | No | `iphone`, `ipad` or `mac`. Default: `iphone`. | |
| 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. |