> ## 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. Each show contributes at most two episodes, the same content republished on another feed is collapsed to one row, and feeds flagged as machine-made or syndication spam are excluded.

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
```