---
title: "App Store"
description: "Reviews of the iPhone and iPad apps a keyword names, with their stars, title and app version."
canonical: https://docs.mentio.dev/platforms/appstore
markdown: https://docs.mentio.dev/platforms/appstore.mdx
---

# App Store

Reviews of the iPhone and iPad apps a keyword names, with their stars, title and app version.

The App Store is a [review platform](/platforms/reviews): the term is never searched here. A keyword names apps in its `reviewSources`, and every new review of them becomes a mention, named or not.

| `platform`    | `appstore`                                                             |
| ------------- | ---------------------------------------------------------------------- |
| What is found | Every new review of the apps a keyword names, per storefront (country) |
| Freshness     | About once a day per app and storefront                                |
| Last 30 days  | Yes, the newest 100 reviews per storefront, free                       |
| Source        | Apple's public customer review feed                                    |

## Connect an app [#connect-an-app]

Paste the app's App Store link, and name the storefronts to read (default: the one in the link, else `us`):

TypeScript:

```ts
const response = await fetch('https://api.mentio.dev/v1/keywords/kw_123', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${process.env.MENTIO_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "reviewSources": [
      {
        "url": "https://apps.apple.com/us/app/acme/id1234567890",
        "countries": [
          "us",
          "gb",
          "de"
        ]
      }
    ]
  }),
});

const data = await response.json();
console.log(data);
```

Python:

```python
import os
import requests

response = requests.patch(
    "https://api.mentio.dev/v1/keywords/kw_123",
    headers={"Authorization": f"Bearer {os.environ['MENTIO_API_KEY']}"},
    json={
      "reviewSources": [
        {
          "url": "https://apps.apple.com/us/app/acme/id1234567890",
          "countries": [
            "us",
            "gb",
            "de"
          ]
        }
      ]
    },
)
print(response.json())
```

cURL:

```bash
curl -X PATCH "https://api.mentio.dev/v1/keywords/kw_123" \
  -H "Authorization: Bearer $MENTIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "reviewSources": [
    {
      "url": "https://apps.apple.com/us/app/acme/id1234567890",
      "countries": [
        "us",
        "gb",
        "de"
      ]
    }
  ]
}'
```

The id is the digits after `id` in the link; `{ "platform": "appstore", "id": "1234567890" }` works too. Reviews are stored per storefront, so an app reviewed mostly in Germany needs `de`. The same review seen in two storefronts is one mention.

## Read its reviews [#read-its-reviews]

Filter the mentions list to App Store. `ratings=1,2` keeps the unhappy ones.

TypeScript:

```ts
const response = await fetch('https://api.mentio.dev/v1/mentions?platforms=appstore&ratings=1,2', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.MENTIO_API_KEY}`,
  },
});

const data = await response.json();
console.log(data);
```

Python:

```python
import os
import requests

response = requests.get(
    "https://api.mentio.dev/v1/mentions?platforms=appstore&ratings=1,2",
    headers={"Authorization": f"Bearer {os.environ['MENTIO_API_KEY']}"},
)
print(response.json())
```

cURL:

```bash
curl -X GET "https://api.mentio.dev/v1/mentions?platforms=appstore&ratings=1,2" \
  -H "Authorization: Bearer $MENTIO_API_KEY"
```

Response (trimmed):

```json
{
  "data": [
    {
      "id": "mm_8f2k1x9q",
      "status": "open",
      "relevant": true,
      "keyword": {
        "id": "kw_123",
        "term": "Acme"
      },
      "post": {
        "publishedAt": "2026-11-07T14:32:10.000Z",
        "platform": "appstore",
        "kind": "post",
        "url": "https://apps.apple.com/us/app/acme/id1234567890",
        "text": "Crashes on launch since the last update. Please fix."
      },
      "author": {
        "name": "kate_r",
        "handle": "kate_r"
      },
      "review": {
        "rating": 1,
        "ratingMax": 5,
        "title": "Crashes since 4.2",
        "version": "4.2.0",
        "country": "us",
        "app": {
          "platform": "appstore",
          "id": "1234567890",
          "url": "https://apps.apple.com/us/app/acme/id1234567890"
        }
      },
      "classification": {
        "relevance": 95,
        "sentiment": "negative",
        "intents": [
          "bug_report",
          "complaint"
        ],
        "note": "A customer reports a problem with Acme."
      }
    }
  ],
  "nextCursor": "eyJ0IjoxNzMxMDAwMDAwfQ"
}
```

## What a mention carries [#what-a-mention-carries]

* `post.text`: the review's title, a blank line, then its body.
* `review.rating` (1 to 5), `review.title`, `review.version` (the app version the reviewer ran) and `review.country`.
* `author.name` and a link to the reviewer's App Store profile.
* `review.response` is always `null`: Apple's feed does not carry the developer's reply.
* Sentiment comes from the stars (4 and 5 positive, 3 neutral, 1 and 2 negative) and relevance from the keyword's kind; the classifier still adds the intent tags.

## Limits [#limits]

* Apple's feed lists the newest 500 reviews of a storefront. A daily poll never outgrows that except for the very largest apps.
* Apple lists a review a few hours after it was written, under the time it was written, so a review can reach the feed a day later than its date.
* An app that is not sold in a storefront has no reviews there: that storefront is simply empty.