How to get Apple Podcasts chart metadata

Apple publishes country-specific rankings for podcast shows and podcast episodes. Apple Podcasts Scraper reads those rankings through official Apple/iTunes endpoints. No proxy is required. This is a chart snapshot: each row can include a rank, show identifiers, and a source URL. It does not compute rank movement between runs. For Top Podcasts movement reports, use Apple Podcasts Chart Scraper.

Open Apple Podcasts Scraper on Apify

chartRequests snapshot versus Chart Scraper

Use this guide when the job is a chartRequests snapshot on Apple Podcasts Scraper (optionally next to search or watchlists). Use Chart Scraper when the job is storefront Top Podcasts ranks and optional movement. Use Apple Podcasts Reviews Scraper for public ratings, not ranks.

Scraper chartRequests Chart Scraper
Intent Rank snapshot on the search / watchlist actor Top Podcasts rows and optional rank movement
Chart input chartRequests with country, feedType, limit countries, optional genreId, limit
feedType podcasts or podcast-episodes Top Podcasts chart path (not a search actor)
Movement Snapshot only One report when a monitorKey sees new, changed, or dropped positions

What you get

Chart rows are source-linked dataset items. Documented fields include:

Optional recent episodes are available with includeEpisodes. Leave that off unless episode context is required; it slows the run.

Chart request input

Use chartRequests. At least one of searchTerm, chartRequests, or lookupIds is required. Each chart 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 (1–200). Per-item country overrides the default country (ISO codes such as us, gb, jp).

{
  "chartRequests": [
    { "country": "us", "feedType": "podcasts", "limit": 25 }
  ],
  "includeEpisodes": false
}

Keep the first run small, then raise limit after the output is useful. Rankings differ by storefront: a US chart is not a GB or JP chart. See charts and search by country.

Run a chart request on Apify

How is chartRequests different from Apple Podcasts Chart Scraper?

Apple Podcasts Scraper chartRequests is a rank snapshot on the search, episode, and watchlist actor. It does not emit movement reports. Apple Podcasts Chart Scraper is storefront Top Podcasts rankings only: raw chart_rank rows, or one movement report when a saved monitor sees new, changed, or dropped positions. Chart Scraper does not search by keyword, look up collection IDs, or attach episode catalogs.

What feedTypes are supported for chart snapshots?

Supported feedType values are podcasts and podcast-episodes. Each chartRequests item can set country, feedType, and limit. If an item omits limit, the top-level limit applies (1–200). Per-item country overrides the default storefront. Episode charts are rankings, not a per-show episode list — see the episode metadata export workflow.

Does a chartRequests run compute rank movement?

No. This is a chart snapshot. Rank movement between runs is not computed here. For a source-linked movement report, use Chart Scraper. To join snapshots yourself, see Track Apple Podcasts charts over time.

How to run it

  1. Open Apple Podcasts Scraper, then the Actor on the Apify Store.
  2. Paste a chartRequests array. Start with one country and feedType: "podcasts".
  3. Leave includeEpisodes false unless you need recent episodes.
  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