> ## Documentation Index
> Fetch the complete documentation index at: https://docs.particle.pro/llms.txt
> Use this file to discover all available pages before exploring further.

# particle_podcast_list_related_episodes

> Episodes from other shows that cover the same story or subject as an episode, best first — with a score, a band to branch on, and optionally the reasons.

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`](/mcp/tools/podcasts/podcast-search-transcripts). It is not a mention lookup — for every line *naming* an entity use [`particle_podcast_find_mentions`](/mcp/tools/podcasts/podcast-find-mentions). For shows like a show, use [`particle_podcast_list_related`](/mcp/tools/podcasts/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`](/mcp/tools/podcasts/podcast-get-episode) and `particle_podcast_search_transcripts`'s `episode_slug` filter; show slugs feed [`particle_podcast_resolve`](/mcp/tools/podcasts/podcast-resolve).

## Example

```text theme={"dark"}
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
```