Google Play Scraper 📱 — Rankings, Reviews & App Details

Scrape Google Play Store data as clean, structured JSON — top-chart rankings by category & country, full app reviews (uncapped & paginated), complete app details, and keyword search. One actor, four jobs.

Fast and reliable: API-first, no headless browser, with proxy rotation and fully-paginated reviews with no artificial cap (the thing most Play scrapers get wrong).

💡 The differentiator: most Google Play actors only do app details + a handful of reviews. This one owns top-chart rankings (a Sensor-Tower-style market-intelligence feed: any category × any country × Top Free / Paid / Grossing) and delivers reviews at scale.

---

📋 Table of contents

• What does it do?
• Use cases
• How to use it
• Input parameters
• Input examples
• Output — data fields
• Sample output records
• Categories & countries
• Tips & best practices
• Frequently asked questions
• Changelog

---

What does it do?

Pick a mode and get clean data:

• 🏆 Rankings — the Top Free / Top Paid / Top Grossing charts for any category and country (up to ~660 apps per chart, with rank position).
• 💬 Reviews — every public review for an app, fully paginated (sort by newest / rating / helpfulness), with rating, text, date, thumbs-up, developer reply and app version.
• 📋 App details — complete app info: rating, ratings & reviews count, ratings histogram, installs, price, IAP, developer, category, content rating, version, screenshots and more.
• 🔎 Search — apps for a keyword (great for ASO / keyword-rank tracking).

Export to JSON, CSV, Excel, XML or HTML, or pull from the Apify API. Everything is localized by country (gl) and language (hl).

---

Use cases

📈 ASO & app market intelligence

• Track top-chart rankings daily by category and country (a low-cost Sensor Tower / data.ai alternative).
• Monitor where apps rank for keywords; benchmark competitors.

💬 Review analysis & product teams

• Pull all reviews for your app (and competitors') for sentiment, bugs and feature requests.
• Track rating trends and developer responses.

🏢 Competitive & investment research

• See who's climbing the charts in any market.
• Compare installs, ratings and monetization across apps.

🤖 Data & AI teams

• Build app datasets, review-sentiment models and ranking dashboards.

---

How to use it (step by step)

No coding required.

1. Click Try for free / Start.
2. Choose a mode:
   • Rankings → pick a chart (Top Free/Paid/Grossing), category and country.
   • Reviews / App details → add App IDs (e.g. com.whatsapp) or Play URLs.
   • Search → add search terms.
3. Set country and language, and Max items.
4. Click Save & Start, then export the results.

---

Input parameters

Field	Type	Description
mode	string	rankings, reviews, appDetails, or search.
collection	string	Rankings chart: TOP_FREE, TOP_PAID, GROSSING.
category	string	Rankings category, e.g. APPLICATION, GAME, SOCIAL, FINANCE, GAME_ACTION.
appIds	array	App package names or URLs (reviews & appDetails modes).
searchTerms	array	Keywords (search mode).
maxReviewsPerApp	integer	Reviews per app, fully paginated. Default 200.
reviewsSort	string	NEWEST, RATING, or HELPFULNESS.
country	string	Country code (gl), e.g. us, gb, de, tr.
language	string	Language code (hl), e.g. en, de, tr.
fullDetail	boolean	Fetch full app details for each ranked/found app.
maxItems	integer	Max records. 0 = no limit. Default 1000.
proxyConfiguration	object	Proxy settings. Default: Apify Proxy on.
maxConcurrency	integer	Parallel apps processed. Default 4.

---

Input examples

1) Top free apps in the US

{
  "mode": "rankings",
  "collection": "TOP_FREE",
  "category": "APPLICATION",
  "country": "us",
  "maxItems": 200
}

2) Top grossing games in Germany

{
  "mode": "rankings",
  "collection": "GROSSING",
  "category": "GAME",
  "country": "de"
}

3) All reviews for an app (newest first)

