---
title: "App Store"
description: "New App Store reviews of your apps, per country, with their star rating."
canonical: https://docs.rumoro.dev/platforms/appstore
markdown: https://docs.rumoro.dev/platforms/appstore.mdx
---

# App Store

New App Store reviews of your apps, per country, with their star rating.

The App Store is a [review site](/platforms/reviews), so Rumoro doesn't search it for your term. You add apps to a keyword's `reviewSources`, and every new review of those apps becomes a mention, even if it doesn't name the app.

| `platform` | `appstore` |
| --- | --- |
| Finds | Every new review of the apps you add, per storefront (country) |
| Checked | Once a day for each app and storefront |
| New page | The 100 newest reviews per storefront, free |
| Source | Apple's public review feed |

## Add an app

Paste the app's App Store link and list the storefronts to read. Without `countries`, Rumoro uses the one in the link, or `us`.

```ts tab="TypeScript"
await rumoro.updateKeyword({
  path: { id: 'kw_...' },
  body: { reviewSources: [{ url: 'https://apps.apple.com/us/app/slack/id618783545', countries: ['us', 'gb', 'de'] }] },
});
```

```python tab="Python"
rumoro.keywords.update(
    "kw_...", reviewSources=[{"url": "https://apps.apple.com/us/app/slack/id618783545", "countries": ["us", "gb", "de"]}]
)
```

```bash tab="curl"
curl -X PATCH https://api.rumoro.dev/v1/keywords/kw_... \
  -H "Authorization: Bearer $RUMORO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "reviewSources": [
        { "url": "https://apps.apple.com/us/app/slack/id618783545", "countries": ["us", "gb", "de"] }
      ] }'
```

You can also send the number after `id` in the link, as `{ "platform": "appstore", "id": "618783545" }`. Each storefront has its own reviews. For an app reviewed mostly in Germany, add `de`. A review seen in two storefronts counts once.

## What you get

| Field | Holds |
| --- | --- |
| `post.text` | Review title, a blank line, then the review |
| `review.rating` | 1 to 5 |
| `review.title`, `review.version`, `review.country` | Title, the reviewer's app version, and country |
| `author` | Name and a link to the reviewer's App Store profile |
| `review.response` | Always `null`. Apple's feed leaves out developer replies. |

Sentiment comes from the stars and relevance from the keyword's kind. Intents are still read from the text.

## Limits

- Apple's feed shows the 500 newest reviews per storefront. A daily read only hits that limit for the very biggest apps.
- Apple lists a review a few hours after it is written, with the time it was written. So a review can show up a day after its date.
- A storefront where the app isn't sold stays empty.