{"uid":"cap_P_8src5rOEaKP0IzVbam9","slug":"apple-podcasts-scraper-b074d966","name":"Apple Podcasts Scraper","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://api.scrapeforagents.tech/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_dDglMgSjdxcQxllOaQ3GF","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":"Searches, discovers, and extracts structured episode and show metadata from Apple Podcasts via search terms, show URLs, podcast IDs, or RSS feeds","exampleAgentPrompt":"Search Apple Podcasts in the US for shows about 'true crime', grab up to 5 shows per search, only keep episodes from 2023-01-01 onwards that are at least 10 minutes long, and include full show metadata like author, genres, and description.","exampleUseCases":[{"title":"Podcast research for content analysis","prompt":"Search Apple Podcasts for shows about 'machine learning' in the US, get up to 20 shows, and pull all episodes released after 2022-06-01 with their titles, episode numbers, and show descriptions — include the RSS feed data for the full archive."},{"title":"Full episode archive for a known show","prompt":"Get every episode from this Apple Podcasts show URL — https://podcasts.apple.com/us/podcast/lex-fridman-podcast/id1434243584 — including author, genres, and all available episode metadata, with no cap on items."},{"title":"Filter explicit-free podcast content","prompt":"Search Apple Podcasts for 'kids stories' in the GB storefront, only return clean episodes, limit to 50 episodes total, and include show metadata like language and genre."}],"resultDescription":"Returns a JSON object with a count and an array of episode items, each containing fields such as episodeTitle, episodeNumber, episodeGuid, episodeId, podcastName, podcastId, author, and season; show-level metadata (creator, genres, country, language, description) included when fetchShowMetadata is true.","failureModes":["Empty result if search terms return no matching podcasts in the given storefront","Podcast ID or URL not found in Apple catalog returns empty items array","RSS feed URL is inaccessible or private, causing that feed to be skipped","Invalid country code may default to US or return an error","Truncated results if maxItems cap is hit before all episodes are fetched","No charge on failed or empty runs per service policy"],"whenToPreferThis":"Use this endpoint when you need structured, queryable episode and show data from Apple Podcasts — especially when you want to search by keyword, filter by date range or duration, retrieve full back-catalogs via RSS, or look up specific shows by ID or URL. Prefer it over generic web scrapers when Apple Podcasts-specific fields like catalog episode count, storefront, and explicit content filters are needed.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:47:54.398Z","isFirstParty":false,"canonicalSlug":"apple-podcasts-scraper-b074d966"}