Apple Podcasts countries

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:

country — default ISO country code for searchTerm and lookupIds (examples in the Actor input: us, gb, jp)
chartRequests[].country — optional override for that chart item

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": "technology",
  "country": "jp",
  "limit": 3,
  "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 iTunes Lookup 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.

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.

Which country codes are documented?

The published input uses ISO 3166-1 alpha-2 storefront codes. Examples in the Actor input include us, gb, and jp. The iTunes Search API documents the country value as a two-letter storefront code. This page does not list every storefront Apple currently serves.

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.

Does lookupIds use the same country as search?

Yes. Search and lookup both use the single default country string per run (default us). Watchlist refreshes are lookupIds plus that default country. There is no country array on lookup.

Can I copy Reviews Scraper countries onto Apple Podcasts search?

No. Reviews Scraper countries is a list for Customer Reviews RSS (at most 10). Apple Podcasts Scraper searchTerm still takes one default country string. Do not treat those inputs as interchangeable.

How is a multi-country chartRequests run priced?

Billing is pay-per-event. The live Store card is from $2.50 / 1,000 results. Published events are Actor Start at $0.005 and result at $0.0025 per default-dataset item ($2.50 per 1,000). Each saved chart row is a result event.

Do chart ranks mean the same thing in us and jp?

No. Rankings differ by storefront. A US chart is not a GB or JP chart. Compare rows by the country field instead of mixing ranks into one list.

Are three-letter country codes documented on this Actor?

No. The published input uses ISO 3166-1 alpha-2 storefront codes (two letters). Examples in the Actor input include us, gb, and jp. This page does not document three-letter codes.

How to run it

Open Apple Podcasts Scraper, then the Actor on the Apify Store.
For charts, paste a chartRequests array with one item per country you need. For search, set searchTerm and one country.
Leave includeEpisodes false unless recent episode context is required. See the episode metadata export workflow.
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 $2.50 per 1,000 dataset results ($0.0025 per row).

From $2.50 per 1,000 results