# Google Play Scraper: App Data, Exact Installs & Ratings (`clearpull/google-play-scraper`) Actor

Google Play app data for any apps or developers: rating, star histogram, Google's exact install count, price, in-app purchases, version, update date and screenshots, in any language and country. A Google Play API alternative for app datasets and tracking. Optional top reviews, no reviewer names.

- **URL**: https://apify.com/clearpull/google-play-scraper.md
- **Developed by:** [Clearpull](https://apify.com/clearpull) (community)
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.60 / 1,000 app details

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Google Play Scraper: App Data, Exact Installs & Ratings

Get Google Play app data for any list of apps or developers: rating and star histogram, number of ratings, the installs band and Google's exact install count, price, in-app purchases, ads, version, last update, description, screenshots and more, in any language and country Google Play supports. Export to CSV, Excel or JSON, or call it from Python, JavaScript, Make, Zapier or n8n. With one switch, add the top reviews Google shows on each app page, without reviewer names or developer reply text.

### What you get

One row per app:

- **Ratings:** the score, the number of ratings and written reviews, and the 1–5 star histogram.
- **Reach:** the installs band Google shows (such as 1,000,000,000+) and Google's own exact install figure.
- **Price:** free or paid, price and currency for the chosen country, in-app purchase range, and whether the app shows ads.
- **Release facts:** version, last update date, first release date, what's new, content rating and category.
- **Store listing:** title, short and full description (as text and HTML), icon, header image, screenshots and promo video.
- **Developer:** name, developer ID, developer page and website, and the privacy policy link.

With **Include top reviews** on, each app row also gets up to 20 reviews, the ones Google shows on the app page in its "most relevant" order, for the language and country you pick. Each review has its star rating, text, date, app version, how many people found it helpful, and whether and when the developer replied.

Two table views come with every run: **Apps** (one row per app) and **Top reviews** (one row per review).

Apps that Google Play doesn't have in the chosen country are listed with status `not-found` and are free.

### Who uses it

- **App marketers and ASO teams:** track your app's and competitors' ratings, installs, versions and listing changes every day.
- **Product managers:** read what users praise and complain about in the most visible reviews, in each market.
- **Investors and analysts:** compare install bands, exact install figures and ratings across a category or a developer's portfolio.
- **Agencies:** monitor a client's whole developer portfolio by pasting just the developer link.

### How to use it

1. **Add apps:** paste Google Play links or package names, one per line. The package name is the `id=` part of the link, such as `com.spotify.music`.
2. **Or add developers:** paste a developer page link (click the developer's name on any of their app pages), a developer name or a numeric developer ID. The Actor reads the apps on that page and returns each one's details.
3. **Pick the language and country**, such as `de` and `DE`. They set the text, the price and currency, the score and the reviews Google shows.
4. **Turn on Include top reviews** if you want them.
5. **Run it**, then download the results or open the Top reviews view.

#### Example: track a competitor set every morning

Add your app and five competitors, save the input as a task and schedule it daily. Each run is a snapshot of ratings, installs, version and price you can compare over time.

#### Example: the same app in five markets

Run the same apps with country `US`, `GB`, `DE`, `IN` and `BR` (and the matching language) to compare scores, prices and the reviews each market sees first.

### Use it from Python or JavaScript

```python
from apify_client import ApifyClient

client = ApifyClient("<YOUR_API_TOKEN>")
run = client.actor("clearpull/google-play-scraper").call(run_input={
    "apps": ["com.spotify.music", "com.mojang.minecraftpe"],
    "includeReviews": True,
    "language": "en",
    "country": "US",
})
for app in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(app["title"], app["score"], app["installs"], len(app.get("topReviews", [])))
```

```javascript
import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: '<YOUR_API_TOKEN>' });
const run = await client.actor('clearpull/google-play-scraper').call({
    developers: ['https://play.google.com/store/apps/developer?id=Spotify+AB'],
    language: 'en',
    country: 'GB',
});
const { items } = await client.dataset(run.defaultDatasetId).listItems({ view: 'apps' });
console.log(items);
```

### Output example

One app, shortened to one of its 20 top reviews and two of its screenshots:

```json
{
  "type": "app",
  "status": "ok",
  "appId": "com.mojang.minecraftpe",
  "title": "Minecraft: Dream it, Build it!",
  "summary": "Millions of crafters have smashed billions of blocks! Now you can join the fun!",
  "description": "Dive into an open world of block building, crafting, and survival...",
  "developer": "Mojang",
  "developerId": "4772240228547998649",
  "developerUrl": "https://play.google.com/store/apps/dev?id=4772240228547998649",
  "developerWebsite": "http://help.mojang.com",
  "privacyPolicyUrl": "http://go.microsoft.com/fwlink/?LinkId=521839",
  "genre": "Arcade",
  "genreId": "GAME_ARCADE",
  "score": 4.300899,
  "ratingCount": 5885566,
  "reviewCount": 635268,
  "histogram": { "1": 633881, "2": 180030, "3": 272409, "4": 494153, "5": 4305082 },
  "installs": "100,000,000+",
  "minInstalls": 100000000,
  "realInstalls": 100597450,
  "free": false,
  "price": 6.99,
  "originalPrice": null,
  "currency": "USD",
  "priceText": "$6.99",
  "offersInAppPurchases": true,
  "inAppPurchaseRange": "$0.99 - $49.99 per item",
  "containsAds": false,
  "contentRating": "Everyone 10+",
  "released": "Aug 15, 2011",
  "releasedAt": "2011-08-16T06:17:21.000Z",
  "updatedAt": "2026-11-04T19:03:05.000Z",
  "version": "1.26.62.1",
  "recentChanges": "What's new in 26.62: Various bug fixes!",
  "icon": "https://play-lh.googleusercontent.com/tI4StRSPVhpGJH5R013naszLUawOjao1ya8FvyaNO7XY_cJFHFqo1EFaEJv_7zz3rRJ5lEpLiw14ZqQLCOYc",
  "headerImage": "https://play-lh.googleusercontent.com/S_Z7YSNVWWd3BNh3AwV0iVv0hNqJ8zvn-HwLTlYqVLU4uxSohpwKpIa-EmwwwoxOlSw8voqu5CsxQGbojanT",
  "screenshots": ["https://play-lh.googleusercontent.com/...", "https://play-lh.googleusercontent.com/..."],
  "video": "https://play.google.com/video/lava/web/player/yt:movie:BLtLrFNRE-E?autoplay=1&embed=play",
  "topReviews": [
    {
      "reviewKey": "a7a3107006501daa150d",
      "position": 1,
      "rating": 2,
      "text": "Despite having bought this game, I am having so much trouble with uploading my skins...",
      "reviewedAt": "2026-09-10T03:43:10.000Z",
      "thumbsUpCount": 103,
      "appVersion": "1.26.45.1",
      "hasDeveloperReply": false,
      "developerRepliedAt": null
    }
  ],
  "topReviewsSort": "most relevant",
  "sourceDeveloper": null,
  "language": "en",
  "country": "US",
  "url": "https://play.google.com/store/apps/details?id=com.mojang.minecraftpe&hl=en&gl=US",
  "scrapedAt": "2026-11-13T16:35:12.204Z"
}
```

`reviewKey` stays the same for the same review across runs, so you can spot new reviews between snapshots. It can't be turned into a link to the reviewer.

### Pricing

- **$0.60 per 1,000 apps** with details.
- **$0.12 per 1,000 reviews**, only when *Include top reviews* is on. An app with 20 top reviews costs $0.0024 for its reviews.
- **$0.005 per run** to start.
- **Example:** 100 apps with their top reviews (about 2,000 reviews) costs $0.06 + $0.24 + $0.005 = about $0.31.
- **Free:** apps that aren't found and apps that fail.
- **No extra usage fees:** proxies and computing are included in the price.
- **Spending cap:** set a maximum cost per run in the run options. The Actor reserves the cost of each app before fetching it, fits as many reviews as the cap allows, and stops cleanly.

### Limits

- Up to 5,000 apps and 200 developers per run.
- **Reviews: the top 20 per app, per language and country.** These are the reviews Google shows on the app page, in its "most relevant" order. Loading more, or sorting by newest, uses a Google Play address that Google's robots.txt asks automated tools not to use, so this Actor doesn't. To see what other markets read, run again with another language and country.
- **No keyword search.** Google's robots.txt asks automated tools not to use Play's search pages. Start from app links, package names or developers instead.
- **Developers: the apps their page shows**, up to about 20. Google loads the rest through the same address as above.
- **No personal data:** reviewer names, photos, profile links and IDs are never collected. Developer email addresses, phone numbers and street addresses are left out too, because individual developers often publish their own.
- **Developer replies: whether and when, not the text.** Replies often greet the reviewer by first name or are signed by a support agent, so their text isn't collected.
- The data safety section isn't included.

### FAQ

**How fast is it?** About 60 apps a minute at the default settings (512 MB, 5 pages at a time), so 100 apps take under 2 minutes. Each app is one page. Raise *Max concurrency* for large runs.

**Why do scores and review counts differ between countries?** Google Play shows a score and written reviews per market and language. The total number of ratings and the installs are the same everywhere.

**Do I need a Google account or an API key?** No.

**Can I get every review of an app?** No. See Limits: only the reviews Google shows on the app page are collected.

### Questions and problems

Open an issue on this Actor's **Issues** tab with the app link, the language and country, and what went wrong. Issues are answered within a day.

# Actor input Schema

## `apps` (type: `array`):

Google Play app links or package names, one per line, such as https://play.google.com/store/apps/details?id=com.spotify.music or com.spotify.music. Up to 5,000 apps per run.

## `developers` (type: `array`):

Optional. Developer page links, developer names or numeric developer IDs, one per line. The Actor reads the apps each developer page lists (up to about 20, as Google shows them) and returns their details. Copy the link from the developer's name on any of their app pages.

## `includeReviews` (type: `boolean`):

Also return the reviews Google shows on each app page: up to 20 per app, in Google's "most relevant" order, for the language and country below. Each review is charged as a review event. Reviewer names, photos and profile links are never collected.

## `language` (type: `string`):

Language of the app text and reviews (Google's hl setting), such as en, de, es, pt-BR or ja.

## `country` (type: `string`):

Two-letter country code (Google's gl setting), such as US, GB, DE or IN. It sets the price, currency and score Google shows, and which apps are available.

## `maxConcurrency` (type: `integer`):

Pages fetched at the same time. Higher is faster but more likely to be slowed down by Google.

## Actor input object example

```json
{
  "apps": [
    "com.spotify.music",
    "https://play.google.com/store/apps/details?id=com.mojang.minecraftpe"
  ],
  "developers": [],
  "includeReviews": false,
  "language": "en",
  "country": "US",
  "maxConcurrency": 5
}
```

# Actor output Schema

## `apps` (type: `string`):

One row per app: rating, installs, price, version, developer and more.

## `reviews` (type: `string`):

One row per review shown on each app page, without reviewer identity (only when Include top reviews is on).

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "apps": [
        "com.spotify.music",
        "https://play.google.com/store/apps/details?id=com.mojang.minecraftpe"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("clearpull/google-play-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "apps": [
        "com.spotify.music",
        "https://play.google.com/store/apps/details?id=com.mojang.minecraftpe",
    ] }

# Run the Actor and wait for it to finish
run = client.actor("clearpull/google-play-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "apps": [
    "com.spotify.music",
    "https://play.google.com/store/apps/details?id=com.mojang.minecraftpe"
  ]
}' |
apify call clearpull/google-play-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,clearpull/google-play-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/aBAoKDGJXhx1mabWo/builds/LVvchNndcfDcpgn6M/openapi.json
