App Rankings Scraper

App store rank is one of the few public signals that moves before a consumer company's earnings do. This Actor reads Apple's App Store top charts for any storefront and category and returns one structured record per ranked app: rank, name, developer, category and price. Pull the finance chart in eight countries and you have a comparable panel nobody has to buy.

What it does

• Reads four charts: top free, top paid, top grossing and newest, which are different questions. Grossing tracks revenue, free tracks reach.
• Covers any App Store storefront by two-letter country code, so the same chart across markets is one run.
• Narrows to an Apple genre, so you can pull the finance, business or utilities chart instead of the overall list.
• Returns up to Apple's maximum of 200 ranked apps per country.
• Carries the developer name on every row, which is what lets you map a chart back to a listed company.
• Returns one record per ranked app with rank and country, so a cross-market panel is a single dataset.

Use cases

You need to	How this Actor does it
Track a competitor's reach	Pull the top free chart in your genre and follow their rank over time
Watch revenue momentum	Use the top grossing chart, which tracks spend rather than downloads
Build a cross-market panel	Pass eight country codes and compare rank for the same app
Spot a launch early	Use the newest apps chart on a daily schedule
Map a chart to listed owners	Group by developer and join to your own ticker mapping
Feed a research agent	Call the Actor over MCP and let the model ask for a chart and market

Quick start

1. Click Try for free.
2. Add App Store country codes, one per line: us, gb, de, jp.
3. Pick a Chart: topfreeapplications, toppaidapplications, topgrossingapplications or newapplications.
4. Optionally set a Genre id to narrow it: 6015 is Finance, 6000 Business, 6002 Utilities. Leave it empty for the overall chart. Set Limit up to Apple's maximum of 200.
5. Click Start. Rows appear within seconds.
6. Export as JSON, CSV, Excel or XML, or read the dataset over the API.

Input

Field	Type	Default	What it controls
countries	array	us	Two-letter App Store country codes
chart	string	topfreeapplications	Which chart: top free, top paid, top grossing or newest
genreId	string	empty	Apple genre id to narrow the chart. Empty gives the overall chart
limit	integer	50	Ranked apps per country, up to Apple's maximum of 200
maxItems	integer	0	Caps how many records are written. 0 writes them all

{
    "countries": [
        "us",
        "gb",
        "de"
    ],
    "chart": "topgrossingapplications",
    "genreId": "6015",
    "limit": 50
}

Output

One dataset item per ranked app per country, in rank order. A country or genre Apple does not serve comes back as a failure row rather than an empty result.

Field group	Fields
Position	status, country, chart, genreId, rank
App	name, developer, category, appId, url
Price	price, currency
Timing	validFrom, scrapedAt

{
    "status": "ok",
    "country": "us",
    "chart": "topgrossingapplications",
    "genreId": "6015",
    "rank": 1,
    "name": "Coinbase",
    "developer": "Coinbase, Inc.",
    "category": "Finance",
    "appId": "886427730",
    "price": 0.0,
    "currency": "USD",
    "validFrom": "2026-09-06T05:30:00.000Z",
    "url": "https://apps.apple.com/us/app/coinbase/id886427730"
}

Integrations

Run it over the API and get the rows back in one call:

curl -X POST "https://api.apify.com/v2/acts/publicmoney~app-rankings-scraper/run-sync-get-dataset-items?token=YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"countries": ["us", "gb", "de"], "chart": "topgrossingapplications", "genreId": "6015", "limit": 50}'

From Python:

from apify_client import ApifyClient

client = ApifyClient("YOUR_TOKEN")
run = client.actor("publicmoney/app-rankings-scraper").call(run_input={"countries": ["us", "gb", "de"], "chart": "topgrossingapplications", "genreId": "6015", "limit": 50})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item["name"], item["validFrom"])

Give an AI agent the Actor over MCP:

{
    "mcpServers": {
        "apify": {
            "url": "https://mcp.apify.com/?actors=publicmoney/app-rankings-scraper"
        }
    }
}

Schedules run it on any cron, webhooks fire when a run finishes, and platform integrations push the dataset to Google Sheets, Slack, Airtable, Zapier or your own endpoint.

Cost

Pay per event, so you pay for records rather than compute time.

Event	Free tier	Top volume tier
Record with data	$0.002	$0.0007
Actor start	$0.00005 per GB	Same

A record that returned no data is published as a failure row and is never charged. Six volume tiers apply, so the per-record price falls with monthly volume.

Troubleshooting

Issue	Solution
A country returns failed	The code is not an App Store storefront. Use two-letter codes such as us, gb, de, jp.
A genre returns nothing	The genre id is wrong. Apple's ids are numeric, so Finance is 6015, not the word.
I asked for 200 and got fewer	Apple serves fewer than 200 in some small storefronts and narrow genres. That is the source.
price is 0 on the paid chart	The app is temporarily free. The chart position was earned as a paid app.
Google Play is missing	This Actor reads the Apple App Store only. Play Store charts are not covered.

FAQ

Does Apple have an App Store rankings API?

Apple publishes chart feeds for its storefronts but no supported product API for rankings, and the commercial alternatives are expensive. This Actor reads the public charts.

Does it cover Google Play?

No, Apple App Store only. If Play coverage matters, treat this as one of two signals rather than the whole picture.

Which chart should I use?

They answer different questions. Top grossing tracks money spent, so it is the closest thing to a revenue signal. Top free tracks reach and installs. Newest catches launches.

Where do I find the genre ids?

They are Apple's numeric genre codes. Finance is 6015, Business 6000, Utilities 6002. Leave the field empty for the overall chart.

Can I get download or revenue numbers?

No. Apple publishes rank, not volume. Rank is a relative signal, which is why the grossing chart over time is more useful than any single day.

Do I need a the App Store API key?

No. You need an Apify token to call the Actor over the API. No the App Store credential is involved anywhere.

Can I get this data in Python?

Yes, with the apify-client package as shown above. It returns parsed JSON, so there is no HTML or response handling on your side.

Can I get the data into Excel or Google Sheets?

Yes. Export the dataset as XLSX or CSV, or connect the Google Sheets integration so each run appends to a sheet.

Can an AI agent call this Actor?

Yes. Add it to an MCP client with the config above and the model can request what it needs on its own. Every record is flat JSON with named fields, so no post-processing is needed.

Is it legal to scrape the App Store?

This Actor reads Apple's public App Store charts, which need no login, and it collects no personal data beyond the developer name Apple publishes on each listing. How you use chart data commercially is governed by your own agreements, so take your own legal advice for your use case.

Changelog

• 0.0.2 Added genre filtering, the newest-apps chart and multi-country runs.
• 0.0.1 First release. Top charts per country.

Feedback

Found a field the App Store publishes that this Actor misses, or an input it rejects? Open an issue on the Issues tab with the input and what you expected. A daily test runs every Actor in the fleet against live sources, so parser fixes ship fast.