# Google Play Scraper (`lergassy/google-play-scraper`) Actor

\[$1/1K apps] Google Play apps by search, link, developer or top chart: installs, rating, star histogram, price, in-app purchases, version, update date, developer e-mail and website. Optional reviews at $0.07/1K. No login.

- **URL**: https://apify.com/lergassy/google-play-scraper.md
- **Developed by:** [Matvey](https://apify.com/lergassy) (community)
- **Categories:** Developer tools, Marketing, Agents
- **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.70 / 1,000 apps

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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** collects **Google Play apps** from **search, app links, developers and top charts** and returns one row per app: **installs, rating, number of ratings and reviews, star histogram, price, in-app purchases, ads, version, release and update dates, Android version, content rating, developer e-mail, website and address, description, screenshots and video**. Switch on one option to add **reviews** with stars, text, date, thumbs-up, app version and the developer's reply.

**$0.001 per app, $0.00007 per review.** No Google account, no API key, no login, no start fee.

### What is Google Play Scraper?

Google Play has no public API for app data. This Actor reads Google Play the way the Play website does and returns clean rows — for app store optimisation (ASO), competitor tracking, market research, lead generation (developer e-mails), and review analysis.

### What is in every row

| Field | Meaning |
|---|---|
| `title`, `appId`, `url`, `genre`, `contentRating` | The app |
| `installs`, `minInstalls`, `maxInstalls` | Installs (Google's bucket and estimate) |
| `rating`, `ratings`, `reviewsCount`, `histogram` | Ratings and stars 1–5 |
| `free`, `price`, `offersInAppPurchases`, `inAppPriceRange`, `adSupported` | Monetisation |
| `version`, `updatedAt`, `released`, `recentChanges`, `androidVersion` | Release history |
| `developer`, `developerEmail`, `developerWebsite`, `developerAddress` | Developer contacts |
| Review rows: `rating`, `text`, `date`, `thumbsUp`, `appVersion`, `replyText` | With **Add reviews** on |

### How much does it cost?

| Event | Price |
|---|---|
| App | **$0.001** |
| Review (optional) | **$0.00007** |

- Full details are included in the app price.
- Apps below **Minimum rating** or **Minimum installs**: **$0**.
- Links that fail: **$0** (an error row says why).

#### Bulk export: what 50,000 rows actually cost

This Actor is built for bulk jobs — thousands of inputs in one run, or a daily schedule. There is **no
fee per run, no fee per page and no proxy charge**: you pay for the rows you keep.

| Job | This Actor | Most-used Actor in this category |
|---|---|---|
| 50,000 reviews | **$3.50** | $7.50 |
| 10,000 apps with full details | **$10** | $23 + start fees |

Checked on the Apify Store on 23 September 2026 against the Actor with the most monthly users in this category
($0.00015 per review for the most-used reviews Actor; $0.0023 per app plus a start fee for the most-used app-details Actor). Some Actors here ask less per row — this table compares against the one buyers actually use most.

### How to use it in three steps

1. Type **searches**, paste **app links**, **developers** or pick a **top chart**.
2. Set **Country** and **Language**, and switch on **Add reviews** if you need them.
3. Press **Start**, then download JSON, CSV or Excel — or call the run from the API, n8n, Make, Zapier or an AI agent.

### ⬇️ Input

```json
{
  "searchQueries": ["vpn", "habit tracker"],
  "apps": ["com.whatsapp"],
  "topChart": "TOP_FREE",
  "topChartCategory": "GAME",
  "country": "us",
  "includeReviews": true,
  "maxReviewsPerApp": 200
}
```

### ⬆️ Output

App:

```json
{
  "type": "app",
  "source": "app",
  "sourceValue": "https://play.google.com/store/apps/details?id=com.whatsapp&hl=en",
  "position": 1,
  "appId": "com.whatsapp",
  "title": "WhatsApp Messenger",
  "url": "https://play.google.com/store/apps/details?id=com.whatsapp&hl=en&gl=us",
  "summary": "Simple. Reliable. Private.",
  "developer": "WhatsApp LLC",
  "developerId": "WhatsApp+LLC",
  "developerEmail": "android@support.whatsapp.com",
  "developerWebsite": "http://www.whatsapp.com/",
  "developerAddress": null,
  "developerLegalName": "Meta Platforms, Inc.",
  "installs": "10,000,000,000+",
  "minInstalls": 10000000000,
  "maxInstalls": 12322703000,
  "rating": 4.62,
  "ratings": 244230395,
  "reviewsCount": 1952294,
  "histogram": {
    "1": 10900402,
    "2": 3466637,
    "3": 8923788,
    "4": 21879889,
    "5": 199059626
  },
  "free": true,
  "price": 0,
  "currency": "USD",
  "offersInAppPurchases": true,
  "inAppPriceRange": "$0.40 - $199.99 per item",
  "adSupported": false,
  "genre": "Communication",
  "genreId": "COMMUNICATION",
  "contentRating": "Everyone",
  "version": "VARY",
  "androidVersion": "Varies with device",
  "released": "Oct 18, 2010",
  "updatedAt": "2026-09-19T00:49:04.000Z",
  "recentChanges": "• You can now choose to share recent group history with new members when you add them to a group\n• Group calls now inclu…",
  "description": "WhatsApp from Meta is a FREE messaging and video calling app. It’s used by over 2B people in more than 180 countries. It…",
  "iconUrl": "https://play-lh.googleusercontent.com/Gqxk4T0uZsDwFp07DE-508hkyvcNmgFuRwPiwTEfF7D7OzGv1FdHDzEyMxNsSBZLOJlGpe3ULvVM2RgrRAlBqA",
  "headerImageUrl": "https://play-lh.googleusercontent.com/eLX_xvno2Kq_zvpkkP8yPBRfo2TEQSrv7m7WrQ6xloPsDRJ85XQ28kGYuoR-_EBWh2Uoq2GMlDvlBEIxHRyhuSg",
  "screenshotUrls": [
    "https://play-lh.googleusercontent.com/GQF4h3VL-kklOrVS_f1QRAJJZa2zQyVNcFbKdOIkvI_Pcu1op0Sy3uiryiTxpdcCDs7vEDA9eq0eWbxo0fx_wc8",
    "https://play-lh.googleusercontent.com/Q042rTbs53V_jW_c5fMqnNLCf-FBKiO2KiFKJJACa65oMCkaxqDSFKPQ7TH8nYetS-js-fMV7ptXSsF-aCkvcw"
  ],
  "videoUrl": null,
  "privacyPolicy": "https://www.whatsapp.com/legal/privacy-policy",
  "preregister": false,
  "country": "us",
  "language": "en",
  "scrapedAt": "2026-09-23T13:20:25.998Z"
}
```

Review:

```json
{
  "type": "review",
  "appId": "ch.protonvpn.android",
  "appTitle": "Proton VPN: Fast & Secure VPN",
  "reviewId": "f6b5d581-8138-4708-b9f7-f5a9b2d62e32",
  "rating": 3,
  "text": "very good app",
  "author": "Bere Bela",
  "authorImageUrl": "https://play-lh.googleusercontent.com/a-/ALV-UjUr8u0gSg4EoaRpODBiJh2rxK-vdwmr3nbNT4tmkh0xb8e-hWrA",
  "date": "2026-09-22T12:57:57.409Z",
  "thumbsUp": 0,
  "appVersion": "5.20.39.0",
  "replyText": "Thank you for your review. If you have any suggestions on what we could further improve to reach a higher rating, let us know, we’ll be happy to pass your feedback along to the team.",
  "replyDate": "2026-09-22T13:54:37.630Z",
  "url": "https://play.google.com/store/apps/details?id=ch.protonvpn.android&reviewId=f6b5d581-8138-4708-b9f7-f5a9b2d62e32",
  "country": "us",
  "language": "en",
  "scrapedAt": "2026-09-23T13:20:22.275Z"
}
```

### Use cases

#### ASO and keyword research

Who ranks for your keywords, with installs and ratings.

#### Competitor tracking

Versions, update dates, ratings and "What's new" of competitor apps every week.

#### Developer lead lists

Developer e-mail, website and address for thousands of apps in a category.

#### Review analysis

Newest reviews and developer replies for sentiment and bug tracking.

### Integrations

Every run is available through the Apify API, and the Actor works out of the box with n8n, Make, Zapier, Google Sheets, LangChain and the Apify MCP server.

### FAQ

**Do I need a Google account?** No.

**Other countries and languages?** Set **Country** (us, id, de…) and **Language** (en, id, de…).

**How many reviews can I get?** Thousands per app, newest first or by rating/helpfulness.

**Why is `installs` a range?** Google shows buckets like "10,000,000+"; `maxInstalls` is Google's own estimate.

**Is this legal?** The Actor reads public app pages. Reviewer names are personal data — handle them in line with data protection law.

# Changelog

This Actor's version history is a separate document: https://apify.com/lergassy/google-play-scraper/changelog.md

# Actor input Schema

## `searchQueries` (type: `array`):

Anything you would type into Google Play search, one per line.

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

Google Play links or package names — <b>com.whatsapp</b>, <b>https://play.google.com/store/apps/details?id=com.gojek.app</b>.

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

Developer names or developer page links — every app of the developer.

## `topChart` (type: `string`):

Add a Google Play top chart.

## `topChartCategory` (type: `string`):

Category of the chart (APPLICATION = all apps, GAME = all games).

## `topChartSize` (type: `integer`):

How many places of the chart.

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

Two-letter country code — us, id, de, br…

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

Language code for texts — en, id, de…

## `maxAppsPerSearch` (type: `integer`):

How many search results to take.

## `includeDetails` (type: `boolean`):

Installs, ratings, histogram, developer e-mail, update date, description and more for search, developer and chart results. Same price.

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

Adds reviews of every app as separate rows: stars, text, date, thumbs-up, app version, developer reply.

## `maxReviewsPerApp` (type: `integer`):

Cap on reviews per app.

## `reviewSort` (type: `string`):

Order in which reviews are collected.

## `minRating` (type: `number`):

Skip apps rated lower. Skipped apps are not charged.

## `minInstalls` (type: `integer`):

Skip apps with fewer installs, e.g. 100000.

## Actor input object example

```json
{
  "searchQueries": [
    "vpn"
  ],
  "topChart": "none",
  "topChartCategory": "APPLICATION",
  "topChartSize": 50,
  "country": "us",
  "language": "en",
  "maxAppsPerSearch": 30,
  "includeDetails": true,
  "includeReviews": false,
  "maxReviewsPerApp": 100,
  "reviewSort": "NEWEST",
  "minRating": 0,
  "minInstalls": 0
}
```

# Actor output Schema

## `results` (type: `string`):

One row per Google Play app (and review): installs, rating, price, developer contacts.

## `runSummary` (type: `string`):

JSON summary of the run: rows delivered, rows filtered out, failed inputs (free) and request statistics.

# 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 = {
    "searchQueries": [
        "vpn"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("lergassy/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 = { "searchQueries": ["vpn"] }

# Run the Actor and wait for it to finish
run = client.actor("lergassy/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 '{
  "searchQueries": [
    "vpn"
  ]
}' |
apify call lergassy/google-play-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,lergassy/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/JsBTqOLh8PWnguj0l/builds/dcpakd0Lq00IgBt64/openapi.json
