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

# App Store Apps API

> Get App Store apps with title, subtitle, app url, bundle id, developer, developer id, by app ids, search query or country.

`POST /v1/data/app-store/apps/run`

**Pricing:** $0.0025 per app ($2.50 per 1,000).

## Ways to call it

* **App IDs**: set `appIds` (optional: `maxResults`, `language`, `country`)
* **Search Query**: set `query` (optional: `maxResults`, `language`, `country`)

## Request

Send the inputs under `params`. Only the keys below are accepted; any other key returns `422 invalid_params`.

**appIds** `string[]`

One or more app ids. One request reads them all.

**query** `string`

Search Query.

**maxResults** `integer` (default: 10)

How many apps to return in total. Defaults to 10; use 0 for all.

**country** `string` (default: us)

App Store country (storefront) to read, e.g. United States. Defaults to United States.

175 allowed values, for example `af` (Afghanistan), `al` (Albania), `dz` (Algeria), `ao` (Angola), `ai` (Anguilla), `ag` (Antigua and Barbuda), `ar` (Argentina), `am` (Armenia), `au` (Australia), `at` (Austria). Fetch the full list with `GET /v1/data/app-store/apps?expand=options`.

**language** `string`

Language.

## Example

```bash cURL theme={null}
curl -X POST "https://api.mindcase.co/v1/data/app-store/apps/run?wait=true" \
  -H "Authorization: Bearer $MINDCASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "params": {
    "appIds": [
      "310633997",
      "425073498",
      "904237743"
    ],
    "country": "us",
    "language": "en",
    "maxResults": 10
  }
}'
```

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

r = requests.post(
    "https://api.mindcase.co/v1/data/app-store/apps/run",
    params={"wait": "true"},
    headers={"Authorization": f"Bearer {os.environ['MINDCASE_API_KEY']}"},
    json={"params": {
    "appIds": [
        "310633997",
        "425073498",
        "904237743"
    ],
    "country": "us",
    "language": "en",
    "maxResults": 10
}},
)
job = r.json()
rows = job.get("data", [])  # if job["status"] == "running", poll /v1/jobs/{job_id}/results
```

```javascript Node.js theme={null}
const r = await fetch("https://api.mindcase.co/v1/data/app-store/apps/run?wait=true", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.MINDCASE_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ params: {
  "appIds": [
    "310633997",
    "425073498",
    "904237743"
  ],
  "country": "us",
  "language": "en",
  "maxResults": 10
} }),
});
const job = await r.json();
const rows = job.data ?? []; // if job.status === "running", poll /v1/jobs/{job_id}/results
```

## Response fields

Each row in `data` is one app, keyed by these fields.

| Field | Name | Type |
| - | - | - |
| `appId` | App ID | text |
| `title` | Title | text |
| `subtitle` | Subtitle | text |
| `appUrl` | App URL | url |
| `bundleId` | Bundle ID | text |
| `developer` | Developer | text |
| `developerId` | Developer ID | text |
| `developerUrl` | Developer URL | url |
| `seller` | Seller | text |
| `developerWebsite` | Developer Website | url |
| `supportUrl` | Support URL | url |
| `privacyPolicy` | Privacy Policy | url |
| `rating` | Rating | rating |
| `ratingsCount` | Ratings Count | number |
| `ratingHistogram` | Rating Histogram | object |
| `price` | Price | number |
| `currency` | Currency | text |
| `free` | Free | boolean |
| `inAppPurchases` | In App Purchases | boolean |
| `category` | Category | text |
| `categoryId` | Category ID | text |
| `categories` | Categories | object\_array |
| `contentRating` | Content Rating | text |
| `contentAdvisories` | Content Advisories | array |
| `description` | Description | text |
| `promotionalText` | Promotional Text | text |
| `releaseNotes` | Release Notes | text |
| `version` | Version | text |
| `released` | Released | date |
| `lastUpdated` | Last Updated | datetime |
| `minimumOsVersion` | Minimum Os Version | text |
| `sizeBytes` | Size Bytes | number |
| `languages` | Languages | array |
| `devices` | Devices | array |
| `appleWatch` | Apple Watch | boolean |
| `gameCenter` | Game Center | boolean |
| `arcade` | Arcade | boolean |
| `chartRank` | Chart Rank | number |
| `chartName` | Chart Name | text |
| `searchRank` | Search Rank | number |
| `icon` | Icon | image |
| `screenshots` | Screenshots | array |
| `copyright` | Copyright | text |

## Example response

Abridged: long text and lists are shortened.

```json theme={null}
{
  "job_id": "7f3a1c2e-0b9d-4c55-9a51-3f2e8d1b6a40",
  "agent": "app-store/apps",
  "status": "completed",
  "row_count": 1,
  "truncated": false,
  "data": [
    {
      "arcade": false,
      "bundleId": "net.whatsapp.WhatsApp",
      "chartName": "Top free · Social Networking",
      "developerUrl": "https://apps.apple.com/us/developer/whatsapp-inc/id310634000",
      "inAppPurchases": true,
      "developer": "WhatsApp Inc.",
      "title": "WhatsApp Messenger",
      "currency": "USD",
      "supportUrl": "http://www.whatsapp.com/faq/",
      "devices": [
        "mac",
        "watch"
      ],
      "released": "2009-05-04",
      "subtitle": "Simple. Reliable. Private.",
      "seller": "WhatsApp Inc.",
      "minimumOsVersion": "15.1",
      "developerWebsite": "http://www.whatsapp.com/",
      "searchRank": null,
      "copyright": "© 2026 WhatsApp LLC",
      "contentAdvisories": [
        "Infrequent/Mild Horror/Fear Themes",
        "Infrequent/Mild Mature/Suggestive Themes"
      ],
      "categoryId": "6005",
      "contentRating": "12+",
      "sizeBytes": 417814528,
      "releaseNotes": "We update the app regularly to fix bugs, optimize performance and improve the experience. Thanks for using WhatsApp!",
      "free": true,
      "categories": [
        {
          "name": "Social Networking",
          "id": "6005"
        },
        {
          "name": "Utilities",
          "id": "6002"
        }
      ],
      "developerId": "310634000"
    }
  ]
}
```

## Related APIs

For reviews use [`app-store/reviews`](https://docs.mindcase.co/apis/app-store/reviews); for the searches an app ranks for use [`app-store/app-keywords`](https://docs.mindcase.co/apis/app-store/app-keywords); for Android apps use [`google-play/apps`](https://docs.mindcase.co/apis/google-play/apps).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.