App Store Top Charts Scraper by Country

📱 App Store Top Charts Scraper by Country

Scrape App Store top charts by country and category: rank, app, developer and rank movement. Run it once and you get the current records as a dataset — that is the default. Turn on watch mode and a scheduled run returns only what changed since the last run (see Optional: run it on a schedule). Built by NexGen Watch on Apify.

Growth and ASO teams pay for stable chart snapshots and position-change alerts by market — a reliable daily read on where apps sit in Apple's top charts.

Use cases by team

• Growth: Track where you and competitors rank in top-free / top-paid charts each day.
• ASO teams: Correlate ranking movement with metadata and keyword changes.
• Market intel: Spot new entrants breaking into a category's top chart.
• Leadership: Get a clean daily ranking snapshot for the standup without manual checks.

Output is one None row per result; billing is pay-per-event, the value event being one ranking snapshot (a $0.02 start fee per run, then $0.002 per ranking snapshot). Source: play.google.com.

No login, no API key and no CAPTCHA solving are involved: the source is read logged-out.

📊 Sample Output

Real rows from run NUDaWivkwwkhHhrMX on build 0.1.24 (2026-09-28), the same input as the Quick start below — every value is as the source published it (emails masked, long text shortened):

chart	app_id	title	developer	category	snapshot_at
top-free	6761538521	StoryReel: Drama Shorts & TV	Equinox Enterprises‌ Technology Limited		2026-09-28T04:09:48.814919+00:00
top-free	518684914	Depop - Buy & Sell Clothes	Depop Ltd	Shopping	2026-09-28T04:09:48.814921+00:00
top-free	6741796873	TikTok Pro - Events	TikTok Ltd.	Entertainment	2026-09-28T04:09:48.814923+00:00
top-free	6447582581	Netflix Game Controller	Netflix, Inc.	Entertainment	2026-09-28T04:09:48.814926+00:00
top-free	1193350206	YouTube TV	Google	Entertainment	2026-09-28T04:09:48.814928+00:00
top-free	905401434	Fubo: Watch Live TV & Sports	fuboTV Inc.	Entertainment	2026-09-28T04:09:48.814930+00:00
top-free	530168168	Paramount+	CBS Interactive	Entertainment	2026-09-28T04:09:48.814932+00:00
top-free	6477489729	Google Gemini	Google	Productivity	2026-09-28T04:09:48.814934+00:00

The run finished with the status message: SUCCEEDED: emitted 25 item(s)

✅ What you get

Each row is flat JSON with these fields (from the dataset schema and the sample run; a field the source does not publish for a given row is null):

• store (string/null) — Output field: store
• country (string/null) — Output field: country
• chart (string/null) — Output field: chart
• position (number/null) — Output field: position
• app_id (string/null) — Output field: app_id
• title (string/null) — Output field: title
• developer (string/null) — Output field: developer
• category (string/null) — Output field: category
• icon_url (string/null) — Output field: icon_url
• source_url (string/null) — Output field: source_url
• snapshot_at (string/null) — Output field: snapshot_at
• previous_status (object/null) — Output field: previous_status

✅ What you get

✅ What you get

✅ What you get

What you get

• Deterministic Apple top-chart snapshots by country, chart, and category
• Position, app ID, title, developer, category, and icon per chart entry
• A 12-field record with previous_status so you can see movement at a glance
• Source URL and snapshot timestamp on every row
• Optional watch mode that emits only position changes on later runs

⚙️ Sample inputs

1. Quick start — the Store example (this is what the sample above came from)

{
  "stores": [
    "apple"
  ],
  "countries": [
    "us"
  ],
  "charts": [
    "top-free"
  ],
  "max_items": 10,
  "watchMode": false
}

The sample run charged exactly: 1 × $0.02 apify-actor-start + 25 × $0.002 ranking-snapshot + 0 × $0.10 watch-check = $0.07 on the Free tier — every delivered row was billed.

2. A smaller, narrowed run

{
  "stores": [
    "apple"
  ],
  "countries": [
    "us"
  ],
  "charts": [
    "top-free"
  ],
  "max_items": 5,
  "watchMode": false
}

Caps the run at 5 rows — about $0.03 on the Free tier ($0.02 start + 5 × $0.002).

3. Optional watch mode (changes only, for a schedule)