{
  "mode": "reviews",
  "appIds": ["com.whatsapp", "com.spotify.music"],
  "maxReviewsPerApp": 1000,
  "reviewsSort": "NEWEST",
  "country": "us"
}

4) App details

{
  "mode": "appDetails",
  "appIds": ["com.instagram.android"]
}

5) Keyword search (ASO)

{
  "mode": "search",
  "searchTerms": ["photo editor", "budget tracker"],
  "country": "us"
}

---

Output — data fields

Ranked app (recordType: "rankedApp"): rank, collection, rankCategory, country, plus all app fields below.

App (recordType: "app" / ranked / search): appId, title, url, summary, developer, developerId, developerEmail, developerWebsite, score, scoreText, ratings, reviews, histogram, installs, minInstalls, maxInstalls, price, free, currency, priceText, offersIAP, IAPRange, adSupported, genre, genreId, categories, contentRating, androidVersion, version, updated, recentChanges, icon, headerImage, screenshots, video, privacyPolicy, editorsChoice.

Review (recordType: "review"): appId, reviewId, userName, userImage, score, title, text, date, thumbsUp, version, replyText, replyDate, criterias (per-feature ratings), url.

---

Sample output records

Ranked app:

{
  "recordType": "rankedApp",
  "rank": 1,
  "collection": "TOP_FREE",
  "rankCategory": "APPLICATION",
  "country": "us",
  "appId": "com.whatsapp",
  "title": "WhatsApp Messenger",
  "developer": "WhatsApp LLC",
  "score": 4.2,
  "ratings": 184000000,
  "installs": "5,000,000,000+",
  "free": true,
  "url": "https://play.google.com/store/apps/details?id=com.whatsapp"
}

Review:

{
  "recordType": "review",
  "appId": "com.whatsapp",
  "reviewId": "gp:AOq...",
  "userName": "Jane D.",
  "score": 5,
  "text": "Works great, love the new updates!",
  "date": "2026-06-01T10:22:00.000Z",
  "thumbsUp": 14,
  "version": "2.26.5",
  "replyText": null
}

---

Categories & countries

• Charts: TOP_FREE, TOP_PAID, GROSSING.
• Categories: APPLICATION (all apps), GAME (all games), and specific ones such as SOCIAL, COMMUNICATION, FINANCE, PRODUCTIVITY, PHOTOGRAPHY, SHOPPING, HEALTH_AND_FITNESS, TOOLS, ENTERTAINMENT, MUSIC_AND_AUDIO, plus game subcategories like GAME_ACTION, GAME_PUZZLE, GAME_STRATEGY.
• Countries / languages: any market via country (gl) + language (hl). Iterate countries to build a global ranking picture.

---

Tips & best practices

• 🏆 Rankings are recurring — schedule a daily run per category/country to track movement over time.
• 🌍 Iterate countries to compare charts across markets.
• 💬 Set maxReviewsPerApp high for full review history (Google serves up to ~4,500 per app); reviews are fully paginated.
• ⚡ Keep concurrency moderate and proxy on for large review jobs to avoid rate-limiting.
• 💾 Use the Apify API / integrations to push results into Google Sheets, a database, or a webhook.

---

Frequently asked questions

Can I get the top-chart rankings for a specific category and country? Yes — that's the rankings mode: pick chart + category + country.

Is there a review limit? Reviews are fully paginated up to Google's per-app ceiling (~4,500). Set maxReviewsPerApp to control how many.

Are prices and rankings localized? Yes — everything respects country (gl) and language (hl).

Can I scrape app details and the ratings histogram? Yes — appDetails mode returns full info including the 1–5 star histogram.

What export formats are supported? JSON, CSV, Excel, XML, HTML table, RSS — plus the Apify API and integrations.

---

Changelog

0.1.0

• Initial release: rankings (Top Free/Paid/Grossing by category & country), uncapped paginated reviews, full app details, and keyword search.
• Localized by country & language; proxy rotation; one mode-switched actor.