Google Play Scraper

📱 Google Play Scraper: Review-Focused App & Review Extractor

Get Google Play Store data in seconds. This Actor extracts slim App Metadata (ratings, installs, developer, versioning) and User Reviews for one or more apps, with customizable sorting, limits and localization — optimized for review analysis.

✨ Key Features

• Review-First Output: Clean review records with the fields analysts actually use — no media metadata noise.
• Multiple Apps per Run: Scrape up to 100 apps in one run; a failure in one app never stops the others.
• Slim App Context: A separate appdetails dataset with one listing record per app (rating, pricing, install and update context), displayed as its own App Details table.
• Deep Review Scraping: Collect up to 10,000 reviews per app — pagination across ~150-review pages is automatic.
• Customizable Localization: Scrape listings and reviews as seen in a specific language and country.
• Smart Sorting: Sort reviews by "Newest", "Helpfulness" or "Rating" to find the most relevant feedback.
• Run Summary: A run-summary key-value store record reports every app's success/failure for easy monitoring.

🛠 How to Use

1. App IDs / URLs: Enter Google Play package names (e.g. com.spotify.music), full store URLs (e.g. https://play.google.com/store/apps/details?id=com.openai.chatgpt), or a mix of both.
2. Localization: Pick your target Language and Country to see localized pricing, ranking and descriptions.
3. Review Settings:
   • Toggle Include Reviews if you need user feedback.
   • Set the Sort Order (e.g. Helpfulness) and the Number of Reviews to collect per app.
4. Run & Export: Click "Start". Once finished, download your data from the Output tab in JSON, CSV or Excel.

📥 Input Parameters

Field	Type	Default	Description
appIds	array	["com.spotify.music"]	Google Play package names or store URLs (max 100 per run).
lang	string	en	Two-letter language code for localized data.
country	string	us	Two-letter country code for store-localized prices and ranks.
includeReviews	boolean	true	Whether to also fetch user reviews for each app.
reviewsSort	string	newest	Review sort order: newest, rating or helpfulness.
reviewsNum	integer	1000	Maximum reviews per app (1–10,000), fetched in ~150-review pages.
proxyConfiguration	object	useApifyProxy: false	Route requests through the Apify Proxy or your own proxies (see note below).

Proxy tip: Google Play frequently rejects requests coming from datacenter IP ranges with 404/403 errors, especially on cloud platforms. Enabling the Apify Proxy (useApifyProxy: true) makes runs far more reliable.

The Actor also still accepts the legacy single appId field for backwards compatibility, but appIds is the recommended input.

Example input

{
    "appIds": ["com.spotify.music", "https://play.google.com/store/apps/details?id=com.openai.chatgpt"],
    "lang": "en",
    "country": "us",
    "includeReviews": true,
    "reviewsSort": "helpfulness",
    "reviewsNum": 1000
}

📊 Output Data Structure

The run's Output tab shows two tables: the default dataset holds review records — the main output, so review exports stay clean — and the appdetails dataset holds a slim app record per scraped app with the listing context. A per-run summary lives under run-summary in the key-value store; the Output tab links all three.

App record (appdetails dataset)

Slim listing context with one record per scraped app.

{
    "type": "app",
    "appId": "com.spotify.music",
    "lang": "en",
    "country": "us",
    "title": "Spotify: Music and Podcasts",
    "summary": "Listen to songs, play podcasts, create playlists...",
    "developer": "Spotify AB",
    "genre": "Music & Audio",
    "score": 4.35,
    "ratings": 35102532,
    "histogram": { "5": 21000000, "4": 6000000 },
    "installs": "1,000,000,000+",
    "minInstalls": 1000000000,
    "price": 0,
    "priceText": "Free",
    "updated": "2026-10-23T12:37:22.000Z",
    "version": "Varies with device",
    "url": "https://play.google.com/store/apps/details?id=com.spotify.music"
}

Review record example

The main output — one record per review.

{
    "type": "review",
    "appId": "com.spotify.music",
    "id": "gp:AOqpTOF...",
    "userName": "Priya Ghosh",
    "date": "2025-08-29T17:08:00.483Z",
    "score": 1,
    "title": "Ads everywhere",
    "text": "Constant popups for premium, can't skip without long ads...",
    "thumbsUp": 35966,
    "version": "9.0.74.1121",
    "replyText": "Thanks for the feedback..."
}

Run summary (run-summary key-value record)

{
    "requestedApps": 2,
    "appsScraped": 1,
    "appsFailed": 1,
    "reviewsCollected": 1000,
    "finishedAt": "2026-10-28T16:46:36.371Z",
    "succeeded": [{ "appId": "com.spotify.music", "reviews": 1000 }],
    "failed": [{ "appId": "com.does.not.exist", "error": "App not found (404)" }]
}

💡 Why use this Actor?

• ASO Research: Monitor how your competitors update their descriptions and what keywords they use.
• Sentiment Analysis: Export thousands of 1-star and 5-star reviews to analyze what users love or hate about an app.
• Price Monitoring: Track app pricing and in-app purchase availability across different countries.
• Lead Gen for Devs: Identify developers with high-traffic apps for partnership opportunities.

💻 Local Development

npm install          # install dependencies
apify run            # run the Actor locally (uses ./storage INPUT.json)
npm test             # run unit tests
npm run lint         # run ESLint
npm run format       # apply Prettier formatting