{
  "stores": [
    "apple"
  ],
  "countries": [
    "us"
  ],
  "charts": [
    "top-free"
  ],
  "max_items": 10,
  "watchMode": true
}

The first run seeds a private baseline and emits zero deltas; every later run emits one row per change, billed at $0.002 each.

🧾 JSON sample record

One real record from run NUDaWivkwwkhHhrMX, exactly as it lands in the dataset (emails masked, long text shortened):

{
  "store": "apple",
  "country": "us",
  "chart": "top-free",
  "position": 10,
  "app_id": "6761538521",
  "title": "StoryReel: Drama Shorts & TV",
  "developer": "Equinox Enterprises‌ Technology Limited",
  "category": null,
  "icon_url": "https://is1-ssl.mzstatic.com/image/thumb/Purple221/v4/fa/d8/be/fad8be6f-eead-eccd-1c4d-016a9283545e/AppIcon-0-0-1x_U007ephone-0-1-0-0-85-220.png/100x100bb.png",
  "source_url": "https://apps.apple.com/us/app/storyreel-drama-shorts-tv/id6761538521",
  "snapshot_at": "2026-09-28T04:09:48.814919+00:00"
}

🔧 How it works

Source. The actor reads play.google.com — endpoints: https://play.google.com/store/apps. Public pages and feeds only; nothing behind a login.

Transport. Requests go through Apify residential proxy.

Watch semantics. Snapshot mode (watchMode: false) returns a preview. Watch mode keys every record on a source-native id, stores a private baseline in a named key-value store, and on each later run emits one delta row per change (new / changed / removed). A blocked fetch is never diffed, so a source outage cannot show up as a mass removal.

Terminal states. A run ends NORMAL, CAPPED (your cap was reached), PARTIAL (something was withheld and the message says what), GENUINE_EMPTY (the source was read and truly had nothing in scope) or BLOCKED (the source refused or changed shape — the run FAILS loud and bills nothing). A zero-row run is never reported as a silent success.

Charging. Each ranking snapshot is charged at the moment it is pushed (ranking-snapshot); a row that fails to charge is not delivered, so the dataset count always equals the charged count.

🔧 How it works

Transport. Requests go through Apify residential proxy.

🔧 How it works

Transport. Requests go through Apify residential proxy.

🔧 How it works

Transport. Requests go through Apify residential proxy.

How it works

Choose stores, countries, charts, and (optionally) categories. It captures deterministic Apple Marketing Tools chart snapshots — the same request yields the same ordered snapshot. Google Play chart requests fail loudly rather than guessing, because no stable official public chart feed has been evidenced. Public surfaces only.

Compliance & honest limits

• Apple charts only for now — Google Play chart requests fail loudly because no stable public feed has been evidenced (no fabricated data).
• Public chart surfaces only; no login, CAPTCHA, paywall, or access-control defeating.
• A source-confirmed empty result is SUCCEEDED-0: GENUINE_EMPTY; exhausted retries fail and truncated runs are PARTIAL.

About

Part of the NexGen Watch App Intelligence cluster — the daily ranking pulse that pairs with metadata and keyword tracking. Questions or need a custom feed? Open an issue on the Actor page.

Preview vs Watch mode

• Preview (watchMode = false): a one-shot snapshot of the current chart positions — emitted and charged per ranking-snapshot record. Use it to see the charts right now; it keeps no baseline.
• Watch (watchMode = true): change detection — the actor keeps a private baseline and emits only the ranking-snapshot rows that moved since the last run under the same baseline key, plus one watch-check per run. Use it on a schedule to be told only what changed.

What is not done. No login, no cookie or CAPTCHA bypass, no private or personal-account data, no browser automation.

⏰ Optional: run it on a schedule

A single run returns the current records. If you also want to be told what changed over time, open the actor in Apify Console → Schedules → Create new, add this actor with input 3 above (watchMode: true) so each run returns only the changes, and pick a cadence:

• Daily — 0 7 * * * (07:00 UTC): catch changes within a day.
• Weekly — 0 7 * * 1: a Monday digest.

Each run is independent; keep the same input on the schedule so the results stay comparable. Schedules can also POST results to a webhook (Console → Integrations).

⏰ Optional: run it on a schedule

A single run returns the current records. If you also want to be told what changed over time, open the actor in Apify Console → Schedules → Create new, add this actor with the watch-mode input above (watchMode: true) so each run returns only the changes, and pick a cadence:

