{
  "data": {
    "id": "l7qfZ0H2LUJ6X0uMc",
    "actId": "2bieGJmDSQHEkqcl9",
    "userId": "tnBVjt3CXmcUrEE3L",
    "startedAt": "2026-11-20T02:26:27.602Z",
    "finishedAt": "2026-11-20T02:26:30.490Z",
    "status": "SUCCEEDED",
    "meta": {
      "origin": "CI"
    },
    "stats": {
      "durationMillis": 2820,
      "runTimeSecs": 2.82,
      "computeUnits": 0.0031333333333333335,
      "imageSizeBytes": 319193088
    },
    "options": {
      "useCache": true,
      "betaPackages": false,
      "memoryMbytes": 4096,
      "diskMbytes": 8192
    },
    "createdByOrganizationMemberUserId": "F2Aeb3gE2syjqz9xC",
    "exitCode": 0,
    "inputSchema": "{\n  \"title\": \"Google Play Top Charts, Collections & Events Input\",\n  \"description\": \"Choose charts, editorial collections or live events for a Google Play market.\",\n  \"type\": \"object\",\n  \"schemaVersion\": 1,\n  \"properties\": {\n    \"mode\": {\n      \"title\": \"Mode\",\n      \"type\": \"string\",\n      \"description\": \"What to collect: ranked charts, editorial collections, or in-app events.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"charts\",\n        \"collections\",\n        \"events\"\n      ],\n      \"enumTitles\": [\n        \"Top charts (ranked apps)\",\n        \"Editorial collections\",\n        \"In-app events & offers\"\n      ],\n      \"default\": \"charts\",\n      \"prefill\": \"charts\"\n    },\n    \"country\": {\n      \"title\": \"Country\",\n      \"type\": \"string\",\n      \"description\": \"Google Play storefront country. Affects chart rankings, prices and availability.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"us\",\n        \"gb\",\n        \"ca\",\n        \"au\",\n        \"nz\",\n        \"ie\",\n        \"in\",\n        \"de\",\n        \"fr\",\n        \"es\",\n        \"it\",\n        \"nl\",\n        \"be\",\n        \"at\",\n        \"ch\",\n        \"se\",\n        \"no\",\n        \"dk\",\n        \"fi\",\n        \"pl\",\n        \"pt\",\n        \"cz\",\n        \"ro\",\n        \"hu\",\n        \"gr\",\n        \"tr\",\n        \"ru\",\n        \"ua\",\n        \"za\",\n        \"eg\",\n        \"ng\",\n        \"ke\",\n        \"id\",\n        \"th\",\n        \"vn\",\n        \"ph\",\n        \"my\",\n        \"sg\",\n        \"tw\",\n        \"hk\",\n        \"jp\",\n        \"kr\",\n        \"br\",\n        \"mx\",\n        \"ar\",\n        \"cl\",\n        \"co\",\n        \"pe\",\n        \"il\",\n        \"ae\",\n        \"sa\",\n        \"pk\",\n        \"bd\",\n        \"lk\",\n        \"kh\",\n        \"mm\",\n        \"kz\"\n      ],\n      \"enumTitles\": [\n        \"United States\",\n        \"United Kingdom\",\n        \"Canada\",\n        \"Australia\",\n        \"New Zealand\",\n        \"Ireland\",\n        \"India\",\n        \"Germany\",\n        \"France\",\n        \"Spain\",\n        \"Italy\",\n        \"Netherlands\",\n        \"Belgium\",\n        \"Austria\",\n        \"Switzerland\",\n        \"Sweden\",\n        \"Norway\",\n        \"Denmark\",\n        \"Finland\",\n        \"Poland\",\n        \"Portugal\",\n        \"Czechia\",\n        \"Romania\",\n        \"Hungary\",\n        \"Greece\",\n        \"Türkiye\",\n        \"Russia\",\n        \"Ukraine\",\n        \"South Africa\",\n        \"Egypt\",\n        \"Nigeria\",\n        \"Kenya\",\n        \"Indonesia\",\n        \"Thailand\",\n        \"Vietnam\",\n        \"Philippines\",\n        \"Malaysia\",\n        \"Singapore\",\n        \"Taiwan\",\n        \"Hong Kong\",\n        \"Japan\",\n        \"South Korea\",\n        \"Brazil\",\n        \"Mexico\",\n        \"Argentina\",\n        \"Chile\",\n        \"Colombia\",\n        \"Peru\",\n        \"Israel\",\n        \"United Arab Emirates\",\n        \"Saudi Arabia\",\n        \"Pakistan\",\n        \"Bangladesh\",\n        \"Sri Lanka\",\n        \"Cambodia\",\n        \"Myanmar\",\n        \"Kazakhstan\"\n      ],\n      \"default\": \"us\",\n      \"prefill\": \"us\"\n    },\n    \"language\": {\n      \"title\": \"Language\",\n      \"type\": \"string\",\n      \"description\": \"Language for app titles, genres and event text.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"en\",\n        \"es\",\n        \"fr\",\n        \"de\",\n        \"it\",\n        \"pt\",\n        \"ja\",\n        \"ko\",\n        \"zh\",\n        \"ru\",\n        \"ar\",\n        \"hi\",\n        \"th\",\n        \"vi\",\n        \"id\",\n        \"tr\",\n        \"pl\",\n        \"nl\",\n        \"sv\",\n        \"da\",\n        \"no\",\n        \"fi\",\n        \"cs\",\n        \"ro\",\n        \"hu\",\n        \"el\",\n        \"he\",\n        \"uk\",\n        \"ms\",\n        \"tl\",\n        \"bn\",\n        \"ur\",\n        \"fa\"\n      ],\n      \"enumTitles\": [\n        \"English\",\n        \"Spanish\",\n        \"French\",\n        \"German\",\n        \"Italian\",\n        \"Portuguese\",\n        \"Japanese\",\n        \"Korean\",\n        \"Chinese\",\n        \"Russian\",\n        \"Arabic\",\n        \"Hindi\",\n        \"Thai\",\n        \"Vietnamese\",\n        \"Indonesian\",\n        \"Turkish\",\n        \"Polish\",\n        \"Dutch\",\n        \"Swedish\",\n        \"Danish\",\n        \"Norwegian\",\n        \"Finnish\",\n        \"Czech\",\n        \"Romanian\",\n        \"Hungarian\",\n        \"Greek\",\n        \"Hebrew\",\n        \"Ukrainian\",\n        \"Malay\",\n        \"Filipino\",\n        \"Bengali\",\n        \"Urdu\",\n        \"Persian\"\n      ],\n      \"default\": \"en\",\n      \"prefill\": \"en\"\n    },\n    \"section\": {\n      \"title\": \"Store section\",\n      \"type\": \"string\",\n      \"description\": \"Apps, games or kid-friendly content. Category options are filtered by this section in the code.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"apps\",\n        \"games\",\n        \"kids\"\n      ],\n      \"enumTitles\": [\n        \"Apps\",\n        \"Games\",\n        \"Kids\"\n      ],\n      \"default\": \"games\",\n      \"prefill\": \"games\"\n    },\n    \"device\": {\n      \"title\": \"Device\",\n      \"type\": \"string\",\n      \"description\": \"Store surface. Watch charts use watch-face/watch-app categories; collections use the device-specific App Store home. Google publishes one shared ranking for phone, tablet, TV, Chromebook and car.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"phone\",\n        \"tablet\",\n        \"tv\",\n        \"chromebook\",\n        \"watch\",\n        \"car\"\n      ],\n      \"enumTitles\": [\n        \"Phone\",\n        \"Tablet\",\n        \"TV\",\n        \"Chromebook\",\n        \"Watch\",\n        \"Car\"\n      ],\n      \"default\": \"phone\",\n      \"prefill\": \"phone\"\n    },\n    \"chart\": {\n      \"title\": \"Chart\",\n      \"type\": \"string\",\n      \"description\": \"Which top chart to read.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"topFree\",\n        \"topGrossing\",\n        \"topPaid\"\n      ],\n      \"enumTitles\": [\n        \"Top free\",\n        \"Top grossing\",\n        \"Top paid\"\n      ],\n      \"default\": \"topFree\",\n      \"prefill\": \"topFree\"\n    },\n    \"category\": {\n      \"title\": \"Category\",\n      \"type\": \"string\",\n      \"description\": \"Category to read. \\\"All categories\\\" uses the section default: all apps, all games or kids.\",\n      \"editor\": \"select\",\n      \"enum\": [\n        \"all\",\n        \"APPLICATION\",\n        \"GAME\",\n        \"ART_AND_DESIGN\",\n        \"AUTO_AND_VEHICLES\",\n        \"BEAUTY\",\n        \"BOOKS_AND_REFERENCE\",\n        \"BUSINESS\",\n        \"COMICS\",\n        \"COMMUNICATION\",\n        \"DATING\",\n        \"EDUCATION\",\n        \"ENTERTAINMENT\",\n        \"EVENTS\",\n        \"FINANCE\",\n        \"FOOD_AND_DRINK\",\n        \"HEALTH_AND_FITNESS\",\n        \"HOUSE_AND_HOME\",\n        \"LIBRARIES_AND_DEMO\",\n        \"LIFESTYLE\",\n        \"MAPS_AND_NAVIGATION\",\n        \"MEDICAL\",\n        \"MUSIC_AND_AUDIO\",\n        \"NEWS_AND_MAGAZINES\",\n        \"PARENTING\",\n        \"PERSONALIZATION\",\n        \"PHOTOGRAPHY\",\n        \"PRODUCTIVITY\",\n        \"SHOPPING\",\n        \"SOCIAL\",\n        \"SPORTS\",\n        \"TOOLS\",\n        \"TRAVEL_AND_LOCAL\",\n        \"VIDEO_PLAYERS\",\n        \"WEATHER\",\n        \"GAME_ACTION\",\n        \"GAME_ADVENTURE\",\n        \"GAME_ARCADE\",\n        \"GAME_BOARD\",\n        \"GAME_CARD\",\n        \"GAME_CASINO\",\n        \"GAME_CASUAL\",\n        \"GAME_EDUCATIONAL\",\n        \"GAME_MUSIC\",\n        \"GAME_PUZZLE\",\n        \"GAME_RACING\",\n        \"GAME_ROLE_PLAYING\",\n        \"GAME_SIMULATION\",\n        \"GAME_SPORTS\",\n        \"GAME_STRATEGY\",\n        \"GAME_TRIVIA\",\n        \"GAME_WORD\",\n        \"FAMILY\",\n        \"FAMILY_ACTION\",\n        \"FAMILY_BRAINGAMES\",\n        \"FAMILY_CREATE\",\n        \"FAMILY_EDUCATION\",\n        \"FAMILY_MUSICVIDEO\",\n        \"FAMILY_PRETEND\",\n        \"WATCH_FACE\",\n        \"ANDROID_WEAR\"\n      ],\n      \"enumTitles\": [\n        \"All categories\",\n        \"All apps\",\n        \"All games\",\n        \"Art & design\",\n        \"Auto & vehicles\",\n        \"Beauty\",\n        \"Books & reference\",\n        \"Business\",\n        \"Comics\",\n        \"Communication\",\n        \"Dating\",\n        \"Education\",\n        \"Entertainment\",\n        \"Events\",\n        \"Finance\",\n        \"Food & drink\",\n        \"Health & fitness\",\n        \"House & home\",\n        \"Libraries & demo\",\n        \"Lifestyle\",\n        \"Maps & navigation\",\n        \"Medical\",\n        \"Music & audio\",\n        \"News & magazines\",\n        \"Parenting\",\n        \"Personalization\",\n        \"Photography\",\n        \"Productivity\",\n        \"Shopping\",\n        \"Social\",\n        \"Sports\",\n        \"Tools\",\n        \"Travel & local\",\n        \"Video players\",\n        \"Weather\",\n        \"Action\",\n        \"Adventure\",\n        \"Arcade\",\n        \"Board\",\n        \"Card\",\n        \"Casino\",\n        \"Casual\",\n        \"Educational\",\n        \"Music\",\n        \"Puzzle\",\n        \"Racing\",\n        \"Role playing\",\n        \"Simulation\",\n        \"Sports\",\n        \"Strategy\",\n        \"Trivia\",\n        \"Word\",\n        \"Kids\",\n        \"Kids action\",\n        \"Kids brain games\",\n        \"Kids create\",\n        \"Kids education\",\n        \"Kids music & video\",\n        \"Kids pretend play\",\n        \"Watch faces\",\n        \"Watch apps\"\n      ],\n      \"default\": \"all\",\n      \"prefill\": \"all\"\n    },\n    \"maxRank\": {\n      \"title\": \"Max rank\",\n      \"type\": \"integer\",\n      \"description\": \"Highest chart position to return (1-200). Google publishes up to 200 ranked entries per chart.\",\n      \"minimum\": 1,\n      \"maximum\": 200,\n      \"default\": 100,\n      \"prefill\": 1\n    },\n    \"includeDetails\": {\n      \"title\": \"Enrich with app details\",\n      \"type\": \"boolean\",\n      \"description\": \"Fetch each app page for rating count, installs range, developer ID/contact, version, update date, ads flag and summary. Adds one request per chart row.\",\n      \"default\": true,\n      \"prefill\": false\n    },\n    \"trackRankChanges\": {\n      \"title\": \"Track rank changes\",\n      \"type\": \"boolean\",\n      \"description\": \"Compare this run with the actor's previous run for the same country, section, device, category and chart. Adds previousRank, rankChange and rankMovement.\",\n      \"default\": true,\n      \"prefill\": true\n    },\n    \"maxClusters\": {\n      \"title\": \"Max collections\",\n      \"type\": \"integer\",\n      \"description\": \"Maximum editorial collections to return in collections mode (1-80).\",\n      \"minimum\": 1,\n      \"maximum\": 80,\n      \"default\": 20,\n      \"prefill\": 3\n    },\n    \"maxAppsPerCluster\": {\n      \"title\": \"Max apps per collection\",\n      \"type\": \"integer\",\n      \"description\": \"Maximum apps to include in each editorial collection (1-60).\",\n      \"minimum\": 1,\n      \"maximum\": 60,\n      \"default\": 20,\n      \"prefill\": 10\n    },\n    \"appIds\": {\n      \"title\": \"App IDs or URLs\",\n      \"type\": \"array\",\n      \"description\": \"Package names or Google Play app URLs to check for Events & offers (mode=events).\",\n      \"editor\": \"stringList\",\n      \"items\": {\n        \"type\": \"string\"\n      },\n      \"default\": [],\n      \"prefill\": [\n        \"com.supercell.clashofclans\"\n      ]\n    },\n    \"maxEventsPerApp\": {\n      \"title\": \"Max events per app\",\n      \"type\": \"integer\",\n      \"description\": \"Maximum Events & offers entries to return per app (1-50).\",\n      \"minimum\": 1,\n      \"maximum\": 50,\n      \"default\": 10,\n      \"prefill\": 3\n    }\n  },\n  \"required\": [\n    \"mode\"\n  ]\n}",
    "readme": "# Google Play Top Charts, Collections & Events Tracker\n\nTrack what is rising on Google Play: ranked top-chart entries, editorial placements and in-app live events. The actor reads public storefront pages and ranking data by country, language, section, device, chart and category, without a Google account, cookie or API key.\n\nUse it for ASO research, launch monitoring, category analysis, competitive placement checks and a daily snapshot of rank movement.\n\n## What this actor does\n\n- **Charts** — returns ranked apps from Top free, Top grossing and Top paid charts for a chosen market and category. Rankings go up to 200 places.\n- **Collections** — returns the editorial clusters shown on the Apps, Games and Kids pages: cluster title, subtitle, position, placement type and the ranked list of apps inside.\n- **Events** — returns the public \"Events & offers\" entries on an app page: event title, description, type, start and end dates, image and app context.\n- **Rank movement** — when you run the same chart twice, the second run adds the previous rank, the change and a movement label (`up`, `down`, `same`, `new`).\n- **Device-aware browsing** — watch faces and watch apps have their own charts and collections; tablet, TV, Chromebook and car pages have device-specific editorial collections.\n\n## Output\n\nEvery record includes `recordType`, `country`, `language`, `sourceUrl` and `scrapedAt` (UTC ISO). Empty fields are omitted instead of written as `null`.\n\n### Chart entries (`recordType: chartEntry`)\n\n`chart`, `chartLabel`, `rank`, `appId`, `title`, `developer`, `developerId`, `developerUrl`, `icon`, `rating`, `ratingText`, `ratingCount`, `reviewCount`, `price`, `currency`, `priceText`, `free`, `originalPrice`, `discountText`, `genre`, `installs`, `minInstalls`, `maxInstalls`, `contentRating`, `containsAds`, `offersIAP`, `IAPRange`, `version`, `updated`, `androidVersion`, `released`, `summary`, `headerImage`, `section`, `device`, `category`, `categoryName`, `appUrl`, `chartUrl`, `previousRank`, `rankChange`, `rankMovement`.\n\n`previousRank`, `rankChange` and `rankMovement` appear only after the same chart has been seen in an earlier run. `containsAds` and the app-page fields require **Enrich with app details**; without it, the chart row still carries the rank, title, developer, icon, rating, price, category and in-app purchase range.\n\n### Collections (`recordType: collection`)\n\n`clusterTitle`, `clusterSubtitle`, `clusterType` (`curated`, `earlyAccess`, `events`, `new`, `popular`), `clusterPosition`, `appCount`, `apps[]`, `pageUrl`.\n\nEach app inside `apps[]` has `position`, `appId`, `title`, `developer`, `icon`, `rating`, `genre`, `installs`, `contentRating`, `price`, `currency`, `priceText`, `free`, `offersIAP`, `IAPRange` and `appUrl`.\n\n### Events (`recordType: event`)\n\n`appId`, `appTitle`, `developer`, `icon`, `eventId`, `eventTitle`, `eventDescription`, `eventType`, `startDate`, `endDate`, `imageUrl`, `appUrl`, `eventUrl`.\n\n## Input\n\n| Field | Default | What it does |\n|---|---|---|\n| `mode` | `charts` | `charts`, `collections` or `events`. |\n| `country` | `us` | Storefront country. Changes ranks, prices, availability and which apps are shown. 57 markets are listed. |\n| `language` | `en` | Language for titles, genres, descriptions and event text. 33 languages are listed. |\n| `section` | `games` | `apps`, `games` or `kids`. It scopes the category list and the default all-content page. |\n| `device` | `phone` | `phone`, `tablet`, `tv`, `chromebook`, `watch` or `car`. Watch uses watch-face/watch-app charts; the other devices are used for device-specific collections. |\n| `chart` | `topFree` | `topFree`, `topGrossing` or `topPaid`. |\n| `category` | `all` | All categories, or one of 60 app, game, kids and watch categories. |\n| `maxRank` | `100` | Highest chart position to return, 1–200. |\n| `includeDetails` | `true` | Adds app-page fields (rating count, install range, developer ID/contact, version, update date, ads flag, summary). One extra request per chart row. |\n| `trackRankChanges` | `true` | Compares the chart with this actor's previous run for the same country, language, section, device, category and chart. |\n| `maxClusters` | `20` | Maximum editorial collections to return (1–80). |\n| `maxAppsPerCluster` | `20` | Maximum apps in each collection (1–60). |\n| `appIds` | `[]` | Package names or Google Play app links for `events` mode. |\n| `maxEventsPerApp` | `10` | Maximum events to return per app (1–50). |\n\n### Example: top free games in the United States\n\n```json\n{\n  \"mode\": \"charts\",\n  \"country\": \"us\",\n  \"language\": \"en\",\n  \"section\": \"games\",\n  \"chart\": \"topFree\",\n  \"category\": \"all\",\n  \"maxRank\": 50\n}\n```\n\n### Example: paid puzzle apps in the United Kingdom\n\n```json\n{\n  \"mode\": \"charts\",\n  \"country\": \"gb\",\n  \"language\": \"en\",\n  \"section\": \"games\",\n  \"device\": \"phone\",\n  \"chart\": \"topPaid\",\n  \"category\": \"GAME_PUZZLE\",\n  \"maxRank\": 100,\n  \"includeDetails\": true\n}\n```\n\n### Example: daily editorial placements for games\n\n```json\n{\n  \"mode\": \"collections\",\n  \"country\": \"us\",\n  \"language\": \"en\",\n  \"section\": \"games\",\n  \"maxClusters\": 10,\n  \"maxAppsPerCluster\": 20\n}\n```\n\n### Example: events on two games\n\n```json\n{\n  \"mode\": \"events\",\n  \"country\": \"us\",\n  \"language\": \"en\",\n  \"appIds\": [\"com.supercell.clashofclans\", \"com.roblox.client\"],\n  \"maxEventsPerApp\": 10\n}\n```\n\n## Use cases\n\n- Watch which apps enter, leave or move inside a country's Top free or Top paid chart.\n- Compare category strength before choosing an ASO keyword or launch market.\n- Track whether an app holds an editorial placement on the Apps or Games page.\n- Collect a publisher's chart footprint across markets and categories.\n- Monitor live events and offers for games or seasonal campaigns.\n- Build a daily ASO snapshot for dashboards, alerts or research notebooks.\n\n## Data source\n\nThe actor reads the public Google Play web storefront (`play.google.com`) and the chart list that the storefront loads for a category. Rankings, prices, genres and dates are shown in the storefront's own country and language settings. Event pages are public. No login, cookie or Google API key is used, and no proxy is needed.\n\n## Limitations\n\n- Google publishes **one shared ranking** for phone, tablet, TV, Chromebook and car; only watch-related categories have separate rankings. The `device` value is still recorded, and device-specific **collections** are available for tablet, TV, Chromebook and car.\n- Each chart is capped by Google at 200 entries. A category with fewer apps returns fewer rows.\n- Google localises titles, genres, prices and event text by `country` and `language`; two locales can show different names for the same app.\n- Rank movement needs the same chart configuration in a previous run. A first-ever run has no previous snapshot, so movement fields are omitted.\n- Editorial collections are whatever Google currently publishes. Google changes, adds and removes clusters without notice, and some pages have no collections in a given market.\n- Only apps with an \"Events & offers\" section return event rows. Many apps have none.\n- `containsAds` is shown only when the app page displays an ads label. Apps with no label omit the field rather than guessing.\n\n## FAQ\n\n**Do I need a Google account or API key?**\nNo. The actor uses public storefront pages and needs no credentials.\n\n**Can I track more than one country?**\nRun the actor once per country with a schedule, or call it from your own workflow. Each run writes rows for the selected market.\n\n**How do I get rank changes?**\nKeep `trackRankChanges` on and run the same country, language, section, device, category and chart again. The actor stores the last snapshot in its key-value store and adds `previousRank`, `rankChange` and `rankMovement` to the new rows.\n\n**Why did a chart return fewer than `maxRank` rows?**\nGoogle's category chart can be shorter than 200 entries in smaller markets or narrow categories.\n\n**Why are some fields missing on a chart row?**\nStore cards do not carry every app-page field. Turn on **Enrich with app details** to fill rating count, install range, developer contact, version, update date, summary and the ads label. Fields Google does not publish for an app are omitted, never invented.\n\n**Do collections include early access or pre-registration apps?**\nWhen Google shows an open-beta, \"Be the first to play\" or pre-registration cluster, it is returned as a collection with `clusterType: \"earlyAccess\"`.\n\n**Can I get events for apps that are not in a chart?**\nYes. `events` mode takes any package names or Play app links in `appIds`.\n\n**Does this actor work for all Google Play markets?**\n57 storefront countries and 33 languages are exposed. A market or category with no published chart for the selected combination returns an empty result with a status message.\n\n**Is this affiliated with Google?**\nNo. This is an independent tool that reads public Google Play pages and is not affiliated with or endorsed by Google.\n\n**Empty fields are omitted.** If Google does not provide a value for an app, the field is left out of that record instead of being filled with a placeholder.\n",
    "actorDefinition": {
      "actorSpecification": 1,
      "name": "google-play-charts",
      "title": "Google Play Top Charts, Collections & Events Tracker",
      "description": "Track Google Play top free, grossing and paid charts by country, category and device, plus editorial collections and in-app live events. Returns ranks, app metadata, pricing, ratings, in-app purchase signals and rank movement between runs.",
      "version": "1.0",
      "buildTag": "latest",
      "dockerfile": "./Dockerfile",
      "readme": "# Google Play Top Charts, Collections & Events Tracker\n\nTrack what is rising on Google Play: ranked top-chart entries, editorial placements and in-app live events. The actor reads public storefront pages and ranking data by country, language, section, device, chart and category, without a Google account, cookie or API key.\n\nUse it for ASO research, launch monitoring, category analysis, competitive placement checks and a daily snapshot of rank movement.\n\n## What this actor does\n\n- **Charts** — returns ranked apps from Top free, Top grossing and Top paid charts for a chosen market and category. Rankings go up to 200 places.\n- **Collections** — returns the editorial clusters shown on the Apps, Games and Kids pages: cluster title, subtitle, position, placement type and the ranked list of apps inside.\n- **Events** — returns the public \"Events & offers\" entries on an app page: event title, description, type, start and end dates, image and app context.\n- **Rank movement** — when you run the same chart twice, the second run adds the previous rank, the change and a movement label (`up`, `down`, `same`, `new`).\n- **Device-aware browsing** — watch faces and watch apps have their own charts and collections; tablet, TV, Chromebook and car pages have device-specific editorial collections.\n\n## Output\n\nEvery record includes `recordType`, `country`, `language`, `sourceUrl` and `scrapedAt` (UTC ISO). Empty fields are omitted instead of written as `null`.\n\n### Chart entries (`recordType: chartEntry`)\n\n`chart`, `chartLabel`, `rank`, `appId`, `title`, `developer`, `developerId`, `developerUrl`, `icon`, `rating`, `ratingText`, `ratingCount`, `reviewCount`, `price`, `currency`, `priceText`, `free`, `originalPrice`, `discountText`, `genre`, `installs`, `minInstalls`, `maxInstalls`, `contentRating`, `containsAds`, `offersIAP`, `IAPRange`, `version`, `updated`, `androidVersion`, `released`, `summary`, `headerImage`, `section`, `device`, `category`, `categoryName`, `appUrl`, `chartUrl`, `previousRank`, `rankChange`, `rankMovement`.\n\n`previousRank`, `rankChange` and `rankMovement` appear only after the same chart has been seen in an earlier run. `containsAds` and the app-page fields require **Enrich with app details**; without it, the chart row still carries the rank, title, developer, icon, rating, price, category and in-app purchase range.\n\n### Collections (`recordType: collection`)\n\n`clusterTitle`, `clusterSubtitle`, `clusterType` (`curated`, `earlyAccess`, `events`, `new`, `popular`), `clusterPosition`, `appCount`, `apps[]`, `pageUrl`.\n\nEach app inside `apps[]` has `position`, `appId`, `title`, `developer`, `icon`, `rating`, `genre`, `installs`, `contentRating`, `price`, `currency`, `priceText`, `free`, `offersIAP`, `IAPRange` and `appUrl`.\n\n### Events (`recordType: event`)\n\n`appId`, `appTitle`, `developer`, `icon`, `eventId`, `eventTitle`, `eventDescription`, `eventType`, `startDate`, `endDate`, `imageUrl`, `appUrl`, `eventUrl`.\n\n## Input\n\n| Field | Default | What it does |\n|---|---|---|\n| `mode` | `charts` | `charts`, `collections` or `events`. |\n| `country` | `us` | Storefront country. Changes ranks, prices, availability and which apps are shown. 57 markets are listed. |\n| `language` | `en` | Language for titles, genres, descriptions and event text. 33 languages are listed. |\n| `section` | `games` | `apps`, `games` or `kids`. It scopes the category list and the default all-content page. |\n| `device` | `phone` | `phone`, `tablet`, `tv`, `chromebook`, `watch` or `car`. Watch uses watch-face/watch-app charts; the other devices are used for device-specific collections. |\n| `chart` | `topFree` | `topFree`, `topGrossing` or `topPaid`. |\n| `category` | `all` | All categories, or one of 60 app, game, kids and watch categories. |\n| `maxRank` | `100` | Highest chart position to return, 1–200. |\n| `includeDetails` | `true` | Adds app-page fields (rating count, install range, developer ID/contact, version, update date, ads flag, summary). One extra request per chart row. |\n| `trackRankChanges` | `true` | Compares the chart with this actor's previous run for the same country, language, section, device, category and chart. |\n| `maxClusters` | `20` | Maximum editorial collections to return (1–80). |\n| `maxAppsPerCluster` | `20` | Maximum apps in each collection (1–60). |\n| `appIds` | `[]` | Package names or Google Play app links for `events` mode. |\n| `maxEventsPerApp` | `10` | Maximum events to return per app (1–50). |\n\n### Example: top free games in the United States\n\n```json\n{\n  \"mode\": \"charts\",\n  \"country\": \"us\",\n  \"language\": \"en\",\n  \"section\": \"games\",\n  \"chart\": \"topFree\",\n  \"category\": \"all\",\n  \"maxRank\": 50\n}\n```\n\n### Example: paid puzzle apps in the United Kingdom\n\n```json\n{\n  \"mode\": \"charts\",\n  \"country\": \"gb\",\n  \"language\": \"en\",\n  \"section\": \"games\",\n  \"device\": \"phone\",\n  \"chart\": \"topPaid\",\n  \"category\": \"GAME_PUZZLE\",\n  \"maxRank\": 100,\n  \"includeDetails\": true\n}\n```\n\n### Example: daily editorial placements for games\n\n```json\n{\n  \"mode\": \"collections\",\n  \"country\": \"us\",\n  \"language\": \"en\",\n  \"section\": \"games\",\n  \"maxClusters\": 10,\n  \"maxAppsPerCluster\": 20\n}\n```\n\n### Example: events on two games\n\n```json\n{\n  \"mode\": \"events\",\n  \"country\": \"us\",\n  \"language\": \"en\",\n  \"appIds\": [\"com.supercell.clashofclans\", \"com.roblox.client\"],\n  \"maxEventsPerApp\": 10\n}\n```\n\n## Use cases\n\n- Watch which apps enter, leave or move inside a country's Top free or Top paid chart.\n- Compare category strength before choosing an ASO keyword or launch market.\n- Track whether an app holds an editorial placement on the Apps or Games page.\n- Collect a publisher's chart footprint across markets and categories.\n- Monitor live events and offers for games or seasonal campaigns.\n- Build a daily ASO snapshot for dashboards, alerts or research notebooks.\n\n## Data source\n\nThe actor reads the public Google Play web storefront (`play.google.com`) and the chart list that the storefront loads for a category. Rankings, prices, genres and dates are shown in the storefront's own country and language settings. Event pages are public. No login, cookie or Google API key is used, and no proxy is needed.\n\n## Limitations\n\n- Google publishes **one shared ranking** for phone, tablet, TV, Chromebook and car; only watch-related categories have separate rankings. The `device` value is still recorded, and device-specific **collections** are available for tablet, TV, Chromebook and car.\n- Each chart is capped by Google at 200 entries. A category with fewer apps returns fewer rows.\n- Google localises titles, genres, prices and event text by `country` and `language`; two locales can show different names for the same app.\n- Rank movement needs the same chart configuration in a previous run. A first-ever run has no previous snapshot, so movement fields are omitted.\n- Editorial collections are whatever Google currently publishes. Google changes, adds and removes clusters without notice, and some pages have no collections in a given market.\n- Only apps with an \"Events & offers\" section return event rows. Many apps have none.\n- `containsAds` is shown only when the app page displays an ads label. Apps with no label omit the field rather than guessing.\n\n## FAQ\n\n**Do I need a Google account or API key?**\nNo. The actor uses public storefront pages and needs no credentials.\n\n**Can I track more than one country?**\nRun the actor once per country with a schedule, or call it from your own workflow. Each run writes rows for the selected market.\n\n**How do I get rank changes?**\nKeep `trackRankChanges` on and run the same country, language, section, device, category and chart again. The actor stores the last snapshot in its key-value store and adds `previousRank`, `rankChange` and `rankMovement` to the new rows.\n\n**Why did a chart return fewer than `maxRank` rows?**\nGoogle's category chart can be shorter than 200 entries in smaller markets or narrow categories.\n\n**Why are some fields missing on a chart row?**\nStore cards do not carry every app-page field. Turn on **Enrich with app details** to fill rating count, install range, developer contact, version, update date, summary and the ads label. Fields Google does not publish for an app are omitted, never invented.\n\n**Do collections include early access or pre-registration apps?**\nWhen Google shows an open-beta, \"Be the first to play\" or pre-registration cluster, it is returned as a collection with `clusterType: \"earlyAccess\"`.\n\n**Can I get events for apps that are not in a chart?**\nYes. `events` mode takes any package names or Play app links in `appIds`.\n\n**Does this actor work for all Google Play markets?**\n57 storefront countries and 33 languages are exposed. A market or category with no published chart for the selected combination returns an empty result with a status message.\n\n**Is this affiliated with Google?**\nNo. This is an independent tool that reads public Google Play pages and is not affiliated with or endorsed by Google.\n\n**Empty fields are omitted.** If Google does not provide a value for an app, the field is left out of that record instead of being filled with a placeholder.\n",
      "input": {
        "title": "Google Play Top Charts, Collections & Events Input",
        "description": "Choose charts, editorial collections or live events for a Google Play market.",
        "type": "object",
        "schemaVersion": 1,
        "properties": {
          "mode": {
            "title": "Mode",
            "type": "string",
            "description": "What to collect: ranked charts, editorial collections, or in-app events.",
            "editor": "select",
            "enum": [
              "charts",
              "collections",
              "events"
            ],
            "enumTitles": [
              "Top charts (ranked apps)",
              "Editorial collections",
              "In-app events & offers"
            ],
            "default": "charts",
            "prefill": "charts"
          },
          "country": {
            "title": "Country",
            "type": "string",
            "description": "Google Play storefront country. Affects chart rankings, prices and availability.",
            "editor": "select",
            "enum": [
              "us",
              "gb",
              "ca",
              "au",
              "nz",
              "ie",
              "in",
              "de",
              "fr",
              "es",
              "it",
              "nl",
              "be",
              "at",
              "ch",
              "se",
              "no",
              "dk",
              "fi",
              "pl",
              "pt",
              "cz",
              "ro",
              "hu",
              "gr",
              "tr",
              "ru",
              "ua",
              "za",
              "eg",
              "ng",
              "ke",
              "id",
              "th",
              "vn",
              "ph",
              "my",
              "sg",
              "tw",
              "hk",
              "jp",
              "kr",
              "br",
              "mx",
              "ar",
              "cl",
              "co",
              "pe",
              "il",
              "ae",
              "sa",
              "pk",
              "bd",
              "lk",
              "kh",
              "mm",
              "kz"
            ],
            "enumTitles": [
              "United States",
              "United Kingdom",
              "Canada",
              "Australia",
              "New Zealand",
              "Ireland",
              "India",
              "Germany",
              "France",
              "Spain",
              "Italy",
              "Netherlands",
              "Belgium",
              "Austria",
              "Switzerland",
              "Sweden",
              "Norway",
              "Denmark",
              "Finland",
              "Poland",
              "Portugal",
              "Czechia",
              "Romania",
              "Hungary",
              "Greece",
              "Türkiye",
              "Russia",
              "Ukraine",
              "South Africa",
              "Egypt",
              "Nigeria",
              "Kenya",
              "Indonesia",
              "Thailand",
              "Vietnam",
              "Philippines",
              "Malaysia",
              "Singapore",
              "Taiwan",
              "Hong Kong",
              "Japan",
              "South Korea",
              "Brazil",
              "Mexico",
              "Argentina",
              "Chile",
              "Colombia",
              "Peru",
              "Israel",
              "United Arab Emirates",
              "Saudi Arabia",
              "Pakistan",
              "Bangladesh",
              "Sri Lanka",
              "Cambodia",
              "Myanmar",
              "Kazakhstan"
            ],
            "default": "us",
            "prefill": "us"
          },
          "language": {
            "title": "Language",
            "type": "string",
            "description": "Language for app titles, genres and event text.",
            "editor": "select",
            "enum": [
              "en",
              "es",
              "fr",
              "de",
              "it",
              "pt",
              "ja",
              "ko",
              "zh",
              "ru",
              "ar",
              "hi",
              "th",
              "vi",
              "id",
              "tr",
              "pl",
              "nl",
              "sv",
              "da",
              "no",
              "fi",
              "cs",
              "ro",
              "hu",
              "el",
              "he",
              "uk",
              "ms",
              "tl",
              "bn",
              "ur",
              "fa"
            ],
            "enumTitles": [
              "English",
              "Spanish",
              "French",
              "German",
              "Italian",
              "Portuguese",
              "Japanese",
              "Korean",
              "Chinese",
              "Russian",
              "Arabic",
              "Hindi",
              "Thai",
              "Vietnamese",
              "Indonesian",
              "Turkish",
              "Polish",
              "Dutch",
              "Swedish",
              "Danish",
              "Norwegian",
              "Finnish",
              "Czech",
              "Romanian",
              "Hungarian",
              "Greek",
              "Hebrew",
              "Ukrainian",
              "Malay",
              "Filipino",
              "Bengali",
              "Urdu",
              "Persian"
            ],
            "default": "en",
            "prefill": "en"
          },
          "section": {
            "title": "Store section",
            "type": "string",
            "description": "Apps, games or kid-friendly content. Category options are filtered by this section in the code.",
            "editor": "select",
            "enum": [
              "apps",
              "games",
              "kids"
            ],
            "enumTitles": [
              "Apps",
              "Games",
              "Kids"
            ],
            "default": "games",
            "prefill": "games"
          },
          "device": {
            "title": "Device",
            "type": "string",
            "description": "Store surface. Watch charts use watch-face/watch-app categories; collections use the device-specific App Store home. Google publishes one shared ranking for phone, tablet, TV, Chromebook and car.",
            "editor": "select",
            "enum": [
              "phone",
              "tablet",
              "tv",
              "chromebook",
              "watch",
              "car"
            ],
            "enumTitles": [
              "Phone",
              "Tablet",
              "TV",
              "Chromebook",
              "Watch",
              "Car"
            ],
            "default": "phone",
            "prefill": "phone"
          },
          "chart": {
            "title": "Chart",
            "type": "string",
            "description": "Which top chart to read.",
            "editor": "select",
            "enum": [
              "topFree",
              "topGrossing",
              "topPaid"
            ],
            "enumTitles": [
              "Top free",
              "Top grossing",
              "Top paid"
            ],
            "default": "topFree",
            "prefill": "topFree"
          },
          "category": {
            "title": "Category",
            "type": "string",
            "description": "Category to read. \"All categories\" uses the section default: all apps, all games or kids.",
            "editor": "select",
            "enum": [
              "all",
              "APPLICATION",
              "GAME",
              "ART_AND_DESIGN",
              "AUTO_AND_VEHICLES",
              "BEAUTY",
              "BOOKS_AND_REFERENCE",
              "BUSINESS",
              "COMICS",
              "COMMUNICATION",
              "DATING",
              "EDUCATION",
              "ENTERTAINMENT",
              "EVENTS",
              "FINANCE",
              "FOOD_AND_DRINK",
              "HEALTH_AND_FITNESS",
              "HOUSE_AND_HOME",
              "LIBRARIES_AND_DEMO",
              "LIFESTYLE",
              "MAPS_AND_NAVIGATION",
              "MEDICAL",
              "MUSIC_AND_AUDIO",
              "NEWS_AND_MAGAZINES",
              "PARENTING",
              "PERSONALIZATION",
              "PHOTOGRAPHY",
              "PRODUCTIVITY",
              "SHOPPING",
              "SOCIAL",
              "SPORTS",
              "TOOLS",
              "TRAVEL_AND_LOCAL",
              "VIDEO_PLAYERS",
              "WEATHER",
              "GAME_ACTION",
              "GAME_ADVENTURE",
              "GAME_ARCADE",
              "GAME_BOARD",
              "GAME_CARD",
              "GAME_CASINO",
              "GAME_CASUAL",
              "GAME_EDUCATIONAL",
              "GAME_MUSIC",
              "GAME_PUZZLE",
              "GAME_RACING",
              "GAME_ROLE_PLAYING",
              "GAME_SIMULATION",
              "GAME_SPORTS",
              "GAME_STRATEGY",
              "GAME_TRIVIA",
              "GAME_WORD",
              "FAMILY",
              "FAMILY_ACTION",
              "FAMILY_BRAINGAMES",
              "FAMILY_CREATE",
              "FAMILY_EDUCATION",
              "FAMILY_MUSICVIDEO",
              "FAMILY_PRETEND",
              "WATCH_FACE",
              "ANDROID_WEAR"
            ],
            "enumTitles": [
              "All categories",
              "All apps",
              "All games",
              "Art & design",
              "Auto & vehicles",
              "Beauty",
              "Books & reference",
              "Business",
              "Comics",
              "Communication",
              "Dating",
              "Education",
              "Entertainment",
              "Events",
              "Finance",
              "Food & drink",
              "Health & fitness",
              "House & home",
              "Libraries & demo",
              "Lifestyle",
              "Maps & navigation",
              "Medical",
              "Music & audio",
              "News & magazines",
              "Parenting",
              "Personalization",
              "Photography",
              "Productivity",
              "Shopping",
              "Social",
              "Sports",
              "Tools",
              "Travel & local",
              "Video players",
              "Weather",
              "Action",
              "Adventure",
              "Arcade",
              "Board",
              "Card",
              "Casino",
              "Casual",
              "Educational",
              "Music",
              "Puzzle",
              "Racing",
              "Role playing",
              "Simulation",
              "Sports",
              "Strategy",
              "Trivia",
              "Word",
              "Kids",
              "Kids action",
              "Kids brain games",
              "Kids create",
              "Kids education",
              "Kids music & video",
              "Kids pretend play",
              "Watch faces",
              "Watch apps"
            ],
            "default": "all",
            "prefill": "all"
          },
          "maxRank": {
            "title": "Max rank",
            "type": "integer",
            "description": "Highest chart position to return (1-200). Google publishes up to 200 ranked entries per chart.",
            "minimum": 1,
            "maximum": 200,
            "default": 100,
            "prefill": 1
          },
          "includeDetails": {
            "title": "Enrich with app details",
            "type": "boolean",
            "description": "Fetch each app page for rating count, installs range, developer ID/contact, version, update date, ads flag and summary. Adds one request per chart row.",
            "default": true,
            "prefill": false
          },
          "trackRankChanges": {
            "title": "Track rank changes",
            "type": "boolean",
            "description": "Compare this run with the actor's previous run for the same country, section, device, category and chart. Adds previousRank, rankChange and rankMovement.",
            "default": true,
            "prefill": true
          },
          "maxClusters": {
            "title": "Max collections",
            "type": "integer",
            "description": "Maximum editorial collections to return in collections mode (1-80).",
            "minimum": 1,
            "maximum": 80,
            "default": 20,
            "prefill": 3
          },
          "maxAppsPerCluster": {
            "title": "Max apps per collection",
            "type": "integer",
            "description": "Maximum apps to include in each editorial collection (1-60).",
            "minimum": 1,
            "maximum": 60,
            "default": 20,
            "prefill": 10
          },
          "appIds": {
            "title": "App IDs or URLs",
            "type": "array",
            "description": "Package names or Google Play app URLs to check for Events & offers (mode=events).",
            "editor": "stringList",
            "items": {
              "type": "string"
            },
            "default": [],
            "prefill": [
              "com.supercell.clashofclans"
            ]
          },
          "maxEventsPerApp": {
            "title": "Max events per app",
            "type": "integer",
            "description": "Maximum Events & offers entries to return per app (1-50).",
            "minimum": 1,
            "maximum": 50,
            "default": 10,
            "prefill": 3
          }
        },
        "required": [
          "mode"
        ]
      },
      "output": {
        "actorOutputSchemaVersion": 1,
        "title": "Google Play Charts Output",
        "description": "Google Play chart entries, editorial collections and in-app events.",
        "properties": {
          "items": {
            "type": "string",
            "title": "Google Play chart data",
            "description": "Dataset containing Google Play chart entries, collections and events.",
            "template": "{{links.apiDefaultDatasetUrl}}/items"
          }
        }
      },
      "storages": {
        "dataset": {
          "actorSpecification": 1,
          "views": {
            "overview": {
              "title": "Chart entries",
              "transformation": {
                "fields": [
                  "rank",
                  "title",
                  "developer",
                  "categoryName",
                  "chart",
                  "country",
                  "rating",
                  "price"
                ]
              },
              "display": {
                "component": "table",
                "properties": {}
              }
            }
          }
        }
      },
      "environmentVariables": {}
    },
    "buildNumber": "1.0.6",
    "imageDigest": "6763e4a9a636548703cc3c1645d92620183448bc4d05575dd255612c87f66e5c",
    "actVersion": {
      "sourceType": "SOURCE_FILES",
      "buildTag": "latest",
      "versionNumber": "1.0"
    },
    "usage": {
      "ACTOR_COMPUTE_UNITS": 0.0031333333333333335
    }
  }
}