# App store tools

> Google Play and App Store listings, reviews, top charts and the store searches apps rank for.

Look up apps on Google Play and the App Store: the listing, what users say in reviews, the top charts, and the store searches an app ranks for. Pass `store` as `google_play` or `app_store` on every call.

Google Play ids are package names (`com.Slack`, with the case the store URL uses); App Store ids are the number in the URL (`618783545`). [`apps_search_apps`](https://www.manifoldmcp.com/docs/tools/apps#apps_search_apps) and [`apps_get_top_charts`](https://www.manifoldmcp.com/docs/tools/apps#apps_get_top_charts) find ids you do not have. Listings, reviews and charts are read live from the store and can take up to a minute. The keyword tools cover the United States in English.

To take a competitor's app apart, start with [`apps_get_app`](https://www.manifoldmcp.com/docs/tools/apps#apps_get_app), then [`apps_get_reviews`](https://www.manifoldmcp.com/docs/tools/apps#apps_get_reviews) for what users complain about and [`apps_get_keywords`](https://www.manifoldmcp.com/docs/tools/apps#apps_get_keywords) for the searches it wins. [`apps_get_competitors`](https://www.manifoldmcp.com/docs/tools/apps#apps_get_competitors) and [`apps_get_shared_keywords`](https://www.manifoldmcp.com/docs/tools/apps#apps_get_shared_keywords) compare it with the apps it fights for those searches.


To connect these tools to your agent, see the [App Store and Google Play MCP](https://www.manifoldmcp.com/mcp/app-store) page.

| Tool | What it does | Cost |
| --- | --- | --- |
| [`apps_get_app`](#apps_get_app) | Get an app | From 1 credit |
| [`apps_get_reviews`](#apps_get_reviews) | Get app reviews | From 1 credit |
| [`apps_get_keywords`](#apps_get_keywords) | Get an app's store keywords | From 5 credits |
| [`apps_get_competitors`](#apps_get_competitors) | Find competing apps | From 5 credits |
| [`apps_get_shared_keywords`](#apps_get_shared_keywords) | Compare apps' keywords | From 5 credits |
| [`apps_search_apps`](#apps_search_apps) | Search apps | From 31 credits |
| [`apps_get_top_charts`](#apps_get_top_charts) | Get a top chart | From 1 credit |

## `apps_get_app`: Get an app

One app's store listing: rating, installs, version, release notes, description, screenshots and the developer's contact details.

**Use when:** "tell me about this app", "how is competitor's app rated", "who makes this app and how do I reach them", "when did they last ship an update".

**Not for:** what users say, use [`apps_get_reviews`](https://www.manifoldmcp.com/docs/tools/apps#apps_get_reviews). Store searches the app ranks for, use [`apps_get_keywords`](https://www.manifoldmcp.com/docs/tools/apps#apps_get_keywords). Finding apps, use [`apps_search_apps`](https://www.manifoldmcp.com/docs/tools/apps#apps_search_apps) or [`apps_get_top_charts`](https://www.manifoldmcp.com/docs/tools/apps#apps_get_top_charts).

**Returns:** Record. store, `app_id`, title, subtitle (App Store only), url, description, category, `genres[]`, rating (out of 5), `ratings_count`, installs (Google Play only), `is_free`, price, currency, `content_rating`, version, `min_os_version`, size, `released_at`, `updated_at`, `update_notes`, developer, `developer_id`, `developer_url`, `developer_website`, `developer_email`, `developer_address` (the last three Google Play only), `screenshots[]`, `similar_apps[]` and `more_by_developer[]` (`app_id`, title). null = the store does not show it.

**Cost:** 1 credit. Cached 1 day. Can take up to a minute.

| Parameter | Default and notes |
| --- | --- |
| `store` | Required; `google_play` \| `app_store` |
| `app_id` | Required; Google Play package name such as com.Slack, case as in the store URL, or the App Store number from the URL such as 618783545 |
| `location` | "United States" |
| `language` | "en" |

Also takes `provider`, `max_credits`, `dry_run`: see [common parameters](https://www.manifoldmcp.com/docs/tools#common-parameters).

```json
{
  "store": "google_play",
  "app_id": "com.Slack"
}
```

## `apps_get_reviews`: Get app reviews

User reviews of one app, newest or most relevant first, with stars, text, app version and any developer reply.

**Use when:** "what do users complain about in X's app", "recent 1-star reviews", "did the last release annoy people", mining pain points for positioning.

**Not for:** the listing itself, use [`apps_get_app`](https://www.manifoldmcp.com/docs/tools/apps#apps_get_app). Reviews of a physical product, use [`shopping_get_reviews`](https://www.manifoldmcp.com/docs/tools/shopping#shopping_get_reviews).

**Returns:** Record. store, `app_id`, title, rating, `ratings_count`, `rows[]`: id, rating, title (App Store only), text, author, `published_at`, `app_version`, `helpful_count` and `developer_reply` (Google Play only).

**Cost:** 1 credit per 100 reviews. Default 100 = 1 credit. Cached 6 hours. Can take up to a minute.

| Parameter | Default and notes |
| --- | --- |
| `store` | Required; `google_play` \| `app_store` |
| `app_id` | Required |
| `sort` | "newest" \| "`most_relevant`", default newest |
| `limit` | 100, max 1000; the App Store returns at most 500 |
| `location` | "United States" |
| `language` | "en" |

Also takes `provider`, `max_credits`, `dry_run`: see [common parameters](https://www.manifoldmcp.com/docs/tools#common-parameters).

```json
{
  "store": "app_store",
  "app_id": "618783545",
  "sort": "newest",
  "limit": 200
}
```

## `apps_get_keywords`: Get an app's store keywords

Store searches an app ranks for, with monthly search volume in the store and the app's position: the core of app store optimisation.

**Use when:** "what does competitor's app rank for in the App Store", "which store keywords bring installs", picking keywords for an app title or subtitle.

**Not for:** Google web searches, use [`seo_get_ranked_keywords`](https://www.manifoldmcp.com/docs/tools/seo#seo_get_ranked_keywords). Keywords two apps share, use [`apps_get_shared_keywords`](https://www.manifoldmcp.com/docs/tools/apps#apps_get_shared_keywords).

**Returns:** List. `rows[]`: keyword, volume (monthly store searches), rank (the app's position), `results_count`. Sorted by volume. United States and English only.

**Cost:** 5 + 5 per 100 rows. Default 100 rows = 10 credits. Cached 7 days.

| Parameter | Default and notes |
| --- | --- |
| `store` | Required; `google_play` \| `app_store` |
| `app_id` | Required; Google Play ids are case sensitive |
| `limit` | 100, max 1000 |

Also takes `cursor`, `provider`, `max_credits`, `dry_run`: see [common parameters](https://www.manifoldmcp.com/docs/tools#common-parameters).

```json
{
  "store": "google_play",
  "app_id": "com.microsoft.teams",
  "limit": 50
}
```

## `apps_get_competitors`: Find competing apps

Apps that compete with one app for the same store searches, with how many searches they share and how strongly each ranks.

**Use when:** "who competes with our app in the App Store", "which apps take our store searches", building a competitor set for an app.

**Not for:** business competitors on the web, use [`seo_get_serp_competitors`](https://www.manifoldmcp.com/docs/tools/seo#seo_get_serp_competitors). The keywords two apps share, use [`apps_get_shared_keywords`](https://www.manifoldmcp.com/docs/tools/apps#apps_get_shared_keywords).

**Returns:** List. `rows[]`: `app_id`, `shared_keywords`, `avg_position`, keywords (every store search it ranks for), `top_3`, `keywords_volume`. Ids only: call [`apps_get_app`](https://www.manifoldmcp.com/docs/tools/apps#apps_get_app) for a name. The app itself is left out. United States and English only.

**Cost:** 5 + 5 per 100 rows. Default 100 rows = 10 credits. Cached 7 days.

| Parameter | Default and notes |
| --- | --- |
| `store` | Required; `google_play` \| `app_store` |
| `app_id` | Required |
| `limit` | 100, max 1000 |

Also takes `cursor`, `provider`, `max_credits`, `dry_run`: see [common parameters](https://www.manifoldmcp.com/docs/tools#common-parameters).

```json
{
  "store": "app_store",
  "app_id": "618783545",
  "limit": 20
}
```

## `apps_get_shared_keywords`: Compare apps' keywords

Store searches that two to twenty apps all rank for, with each app's position side by side.

**Use when:** "where do we and competitor both rank", "which store keywords does Teams beat Slack on", comparing apps keyword by keyword.

**Not for:** every keyword one app ranks for, use [`apps_get_keywords`](https://www.manifoldmcp.com/docs/tools/apps#apps_get_keywords). Finding the competitors first, use [`apps_get_competitors`](https://www.manifoldmcp.com/docs/tools/apps#apps_get_competitors).

**Returns:** List. `rows[]`: keyword, volume, `ranks[]` (`app_id`, rank) in the order the apps were given. Sorted by volume. United States and English only.

**Cost:** 5 + 5 per 100 rows. Default 100 rows = 10 credits. Cached 7 days.

| Parameter | Default and notes |
| --- | --- |
| `store` | Required; `google_play` \| `app_store` |
| `app_ids` | Required; 2 to 20 |
| `limit` | 100, max 1000 |

Also takes `cursor`, `provider`, `max_credits`, `dry_run`: see [common parameters](https://www.manifoldmcp.com/docs/tools#common-parameters).

```json
{
  "store": "google_play",
  "app_ids": [
    "com.Slack",
    "com.microsoft.teams"
  ]
}
```

## `apps_search_apps`: Search apps

Apps whose title matches a query, from an index of every app in a store, with the full listing and the developer's contact details on each row.

**Use when:** "find CRM apps", "every app with invoice in its name", building a list of app makers to contact, sizing a category.

**Not for:** the store's own ranking for a search or a chart, use [`apps_get_top_charts`](https://www.manifoldmcp.com/docs/tools/apps#apps_get_top_charts). One app you already have, use [`apps_get_app`](https://www.manifoldmcp.com/docs/tools/apps#apps_get_app) (much cheaper).

**Returns:** List. `rows[]`: store, `app_id`, title, subtitle, url, description (first 500 characters), category, `genres[]`, rating, `ratings_count`, installs, `is_free`, price, currency, `content_rating`, version, `min_os_version`, size, `released_at`, `updated_at`, developer, `developer_id`, `developer_url`, `developer_website`, `developer_email`, `developer_address`. Not ranked by the store.

**Cost:** 31 + 31 per 100 rows. Default 100 rows = 62 credits. Cached 7 days.

| Parameter | Default and notes |
| --- | --- |
| `store` | Required; `google_play` \| `app_store` |
| `query` | Required; matched in the title |
| `category` | Optional; the store's category name, such as Business |
| `limit` | 100, max 1000 |

Also takes `cursor`, `provider`, `max_credits`, `dry_run`: see [common parameters](https://www.manifoldmcp.com/docs/tools#common-parameters).

```json
{
  "store": "google_play",
  "query": "crm",
  "limit": 50
}
```

## `apps_get_top_charts`: Get a top chart

A store's top chart (free, paid, grossing or new) overall or in one category, in chart order.

**Use when:** "top free business apps", "what is grossing in the App Store's finance chart", spotting rising apps in a category.

**Not for:** apps matching a word, use [`apps_search_apps`](https://www.manifoldmcp.com/docs/tools/apps#apps_search_apps). One app's details, use [`apps_get_app`](https://www.manifoldmcp.com/docs/tools/apps#apps_get_app).

**Returns:** List. `rows[]`: rank, `app_id`, title, url, developer (Google Play only), rating, `ratings_count`, `is_free`, price, currency.

**Cost:** 1 credit per 100 rows. Default 100 rows = 1 credit. Cached 1 day. Can take up to a minute.

| Parameter | Default and notes |
| --- | --- |
| `store` | Required; `google_play` \| `app_store` |
| `chart` | "`top_free`" \| "`top_paid`" \| "`top_grossing`" \| "`new_free`" \| "`new_paid`", default `top_free` |
| `category` | Optional; the store's category id, such as business or finance |
| `limit` | 100; max 200 on Google Play, 100 on the App Store |
| `location` | "United States" |
| `language` | "en" |

Also takes `provider`, `max_credits`, `dry_run`: see [common parameters](https://www.manifoldmcp.com/docs/tools#common-parameters).

```json
{
  "store": "app_store",
  "chart": "top_grossing",
  "category": "finance"
}
```