💰 Pricing example

Event	Free	Bronze	Silver	Gold
Actor Start (apify-actor-start)	$0.02	$0.02	$0.02	$0.02
Ranking snapshot (ranking-snapshot)	$0.002	$0.0018	$0.0016	$0.0013
Watch check (watch-check)	$0.10	$0.09	$0.08	$0.067

Worked at the live Free-tier price (watch mode, one delta per change):

• 8 ranking snapshots: $0.02 start + 8 × $0.002 = $0.036
• 25 ranking snapshots: $0.02 start + 25 × $0.002 = $0.07

A run that delivers zero rows charges the $0.02 start fee only. A BLOCKED run (source refused) fails loud and charges no value event. The start fee is charged once per GB of run memory; the default run memory is 1024 MB.

Yield on the sample run: SUCCEEDED: emitted 25 item(s). max_items is a hard ceiling on what is delivered and billed, never a target.

⚖️ Legal & ToS

This actor reads public, logged-out pages and feeds published by play.google.com. It collects only what the source publishes to any visitor, identifies itself, and does not access accounts, private data or anything behind authentication. Use the output in line with the source's terms and your local law; the intended use is B2B research and monitoring.

❓ FAQ

Q: Do I need an API key or a login?
A: No. The source (play.google.com) is read logged-out; the input schema has no key field and the actor carries no secrets.

Q: Why did my run return 0 rows?
A: Read the run's status message. GENUINE_EMPTY means the source was read and had nothing in scope for your input (in watch mode the first run always seeds the baseline and returns zero deltas); BLOCKED means the source refused and the run failed without billing a value event — retry later or narrow the input. A zero-row run bills the start fee only.

Q: How many rows can one run return?
A: Up to max_items (default 25). Raise the cap for a bigger run; you pay per delivered row.

Q: What does watch mode remember between runs?
A: A private baseline of source-native record ids in a named key-value store. Each later run diffs the live source against it and emits only changes.

Q: How fresh is the data?
A: Every run reads the source live at run time; nothing is cached between runs except the watch baseline. Put it on a schedule for a continuous feed.

Q: What formats can I export?
A: The dataset downloads as JSON, CSV, Excel, XML or RSS from the run's Dataset tab or the Apify API, and any run can push to a webhook or integration.

Q: How is this different from the other app store intelligence actors?
A: Same output shape and billing model; this one covers play.google.com. The siblings under Related Actors cover the other sources or slices — run several on one schedule for a combined feed.

🆘 Troubleshooting

• Run FAILED with BLOCKED → the source refused the request or changed its page shape → nothing was billed beyond the start fee; retry after a while, and if it persists open an Issue with the run id.
• Status says CAPPED → your cap (max_items) was reached → raise it for a bigger run.
• Input validation error on start → a field is outside the schema's allowed values → start from the Quick start block and change one field at a time.
• Run TIMED-OUT → a very wide request on a slow day → raise the run timeout in Run options or narrow the input; what was delivered before the timeout is still in the dataset.
• First watch run shows no deltas → expected: it seeds the baseline; changes appear from the second run.

🔗 Related Actors

• App Store & Google Play Metadata Scraper — One Schema — Scrape public Apple App Store and Google Play app metadata by app ID — title, developer, description, category, price, rating, rating count, version,…
• ASO Keyword Rank Scraper - App Store and Google Play — Scrape App Store and Google Play keyword rankings for any app: position per keyword, per country, per store. Every run returns the current records as…
• Google Play Reviews Scraper — Ratings, Text & Replies — Scrape Google Play reviews for any app by package ID or URL: rating, text, thumbs-up, version, date and the developer's reply. Filter by star rating,…
• Apple App Store Reviews Scraper — Ratings, Text & Dates — Scrape Apple App Store reviews for any app by ID or URL: rating, title, text, version, date and the developer's reply. Filter by star rating, review-…
• 🏢 About NexGen Watch — NexGen Watch is a catalog of more than 300 public data actors built on official sources, pay-per-result. Browse the catalog at apify.com/nexgenwatch.

⭐ Found this useful?

If this actor saved you a manual check, a quick review on the Apify Store helps other teams find it. Feature request or a source that changed? Open it from the Issues tab — every one is read.