How to Use Apple App Store top charts in Claude Code
Returns App Store rankings overall or by genre. Use it to identify chart leaders and compare their positions across repeated checks.
Prompts to try with Apple App Store top charts in Claude Code
Copy an example into Claude Code, or ask in your own words.
Use Apple App Store top charts to fetch the first 25 free Health & Fitness apps in the United States. Write a report comparing their positions with the previous chart snapshot in this project.
Use Apple App Store top charts to look this up and give me the result as a table. Save the result in ./assets.
Pull the latest numbers from Apple App Store top charts and tell me what changed since last week.
Check Apple App Store top charts and summarize what you find in three bullet points.
Pull the newest data from Apple App Store top charts and give me the result as a table.
How to set up Apple App Store top charts in Claude Code
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the hosted server
This adds Spiral to the current project. Add --scope user to use it in every project.
claude mcp add --transport http spiral https://api.spiral.ai/mcp
- Sign in
Start claude, type /mcp, choose spiral and Authenticate. Sign in to Spiral in the browser and click Authorize. No API key.
Use the Spiral skill
- Send Claude Code this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use the Spiral CLI
- Install and sign in
Installs the Spiral CLI, signs you in and adds its skill to your coding agents.
npx -y spiral-cli@latest init
Call the Spiral API
- Create an API key
In the console, under API keys.
- Run Apple App Store top charts
One request; the result comes back by polling or a webhook.
curl https://api.spiral.ai/v1/runs \ -H "Authorization: Bearer $SPIRAL_API_KEY" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: $(uuidgen)" \ -d '{ "provider": "alexandria", "model": "apps-apple-com/apps/top_charts", "input": { "chart": "top-free" } }'
Then paste one of the prompts above: Claude Code finds Apple App Store top charts on Spiral, shows the price and runs it.
Apple App Store top charts providers and prices
Spiral runs Apple App Store top charts through Alexandria. Open a card for today's price, with every fee included.
Settings you can ask for
Ask Claude Code for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Chart | top-free, top-paid, or top-grossing | Default | |
| Limit | 1 to 200 | Number of ranks (default 25). |
Every API field of Apple App Store · Top charts is on its tool page: open its card above.
What can you do with Apple App Store top charts in Claude Code?
Build an App Store research report that connects discovered apps with publisher catalogs, release information, charts, and customer feedback. A coding agent can compare the returned data with project requirements and turn review themes into investigation tasks.
Build a competitor research brief
Find meditation apps by keyword, identify chart leaders, inspect their listings, read customer complaints, and check each publisher's other apps. Use the results to propose feature comparisons supported by public evidence.
Research a regional launch
Compare US and UK keyword results, category charts, publisher catalogs, individual listings, and customer feedback. Keep territory-specific ratings separate when assessing the two markets.
Prepare a weekly category briefing
Review Health & Fitness chart positions, search for relevant apps, check publisher catalogs, inspect release notes, and summarize customer feedback. Compare successive reports to identify changes worth investigating.
Research an app comparison article
Discover candidates through search and charts, confirm publishers through their catalogs, check device requirements, and examine review themes. Build an editorial shortlist with clear reasons for including each app.
Find product research questions
Use keyword results and category charts to select apps for review analysis. Turn recurring customer complaints into interview questions about unmet needs without profiling reviewers.
Watch category rank changes
Compare repeated category-chart checks and inspect the listings of apps that move. Add version history to the report as context for each observed change.
More on Apple App Store top charts and Claude Code
Overview
Apple App Store top charts in other agents
Questions about Apple App Store top charts in Claude Code
Can Claude Code use Apple App Store top charts?
Yes. Add Spiral to Claude Code as an MCP server, and Claude Code can find and run Apple App Store top charts like any built-in tool.
How much does Apple App Store top charts cost in Claude Code?
$0.00873 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Claude Code plan is separate.
Do I need an Alexandria account to use Apple App Store top charts in Claude Code?
No. Spiral runs Apple App Store top charts on its own Alexandria account. You sign in to Spiral once and never paste a key.
How long does it take to set up Apple App Store top charts in Claude Code?
About two minutes: add the hosted server, then sign in.
Does Claude Code wait while Apple App Store top charts runs?
Apple App Store top charts runs in the background. Claude Code starts the run, checks on it and gives you the json when it's ready.
Does an App Store listing cover every country?
Apple documents 175 App Store countries or regions, but publishers choose where to release each app. A listing in the United States does not establish availability in Japan or Germany.
How quickly do availability changes appear?
Apple says availability changes may take up to 24 hours to become visible to all users. This is a publishing delay for availability changes, not a refresh schedule for every App Store data field.
Is an app's rating a worldwide average?
No. Apple calculates the displayed summary rating for each territory, so US and UK ratings describe different storefront audiences.
Does the public review history preserve every review revision?
Apple displays only the latest review and response for each user. Written reviews also survive a summary-rating reset, so the visible reviews and summary rating can cover different periods.
Can one keyword search return the entire matching catalog?
Apple's documented iTunes search range stops at 200 results per request. Treat keyword results as a candidate list rather than evidence that every matching app has been found.
Start using Apple App Store top charts in Claude Code
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Claude Code:
set up https://spiral.ai/SKILL.md


