{"uid":"cap_L-wJMZLM0xClW7JMUJqur","slug":"particle-pro-list-related-episodes-0e12cdfb","name":"Particle Pro – List Related Episodes","description":"List related episodes. Returns episodes from other shows that cover the same story or subject as this episode, best first: a live nearest-neighbour search over episode content, reranked on shared salient entities, shared topics and a shared","url":"https://api.particle.pro/v1/podcasts/episodes/: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":"Episode slug or 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 episodes related: content similarity, shared entities (with names), shared topics, a shared news story, shared guests, and days apart."},"same_podcast":{"type":"boolean","description":"Admit episodes of the same show. Off by default: a show's own episodes are its episode list (GET /v1/podcasts/{id}/episodes), not its related content."},"published_within_days":{"type":"integer","format":"int64","description":"Only episodes published within this many days of the query episode, on either side. Omit (or 0) for no window. Use a short window (7–30) for 'who else covered this story'."}}}},"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_Dbs0Qo9Acr-N86Mcte2Al","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 episodes from other podcasts that cover the same story or subject as a given episode, ranked by content similarity, shared entities, shared topics, and shared news stories.","exampleAgentPrompt":"Find me other podcast episodes that covered the same story as episode 'nvidia-earnings-q4-2024' on Particle Pro — limit to episodes published within 14 days of it and include the basis signals so I can see which entities and topics they share.","exampleUseCases":[{"title":"Cross-show news story tracking","prompt":"I'm analyzing coverage of the OpenAI GPT-5 announcement. Find me other podcast episodes that covered the same story as episode 'openai-gpt5-launch-deep-dive', published within 7 days of it, and show me the shared entities and topics for each result."},{"title":"Competitive podcast content research","prompt":"For the episode with ID 'fed-rate-decision-march-2025', show me up to 20 related episodes from other shows that covered the same subject — I want to see which other podcasts reported on the same Fed decision."},{"title":"Guest and topic overlap discovery","prompt":"Can you pull related episodes for 'elon-musk-x-interview-jan2025' and include the basis breakdown so I can see which shows had the same guest or covered the same topics?"}],"resultDescription":"A paginated list of related podcast episodes from other shows, ordered best-first by a combined relevance score. Each result includes episode metadata (title, show, publish date). When include=basis is passed, each result also includes: content similarity score, shared named entities with their names, shared topics, any shared news story, shared guests, and the number of days apart the two episodes were published.","failureModes":["Episode ID not found — 404 if the slug or ID does not exist","No related episodes found — empty results list if the episode has insufficient content signals","Pagination cursor invalid — error if a stale or malformed cursor is passed","Rate limiting or payment failure — 402 if the x402 payment is not provided or insufficient","published_within_days too narrow — may return zero results if the time window excludes all candidates"],"whenToPreferThis":"Use this endpoint when you need cross-show podcast discovery — specifically to find what other podcasts covered the same story, topic, or guest as a known episode. It is preferable over a general keyword podcast search when you want semantically ranked, entity-aware results grounded in a specific episode's content. The published_within_days filter makes it particularly useful for 'who else covered this breaking story' use cases within a short news cycle window.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:57:23.612Z","isFirstParty":false}