Apple Podcasts charts and search by country

Apple Podcasts rankings and search results are storefront-specific. A US chart is not a GB or JP chart, and the same keyword can return a different set of shows. Apple Podcasts Scraper passes ISO country codes through official Apple/iTunes endpoints. No proxy is required. Apple Podcasts Chart Scraper also takes storefront codes, as a countries list for Top Podcasts ranks.

Open Apple Podcasts Scraper on Apify

One default country versus a chart array

Use this guide when the job is picking storefronts on Apple Podcasts Scraper. Reviews Scraper also takes a countries list (at most 10) for review RSS — that is ratings, not search. Chart Scraper’s countries list is Top Podcasts ranks, not keyword search.

Search / lookup Scraper chartRequests Chart Scraper
Country input One default country string Per-item country on an array countries list (at most 20)
Default us Default country unless an item overrides ["us"]
Multi-storefront in one run No — run once per storefront Yes — one array item per storefront Yes — unique codes in countries

How country is applied

The published input has one default country string (default us) plus optional per-chart overrides:

Search and lookup use that single default code per run. Charts can request several storefronts in one run because chartRequests is an array. The iTunes Search API documents the country value as a two-letter storefront code (ISO 3166-1 alpha-2). This page does not list every storefront Apple currently serves.

Multi-country chart snapshot

Add one chartRequests item per storefront. Each item can set country, feedType, and limit. Supported feedType values are podcasts and podcast-episodes. If an item omits limit, the top-level limit applies. Keep the first run small.

{
  "chartRequests": [
    { "country": "us", "feedType": "podcasts", "limit": 10 },
    { "country": "gb", "feedType": "podcasts", "limit": 10 },
    { "country": "jp", "feedType": "podcasts", "limit": 10 }
  ],
  "includeEpisodes": false
}

Each chart row can include rank, country, show identifiers, and sourceUrl. Compare rows by country; do not treat ranks from different storefronts as one list. This is a snapshot: the Actor does not compute rank movement between runs. For joining snapshots over time, see chart tracking over time.

Run a multi-country chart request on Apify

Search one storefront at a time

Keyword discovery uses searchTerm plus the default country. There is no country array on search. To compare markets, run once per storefront (or schedule separate runs) and keep country on the output rows.

{
  "searchTerm": "founder podcast",
  "country": "jp",
  "limit": 10,
  "includeEpisodes": false
}

Watchlist refreshes work the same way: lookupIds plus one default country. After you have collection IDs from search or charts, pass them into a watchlist refresh.

Can I search multiple Apple Podcasts countries in one run?

No. Search and lookup use a single default country per run (default us). There is no country array on search. To compare markets, run once per storefront (or schedule separate runs) and keep country on the output rows. See search discovery.

How do chartRequests handle multiple storefronts?

Charts can request several storefronts in one run because chartRequests is an array. Add one item per storefront. Each item can set country, feedType, and limit. Per-item country overrides the default country. Compare rows by the country field; do not treat ranks from different storefronts as one list.

Should I compare ranks across countries?

No. A US chart is not a GB or JP chart, and the same keyword can return a different set of shows. Rankings and search results differ by storefront. This is a snapshot: Apple Podcasts Scraper does not compute rank movement between runs. Chart Scraper also treats unsupported storefronts as warnings, never as a mass drop.

How does Chart Scraper’s countries field differ?

Apple Podcasts Chart Scraper accepts countries as a list of unique ISO-3166-1 alpha-2 codes (at most 20 per run; default ["us"]). That Actor is Top Podcasts ranks and optional movement reports, not keyword search. Apple Podcasts Scraper search/lookup still use one default country string per run. Reviews Scraper accepts at most 10 country codes for review RSS.

How to run it

  1. Open Apple Podcasts Scraper, then the Actor on the Apify Store.
  2. For charts, paste a chartRequests array with one item per country you need. For search, set searchTerm and one country.
  3. Leave includeEpisodes false unless recent episode context is required. See the episode metadata export workflow.
  4. Deliver to the default dataset. Switch delivery to webhook only after the payload shape is approved. Set dryRun true to test without saving results or sending webhooks.

Billing is pay-per-event: Actor start plus one result event per default-dataset item. The published Store price is $0.005 per Actor start and $10.00 per 1,000 dataset results ($0.01 per row).

From $10 per 1,000 results

Open Apple Podcasts Scraper on Apify

Related guides