Refresh Apple Podcasts watchlists
A watchlist refresh re-resolves shows you already know. Apple Podcasts Scraper looks up Apple Podcasts collection IDs through the official iTunes Lookup API. No proxy is required. Use this after search or charts have produced collection IDs, or when you already store IDs from Apple Podcasts URLs (id1535144780 → 1535144780).
Open Apple Podcasts Scraper on Apify
Watchlist versus reviews and rank movement
Use this guide when the job is refreshing known collection IDs. Use Apple Podcasts Reviews Scraper for public ratings on those IDs. Use Apple Podcasts Chart Scraper for Top Podcasts movement, not a show watchlist. See one-time export vs watchlist.
Watchlist (lookupIds) |
Reviews Scraper | Chart Scraper monitor | |
|---|---|---|---|
| Input IDs | Apple collection IDs | podcastIds (same IDs) |
Storefront countries, not a show list |
| Output | Show metadata, optional episodeTitle |
Review rows or one rating report | Chart rows or one movement report |
| Unchanged polls | Described as avoiding payable dataset writes when nothing is saved | Zero rows / zero charge when emitUnchanged is false |
Zero rows / zero charges when ranks are unchanged |
What a watchlist refresh returns
Lookup rows are source-linked dataset items with stable identifiers for recurring checks. Documented fields include:
collectionId— the ID you asked to refreshshowName,publisher,countrysourceUrl— Apple Podcasts pagefetchedAt— fetch timestampepisodeTitle— present when recent episodes are included
Set includeEpisodes true to fetch recent episodes for each resolved podcast. That is slower. This Actor’s published input controls episode inclusion with that boolean only.
Watchlist input
Pass lookupIds. At least one of searchTerm, chartRequests, or lookupIds is required. country applies to lookup requests (default us).
{
"lookupIds": ["1535144780"],
"country": "us",
"includeEpisodes": true
}
Empty or no-change watchlist polls are described as avoiding payable default-dataset writes when nothing is saved. Use dryRun to validate a setup without saving results or sending webhooks.
Run a watchlist refresh on Apify
How do I get Apple Podcasts collection IDs for a watchlist?
Use this after search or charts have produced collection IDs, or when you already store IDs from Apple Podcasts URLs (id1535144780 → 1535144780). Pass those values as lookupIds. Lookup uses the official iTunes Lookup API. The outreach shortlist workflow keeps IDs from a search export, then switches later runs to lookup.
Do unchanged watchlist polls write payable rows?
Empty or no-change watchlist polls are described as avoiding payable default-dataset writes when nothing is saved. Use dryRun to validate a setup without saving results or sending webhooks. See webhooks before switching delivery.
How is a watchlist different from Reviews Scraper?
A lookupIds watchlist re-resolves show metadata (name, publisher, source URL, optional recent episode titles). Apple Podcasts Reviews Scraper reads public Customer Reviews RSS for podcastIds you already have and can emit review rows or one rating report. Pass the same collection IDs to Reviews Scraper when reputation context is required.
Does a watchlist compute rank movement?
No. lookupIds refresh known shows. For storefront Top Podcasts movement (new, changed, or dropped positions), use Apple Podcasts Chart Scraper. For joining chart snapshots yourself, use chartRequests on a schedule.
How to run it
- Open Apple Podcasts Scraper, then the Actor on the Apify Store.
- Paste Apple Podcasts collection IDs into
lookupIds. - Set
countryto the storefront you track. Turn onincludeEpisodesonly if recent episodes are needed. - Start with
delivery: "dataset". After the payload is approved, you can setdeliverytowebhookand providewebhookUrl(Slack, Discord, Zapier, or any HTTP endpoint).
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
- Apple Podcasts Scraper — search, episodes, and watchlists
- Apple Podcasts Chart Scraper
- Apple Podcasts Reviews Scraper — public ratings for known collection IDs
- How to get Apple Podcasts chart metadata
- Apple Podcasts search discovery
- Export Apple Podcasts episode metadata
- Apple Podcasts charts and search by country
- Apple Podcasts Scraper FAQ
- Shortlist podcasts for outreach
- Tools