> ## Documentation Index
> Fetch the complete documentation index at: https://mindcase.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# App Store Reviews

> Extract App Store reviews – text, rating, author, and date – from app URLs

`$0.1 / 1k reviews`

Extract App Store reviews – text, rating, author, and date – from app URLs

## Endpoint

`POST /api/v1/agents/appstore/reviews/run`

## Parameters

<ParamField body="urls" type="array" required>
  **List** · App Store URLs to scrape reviews from. Format: [https://apps.apple.com/us/app/instagram/id389801252](https://apps.apple.com/us/app/instagram/id389801252). One per line.
</ParamField>

<ParamField body="country" type="string" default="us">
  **Dropdown** · Country's App Store to pull reviews from. Defaults to the country in the URL, or US if missing.

  [View all 65 options →](/agents/appstore/reviews/values#country)
</ParamField>

<ParamField body="maxResults" type="integer" default={100}>
  **Number** · Max reviews per app. Use 0 for all.
</ParamField>

## Response columns

| Field         | Display name | Type   |
| ------------- | ------------ | ------ |
| `appUrl`      | App URL      | url    |
| `reviewUrl`   | Review URL   | url    |
| `reviewTitle` | Review Title | text   |
| `reviewText`  | Review Text  | text   |
| `rating`      | Rating       | rating |
| `reviewer`    | Reviewer     | text   |
| `reviewerUrl` | Reviewer URL | url    |
| `posted`      | Posted       | text   |
| `appVersion`  | App Version  | text   |
| `country`     | Country      | text   |

## Example

<CodeGroup>
  ```bash curl theme={null}
  curl -X POST https://api.mindcase.co/api/v1/agents/appstore/reviews/run \
    -H "Authorization: Bearer mk_live_abc123def456" \
    -H "Content-Type: application/json" \
    -d '{
    "params": {
      "appIds": [
        "284882215",
        "408709785"
      ],
      "urls": [
        "https://apps.apple.com/gb/app/instagram/id389801252",
        "https://apps.apple.com/ca/app/tiktok/id835599320"
      ],
      "maxResults": 10,
      "customMapFunction": "(object) => { return {...object} }"
    }
  }'
  ```

  ```python Python theme={null}
  import requests

  resp = requests.post(
      "https://api.mindcase.co/api/v1/agents/appstore/reviews/run",
      headers={"Authorization": "Bearer mk_live_abc123def456"},
      json={"params": {
      "appIds": [
          "284882215",
          "408709785"
      ],
      "urls": [
          "https://apps.apple.com/gb/app/instagram/id389801252",
          "https://apps.apple.com/ca/app/tiktok/id835599320"
      ],
      "maxResults": 10,
      "customMapFunction": "(object) => { return {...object} }"
  }},
  )
  data = resp.json()
  ```
</CodeGroup>

### Example response

```json Response theme={null}
{
  "job_id": "job_7f3a2b1c",
  "status": "completed",
  "data": [
    {
      "appUrl": "https://apps.apple.com/us/app/id408709785",
      "reviewUrl": "https://itunes.apple.com/us/review?id=408709785&type=Purple%20Software",
      "reviewTitle": "Ringtones",
      "reviewText": "Free ringtones",
      "rating": 5,
      "reviewer": "Alersar7",
      "reviewerUrl": "https://itunes.apple.com/us/reviews/id1717541561",
      "posted": "2026-04-29T23:28:12-07:00",
      "appVersion": "2.3.18",
      "country": "US"
    }
  ]
}
```