[Integrations](https://spiral.ai/integrations) › [opencode](https://spiral.ai/integrations/opencode) › [Apple App Store app reviews](https://spiral.ai/integrations/opencode/apple-app-store-app-reviews)

# How to Use Apple App Store app reviews in opencode

Returns paginated customer reviews for an app. Use it to examine reported problems and feature requests behind the summary rating.

|  |  |
| --- | --- |
| Model | Apple App Store app reviews |
| Available through | Alexandria |
| Category | E-commerce |
| Price | $0.00873 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Apple App Store app reviews in opencode

- Use Apple App Store app reviews for Headspace, app 493145008, in the United States. Summarize the 10 newest reviews and draft QA investigation tasks for reported technical problems.
- Use Apple App Store app reviews 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 app reviews and tell me what changed since last week.
- Check Apple App Store app reviews and summarize what you find in three bullet points.
- Pull the newest data from Apple App Store app reviews and give me the result as a table.

## How to set up Apple App Store app reviews in opencode

Pick the way that suits you. Each takes about two minutes.

### Use Spiral's MCP server

1. **Add the server**: Leave out `--global` to add Spiral to the current project only. No header and no client ID or secret: opencode registers itself with Spiral.

```bash
opencode mcp add spiral --global --url https://api.spiral.ai/mcp
```

2. **Sign in**: Your browser opens. Sign in to Spiral, pick the organization and click Authorize, then return to the terminal. No API key. Inside opencode, `/mcps` starts the same sign-in.

```bash
opencode mcp auth spiral
```

3. **Check it**: Spiral shows as connected.

```bash
opencode mcp list
```

### Use the Spiral skill

1. **Send opencode this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run Apple App Store app reviews**: One request; the result comes back by polling or a webhook.

```bash
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/reviews",
    "input": {
      "app_id": "<app_id>"
    }
  }'
```

Then paste one of the prompts above: opencode finds Apple App Store app reviews on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/opencode

## Apple App Store app reviews tools and prices

- [Apple App Store · Reviews](https://spiral.ai/tools/alexandria/apps-apple-com/apps/reviews) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| sort | most_recent, most_helpful, most_favorable, most_critical | — | Review order, the App Store's own sort options. `most_recent` (default): newest first, dates non-increasing within and across pages. `most_helpful`: Apple's 'Most Helpful' ranking, not chronological. `most_favorable` / `most_critical`: positive / critical reviews (observed as 5-star / 1-star), newest first. |
| limit | 1 to 10 | — | Reviews per page (default and maximum 10, the page size the App Store web client uses). |
| locale |  | — | Display locale for names, descriptions and release notes, e.g. `en-US`, `en-GB`. Default `en-US`. Pattern: ^[a-zA-Z]{2,3}(-[a-zA-Z0-9]{2,8})*$. |
| offset | 0 to 10000 | — | Zero-based offset; pass `next_offset` from the previous page. |
| country |  | — | Two-letter App Store storefront code (lowercase, e.g. `us`, `gb`, `de`). Default `us`. Prices and availability are storefront specific. Pattern: ^[a-zA-Z]{2}$. |

## What can you do with Apple App Store app reviews in opencode?

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.

### Investigate feedback around a release

Compare an app's version history with customer reviews to find reports that warrant a QA investigation. Present the timing as a lead to investigate rather than proof that an update caused a problem.

### 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.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All opencode guides](https://spiral.ai/integrations/opencode)

## Apple App Store app reviews in other agents

- [Amp](https://spiral.ai/integrations/amp/apple-app-store-app-reviews)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/apple-app-store-app-reviews)
- [Claude](https://spiral.ai/integrations/claude-desktop/apple-app-store-app-reviews)
- [Claude Code](https://spiral.ai/integrations/claude-code/apple-app-store-app-reviews)
- [Cline](https://spiral.ai/integrations/cline/apple-app-store-app-reviews)
- [Codex](https://spiral.ai/integrations/codex/apple-app-store-app-reviews)
- [Cursor](https://spiral.ai/integrations/cursor/apple-app-store-app-reviews)
- [Devin](https://spiral.ai/integrations/devin/apple-app-store-app-reviews)
- [dots](https://spiral.ai/integrations/dots/apple-app-store-app-reviews)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/apple-app-store-app-reviews)
- [Gemini](https://spiral.ai/integrations/gemini/apple-app-store-app-reviews)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/apple-app-store-app-reviews)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/apple-app-store-app-reviews)
- [goose](https://spiral.ai/integrations/goose/apple-app-store-app-reviews)
- [Grok](https://spiral.ai/integrations/grok/apple-app-store-app-reviews)
- [Grok Build](https://spiral.ai/integrations/grok-build/apple-app-store-app-reviews)
- [Hermes](https://spiral.ai/integrations/hermes/apple-app-store-app-reviews)
- [Instinct](https://spiral.ai/integrations/instinct/apple-app-store-app-reviews)
- [Manus](https://spiral.ai/integrations/manus/apple-app-store-app-reviews)
- [Muse](https://spiral.ai/integrations/muse/apple-app-store-app-reviews)
- [Muse Code](https://spiral.ai/integrations/muse-code/apple-app-store-app-reviews)
- [n8n](https://spiral.ai/integrations/n8n/apple-app-store-app-reviews)
- [Notion](https://spiral.ai/integrations/notion/apple-app-store-app-reviews)
- [OpenClaw](https://spiral.ai/integrations/openclaw/apple-app-store-app-reviews)
- [Perplexity](https://spiral.ai/integrations/perplexity/apple-app-store-app-reviews)
- [Raycast](https://spiral.ai/integrations/raycast/apple-app-store-app-reviews)
- [VS Code](https://spiral.ai/integrations/vscode/apple-app-store-app-reviews)
- [Windsurf](https://spiral.ai/integrations/windsurf/apple-app-store-app-reviews)
- [Zapier](https://spiral.ai/integrations/zapier/apple-app-store-app-reviews)

## More opencode guides

- [Apple App Store app details](https://spiral.ai/integrations/opencode/apple-app-store-app-details)
- [Apple App Store app search](https://spiral.ai/integrations/opencode/apple-app-store-app-search)
- [Amazon.nl product search](https://spiral.ai/integrations/opencode/amazon-nl-product-search)
- [Apple App Store developer apps](https://spiral.ai/integrations/opencode/apple-app-store-developer-apps)
- [Amazon.nl product review summary](https://spiral.ai/integrations/opencode/amazon-nl-product-review-summary)
- [Apple App Store top charts](https://spiral.ai/integrations/opencode/apple-app-store-top-charts)

## Questions about Apple App Store app reviews in opencode

**Can opencode use Apple App Store app reviews?**

Yes. Add Spiral to opencode as an MCP server, and opencode can find and run Apple App Store app reviews like any built-in tool.

**How much does Apple App Store app reviews cost in opencode?**

$0.00873 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your opencode plan is separate.

**Do I need an Alexandria account to use Apple App Store app reviews in opencode?**

No. Spiral runs Apple App Store app reviews 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 app reviews in opencode?**

About two minutes: add the server, then sign in, then check it.

**Does opencode wait while Apple App Store app reviews runs?**

Apple App Store app reviews runs in the background. opencode 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.

