List guests a podcast could plausibly book
Returns people who have guested on the podcast's related shows but never on this one, ranked by how related those venues are and how many distinct publishers among them chose the person — a booking pipeline, not a prediction. Recurring on any one show does not count, and a publisher's sibling feeds count once, so an outlet's own correspondents do not outrank guests several independent shows chose. Guests who appear everywhere (circuit regulars) are excluded, since recommending them says nothing about this show. Each row carries the person, a score, a band, how many related shows booked them, and with include=via which shows. For the show's existing roster use GET /v1/podcasts/{id}/guests; for shows like this one use GET /v1/podcasts/{id}/related.
Request
- Base URL: https://api.particle.pro
- URL: https://api.particle.pro/v1/podcasts/{id}/recommendations/guests
- Auth: one of:
- API key in header X-API-Key
- HTTP bearer
Path parameters
Podcast slug (e.g., 'all-in'), internal ID, or numeric iTunes ID
Query parameters
Results per page
Opaque pagination cursor from previous response
Optional response sections. Pass include=via to attach, for each recommended guest, the related shows that booked them.
Response
OK
Changes
No recorded changes to this operation across all 2 revisions of this API.