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

Google Play Scraper returns app title, developer, rating, price, installs, category, media links, and optional reviews for any package id, Play Store URL or search term — one row per app.

- **URL**: https://apify.com/webdatatools/google-play-scraper.md
- **Developed by:** [Murat Uzun](https://apify.com/webdatatools) (community)
- **Categories:** Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.20 / 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?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.
Actors are written with capital "A".

## 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.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

### What is Google Play Scraper?

Google Play Scraper is an Apify Actor that reads any Android app's Google Play Store listing — **title, developer, rating, price, installs, category, media links, description and optional reviews** — and returns **one clean row per app**. Give it a package id (`com.spotify.music`), a full [Play Store URL](https://play.google.com/store/apps/details?id=com.spotify.music), or `search:<term>` to pull the top search results for a keyword. No login, no proxy, no headless browser — every field comes from the same hydration data and structured metadata the Play Store web page itself renders from.

### What data does Google Play Scraper extract?

Google Play Scraper extracts around 35 fields per app:

| Field | Type | Description |
| --- | --- | --- |
| `appId`, `url`, `query` | string | Package id, canonical detail URL, and the input entry that produced this row |
| `title`, `summary`, `description` | string | App name, one-line summary, full description (truncated to 5,000 characters) |
| `developer`, `developerId`, `developerUrl`, `developerEmail`, `developerWebsite` | string | Publisher identity and contact details |
| `score`, `ratingCount`, `reviewCount`, `histogram` | number, object | Average rating, total ratings/reviews, and the 1-5 star breakdown |
| `price`, `currency`, `isFree` | number, string, boolean | Purchase price in the storefront currency |
| `containsAds`, `offersIAP` | boolean | Whether the listing shows the ads badge or an in-app purchase price range |
| `installs`, `minInstalls` | string, number | Install count range as displayed, and its lower bound |
| `version`, `androidVersion` | string | Current version and minimum Android OS version, when disclosed (see Limitations) |
| `contentRating`, `genre`, `genreId`, `categories` | string, array | Age rating and category tag(s) |
| `released`, `updatedAt`, `daysSinceUpdate` | string, number | First release date, last update date, and days since |
| `iconUrl`, `headerImage`, `screenshotCount`, `privacyPolicyUrl` | string, number | Media links |
| `reviews` | array | Newest reviews (id, userName, score, text, date, thumbsUp, replyText, replyDate, version) when **Include reviews** is on |
| `error`, `scrapedAt` | string | Per-app failure note and scrape timestamp |

### How to use Google Play Scraper

1. Paste package ids, full Play Store URLs, or `search:<term>` entries into **Apps** — one row comes back per app, or per top search result.
2. Set **Country** and **Language** to read a specific storefront; pricing and availability can differ by country.
3. Turn on **Include reviews** and set **Max reviews per app** to also pull each app's newest reviews.
4. Click **Start**, then export the dataset as JSON, CSV, Excel or HTML.

### Example input

```json
{
    "apps": ["com.spotify.music", "com.duolingo", "search:meditation"],
    "country": "us",
    "language": "en",
    "searchLimit": 20,
    "includeReviews": false,
    "maxConcurrency": 3
}
```

### Example output

```json
{
    "appId": "com.spotify.music",
    "url": "https://play.google.com/store/apps/details?id=com.spotify.music&hl=en&gl=us",
    "title": "Spotify: Music and Podcasts",
    "developer": "Spotify AB",
    "developerEmail": "support@spotify.com",
    "developerWebsite": "https://www.spotify.com",
    "summary": "Listen to songs, play podcasts, create playlists and discover music you'll love",
    "score": 4.35,
    "ratingCount": 36290063,
    "reviewCount": 1852083,
    "price": 0,
    "currency": "USD",
    "isFree": true,
    "containsAds": true,
    "offersIAP": true,
    "installs": "1,000,000,000+",
    "genre": "Music & Audio",
    "genreId": "MUSIC_AND_AUDIO",
    "updatedAt": "2026-09-10T09:06:44.000Z",
    "daysSinceUpdate": 3,
    "iconUrl": "https://play-lh.googleusercontent.com/IzQgYCcnCFCD08GR-3bdtcT8xzOvrNkC84avGT5CwTX2VIqmTmKKJcP_Cd4JoBOdmCMlTndlOzV6hrthg2fOWA",
    "screenshotCount": 40,
    "query": "com.spotify.music",
    "error": null,
    "scrapedAt": "2026-09-13T00:00:00.000Z"
}
```

### Input parameters

| Parameter | Type | Default | Description |
| --- | --- | --- | --- |
| `apps` | array | `["com.spotify.music"]` | Package ids, Play URLs, or `search:<term>` entries, one row (or result set) each |
| `country` | string | `us` | 2-letter storefront country code |
| `language` | string | `en` | 2-letter language code for text fields |
| `searchLimit` | integer | 20 | Max results per `search:<term>` entry (1-100) |
| `includeReviews` | boolean | `false` | Add each app's newest reviews |
| `maxReviewsPerApp` | integer | 50 | Max reviews per app when reviews are on (1-500) |
| `maxConcurrency` | integer | 3 | Apps fetched in parallel (1-20) |

### How the data is extracted

Google Play's detail pages embed a large `AF_initDataCallback({key:'ds:5', data:[...]})` hydration payload — the same technique used by this suite's Chrome Web Store Extension Scraper — that carries almost every field: rating, histogram, price, installs, developer contact, media links and, for single-APK apps, version and minimum Android version. This is cross-checked against the page's `application/ld+json` structured data (name, rating, price, content rating) and, for the category tag(s), the rendered genre chip HTML. A field missing from all three sources is reported as `null` rather than guessed. `search:<term>` entries are resolved by reading the Play Store search results page for package ids, which are then scraped exactly like any other app. Reviews, when requested, use the same unauthenticated `batchexecute` endpoint the open-source `google-play-scraper` npm package uses — no login required.

### Limitations

Google's array layout is undocumented and unversioned; a future redesign could shift the field indices, in which case affected fields degrade to `null` rather than break the run — check the Issues tab if a run starts returning unexpectedly empty fields. `version` and `androidVersion` are only available for apps Google serves as a single APK; multi-variant apps (most large apps, including Spotify and Duolingo) show no single version on the web listing, so these come back `null` by design. `size` is always `null` — Google Play's web detail page no longer publishes install size. A single `search:<term>` fetch returns roughly 20-30 unauthenticated results with no further pagination, so `searchLimit` above that is a ceiling, not a guarantee. The reviews endpoint is an undocumented Google API and could change without notice.

### Pricing

Google Play Scraper uses pay-per-event pricing, billed per app row returned, plus a negligible actor-start fee, platform usage included. Set **Maximum cost per run** and the Actor trims the app list to what the budget covers instead of overspending.

### Google Play Scraper vs. manual lookups

Checking installs, rating trends or a competitor's latest update one listing at a time does not scale past a handful of apps. Google Play Scraper takes a whole portfolio or a whole search results page in one run, returns a flat dataset ready for a spreadsheet or BI tool, and can be scheduled to catch a rating drop or a policy change the day it happens.

### Using Google Play Scraper with AI agents and MCP

Google Play Scraper is pay-per-event with limited permissions — the two requirements for an Actor to be callable through the Apify MCP server at `mcp.apify.com`. An agent passes `apps` and gets one structured row per app back, ready for an ASO audit, a competitor-monitoring step, or a "what does the market think of this app" reviews summary. The same run works from n8n, Make, Zapier and LangChain through Apify's integrations.

### FAQ

**Why are `version` and `androidVersion` null for most apps?** Google Play serves large apps as multiple APK/AAB variants targeting different devices, and the web listing shows no single version number for those — only single-APK apps disclose one.

**Is this legal to run?** Yes. This Actor reads the same public HTML, structured data and review data Google already serves to any visitor's browser; no login or bypass of any access control is involved.

**Can I look up an app by developer instead of package id?** Not directly — search `search:<developer name>` for a keyword match, or scrape each of the developer's known package ids.

**What happens if a package id doesn't exist?** The row comes back with `error` set (e.g. "App not found, removed, or not available in the requested country") and every data field `null`, so the run still succeeds and you can see which ids failed.

### Related Actors

Part of the **webdatatools** web-intelligence suite — every Actor is pay-per-event, runs without
proxies or a headless browser, and returns one clean row per entity:

**Website & domain intelligence**

- [Website Contact & Social Extractor](https://apify.com/webdatatools/contact-extractor) — e-mails, phones and social profiles per domain
- [Website Tech Stack Detector](https://apify.com/webdatatools/tech-stack-detector) — CMS, e-commerce, analytics, pixels and payments per domain
- [Domain DNS & Email Security Checker](https://apify.com/webdatatools/dns-email-security-checker) — SPF, DKIM, DMARC, MX provider, registrar and domain age
- [Domain Security Audit](https://apify.com/webdatatools/domain-security-audit) — TLS expiry, security headers, redirect chain, robots and llms.txt
- [Subdomain Finder (Certificate Transparency)](https://apify.com/webdatatools/subdomain-finder) — every subdomain seen in CT logs, with a live DNS check
- [Bulk Core Web Vitals & PageSpeed Audit](https://apify.com/webdatatools/core-web-vitals-audit) — Lighthouse scores, LCP, CLS, INP and top fixes per URL
- [On-Page SEO Audit](https://apify.com/webdatatools/seo-page-audit) — title, meta, headings, links, images and schema issues per page
- [Sitemap URL Extractor & Change Monitor](https://apify.com/webdatatools/sitemap-extractor) — every sitemap URL, or new and removed pages between runs
- [Wayback Machine Snapshot & Page Change Tracker](https://apify.com/webdatatools/wayback-page-diff) — how a page changed over time, or every archived snapshot

**Content for AI, LLMs and RAG**

- [AI Web Search & Read](https://apify.com/webdatatools/ai-web-search) — a query turned into clean Markdown from the top search results
- [Website to Markdown Crawler for LLM & RAG](https://apify.com/webdatatools/website-to-markdown) — any site as clean Markdown per page, no browser
- [Article & News Extractor](https://apify.com/webdatatools/article-extractor) — clean article text, author, date and Markdown per URL
- [Structured Data & JSON-LD Extractor](https://apify.com/webdatatools/structured-data-extractor) — Schema.org and Open Graph data from any page
- [Google News Scraper](https://apify.com/webdatatools/google-news-scraper) — news results by keyword, topic or site
- [Press Release Monitor](https://apify.com/webdatatools/press-release-monitor) — PR Newswire, Business Wire and GlobeNewswire releases

**Search, video and social**

- [Google Search Results Scraper](https://apify.com/webdatatools/google-search-scraper) — organic SERP results per keyword and country
- [YouTube Comments Scraper](https://apify.com/webdatatools/youtube-comments-scraper) — comments and replies with likes, no API key
- [YouTube Channel Latest Videos](https://apify.com/webdatatools/youtube-channel-videos) — the latest 15 videos of any channel from RSS
- [YouTube Channel Videos Scraper](https://apify.com/webdatatools/youtube-channel-scraper) — a channel's full video, shorts and stream list
- [YouTube Search Results Scraper](https://apify.com/webdatatools/youtube-search-scraper) — videos, channels and playlists per query
- [YouTube Video Details Scraper](https://apify.com/webdatatools/youtube-video-details) — views, likes, description, tags and chapters per video
- [Apple Podcasts Lookup & Episodes Scraper](https://apify.com/webdatatools/podcast-lookup) — podcast metadata and episodes from iTunes and RSS
- [Bluesky Scraper](https://apify.com/webdatatools/bluesky-scraper) — posts, profiles, followers and threads from the AT Protocol API

**Leads, jobs and company data**

- [Company 360](https://apify.com/webdatatools/company-360) — one row per domain: contacts, tech, security, hiring and company facts
- [Hiring Signals Scraper](https://apify.com/webdatatools/hiring-signals) — open jobs and hiring velocity from 10 public ATS boards
- [Y Combinator Companies & Founders Scraper](https://apify.com/webdatatools/yc-companies-scraper) — YC startups by batch, industry and hiring status
- [Wikidata Entity & Company Enrichment](https://apify.com/webdatatools/wikidata-entity-enrichment) — HQ, founders, employees, revenue and social IDs per company
- [Bulk Email Validator](https://apify.com/webdatatools/email-validator) — syntax, MX, disposable, role and free-provider checks
- [OpenStreetMap POI Extractor](https://apify.com/webdatatools/overpass-poi-extractor) — shops and amenities by radius, bbox or area

**Developer, app and research data**

- [npm, PyPI & Crates.io Package Health Checker](https://apify.com/webdatatools/package-health-checker) — releases, downloads, deprecation and a health score
- [GitHub Repository Health & Activity Report](https://apify.com/webdatatools/github-repo-health) — stars, commits, contributors and risk flags per repo
- [VS Code Marketplace Extension Scraper](https://apify.com/webdatatools/vscode-marketplace-extensions) — installs, ratings and versions per extension
- [Chrome Web Store Extension Scraper](https://apify.com/webdatatools/chrome-web-store-extensions) — users, rating, version and developer per extension
- [App Store (iOS) App Metadata & Top Charts](https://apify.com/webdatatools/app-store-lookup) — ratings, price, version and charts per app
- [CrossRef DOI & Citation Metadata Lookup](https://apify.com/webdatatools/crossref-doi-lookup) — papers, authors, journals and citation counts
- [FDA Recalls & Adverse Events Monitor](https://apify.com/webdatatools/openfda-recall-monitor) — food, drug and device recalls from openFDA
- [iCal / ICS Calendar Feed to Events Extractor](https://apify.com/webdatatools/ical-calendar-extractor) — any public calendar feed as event rows
- [Shopify Store Products Scraper](https://apify.com/webdatatools/shopify-products-scraper) — catalog, prices, variants and stock per store

### Support and feedback

Found a field that's come back empty on an app where it should be populated, or a parsing bug? Open an issue on the **Issues** tab.

# Actor input Schema

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

Enter the apps to scrape, one row is returned per app. Use the package id, e.g. com.spotify.music, a full Play Store URL, e.g. https://play.google.com/store/apps/details?id=com.spotify.music, or search:<term>, e.g. search:meditation, to scrape the top search results for a term.

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

Enter the 2-letter country code for the Play Store storefront to read, e.g. us, gb, de. Pricing, availability and installs shown can differ by country.

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

Enter the 2-letter language code for the app title, description and other text, e.g. en, es, de.

## `searchLimit` (type: `integer`):

Enter how many apps to return per search:<term> entry, e.g. 20. A single Play Store search page load returns roughly 20-30 unauthenticated results with no further pagination, so this is a ceiling, not a guarantee.

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

Turn this on to add the newest reviews for each app (capped by "Max reviews per app"). Uses the same unauthenticated batchexecute endpoint the open-source google-play-scraper npm package uses for reviews — no login required, but it is an undocumented Google endpoint and could change without notice.

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

Enter how many of the newest reviews to fetch per app when "Include reviews" is on, e.g. 50. Ignored when "Include reviews" is off.

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

Enter the maximum number of apps to fetch in parallel, e.g. 3. Google Play has no published rate limit for these endpoints, but a lower value is safer for long lists.

## Actor input object example

```json
{
  "apps": [
    "com.spotify.music",
    "com.duolingo",
    "search:meditation"
  ],
  "country": "us",
  "language": "en",
  "searchLimit": 20,
  "includeReviews": false,
  "maxReviewsPerApp": 50,
  "maxConcurrency": 3
}
```

# Actor output Schema

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

All scraped apps — download as JSON, CSV, Excel or HTML.

# 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",
        "com.duolingo",
        "search:meditation"
    ],
    "country": "us",
    "language": "en",
    "searchLimit": 20,
    "includeReviews": false,
    "maxReviewsPerApp": 50,
    "maxConcurrency": 3
};

// Run the Actor and wait for it to finish
const run = await client.actor("webdatatools/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",
        "com.duolingo",
        "search:meditation",
    ],
    "country": "us",
    "language": "en",
    "searchLimit": 20,
    "includeReviews": False,
    "maxReviewsPerApp": 50,
    "maxConcurrency": 3,
}

# Run the Actor and wait for it to finish
run = client.actor("webdatatools/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",
    "com.duolingo",
    "search:meditation"
  ],
  "country": "us",
  "language": "en",
  "searchLimit": 20,
  "includeReviews": false,
  "maxReviewsPerApp": 50,
  "maxConcurrency": 3
}' |
apify call webdatatools/google-play-scraper --silent --output-dataset

```

## MCP server setup

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