particle_podcast_list_related_episodes

List episodes elsewhere that cover the same story or subject as a given episode — “who else discussed this”. Each result carries the episode’s slug and show, a score in (0, 1), and a coarse band (strong / moderate / weak). Branch on the band rather than on raw score thresholds. Add include: ["basis"] to see why each pair is related: content similarity of the two episodes, the named entities they share, shared topics, a shared news story, shared guests, and how many days apart they were published. Use published_within_days for news-style questions (“who covered this in the same fortnight”) and same_podcast: true to include the source show’s own episodes, which are excluded by default. Results are computed live from the episode’s content centroid and reranked on the structured signals, then cached for a day, so the first call for an episode is slower than repeats. An episode with no embedded content yet returns an empty list, not an error. This is not a topic search — for dialogue about a subject use particle_podcast_search_transcripts. It is not a mention lookup — for every line naming an entity use particle_podcast_find_mentions. For shows like a show, use particle_podcast_list_related.

Inputs

Field	Type	Required	Default	Description
`episode_slug`	string	yes	—	The source episode — slug or ID from `particle_podcast_list_episodes`, `particle_podcast_get_episode`, or a search result.
`include`	array of enums	no	`[]`	`basis` attaches the signals behind each result.
`same_podcast`	boolean	no	`false`	Include the source show’s own episodes.
`published_within_days`	integer	no	—	Only episodes published within this many days of the source episode.
`limit`	integer (1–50)	no	10	Results per page.
`cursor`	string	no	—	Opaque pagination cursor.

Output

## Related episodes for <episode_slug> (N) followed by one numbered line per episode — **Episode title** (episode-slug) — Show title (podcast-slug) · 2026-09-01 — score 0.83, strong — and, with include: ["basis"], an indented reason line such as content similarity 0.71; shared entities: Federal Reserve, Jerome Powell; same story; 2 days apart. When more pages exist a trailing line More results: pass cursor=… is appended, carrying the cursor to pass back. An empty set carries a one-line note instead of an error. Slugs are edges: every episode slug feeds particle_podcast_get_episode and particle_podcast_search_transcripts’s episode_slug filter; show slugs feed particle_podcast_resolve.

Example

Agent calls: particle_podcast_list_related_episodes {
  "episode_slug": "the-fed-holds-rates-steady",
  "include": ["basis"],
  "published_within_days": 14,
  "limit": 3
}

Server returns:
## Related episodes for the-fed-holds-rates-steady (2)

1. **Powell's pause, explained** (`powells-pause-explained`) — Odd Lots (`odd-lots`) · 2026-09-02 — score 0.83, strong
   content similarity 0.71; shared entities: Federal Reserve, Jerome Powell; same story; 2 days apart
2. **What the rate decision means for housing** (`rate-decision-housing`) — Marketplace (`marketplace`) · 2026-09-03 — score 0.64, moderate
   content similarity 0.58; shared entities: Federal Reserve; 1 day apart

Get started

Tools

particle_podcast_list_related_episodes

Inputs

Output

Example

​Inputs

​Output

​Example

Inputs

Output

Example