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
FieldTypeMeaning
typestringRow type: review, app or status.
app_idstring / nullAndroid package name, e.g. com.whatsapp.
app_namestring / nullApp name in that language.
languagestring / nullPlay language the row was read in (hl), e.g. en, pt-BR.
countrystring / nullPlay country the row was read in (gl), two-letter code.
review_idstring / nullGoogle's id for the review.
ratinginteger / nullStars the reviewer gave, 1-5.
textstring / nullReview text; null for a star-only review.
authorstring / nullReviewer's display name.
author_idstring / nullGoogle's id for the reviewer.
thumbs_upinteger / nullHow many users marked the review helpful.
app_versionstring / nullApp version the review was written against.
review_datestring / nullWhen the review was posted, ISO 8601 UTC.
review_daystring / nullReview date as YYYY-MM-DD.
reply_textstring / nullThe developer's public reply, when there is one.
reply_datestring / nullWhen the developer replied, ISO 8601 UTC.
urlstring / nullGoogle Play page deep-linked to the review (reviewId).
developerstring / nullDeveloper name (app rows).
developer_urlstring / nullDeveloper website (app rows).
categorystring / nullPlay category, e.g. COMMUNICATION (app rows).
content_ratingstring / nullContent rating, e.g. Everyone (app rows).
rating_avgnumber / nullAverage rating on Google Play (app rows).
rating_countinteger / nullHow many ratings the app has (app rows).
pricenumber / nullList price, 0 for free apps (app rows).
currencystring / nullCurrency of the price (app rows).
iconstring / nullApp icon URL (app rows).
descriptionstring / nullShort description (app rows).
app_urlstring / nullGoogle Play page URL (app rows).
reviews_fetchedinteger / nullReviews read for this app and locale before filtering (app rows).
statusstring / nullok, no_reviews, not_found or error (status rows).
targetstring / nullThe package name you gave (status rows).
reviewsinteger / nullReview rows delivered for this job (status rows).
filteredinteger / nullReviews dropped by minRating, maxRating, sinceDate or requireText — never billed (status rows).
pagesinteger / nullReview calls made for this job (status rows).
duplicatesinteger / nullReviews already delivered under another locale — never billed twice (status rows).
errorstring / nullWhy the job failed, when it did (status rows).
fetched_atstring / nullWhen 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.

EventUSD eachWhat is charged
review$0.004One 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

Public contract checked 2026-11-11. Active build: 1.0.6. Refresh live details before a large or recurring run.