{"uid":"cap_VihWNAu33M6sexvDaN1ei","slug":"particle-pro-podcast-search-list-13eab1c2","name":"Particle Pro Podcast Search & List","description":"List and search podcasts. Returns a paginated list of podcasts, with filters for topic, language, suitability tier, popularity, and format.","url":"https://api.particle.pro/v1/podcasts","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","properties":{"q":{"type":"string","description":"Search the catalog by podcast name. GET /v1/podcasts/search is the canonical search endpoint and accepts the same parameters. The search is forgiving: it handles typos, missing or extra words ('offline jon favreau' finds Offline with Jon Favreau), a name plus qualifiers ('equity techcrunch'), and pasted episode titles ('Ferrari | Acquired' finds Acquired). The best matches come first, and each result's match_quality tells you how confident the match is — including when a show matched only through its description (match_quality=description) rather than its name."},"slug":{"type":"string","description":"Filter by exact podcast slug (e.g., 'all-in'). Slugs are stable, human-readable identifiers returned on every podcast object."},"sort":{"enum":["relevance","popularity"],"type":"string","description":"Result ordering. relevance — the default whenever q is present — ranks by how well each podcast matches the query, breaking ties by popularity. popularity orders purely by the global popularity percentile (most popular first; podcasts not currently charting sort last), and also overrides topic_id's concentration ordering. Without q or topic_id, results are popularity-ordered either way."},"limit":{"type":"integer","format":"int64","description":"Results per page"},"cursor":{"type":"string","description":"Opaque pagination cursor from previous response"},"has_ads":{"enum":["true","false"],"type":"string","description":"Filter by advertiser presence. Pass false to find ad-free shows — an assertion that requires the show to have enough analyzed episodes, so sparsely-analyzed podcasts are excluded rather than presumed ad-free."},"language":{"type":"string","description":"Filter by the podcast's language (ISO 639-1 code, e.g. 'en', 'fr'). Matches the primary language subtag, so 'fr' covers 'fr-FR'."},"topic_id":{"type":"string","description":"Filter by topic ID, ancestry slug (e.g., technology/artificial-intelligence), or ancestry path hash. Matches podcasts where the topic accounts for at least 20% of the show's episodes, ranked by topic concentration — not merely podcasts that mention it once."},"has_video":{"enum":["true","false"],"type":"string","description":"Filter by whether episodes have discovered video versions (e.g. YouTube releases)."},"format_signal":{"type":"array","items":{"type":"string"},"description":"Filter by detected production format. Pass a comma-separated list to match any of several formats — e.g. panel,call_in. Values mirror the format.signals field on podcast responses; a show can carry several signals."},"guest_frequency":{"type":"array","items":{"type":"string"},"description":"Filter by how often episodes feature a guest. Pass a comma-separated list to match any of several buckets — e.g. regular,always for interview-driven shows, or never for shows that don't host guests. Only matches podcasts with enough analyzed episodes to judge; values mirror the format.guest_frequency field on podcast responses."},"suitability_tier":{"enum":["SAFE","LIMITED","SENSITIVE","UNSAFE"],"type":"string","description":"Filter by brand-suitability tier (IAB Tech Lab Brand Safety & Suitability Framework, formerly GARM). Only returns podcasts whose most recent suitability analysis assigned this tier. Podcasts without a suitability analysis are excluded when this filter is set."},"publishing_status":{"enum":["active","dormant"],"type":"string","description":"Filter by publishing activity: active shows have released an episode within the last 90 days; dormant shows have not."},"popularity_threshold":{"type":"number","format":"double","description":"Restrict results to podcasts whose global popularity percentile is at least this value (accepted range [0,1]). Omitting the parameter or passing 0 disables the filter; only a value greater than 0 activates it. Popularity is always global — a cume_dist ranking over all currently-charting podcasts (Apple Podcasts) — never scoped to topic_id or any other filter. When the filter is active (threshold > 0), podcasts not currently charting have no percentile and are excluded, so a high threshold combined with a narrow topic_id may return zero results; lower or remove the threshold to widen the set."},"max_episodes_per_week":{"type":"number","format":"double","description":"Only podcasts publishing at most this many episodes per week on average (e.g. 0.5 for fortnightly-or-slower shows)."},"min_episodes_per_week":{"type":"number","format":"double","description":"Only podcasts publishing at least this many episodes per week on average (e.g. 5 for weekday dailies). Cadence is measured over the trailing 90 days; podcasts tracked too briefly to measure are excluded."},"max_avg_episode_minutes":{"type":"integer","format":"int64","description":"Only podcasts whose average episode runs at most this many minutes."},"min_avg_episode_minutes":{"type":"integer","format":"int64","description":"Only podcasts whose average episode runs at least this many minutes. Combine with max_avg_episode_minutes to target a length band (e.g. 20–40 minute commute shows)."}}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_IsgAWg3oMWl6LAhgTLaC8","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"List and search podcasts with filters for topic, language, ad presence, popularity, suitability, and format, returning paginated results with match quality signals.","exampleAgentPrompt":"Can you find me the top 10 most popular English-language technology podcasts that don't have ads? Sort them by popularity.","exampleUseCases":[{"title":"Fuzzy podcast name lookup","prompt":"I'm trying to find a podcast called something like 'equity techcrunch' — can you look it up and tell me the exact name and slug so I can subscribe?"},{"title":"Ad-free show discovery by topic","prompt":"Find me up to 20 ad-free podcasts about personal finance in English, sorted by popularity, so I can pick one to binge this weekend."},{"title":"Podcast catalog browsing by language","prompt":"Show me the first page of Spanish-language podcasts sorted by popularity — I want to see what's charting right now."}],"resultDescription":"A paginated list of podcast objects, each including the podcast name, stable slug, popularity percentile, language, topic tags, suitability tier, ad presence flag, format, match quality (name vs description match), and a cursor for fetching the next page.","failureModes":["Invalid or unknown cursor returns an error or empty results","Filtering by slug with a non-existent slug returns an empty list","Sparse episode coverage causes ad-free filter to exclude some legitimate shows","Very broad queries with no q or topic_id default to popularity ordering which may not be what user expected","Language code typos or unsupported values may return no results or an error"],"whenToPreferThis":"Use this endpoint when you need to discover, search, or enumerate podcasts from the Particle Pro catalog — especially when fuzzy name matching, topic filtering, language filtering, or ad-presence filtering is required. Prefer this over generic podcast directories when you need rich metadata like popularity percentiles, match quality signals, and suitability tiers. Use the q parameter for forgiving name-based search and topic_id for category browsing.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:56:58.802Z","isFirstParty":false}