List related podcasts

Returns the shows most related to a podcast, best first, each with a calibrated score, a coarse band (strong, moderate, weak) to branch on, and — with include=basis — the signals behind the pairing: content similarity of recent episodes, shared topics, shared guests (named), same publisher, and shared sponsors. Related sets are precomputed per show from its embedded transcripts, topic profile, guest roster, network, and advertisers, restricted to the show’s language, and refreshed as new episodes land; the endpoint is a fast page read. A show whose set has not been computed yet returns 200 with an empty data array, not 404. Use this for “shows like this show” — media planning around a known show, PR pitch lists, and agent traversal from one resolved slug to its neighbours. It is not a topic browser (use GET /v1/podcasts?topic_id=… for shows that cover a topic), not a guest lookup (GET /v1/podcasts/guests/{id}/podcasts lists where a guest has appeared), and not advertiser co-occurrence (GET /v1/podcasts/advertising/co-occurrence). Every result carries the related show’s slug, which every other podcast endpoint accepts as {id}; person slugs in the basis feed the guest endpoints and topic slugs feed topic_id. Identify the podcast by slug (e.g., ‘all-in’), internal ID, or numeric iTunes ID.

GET /v1/podcasts/{id}/related

cURL

cURL

curl -H "X-API-Key: $PARTICLE_API_KEY" \
  "https://api.particle.pro/v1/podcasts/{id}/related?limit=25"

200

{
  "data": [
    {
      "band": "strong",
      "podcast": {
        "id": "<string>",
        "title": "<string>",
        "best_rank": {
          "captured_at": "2023-11-07T05:31:56Z",
          "chart_type": "top_podcasts",
          "rank": 123,
          "source": "apple",
          "category_slug": "<string>",
          "country": "<string>"
        },
        "image_url": "<string>",
        "popularity": 123,
        "publisher": {
          "id": "<string>",
          "name": "<string>",
          "slug": "<string>"
        },
        "slug": "<string>"
      },
      "score": 123,
      "basis": {
        "same_publisher": true,
        "shared_category_count": 123,
        "shared_guest_count": 123,
        "shared_sponsor_count": 123,
        "content_similarity": 123,
        "shared_guests": [
          {
            "id": "<string>",
            "name": "<string>",
            "description": "<string>",
            "image_url": "<string>",
            "slug": "<string>"
          }
        ],
        "shared_topics": [
          {
            "id": "<string>",
            "name": "<string>",
            "slug": "<string>",
            "ancestry": "<string>",
            "ancestry_path": "<string>",
            "episode_count": 123
          }
        ],
        "topic_overlap": 123
      }
    }
  ],
  "has_more": true,
  "cursor": "<string>"
}

Authorizations

ApiKeyHeaderBearerAuth

X-API-Key · string · header · required

Pass your API key in the X-API-Key header (recommended).

Path Parameters

id · string · required

Podcast slug (e.g., 'all-in'), internal ID, or numeric iTunes ID

Query Parameters

limit · integer<int64> · default: 25

Results per page

Required range: 1 <= x <= 100

cursor · string

Opaque pagination cursor from previous response

include · enum<string>[] | null

Optional response sections. Pass include=basis to attach, for every result, the signals that make the two shows related: content similarity, shared topics, shared guests (with names), same publisher, shared sponsors.

Available options: basis

min_score · number<double>

Only results with a fused score at or above this value. Omit (or 0) to return every stored neighbour; the band field is the recommended way to filter by strength.

Required range: 0 <= x <= 1

language · string

Only shows in this language (ISO 639-1 code, e.g. 'en', 'es'; a region suffix such as 'fr-CA' is reduced to the language). Related sets are built within the source show's language, so this mostly matters for shows with a mixed catalogue.

publishing_status · enum<string>

Only shows that have released an episode in the last 90 days (active) or have not (dormant). Shows with no known episode date match neither.

Available options: active, dormant

suitability_tier · enum<string>

Only shows whose latest brand-suitability assessment is this tier. Shows never assessed are excluded when this is set.

Available options: SAFE, LIMITED, SENSITIVE, UNSAFE

min_popularity · number<double>

Only shows at or above this popularity percentile (0-1]. A floor above 0 excludes shows that do not chart; 0 (or omitting it) applies no floor.

Required range: 0 <= x <= 1

exclude_same_publisher · boolean

Drop shows from the source show's own publisher — 'shows like mine that I do not already own'.

Response

200

application/json

OK

data · object[] | null · required

List of results

Show child attributes

has_more · boolean · required

Whether more results exist

cursor · string

Pass to next request for more results