Scrape iOS App Store charts including TOP GROSSING — the revenue chart — plus keyword search and full app metadata. Any country. Pure HTTP on Apple's public feeds: no API key, no login, no headless browser, no residential proxy.

Most App Store scrapers give you Top Free. Top Free tells you what is popular. Top Grossing tells you what makes money — and that is the chart this Actor reads.

🇧🇷 Versão em português no final deste README.

---

Features

• Top Grossing chart — the revenue ranking, per storefront, up to 100 apps.
• Top Free and Top Paid charts too, same shape.
• Genre scoping — pass an Apple genre ID (6017 Education, 6007 Productivity, 6013 Health & Fitness, 6015 Finance…) to get the chart inside a niche.
• Keyword search — what ranks for a search term, per country.
• App details by ID — 20+ fields per app including rating, rating count, price, size, version.
• Optional enrichment — chart entries carry no ratings; switch enrichWithLookup on and each entry is completed with the full metadata record.
• Explicit nulls — every field Apple does not provide comes back as null, never as a guess or an empty string. What is missing is visible.
• Provenance-checked — every row is verified before publication: known data source, numeric appId, parseable timestamp, matching storefront, non-empty name. A malformed record is dropped and logged, never published; if more than 5% of a run fails the check the run aborts with the rate, because that means the upstream schema moved.
• Honest failures — a blocked feed or an empty answer returns a labeled diagnostic and is not charged. A schema change fails loudly instead of returning silence.

Input

Field	Type	Default	Description
mode	select	charts	charts · search · appDetails
countries	array	["us","br"]	2-letter storefronts. Charts are per country.
chart	select	top-grossing	top-grossing · top-free · top-paid
genreId	string	—	Apple genre ID, e.g. 6017. Empty = overall chart.
limit	integer	50	1–100. Apple caps at 100 — asking 200 still returns 100.
searchTerms	array	—	Keywords (mode = search).
appIds	array	—	Numeric App Store IDs (mode = appDetails).
enrichWithLookup	boolean	false	Complete chart entries with ratings and full metadata.
proxyConfiguration	object	datacenter	Optional — feeds are public, residential is not needed.

Output

One row per app. itemType: "app".

country · chart · genreId · rank · searchTerm · appId · bundleId · name · developer · developerId · categoryId · categoryName · price · currency · formattedPrice · isFree · releaseDate · currentVersionReleaseDate · version · averageUserRating · userRatingCount · averageUserRatingCurrentVersion · userRatingCountCurrentVersion · contentAdvisoryRating · fileSizeBytes · minimumOsVersion · languageCount · genres · description · sellerName · sellerUrl · artworkUrl · appStoreUrl · hasInAppPurchases · chartUpdatedAt · dataSource · enriched · scrapedAt

Use cases

• Niche discovery — read Top Grossing inside a genre and see which categories sustain paying users.
• Competitor tracking — watch a rival's rank, rating count and version cadence over time.
• Market entry research — compare the same niche across storefronts (US vs BR vs DE).
• ASO research — what actually ranks for a keyword, per country.
• Pricing benchmarks — price and currency per app, per storefront.

Documented limitations — validated 2026-07-28

Everything here was checked with a live request on that date. Nothing is assumed.

Limitation	Status
In-app purchases	❌ Not obtainable. No public Apple endpoint exposes IAP presence — the 44-field lookup record has zero purchase/subscription keys. hasInAppPurchases is always null.
Download / revenue numbers	❌ Not public. Rank is the only public proxy; absolute installs and revenue are Apple-private.
Chart depth	⚠️ Capped at 100 per storefront by Apple. limit=200 returns 100.
Ratings in charts	⚠️ Not in the chart feed. Use enrichWithLookup — it costs one extra request per 100 apps.
top-grossing on the new API	❌ rss.marketingtools.apple.com returns 404 for top-grossing and gives genres: [] empty. This Actor uses the legacy itunes.apple.com/rss feed, which does serve it with a populated category.
Non-browser User-Agent	⚠️ Apple returns an empty body to plain server agents. This Actor sends a browser User-Agent.

FAQ

Do I need an Apple developer account or API key? No. Every feed used is public.

Is Top Grossing really available? Yes — verified on us and br, with and without a genre filter, on 2026-07-28. It lives in Apple's legacy RSS feed, not in the newer marketing-tools API.

Why are ratings null in my chart run? The chart feed does not carry them. Turn on enrichWithLookup.

