Google Play Rankings Scraper

What this Actor does

Google Play Rankings Scraper collects apps with an explicit position on the public Top free category chart. Optional enrichment adds details visible on each app's public listing. The Actor supports Top free rankings only and reports the positions shown by Google Play; it does not estimate ranking changes.

Input

Choose a category and ranking type, or provide public category or app URLs. App package IDs can also be supplied directly. maxApps limits ranked apps per category and maxItems caps total rows. Set includeDetails to true to add public app listing details; maxDetailItems caps the number of apps enriched.

{"category":"TRAVEL_AND_LOCAL","maxItems":20}

{"startUrls":[{"url":"https://play.google.com/store/apps/category/TRAVEL_AND_LOCAL?hl=en&gl=US"}],"includeDetails":true,"maxDetailItems":5}

{"appIds":["com.example.travel","com.example.maps"],"locale":"en-US","maxItems":10}

Input	Description	Default
category	Google Play category slug, such as TRAVEL_AND_LOCAL.	TRAVEL_AND_LOCAL
rankingType	Ranking shelf to collect. The current option is top_free.	top_free
startUrls	Public category or app listing URLs. sourceUrls, urls, and url are aliases.	—
appId / appIds	One or more package IDs for direct app detail records.	—
maxApps	Maximum ranked apps per category (1–500).	20
maxItems	Maximum dataset rows (1–500).	20
includeDetails	Add public details from app listing pages.	false
maxDetailItems	Maximum ranked apps to enrich when details are enabled (0–50).	10
deduplicate	Avoid duplicate app records.	true
locale / language / country	Select the Google Play storefront and language.	—
proxyConfiguration	Optional Apify Proxy configuration for public listing pages.	—

Only the first public ranking page is supported; page and maxPages are fixed at 1.

Dataset output

Each row describes an app and its visible chart position. Useful fields include appId, title, appUrl, developer, rank, rankType, rankBadge, categorySlug, shelf, rating, reviewCountText, ratingBreakdown, installsText, installsLowerBound, installsIsLowerBound, description, descriptionHtml, whatsNew, version, updatedAt, releaseDate, minimumAndroidVersion, contentRating, price, dataSafety, appIconUrl, screenshotUrls, locale, and country.

{
  "appId": "com.example.travel",
  "title": "Example Travel",
  "rank": 1,
  "rankType": "top_free",
  "categorySlug": "TRAVEL_AND_LOCAL",
  "rating": 4.6,
  "reviewCountText": "453K reviews",
  "installsText": "10M+",
  "installsLowerBound": 10000000,
  "installsIsLowerBound": true,
  "country": "US"
}

Google Play may display rounded review totals and install bands. The Actor preserves the displayed text and marks estimates or lower bounds instead of presenting them as exact counts. Detail fields appear when they are visible on the listing. Download dataset results as JSON, CSV, Excel, or another format supported by Apify.

Cost and responsible use

Check the Actor's Pricing tab for current Actor and platform charges. Enabling app detail enrichment adds public page requests. Results reflect the selected market and the listing at run time; availability and displayed values may change. Follow Google Play's terms and applicable laws.