curl -H "X-API-Key: $PARTICLE_API_KEY" \
"https://api.particle.pro/v1/podcasts/{id}/recommendations/sponsors?limit=25"{
"data": [
{
"band": "strong",
"score": 123,
"shared_show_count": 123,
"sponsor": {
"id": "<string>",
"name": "<string>",
"company": {
"id": "<string>",
"name": "<string>",
"description": "<string>",
"domain": "<string>",
"image_mode": "AUTOMATIC",
"image_url": "<string>",
"slug": "<string>",
"ticker": "<string>"
}
},
"total_ads": 123,
"last_ad_at": "2023-11-07T05:31:56Z",
"via": [
{
"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>"
}
]
}
],
"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 sponsors a podcast could pitch
Returns advertisers that run on the podcast’s related shows but not on this one, ranked by how related those venues are, how much the sponsor buys there, and how recently — a prospecting list for a show selling its own inventory (‘who buys shows like mine’), not a prediction. Each row carries the sponsor (with its linked company, the path to people to contact via GET /v1/companies//people), a score, a band, how many related shows run it, its ad count across them, the date of its most recent ad, and with include=via which shows. active_since keeps only sponsors still buying after a date. Related sets are precomputed (GET /v1/podcasts//related); a show whose set has not been computed yet gets an empty page. For who sponsors THIS show use GET /v1/podcasts//advertising; for a sponsor’s full footprint use GET /v1/podcasts/advertising/sponsors//podcasts.
curl -H "X-API-Key: $PARTICLE_API_KEY" \
"https://api.particle.pro/v1/podcasts/{id}/recommendations/sponsors?limit=25"{
"data": [
{
"band": "strong",
"score": 123,
"shared_show_count": 123,
"sponsor": {
"id": "<string>",
"name": "<string>",
"company": {
"id": "<string>",
"name": "<string>",
"description": "<string>",
"domain": "<string>",
"image_mode": "AUTOMATIC",
"image_url": "<string>",
"slug": "<string>",
"ticker": "<string>"
}
},
"total_ads": 123,
"last_ad_at": "2023-11-07T05:31:56Z",
"via": [
{
"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>"
}
]
}
],
"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
Podcast slug (e.g., 'all-in'), internal ID, or numeric iTunes ID
Query Parameters
Results per page
1 <= x <= 100Opaque pagination cursor from previous response
Optional response sections. Pass include=via to attach, for each recommended sponsor, the related shows that run it — the peer set to cite in a pitch.
via Only recommendations with a score at or above this value. Omit (or 0) for every recommendation; the band field is the recommended way to filter by strength.
0 <= x <= 1Only sponsors whose most recent ad across the related shows was published on or after this ISO 8601 date or date-time — the 'still buying' filter.
"2026-01-01T00:00:00Z"
Was this page helpful?