# App Store Top Charts Tracker (`saint_person/app-store-top-charts-tracker`) Actor Compare Apple App Store top free/paid app charts across multiple countries in one run - top apps, publishers, and category mix, ranked side by side. - **URL**: https://apify.com/saint\_person/app-store-top-charts-tracker.md - **Developed by:** [saint person](https://apify.com/saint_person) (community) - **Categories:** Business - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing Pay per event This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## ๐Ÿ“ฑ App Store Top Charts Tracker > ๐Ÿš€ **Compare App Store top charts across countries in one run.** Top apps, publisher concentration, and freshness - not a single-market top-20 dump. > ๐Ÿ•’ **Last updated:** 2026-07-11 ยท ๐Ÿ“Š **8 fields** per country ยท Built on Apple's official marketing-tools feed (no key) > ๐ŸŽ **Try it free:** the free Apify plan returns up to **10 results per run** - enough to see the output quality. Any paid Apify plan unlocks full-size runs. Give it a list of countries and it pulls Apple's official Top Free (or Top Paid) App Store chart for each, then computes how concentrated the chart is (unique publishers among the top apps) and how fresh it is (apps released in the last 30 days) - so you can see India's or Brazil's chart landscape without opening the App Store five times. | ๐ŸŽฏ Target Audience | ๐Ÿ’ก Primary Use Cases | | --- | --- | | App marketers, ASO consultants, investors/analysts, competitive intelligence teams | Cross-market app landscape research, competitor monitoring, launch-market selection, ASO strategy | --- ### ๐Ÿ“‹ What this Actor does - Fetches Apple's official Top Free/Paid chart per country you list - Counts unique publishers among the sampled apps (chart concentration signal) - Flags apps released in the last 30 days (chart freshness/volatility signal) - Returns the #1 app, publisher, and a ranked sample list > ๐Ÿ’ก **Why it matters:** a chart dominated by 5 publishers tells a very different story than one with 20 different publishers - concentration is a market signal raw rankings don't show. --- ### ๐ŸŽฌ Full demo ๐Ÿšง Video walkthrough coming soon - the Quick Start below takes under 3 minutes end to end. --- ### โš™๏ธ Input | Input | Type | Default | Behavior | | --- | --- | --- | --- | | `countries` | string | (prefilled) | Comma-separated ISO country codes, up to 10 | | `chart` | string | top-free | "top-free" or "top-paid" | | `maxResults` | integer | 20 | Apps sampled per country (5-100) | **Example: Compare 5 major markets** ```json { "countries": "us, gb, jp, de, br", "chart": "top-free", "maxResults": 20 } ```` **Example: Paid-app landscape in two markets** ```json { "countries": "us, gb", "chart": "top-paid", "maxResults": 30 } ``` > โš ๏ธ **Good to know:** country codes are lowercase ISO 3166-1 alpha-2 (e.g. "us", not "US" - though the Actor normalizes case for you). *** ### ๐Ÿ“Š Output Each country returns **8 fields**. Download as CSV, Excel, JSON, or XML, or consume via the Apify API. #### ๐Ÿงพ Schema | Field | Type | Example | | --- | --- | --- | | country / chart | string | us / top-free | | appsSampled | integer | 20 | | topApp / topPublisher | string | ChatGPT / OpenAI OpCo, LLC | | uniquePublishers | integer | 18 | | newInLast30DaysCount | integer | 0 | | sampleApps | array | \["ChatGPT", "Threads"] | | generatedAt | string | 2026-07-11T00:01:07Z | #### ๐Ÿ“ฆ Sample record ```json {"country":"us","chart":"top-free","appsSampled":20,"topApp":"ChatGPT","topPublisher":"OpenAI OpCo, LLC","uniquePublishers":18,"newInLast30DaysCount":0,"sampleApps":["ChatGPT","Threads"],"generatedAt":"2026-07-11T00:01:07Z"} ``` *** ### โœจ Why choose this Actor | | Capability | | --- | --- | | ๐Ÿ† | **Concentration, not just rank.** Publisher-diversity and freshness signals, not a raw top-20 list. | | ๐ŸŒ | **Multi-country in one run.** Compare up to 10 markets side by side. | | โšก | **Built on Apple's official feed.** No scraping, no key - stable and durable. | | ๐Ÿ” | **Automatic retries.** Transient failures retry with backoff. | | ๐Ÿ’ณ | **Pay per result.** No subscription. A typical 5-country run costs about $0.035. | > ๐Ÿ“Š Turns 5 manual App Store checks into 1 ranked table. *** ### ๐Ÿ“ˆ How it compares to alternatives | Approach | Cost | Coverage | Refresh | Setup | | --- | --- | --- | --- | --- | | **โญ App Store Top Charts Tracker** *(this Actor)* | $5 free credit, then pay-per-use | Any country, up to 10 per run | **Live per run** | โšก 2 min | | Browsing the App Store manually | Free | One country at a time | Live | ๐Ÿข Manual, one by one | | ASO SaaS platforms | $50-300+/mo subscription | Broad | Live | ๐Ÿข Sales call + onboarding | | Manual copy-paste | Free | Current session only | One-shot | ๐Ÿข Hours of clicking | Pick this Actor when you want a ranked, multi-market chart view without a subscription. *** ### ๐Ÿš€ How to use 1. ๐Ÿ“ **Sign up.** Create a free Apify account with $5 credit (takes 2 minutes). 2. ๐ŸŒ **Open the Actor.** Go to the App Store Top Charts Tracker page on the Apify Store. 3. โœ๏ธ **Set your input.** List your countries - or just press Start, the prefilled example works. 4. ๐Ÿš€ **Run it.** Watch results stream into the Dataset tab. 5. ๐Ÿ“ฅ **Download.** Grab results as CSV, Excel, JSON, or XML - or pipe them anywhere via the Apify API. > โฑ๏ธ Total time from signup to downloaded dataset: **3-5 minutes.** No coding required. *** ### ๐Ÿ’ผ Business use cases - **App marketers:** scout which markets have the least concentrated (most winnable) charts. - **ASO consultants:** back a market-entry recommendation with real chart data. - **Investors/analysts:** track which publishers dominate mobile in which regions. - **Competitive intelligence:** monitor competitor app rank across your target markets. *** ### ๐ŸŒŸ Beyond business use cases - ๐ŸŽ“ **Research & academia** - mobile market studies, digital economy research. - ๐ŸŽจ **Personal & creative** - content research for an app-review blog or newsletter. - ๐Ÿค **Non-profit & civic** - track public-sector app adoption (e.g. government apps trending). - ๐Ÿงช **Experimentation** - prototype an app-market dashboard on real data. *** ### ๐Ÿ”Œ Automating App Store Top Charts Tracker **Node.js** (`apify-client` on NPM): ```javascript const { ApifyClient } = require('apify-client'); const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' }); const run = await client.actor('saint_person/app-store-top-charts-tracker').call({ countries: "us, gb, jp", chart: "top-free", maxResults: 20 }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); ``` **Python** (`apify-client` on PyPI): ```python from apify_client import ApifyClient client = ApifyClient('YOUR_APIFY_TOKEN') run = client.actor('saint_person/app-store-top-charts-tracker').call(run_input={"countries": "us, gb, jp", "chart": "top-free", "maxResults": 20}) items = client.dataset(run['defaultDatasetId']).list_items().items ``` ๐Ÿ“š [Full Apify API documentation](https://docs.apify.com/api/v2) [Apify Schedules](https://docs.apify.com/platform/schedules) triggers this Actor on any cron interval - daily for a standing multi-market chart watch. *** ### ๐Ÿง  Use via MCP (for AI agents) App Store Top Charts Tracker is directly callable by any MCP-compatible AI agent (Claude, ChatGPT, Cursor, and others) through Apify's hosted MCP server - no custom integration code needed. ```json { "mcpServers": { "apify": { "url": "https://mcp.apify.com/sse?actors=saint_person/app-store-top-charts-tracker", "headers": { "Authorization": "Bearer YOUR_APIFY_TOKEN" } } } } ``` Once connected, just ask your agent something like: *"Use the App Store Top Charts Tracker Actor to tell me which of these 5 countries has the most fragmented top-apps chart."* ๐Ÿ“š [Apify MCP server docs](https://docs.apify.com/platform/integrations/mcp) *** ### ๐Ÿค– Ask an AI assistant about this Actor - ๐Ÿ’ฌ [**ChatGPT**](https://chat.openai.com/?q=How%20do%20I%20use%20the%20App%20Store%20Top%20Charts%20Tracker%20on%20Apify%3F) - ๐Ÿง  [**Claude**](https://claude.ai/new?q=How%20do%20I%20use%20the%20App%20Store%20Top%20Charts%20Tracker%20on%20Apify%3F) - ๐Ÿ” [**Perplexity**](https://perplexity.ai/search?q=How%20do%20I%20use%20the%20App%20Store%20Top%20Charts%20Tracker%20on%20Apify%3F) *** ### โ“ Frequently Asked Questions #### ๐Ÿงฉ How does it work? It calls Apple's official marketing-tools top-charts feed per country, then computes publisher diversity and recent-release counts across the sample. #### Does this cover Google Play too? Not currently - Google doesn't publish an equivalent official, unauthenticated top-charts feed. This Actor is Apple App Store only. #### What does "uniquePublishers" tell me? A lower number means fewer companies dominate that market's chart (more concentrated/competitive at the top); a higher number means a more fragmented, open chart. #### โฐ Can I schedule regular runs? Yes. Use Apify Schedules to run this Actor on any cron interval. #### โš–๏ธ Is this data legal to collect? This Actor only collects data that is publicly accessible via Apple's official feed. No login, no bypass of access controls. #### ๐Ÿ’ณ Do I need a paid Apify plan? No. The free Apify plan is enough for testing and small runs. #### ๐Ÿ” What happens if a run fails? Transient errors retry automatically with backoff. If a run still fails, the log explains exactly why. #### ๐Ÿ†˜ What if I need help? Open an issue on this Actor's Issues tab. *** ### ๐Ÿ”Œ Integrate with any app - [**Zapier**](https://docs.apify.com/platform/integrations/zapier) - [**Make**](https://docs.apify.com/platform/integrations/make) - [**n8n**](https://docs.apify.com/platform/integrations) - [**Google Sheets**](https://docs.apify.com/platform/integrations/drive) - [**Slack**](https://docs.apify.com/platform/integrations/slack) - [**Gmail**](https://docs.apify.com/platform/integrations/gmail) - [**Webhooks**](https://docs.apify.com/platform/integrations/webhooks) - [**MCP**](https://docs.apify.com/platform/integrations/mcp) *** ### ๐Ÿ”— Recommended Actors Pairs well with [YouTube Trending Video Momentum Tracker](https://apify.com/saint_person/youtube-trending-video-tracker) for a fuller cross-platform mainstream attention picture. > ๐Ÿ’ก **Pro tip:** browse the complete [saint\_person collection](https://apify.com/saint_person) for more tools like this. *** ### ๐Ÿ†˜ Help & custom requests - ๐Ÿ› **Something not working?** Open an issue on this Actor's **Issues tab**. - ๐Ÿ› ๏ธ **Need a custom feature or a different data source?** Open an issue describing what you need. *** > **โš ๏ธ Disclaimer:** this Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by Apple Inc. All trademarks are the property of their respective owners. Only publicly available data is collected. # Actor input Schema ## `countries` (type: `string`): Comma-separated ISO 3166-1 alpha-2 country codes to compare (up to 10), lowercase, e.g. 'us, gb, jp, de, br'. Works out of the box with the prefilled example. ## `chart` (type: `string`): Which official Apple chart to pull. ## `maxResults` (type: `integer`): How many top-chart apps to sample per country. Controls your cost: you pay per country profile returned. ## Actor input object example ```json { "countries": "us, gb, jp, de, br", "chart": "top-free", "maxResults": 20 } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "countries": "us, gb, jp, de, br" }; // Run the Actor and wait for it to finish const run = await client.actor("saint_person/app-store-top-charts-tracker").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "countries": "us, gb, jp, de, br" } # Run the Actor and wait for it to finish run = client.actor("saint_person/app-store-top-charts-tracker").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "countries": "us, gb, jp, de, br" }' | apify call saint_person/app-store-top-charts-tracker --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=saint_person/app-store-top-charts-tracker", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "App Store Top Charts Tracker", "description": "Compare Apple App Store top free/paid app charts across multiple countries in one run - top apps, publishers, and category mix, ranked side by side.", "version": "1.0", "x-build-id": "C1DBQZLqmIvWXsiQW" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/saint_person~app-store-top-charts-tracker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-saint_person-app-store-top-charts-tracker", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/saint_person~app-store-top-charts-tracker/runs": { "post": { "operationId": "runs-sync-saint_person-app-store-top-charts-tracker", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/saint_person~app-store-top-charts-tracker/run-sync": { "post": { "operationId": "run-sync-saint_person-app-store-top-charts-tracker", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "countries" ], "properties": { "countries": { "title": "Country codes", "type": "string", "description": "Comma-separated ISO 3166-1 alpha-2 country codes to compare (up to 10), lowercase, e.g. 'us, gb, jp, de, br'. Works out of the box with the prefilled example." }, "chart": { "title": "Chart type", "enum": [ "top-free", "top-paid" ], "type": "string", "description": "Which official Apple chart to pull.", "default": "top-free" }, "maxResults": { "title": "Apps sampled per country", "minimum": 5, "maximum": 100, "type": "integer", "description": "How many top-chart apps to sample per country. Controls your cost: you pay per country profile returned.", "default": 20 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```