curl -H "X-API-Key: $PARTICLE_API_KEY" \
"https://api.particle.pro/v1/podcasts/episodes/{id}/related?limit=25"{
"data": [
{
"band": "strong",
"episode": {
"id": "<string>",
"title": "<string>",
"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>"
},
"published_at": "2023-11-07T05:31:56Z",
"slug": "<string>"
},
"score": 123,
"basis": {
"shared_entity_count": 123,
"shared_guest_count": 123,
"shared_story_count": 123,
"shared_topic_count": 123,
"content_similarity": 123,
"days_apart": 123,
"shared_entities": [
{
"id": "<string>",
"name": "<string>"
}
]
}
}
],
"has_more": true,
"cursor": "<string>"
}{
"detail": "Property foo is required but is missing.",
"error_code": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
],
"instance": "https://example.com/error-log/abc123",
"resolve": {
"message": "<string>",
"action": "<string>",
"endpoint": "<string>",
"method": "<string>",
"url": "<string>"
},
"status": 400,
"title": "Bad Request",
"type": "https://example.com/errors/example"
}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.
curl -H "X-API-Key: $PARTICLE_API_KEY" \
"https://api.particle.pro/v1/podcasts/episodes/{id}/related?limit=25"{
"data": [
{
"band": "strong",
"episode": {
"id": "<string>",
"title": "<string>",
"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>"
},
"published_at": "2023-11-07T05:31:56Z",
"slug": "<string>"
},
"score": 123,
"basis": {
"shared_entity_count": 123,
"shared_guest_count": 123,
"shared_story_count": 123,
"shared_topic_count": 123,
"content_similarity": 123,
"days_apart": 123,
"shared_entities": [
{
"id": "<string>",
"name": "<string>"
}
]
}
}
],
"has_more": true,
"cursor": "<string>"
}{
"detail": "Property foo is required but is missing.",
"error_code": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
],
"instance": "https://example.com/error-log/abc123",
"resolve": {
"message": "<string>",
"action": "<string>",
"endpoint": "<string>",
"method": "<string>",
"url": "<string>"
},
"status": 400,
"title": "Bad Request",
"type": "https://example.com/errors/example"
}Authorizations
Pass your API key in the X-API-Key header (recommended).
Path Parameters
Episode slug or ID
Query Parameters
Results per page
1 <= x <= 100Opaque 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'.
0 <= x <= 3650Optional 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.
basis Was this page helpful?