MCP + API · kestrel/google-play-reviews-scraper
Google Play Reviews Scraper — Android App Reviews & Ratings
Play Store reviews by language and country for Android apps by package name or URL. One row per review: 1-5 rating, text, reviewer, thumbs-up, app version, developer reply. Free app row: Google Play ratings. Filters before billing: star rating (negative, one-star reviews), since date (new reviews).
Open Actor Download MCP config
Connect this tool
Add this URL as a remote MCP server in your client, then sign in to Apify. For a client-specific setup, use Apify's configurator.
https://mcp.apify.com?tools=call-actor,fetch-actor-details,kestrel/google-play-reviews-scraper
Generic MCP client configuration
{
"mcpServers": {
"kestrel-google-play-reviews-scraper": {
"url": "https://mcp.apify.com?tools=call-actor,fetch-actor-details,kestrel/google-play-reviews-scraper"
}
}
}
Understand the output before you run
Three row types share one dataset: review (one user review, charged), app (context for an app in a language and country, free) and status (per app, language and country, free).
Declared dataset fields and row types · Output locations and dataset links
Use the declared dataset schema for item fields; the output schema describes where results are stored. Optional fields may be null or absent. If an integration shows a sampled schema without an optional field, check this declaration, the Actor instructions and actual returned rows before concluding that the field is unsupported.
Inspect 37 declared output fields
| Field | Type | Meaning |
|---|---|---|
type | string | Row type: review, app or status. |
app_id | string / null | Android package name, e.g. com.whatsapp. |
app_name | string / null | App name in that language. |
language | string / null | Play language the row was read in (hl), e.g. en, pt-BR. |
country | string / null | Play country the row was read in (gl), two-letter code. |
review_id | string / null | Google's id for the review. |
rating | integer / null | Stars the reviewer gave, 1-5. |
text | string / null | Review text; null for a star-only review. |
author | string / null | Reviewer's display name. |
author_id | string / null | Google's id for the reviewer. |
thumbs_up | integer / null | How many users marked the review helpful. |
app_version | string / null | App version the review was written against. |
review_date | string / null | When the review was posted, ISO 8601 UTC. |
review_day | string / null | Review date as YYYY-MM-DD. |
reply_text | string / null | The developer's public reply, when there is one. |
reply_date | string / null | When the developer replied, ISO 8601 UTC. |
url | string / null | Google Play page deep-linked to the review (reviewId). |
developer | string / null | Developer name (app rows). |
developer_url | string / null | Developer website (app rows). |
category | string / null | Play category, e.g. COMMUNICATION (app rows). |
content_rating | string / null | Content rating, e.g. Everyone (app rows). |
rating_avg | number / null | Average rating on Google Play (app rows). |
rating_count | integer / null | How many ratings the app has (app rows). |
price | number / null | List price, 0 for free apps (app rows). |
currency | string / null | Currency of the price (app rows). |
icon | string / null | App icon URL (app rows). |
description | string / null | Short description (app rows). |
app_url | string / null | Google Play page URL (app rows). |
reviews_fetched | integer / null | Reviews read for this app and locale before filtering (app rows). |
status | string / null | ok, no_reviews, not_found or error (status rows). |
target | string / null | The package name you gave (status rows). |
reviews | integer / null | Review rows delivered for this job (status rows). |
filtered | integer / null | Reviews dropped by minRating, maxRating, sinceDate or requireText — never billed (status rows). |
pages | integer / null | Review calls made for this job (status rows). |
duplicates | integer / null | Reviews already delivered under another locale — never billed twice (status rows). |
error | string / null | Why the job failed, when it did (status rows). |
fetched_at | string / null | When the row was read, ISO 8601 UTC. |
Start with a small sample
Use call-actor with the JSON below. The $0.25 run ceiling is separate from the Actor input and may stop the sample early. Change the target to match your request. This input validates against build 1.0.6; it is not a promise that the source has matching rows today.
{
"actor": "kestrel/google-play-reviews-scraper",
"input": {
"appIds": [
"com.whatsapp"
],
"languages": [
"en"
],
"countries": [
"us"
],
"maxReviewsPerApp": 3,
"sort": "most_recent"
},
"callOptions": {
"maxTotalChargeUsd": 0.25,
"timeout": 300
},
"waitSecs": 30
}
After completion, use get-dataset-items with storages.datasets.default.id. If still running, poll get-actor-run using the returned runId. Check status rows and errors before treating an empty dataset as no matches.
Call from Python, JavaScript or REST
Python SDK 3 example · JavaScript SDK 2 example · curl + jq example. Each uses this same small input, reads APIFY_TOKEN from your environment, sets a five-minute run timeout and exports all dataset row types as JSON Lines. The $0.25 run ceiling is separate from the Actor input and may stop the sample early. Inspect the run and source status before treating results as complete. Installation and usage.
Pricing and limits
Current listed event prices in USD. Some Actors charge for successful source checks even when no output rows match. The event descriptions below define those differences.
| Event | USD each | What is charged |
|---|---|---|
review | $0.004 | One Google Play review (row keys review_id, app_id, language, country, rating = 1-5, text, author, thumbs_up, app_version, review_date, reply_text = developer reply, reply_date, url): $4 per 1,000 reviews. Not charged: app rows (Google Play rating, rating count, category, price), status rows, reviews removed by minRating, maxRating, sinceDate or requireText, reviews Google itself skips when one star value is asked (never fetched), a review listed under two languages or countries (delivered once), apps with no reviews, unknown packages, failed jobs, bad input. No start fee; proxy and compute are included in the event price. Google answers up to 100 reviews per request. The run stops at the maximum cost per run you set when starting it (Apify run option maxTotalChargeUsd), never above it. |
Contracts for agents
- Input schema and sample input
- Prepared MCP call and pricing events
- Full Actor instructions and limits
- REST API
Public contract checked 2026-11-11. Active build: 1.0.6. Refresh live details before a large or recurring run.