# Google Play API guide



## Start with Google Play



Research an Android app using its package name and a consistent country/language pair, then read the available review pages.



These requests use your API key and can spend credits. Check the current price on the endpoint page; each new page is a separate request. Later examples use illustrative identifiers: replace them with values from your earlier response.



### 1. Find the app



Save the selected package name. Similar titles can refer to different apps. [Parameters and current cost →](https://www.monocrawl.com/docs/endpoints/google_play/app-search)



**google_play/app-search**

```
curl "https://www.monocrawl.com/v1/google_play/app-search?query=budgeting&country=gb&language=en" \
  -H "x-api-key: mn_your_key_here"
```



### 2. Read the listing



Replace the example package with the selected result. Keep installs text separate from min_installs. [Parameters and current cost →](https://www.monocrawl.com/docs/endpoints/google_play/app-info)



**google_play/app-info**

```
curl "https://www.monocrawl.com/v1/google_play/app-info?package=co.uk.getmondo&country=gb&language=en" \
  -H "x-api-key: mn_your_key_here"
```



### 3. Read review pages



Use the same package. Retain the returned cursor and keep filters unchanged. [Parameters and current cost →](https://www.monocrawl.com/docs/endpoints/google_play/app-reviews)



**google_play/app-reviews**

```
curl "https://www.monocrawl.com/v1/google_play/app-reviews?package=co.uk.getmondo&country=gb&language=en&sort_by=newest&limit=25" \
  -H "x-api-key: mn_your_key_here"
```



## Choose filters with the source behavior in mind



| Control | Behavior and limits |
| --- | --- |
| App identity | package is the Android package name or Play Store URL, not the App Store numeric ID. Keep country and language consistent. [Endpoint reference →](https://www.monocrawl.com/docs/endpoints/google_play/app-info) |
| Review selection | sort_by accepts newest, helpful or rating. rating is a local filter applied after fetch; retain the cursor even if filtering makes a page sparse. [Endpoint reference →](https://www.monocrawl.com/docs/endpoints/google_play/app-reviews) |
| Install and score fields | installs can be source text such as a range; min_installs is a lower bound when supplied. A store score and an individual review rating describe different populations. [Endpoint reference →](https://www.monocrawl.com/docs/endpoints/google_play/app-info) |



Source availability, ordering and field coverage can change. Inspect warnings and partial-result metadata alongside the rows. See [runnable workflows](https://www.monocrawl.com/docs/workflows), [metric semantics](https://www.monocrawl.com/docs/metric-semantics), [computed fields](https://www.monocrawl.com/docs/computed-fields) and the [pagination matrix](https://www.monocrawl.com/docs/pagination).



## Match the operation to your task



| Your task | Endpoint | When to use it |
| --- | --- | --- |
| Store charts | [`app-list`](https://www.monocrawl.com/docs/endpoints/google_play/app-list) | Choose declared collection and category values. |
| Supported categories | [`categories`](https://www.monocrawl.com/docs/endpoints/google_play/categories) | Google Play categories differ from App Store numeric genres. |
| Supported markets | [`locations`](https://www.monocrawl.com/docs/endpoints/google_play/locations) | Market selection affects which listing or reviews you observe. |



Explore all documented operations by purpose below. Each endpoint reference contains its accepted parameters and current price.



### Other operations



- [`app-info`](https://www.monocrawl.com/docs/endpoints/google_play/app-info)

- [`app-list`](https://www.monocrawl.com/docs/endpoints/google_play/app-list)

- [`languages`](https://www.monocrawl.com/docs/endpoints/google_play/languages)

- [`locations`](https://www.monocrawl.com/docs/endpoints/google_play/locations)



### Reviews and offers



- [`app-reviews`](https://www.monocrawl.com/docs/endpoints/google_play/app-reviews)



### Search and discovery



- [`app-search`](https://www.monocrawl.com/docs/endpoints/google_play/app-search)

- [`search-suggestions`](https://www.monocrawl.com/docs/endpoints/google_play/search-suggestions)



### Products and categories



- [`categories`](https://www.monocrawl.com/docs/endpoints/google_play/categories)



## Endpoint reference

## google_play/app-info

`GET /v1/google_play/app-info`

One Google Play app by package name: title, developer, score, ratings and review counts, installs, price, version, release and update dates, rating histogram.

*Google Play app*

| Parameter | Required | Description |
| --- | --- | --- |
| `package` | yes | Play package name (or a Play Store URL) — e.g. `co.uk.getmondo` |
| `country` | no | 2-letter storefront country (default us) — e.g. `gb` |
| `language` | no | Language code (default en) — e.g. `en` |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `country`: Select the documented market or country filter. Read this endpoint’s country semantics; filtering and source request location can differ.
- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 1 credit at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/google_play/app-info?package=co.uk.getmondo" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "package": "com.example.app",
  "title": "Example App",
  "score": 4.5,
  "installs": "10,000+",
  "min_installs": 10000,
  "free": true
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/google_play/app-info#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/google_play/app-info.json)


## google_play/app-list

`GET /v1/google_play/app-list`

A Google Play chart, ranked: top free, top paid or top grossing for a storefront, optionally within one category — rank, package name, title, developer, summary, score, price and icon for each entry.

*Google Play top charts*

| Parameter | Required | Description |
| --- | --- | --- |
| `collection` | no | Chart collection. Some collections depend on alternate source coverage. Accepted values: top_free, top_paid, top_grossing, grossing, new_free, new_paid, featured, movers_shakers. Case, spaces, hyphens and underscores are interchangeable. — e.g. `top_free` |
| `category` | no | Play category id such as FINANCE, PRODUCTIVITY or GAME_PUZZLE (default: all apps) — e.g. `FINANCE` |
| `country` | no | 2-letter storefront country (default us) — e.g. `gb` |
| `language` | no | Language code (default en) — e.g. `en` |
| `limit` | no | Requested results, 1–100 (default 100); the source may return fewer. No per-item detail enrichment. — e.g. `100` |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `country`: Select the documented market or country filter. Read this endpoint’s country semantics; filtering and source request location can differ.
- `limit`: Bound the returned rows to what your task needs. A smaller limit does not necessarily reduce source calls or price; inspect the quote.
- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 2 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/google_play/app-list" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "_warnings": [],
  "collection": "example",
  "count": 0,
  "country": "example",
  "items": [
    {
      "currency": "example",
      "developer": "example",
      "free": false,
      "icon": "example",
      "package": "example",
      "price": 0,
      "rank": 0,
      "score": 0,
      "score_text": "example",
      "summary": "example",
      "title": "example",
      "url": "https://example.com/example"
    }
  ],
  "language": "example"
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/google_play/app-list#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/google_play/app-list.json)


## google_play/app-reviews

`GET /v1/google_play/app-reviews`

Reviews of a Google Play app, newest first by default: id, title, text, rating, author, date, version, helpful votes and the developer reply when there is one. Page with the returned cursor.

*Google Play app reviews*

| Parameter | Required | Description |
| --- | --- | --- |
| `package` | yes | Play package name (or a Play Store URL) — e.g. `co.uk.getmondo` |
| `country` | no | 2-letter storefront country (default us) — e.g. `gb` |
| `language` | no | Language code (default en) — e.g. `en` |
| `sort_by` | no | newest (default), helpful or rating Accepted values: newest, helpful, mosthelpful, rating. Case, spaces, hyphens and underscores are interchangeable. — e.g. `newest` |
| `limit` | no | Requested results, 1–100 (default 100); the source may return fewer. No per-item detail enrichment. — e.g. `100` |
| `rating` | no | Keep only reviews with this star rating (1-5), applied after the fetch — e.g. `1` |
| `cursor` | no | Opaque cursor from the previous page |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |
| `judgments` | no | Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Accepted values: on, off. Case, spaces, hyphens and underscores are interchangeable. — e.g. `on` |
| `label` | no | Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Accepted values: default, none. Case, spaces, hyphens and underscores are interchangeable. — e.g. `none` |
| `label_evidence` | no | Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |
| `exclude` | no | Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Accepted values: engagement_bait. Case, spaces, hyphens and underscores are interchangeable. — e.g. `engagement_bait` |
| `fit` | no | Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Accepted values: goal. Case, spaces, hyphens and underscores are interchangeable. — e.g. `goal` |
| `goal` | no | Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. — e.g. `Find concrete product complaints` |
| `tokens` | no | Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. — e.g. `4000` |

### Useful optional inputs

- `country`: Select the documented market or country filter. Read this endpoint’s country semantics; filtering and source request location can differ.
- `limit`: Bound the returned rows to what your task needs. A smaller limit does not necessarily reduce source calls or price; inspect the quote.
- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 2 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/google_play/app-reviews?package=co.uk.getmondo" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "items": [
    {
      "id": "example-review",
      "text": "Illustrative review",
      "rating": 4,
      "author": "Example Reader",
      "helpful": 0,
      "reply": null
    }
  ],
  "cursor": null,
  "has_more": null
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/google_play/app-reviews#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/google_play/app-reviews.json)


## google_play/app-search

`GET /v1/google_play/app-search`

Apps matching a term on Google Play: package name, title, developer, summary, score and price.

*Google Play app search*

| Parameter | Required | Description |
| --- | --- | --- |
| `query` | yes | Search term — e.g. `budgeting` |
| `country` | no | 2-letter storefront country (default us) — e.g. `gb` |
| `language` | no | Language code (default en) — e.g. `en` |
| `limit` | no | Results, 1-50 (default 20) — e.g. `20` |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `country`: Select the documented market or country filter. Read this endpoint’s country semantics; filtering and source request location can differ.
- `limit`: Bound the returned rows to what your task needs. A smaller limit does not necessarily reduce source calls or price; inspect the quote.
- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 2 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/google_play/app-search?query=budgeting" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "items": [
    {
      "package": "com.example.app",
      "title": "Example App",
      "score": 4.5
    }
  ],
  "cursor": null,
  "has_more": null
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/google_play/app-search#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/google_play/app-search.json)


## google_play/categories

`GET /v1/google_play/categories`

The list of Google Play app categories.

*Google Play categories*

| Parameter | Required | Description |
| --- | --- | --- |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** free — 0 credits.

```bash
curl "https://www.monocrawl.com/v1/google_play/categories" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "count": 0,
  "has_more": false,
  "items": [
    {
      "code": "example",
      "name": "example"
    }
  ]
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/google_play/categories#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/google_play/categories.json)


## google_play/languages

`GET /v1/google_play/languages`

The list of Google Play store languages.

*Google Play languages*

| Parameter | Required | Description |
| --- | --- | --- |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** free — 0 credits.

```bash
curl "https://www.monocrawl.com/v1/google_play/languages" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "count": 0,
  "has_more": false,
  "items": [
    {
      "code": "example",
      "name": "example"
    }
  ]
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/google_play/languages#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/google_play/languages.json)


## google_play/locations

`GET /v1/google_play/locations`

The list of Google Play store locations.

*Google Play locations*

| Parameter | Required | Description |
| --- | --- | --- |
| `cursor` | no | Return the previous response cursor unchanged for the next block of up to 500 locations. |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `cursor`: Continue the same source traversal with the complete returned cursor. Saved-result retrieval and a new source page can have different prices; quote the next call.
- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** free — 0 credits.

```bash
curl "https://www.monocrawl.com/v1/google_play/locations" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "_warnings": [
    "example"
  ],
  "count": 0,
  "cursor": null,
  "has_more": false,
  "items": [
    {
      "code": 0,
      "country_code": "example",
      "name": "example",
      "type": "example"
    }
  ],
  "total": 0
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/google_play/locations#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/google_play/locations.json)


## google_play/search-suggestions

`GET /v1/google_play/search-suggestions`

The search terms Google Play suggests for a partial query, in the order the store ranks them.

*Google Play search suggestions*

| Parameter | Required | Description |
| --- | --- | --- |
| `query` | yes | Partial search term — e.g. `spotify` |
| `country` | no | 2-letter storefront country code (default us) — e.g. `us` |
| `language` | no | Language code (default en) — e.g. `en` |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `country`: Select the documented market or country filter. Read this endpoint’s country semantics; filtering and source request location can differ.
- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 1 credit at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/google_play/search-suggestions?query=spotify" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "_warnings": [],
  "count": 0,
  "country": "example",
  "items": [
    {
      "rank": 0,
      "term": "example"
    }
  ],
  "language": "example",
  "query": "example"
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/google_play/search-suggestions#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/google_play/search-suggestions.json)