Can I get install counts? No, and no honest scraper can — Apple does not publish them. Anyone selling you "estimated downloads" is modelling, not measuring.

What happens if a genre has no chart? The run ends SUCCEEDED with one diagnostic item saying so, and nothing is charged.

Pricing

Pay-per-event on apps actually delivered. Diagnostic rows are not charged. Platform usage is billed to your account at Apify cost — this Actor is pure HTTP, so it is a fraction of a cent per run. See the pricing panel on this page for the current rate and tiers.

Related Actors

• viralanalyzer/substack-newsletter-intelligence — paywall and monetization signals for newsletters
• viralanalyzer/telegram-channel-scraper — the same pure-HTTP approach for Telegram
• viralanalyzer/producthunt-launches-tracker — new product launches

Changelog

1.0 — First release. Legacy RSS charts (top-grossing/free/paid) with genre scoping, keyword search, lookup by ID, optional enrichment, block-gated diagnostics, owner-skip PPE.

---

---

🇧🇷 App Store Scraper — Top Grossing, Rankings e Dados de Apps

Extraia rankings da App Store iOS incluindo TOP GROSSING — o ranking de faturamento — além de busca por palavra-chave e metadados completos de apps. Qualquer país. HTTP puro sobre os feeds públicos da Apple: sem API key, sem login, sem navegador, sem proxy residencial.

A maioria dos scrapers entrega Top Free. Top Free mostra o que é popular. Top Grossing mostra o que dá dinheiro — e é esse o ranking que este Actor lê.

Funcionalidades

• Ranking Top Grossing por storefront, até 100 apps
• Top Free e Top Paid no mesmo formato
• Recorte por gênero — ID da Apple (6017 Educação, 6007 Produtividade, 6013 Saúde, 6015 Finanças)
• Busca por palavra-chave — o que ranqueia para um termo, por país
• Detalhe por ID — 20+ campos incluindo nota, número de avaliações, preço, tamanho, versão
• Enriquecimento opcional — o ranking não traz notas; ligue enrichWithLookup e cada entrada é completada com o registro cheio
• Nulls explícitos — todo campo que a Apple não fornece vem como null, nunca como chute
• Procedência verificada — cada linha é checada antes de publicar: fonte conhecida, appId numérico, timestamp parseável, storefront correspondente, nome não vazio. Registro malformado é descartado e logado, nunca publicado; acima de 5% de descarte o run aborta informando a taxa
• Falha honesta — feed bloqueado ou resposta vazia gera diagnóstico rotulado, sem cobrança

Entrada

Ver a tabela na seção em inglês. Padrões: mode=charts, countries=["us","br"], chart=top-grossing, limit=50 (máximo 100, imposto pela Apple).

Limitações documentadas — validadas em 28/07/2026

Limitação	Situação
Compras no app (IAP)	❌ Não obtenível. Nenhum endpoint público da Apple expõe. O registro de 44 campos não tem nenhuma chave de compra/assinatura. hasInAppPurchases é sempre null.
Downloads / receita	❌ Não são públicos. O ranking é o único proxy; números absolutos são privados da Apple.
Profundidade do ranking	⚠️ Limitado a 100 por storefront pela própria Apple.
Notas no ranking	⚠️ Não vêm no feed de ranking. Use enrichWithLookup.
top-grossing na API nova	❌ rss.marketingtools.apple.com devolve 404 e genres: [] vazio. Este Actor usa o feed legado, que entrega o ranking com categoria preenchida.
User-Agent não-navegador	⚠️ A Apple devolve corpo vazio para agentes de servidor. Este Actor envia UA de navegador.

FAQ

Preciso de conta de desenvolvedor Apple? Não. Todos os feeds são públicos.

O Top Grossing existe mesmo? Sim — verificado em us e br, com e sem filtro de gênero, em 28/07/2026. Está no feed RSS legado, não na API nova.

Por que as notas vieram null? O feed de ranking não as traz. Ligue enrichWithLookup.

Consigo número de downloads? Não — e nenhum scraper honesto consegue. A Apple não publica. Quem vende "downloads estimados" está modelando, não medindo.

Preço

Cobrança por evento, sobre apps efetivamente entregues. Itens de diagnóstico não são cobrados. O custo de plataforma é debitado na sua conta ao custo da Apify.

Changelog

1.0 — Primeira versão. Rankings via RSS legada com recorte por gênero, busca, lookup por ID, enriquecimento opcional, diagnóstico com gate de bloqueio, owner-skip no PPE.