{"uid":"cap_AU9EodHcQTHTQpz6eX-qb","slug":"apple-podcasts-scraper-api-x402-9c754ae1","name":"Apple Podcasts Scraper API (x402)","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://x402.186-241-26-229.sslip.io/v1/apple-podcasts?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"country":{"type":"string","default":"us","description":"Two-letter storefront code for search, charts, and lookup, such as us, gb, or tr."},"explicit":{"enum":["all","clean","explicit"],"type":"string","default":"all","description":"Filter to all, clean, or explicit episodes."},"maxItems":{"type":"integer","default":100,"minimum":0,"description":"Stop after this many episode rows across all inputs. Zero removes the cap."},"rssFeeds":{"type":"array","default":[],"description":"Direct public podcast RSS URLs. These can be used without a catalog ID."},"podcastIds":{"type":"array","default":[],"description":"Numeric collection IDs from podcast page URLs."},"podcastUrls":{"type":"array","default":[],"description":"Full Apple Podcasts show URLs; the numeric show ID is extracted automatically."},"searchTerms":{"type":"array","default":[],"description":"Podcast keywords. Each query discovers up to maxPodcastsPerSearch shows."},"maxReleaseDate":{"type":"string","default":null,"description":"Include episodes released on or before this date, YYYY-MM-DD."},"minReleaseDate":{"type":"string","default":null,"description":"Include episodes released on or after this date, YYYY-MM-DD."},"fetchShowMetadata":{"type":"boolean","default":true,"description":"Include creator, genres, country, language, show description, and catalog episode count."},"minDurationSeconds":{"type":"integer","default":0,"minimum":0,"description":"Only keep episodes at least this many seconds long. Episodes without duration are excluded when this is greater than zero."},"maxPodcastsPerSearch":{"type":"integer","default":10,"maximum":200,"minimum":1,"description":"Maximum shows per search term or chart default. The catalog caps a query at 200."},"useRssForFullArchive":{"type":"boolean","default":true,"description":"Read each discovered show’s public RSS feed to collect older episodes and enrich show notes, episode numbers, and enclosure metadata."},"maxEpisodesPerPodcast":{"type":"integer","default":100,"maximum":200,"minimum":1,"description":"Maximum recent episodes requested from catalog lookup. RSS archive mode can return older episodes beyond this limit."}}},"responseSchema":{"type":"json","example":{"count":1,"items":[{"author":null,"season":null,"episodeId":null,"podcastId":null,"episodeGuid":null,"podcastName":null,"episodeTitle":null,"episodeNumber":null}],"product":"apple-podcasts"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.025","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.025/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_tS7KtbOzdTc8m2LoTL-xm","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.025","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Scrapes structured episode and show metadata from Apple Podcasts via search terms, show URLs, podcast IDs, or direct RSS feeds, returning normalized episode rows.","exampleAgentPrompt":"Search Apple Podcasts for shows about 'true crime' in the US, grab up to 50 episodes per show across 5 shows max, only include episodes at least 10 minutes long released after 2023-01-01, and give me the full episode list with author and show metadata.","exampleUseCases":[{"title":"Podcast research for a newsletter","prompt":"Find all episodes from the Apple Podcasts show at https://podcasts.apple.com/us/podcast/huberman-lab/id1545953110 released between 2024-01-01 and 2024-12-31, include show metadata like genres and description, and return them sorted by date — I want episode titles, numbers, and author."},{"title":"Competitor podcast analysis","prompt":"Search Apple Podcasts in the US for shows about 'startup investing', get up to 10 shows, pull up to 200 episodes total, exclude explicit content, and give me each episode's title, release date, duration, and the podcast name so I can compare content cadence."},{"title":"Archive ingestion from RSS","prompt":"I have these two RSS feed URLs — https://feeds.simplecast.com/54nAGcIl and https://anchor.fm/s/abc123/podcast/rss — pull the full episode archive from both, include show notes and enclosure metadata, and cap it at 500 episodes total so I can import them into my database."}],"resultDescription":"Returns a JSON object with a count of results and an array of episode items. Each item includes fields such as podcastId, podcastName, episodeId, episodeTitle, episodeGuid, episodeNumber, season, author, and additional show metadata (genres, country, language, description) when fetchShowMetadata is enabled. The product field confirms 'apple-podcasts'. Failed or empty runs are not billed.","failureModes":["No results returned if search terms match no podcasts in the specified storefront — not charged","Invalid RSS URL causes that feed to be skipped or return an error","Podcast ID not found in Apple catalog returns empty items for that ID","Rate limits or Apple Podcasts catalog caps may truncate results beyond 200 shows per search","Malformed date strings in minReleaseDate/maxReleaseDate may cause filtering to behave unexpectedly","Private or paywalled RSS feeds cannot be accessed and return no data"],"whenToPreferThis":"Choose this endpoint when you need structured, normalized episode data from Apple Podcasts — especially when combining catalog search, show URLs, podcast IDs, and RSS feeds in a single call. It is superior to manual RSS parsing when you need Apple catalog metadata (genres, episode counts, storefronts) alongside full RSS archive data. Prefer it over general web scrapers when the target is specifically Apple Podcasts or compatible podcast RSS feeds and you want pay-per-successful-call pricing.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:47:41.947Z","isFirstParty":false,"canonicalSlug":"apple-podcasts-scraper-api-x402-9c754ae1"}