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 news story. Each result carries a calibrated score and a band (strong / moderate / weak); pass include=basis to see the signals behind each match. Use published_within_days for 'who else covered this story this week'; pass same_podcast=true to admit the show's own episodes. Returns an empty page when the episode has no embedded content yet, and 404 when the episode is not found.
Request
- Base URL: https://api.particle.pro
- URL: https://api.particle.pro/v1/podcasts/episodes/{id}/related
- Auth: one of:
- API key in header X-API-Key
- HTTP bearer
Path parameters
Episode slug or ID
Query parameters
Results per page
Opaque pagination cursor from previous response
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.
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'.
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.
Response
OK
Changes
No recorded changes to this operation across all 2 revisions of this API.