# Google Play Reviews Scraper (`santamaria-automations/google-play-reviews-scraper`) Actor Scrape customer reviews from Google Play Store for any Android app. Input one or more package names or Google Play URLs, choose language, country and sort order, and export review text, ratings, authors, app versions, developer replies, and thumbs-up counts. No login required. Pay-per-result. - **URL**: https://apify.com/santamaria-automations/google-play-reviews-scraper.md - **Developed by:** [NanoScrape](https://apify.com/santamaria-automations) (community) - **Categories:** Lead generation, Automation - **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing Pay per event 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 Reviews Scraper Collect customer reviews from the [Google Play Store](https://play.google.com/store/apps) for any Android app. Provide one or more package names or Google Play URLs, choose your preferred language, country and sort order, and receive a clean dataset of review text, star ratings, author names, app versions, developer replies, and thumbs-up counts. No login required. ### Use with AI Agents (MCP) Connect this actor to any MCP-compatible AI client, including Claude Desktop, Claude.ai, Cursor, VS Code, LangChain and LlamaIndex. ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "-y", "mcp-remote", "https://mcp.apify.com?tools=santamaria-automations/google-play-reviews-scraper", "--header", "Authorization: Bearer " ] } } } ``` Example prompt: "Use `google-play-reviews-scraper` to collect the 100 most recent reviews for `com.instagram.android` and summarise the main complaints." ### Features - **Multi-app support**: scrape reviews for multiple apps in a single run - **Language and country selection**: access reviews from any regional Play Store - **Sort order control**: retrieve most recent, most helpful, or highest-rated reviews first - **Developer replies included**: captures both the reply text and its timestamp - **Thumbs-up counts**: see how many users found each review helpful - **Package name or URL input**: accepts bare package names or full Google Play URLs - **No credentials required**: no Google account needed - **Deduplication**: no duplicate reviews in output - **Pay-per-result**: you are only charged for reviews that were saved; runs with no reviews cost nothing ### Example input ```json { "appIds": ["com.whatsapp", "https://play.google.com/store/apps/details?id=com.spotify.music"], "language": "en", "country": "us", "sortBy": "newest", "maxReviews": 100 } ``` ### Input Parameters | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `appIds` | array or string | `["com.instagram.android"]` | Package names (e.g. `"com.whatsapp"`) or Google Play URLs (e.g. `"https://play.google.com/store/apps/details?id=com.whatsapp"`). A single value is accepted. | | `language` | string | `"en"` | Language code of the reviews and store page. | | `country` | string | `"us"` | Two-letter ISO country code for the Play Store region. | | `sortBy` | string | `"newest"` | `"newest"`, `"mosthelpful"` or `"rating"`. | | `maxReviews` | integer | `100` | Maximum reviews per app (1-5000). Numbers given as text (`"20"`) work too. | An empty input (`{}`) runs the defaults. Invalid input (for example `maxReviews` set to an object) stops the run with a clear message before anything is charged. Entries that are not a package name or Play URL are skipped with a warning; apps that do not exist are reported in the run status. ### What you get One row per review: | Field | Type | Example | Description | |-------|------|---------|-------------| | `review_id` | string | `"gp:AOqpTOFmR3z5V_vNFpGrW8xQ"` | Unique review ID from Google Play | | `app_id` | string | `"com.instagram.android"` | Google Play package name | | `app_name` | string | `"Instagram"` | App name as listed on Google Play | | `author_name` | string | `"Jane Smith"` | Display name of the reviewer | | `author_image` | string | `"https://lh3.googleusercontent.com/..."` | URL of the reviewer's Google profile picture | | `rating` | integer | `4` | Star rating from 1 (lowest) to 5 (highest) | | `body` | string | `"Great app, works perfectly."` | Full review text | | `date` | string | `"2026-04-15T08:32:00Z"` | ISO 8601 timestamp when the review was written | | `thumbs_up` | integer | `42` | Number of helpful votes the review received | | `reply_text` | string | `"Thanks for your feedback!"` | Developer reply text (empty if no reply) | | `reply_at` | string | `"2026-04-16T10:00:00Z"` | Developer reply timestamp (empty if no reply) | | `app_version` | string | `"316.0.0.0"` | App version the reviewer used | | `language` | string | `"en"` | Language code used for the query | | `country` | string | `"us"` | Country code of the Play Store region | | `review_url` | string | `"https://play.google.com/store/apps/details?id=com.instagram.android&reviewId=gp:AOqp..."` | Link to this review on Google Play | | `scraped_at` | string | `"2026-05-18T10:00:00Z"` | ISO 8601 timestamp when this record was scraped | ### Pricing | Event | Price | Description | |-------|-------|-------------| | `actor-start` | **$0.005** | Charged once per run, only when at least one review was saved | | `google-play-review-result` | **$0.00015** | Per review saved to the dataset ($0.15 per 1,000 reviews) | ### Data protection This actor returns only data that is publicly visible on the source pages. Results can include personal data, such as names, phone numbers, email addresses and addresses of private persons, sole traders or contact persons. Where the source labels an entry type, it is included so you can filter the results yourself. You are responsible for using the data lawfully, including the GDPR/DSGVO, national data-protection laws and unfair-competition rules (e.g. UWG) for marketing and outreach. ### Related actors - [App Store Reviews Scraper](https://apify.com/santamaria-automations/app-store-reviews-scraper) - the same for iOS apps on the Apple App Store. - [Trustpilot Scraper](https://apify.com/santamaria-automations/trustpilot-scraper) - company reviews from Trustpilot. - [G2 Reviews Scraper](https://apify.com/santamaria-automations/g2-reviews-scraper) - B2B software reviews from G2. - [Amazon Reviews Scraper](https://apify.com/santamaria-automations/amazon-reviews-scraper) - product reviews from Amazon. ### Support If something is not working or you are missing a feature, please [open an issue](https://console.apify.com/actors/JL42FSCkM3BwHLdSZ/issues) or email us at contact@nanoscrape.com. # Actor input Schema ## `appIds` (type: `array`): List of Google Play package names (e.g. "com.whatsapp") or full Google Play URLs (e.g. "https://play.google.com/store/apps/details?id=com.whatsapp"). A single value also works. Defaults to com.instagram.android when left empty in an API call. ## `language` (type: `string`): BCP 47 language code for the review language and interface. Defaults to "en" (English). ## `country` (type: `string`): Two-letter ISO country code for the Google Play store to scrape reviews from. Defaults to "us" (United States). ## `sortBy` (type: `string`): Review sort order: "newest" (newest first), "mosthelpful" (most helpful first) or "rating" (highest rating first). ## `maxReviews` (type: `integer`): Maximum number of reviews to collect per app (1-5000). Google Play returns reviews in pages of 40. Default is 100. ## Actor input object example ```json { "appIds": [ "com.whatsapp" ], "language": "en", "country": "us", "sortBy": "newest", "maxReviews": 100 } ``` # Actor output Schema ## `defaultDataset` (type: `string`): Dataset containing customer reviews from the Google Play Store # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "appIds": [ "com.whatsapp" ], "language": "en", "country": "us", "sortBy": "newest", "maxReviews": 100 }; // Run the Actor and wait for it to finish const run = await client.actor("santamaria-automations/google-play-reviews-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "appIds": ["com.whatsapp"], "language": "en", "country": "us", "sortBy": "newest", "maxReviews": 100, } # Run the Actor and wait for it to finish run = client.actor("santamaria-automations/google-play-reviews-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 '{ "appIds": [ "com.whatsapp" ], "language": "en", "country": "us", "sortBy": "newest", "maxReviews": 100 }' | apify call santamaria-automations/google-play-reviews-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,santamaria-automations/google-play-reviews-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 ` 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/JL42FSCkM3BwHLdSZ/builds/T25xaMdqf3Is6Dpei/openapi.json