{"uid":"cap_dE5XBzCsAax5HnJh6mP0d","slug":"particle-pro-list-related-podcasts-53e8fe62","name":"Particle Pro: List Related Podcasts","description":"List related podcasts. Returns the shows most related to a podcast, best first, each with a calibrated score, a coarse band (strong, moderate, weak) to branch on, and — with include=basis — the signals behind the pairing: content similarity","url":"https://api.particle.pro/v1/podcasts/:id/related","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"},"pathParams":{"type":"object","required":["id"],"properties":{"id":{"type":"string","description":"Podcast slug (e.g., 'all-in'), internal ID, or numeric iTunes ID"}}},"queryParams":{"type":"object","properties":{"limit":{"type":"integer","format":"int64","description":"Results per page"},"cursor":{"type":"string","description":"Opaque pagination cursor from previous response"},"include":{"type":"array","items":{"type":"string"},"description":"Optional response sections. Pass include=basis to attach, for every result, the signals that make the two shows related: content similarity, shared topics, shared guests (with names), same publisher, shared sponsors."},"language":{"type":"string","description":"Only shows in this language (ISO 639-1 code, e.g. 'en', 'es'; a region suffix such as 'fr-CA' is reduced to the language). Related sets are built within the source show's language, so this mostly matters for shows with a mixed catalogue."},"min_score":{"type":"number","format":"double","description":"Only results with a fused score at or above this value. Omit (or 0) to return every stored neighbour; the band field is the recommended way to filter by strength."},"min_popularity":{"type":"number","format":"double","description":"Only shows at or above this popularity percentile (0-1]. A floor above 0 excludes shows that do not chart; 0 (or omitting it) applies no floor."},"suitability_tier":{"enum":["SAFE","LIMITED","SENSITIVE","UNSAFE"],"type":"string","description":"Only shows whose latest brand-suitability assessment is this tier. Shows never assessed are excluded when this is set."},"publishing_status":{"enum":["active","dormant"],"type":"string","description":"Only shows that have released an episode in the last 90 days (active) or have not (dormant). Shows with no known episode date match neither."},"exclude_same_publisher":{"type":"boolean","description":"Drop shows from the source show's own publisher — 'shows like mine that I do not already own'."}}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","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.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_GCgTWx9lWU3SG6SJK-s7t","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the most related podcasts to a given podcast, ranked by calibrated relevance score with band labels and optional content-similarity signals.","exampleAgentPrompt":"Find the top 10 podcasts most similar to 'All In' (use slug 'all-in'), only include shows that are active and rated SAFE for brands, and show me the content signals behind each pairing.","exampleUseCases":[{"title":"Competitive podcast landscape mapping","prompt":"I'm researching the competitive space around the 'How I Built This' podcast — can you pull the 15 most related shows with at least a moderate relevance band, limited to English active podcasts, and include the similarity signals so I can see what they share?"},{"title":"Brand-safe podcast ad targeting","prompt":"We want to advertise on shows similar to 'The Tim Ferriss Show' but only if they're brand-safe — pull related podcasts with suitability tier SAFE, active publishing status, and show me content similarity and shared sponsors in the results."},{"title":"Cross-promotion partner discovery","prompt":"I produce the 'Acquired' podcast and want to find strong cross-promotion partners — show me the top 20 most strongly related podcasts using the 'acquired' slug, include the basis signals, and filter to shows with a popularity percentile above 0.5."}],"resultDescription":"A ranked list of podcasts most related to the queried show, each with a numeric relevance score, a coarse band label (strong, moderate, or weak), and — when include=basis is passed — the supporting signals: content similarity, shared topics, shared guests (with names), same publisher, and shared sponsors. Results are paginated via opaque cursor.","failureModes":["Unknown podcast ID or slug returns 404","No related shows found returns empty list","Invalid suitability_tier enum value returns 400","Invalid language code returns 400 or empty results","min_score or min_popularity out of valid range returns 400","Expired or invalid pagination cursor returns 400 or unexpected results","Rate limit exceeded returns 429","Missing or invalid x402 payment returns 402"],"whenToPreferThis":"Use this endpoint when you need ranked, scored podcast recommendations relative to a specific known show — especially when you need explainability via content-similarity signals (topics, guests, sponsors). Prefer it over generic podcast search when the anchor show is known and you want semantic neighbors rather than keyword matches. It is particularly valuable for advertising research, competitive analysis, and cross-promotion discovery because it surfaces relationship signals beyond simple category tags.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:57:34.255Z","isFirstParty":false}