curl -H "X-API-Key: $PARTICLE_API_KEY" \
"https://api.particle.pro/v1/companies/{id}/podcast/advertising/podcasts?limit=25"{
"data": [
{
"ad_count": 123,
"episode_count": 123,
"podcast": {
"id": "<string>",
"title": "<string>",
"best_rank": {
"captured_at": "2023-11-07T05:31:56Z",
"chart_type": "top_podcasts",
"rank": 123,
"category_slug": "<string>",
"country": "<string>"
},
"image_url": "<string>",
"popularity": 123,
"publisher": {
"id": "<string>",
"name": "<string>",
"slug": "<string>"
},
"slug": "<string>"
},
"preview_segments": [
{
"segment": {
"duration_seconds": 123,
"end_seconds": 123,
"id": "<string>",
"number": 123,
"start_seconds": 123,
"title": "<string>",
"type": "<string>",
"audio_url": "<string>",
"description": "<string>",
"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,
"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>"
},
"read_type": "<string>",
"summary": "<string>"
},
"sponsors": [
{
"id": "<string>",
"name": "<string>",
"company": {
"id": "<string>",
"name": "<string>",
"description": "<string>",
"domain": "<string>",
"image_url": "<string>",
"slug": "<string>",
"ticker": "<string>"
}
}
]
}
],
"sponsors": [
{
"ad_count": 123,
"episode_count": 123,
"sponsor": {
"id": "<string>",
"name": "<string>",
"company": {
"id": "<string>",
"name": "<string>",
"description": "<string>",
"domain": "<string>",
"image_url": "<string>",
"slug": "<string>",
"ticker": "<string>"
}
},
"last_seen_at": "2023-11-07T05:31:56Z"
}
],
"last_seen_at": "2023-11-07T05:31:56Z"
}
],
"has_more": true,
"sponsors": [
{
"ad_count": 123,
"episode_count": 123,
"sponsor": {
"id": "<string>",
"name": "<string>",
"company": {
"id": "<string>",
"name": "<string>",
"description": "<string>",
"domain": "<string>",
"image_url": "<string>",
"slug": "<string>",
"ticker": "<string>"
}
},
"last_seen_at": "2023-11-07T05:31:56Z"
}
],
"cursor": "<string>"
}{
"detail": "<string>",
"error_code": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
],
"instance": "<string>",
"resolve": {
"message": "<string>",
"action": "<string>",
"endpoint": "<string>",
"method": "<string>",
"url": "<string>"
},
"status": 123,
"title": "<string>",
"type": "about:blank"
}List podcasts carrying company advertising
Returns podcasts ranked by exact company-linked ad count, with company-wide sponsor filters, per-podcast sponsor breakdowns, recent preview segments, and cursor pagination.
curl -H "X-API-Key: $PARTICLE_API_KEY" \
"https://api.particle.pro/v1/companies/{id}/podcast/advertising/podcasts?limit=25"{
"data": [
{
"ad_count": 123,
"episode_count": 123,
"podcast": {
"id": "<string>",
"title": "<string>",
"best_rank": {
"captured_at": "2023-11-07T05:31:56Z",
"chart_type": "top_podcasts",
"rank": 123,
"category_slug": "<string>",
"country": "<string>"
},
"image_url": "<string>",
"popularity": 123,
"publisher": {
"id": "<string>",
"name": "<string>",
"slug": "<string>"
},
"slug": "<string>"
},
"preview_segments": [
{
"segment": {
"duration_seconds": 123,
"end_seconds": 123,
"id": "<string>",
"number": 123,
"start_seconds": 123,
"title": "<string>",
"type": "<string>",
"audio_url": "<string>",
"description": "<string>",
"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,
"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>"
},
"read_type": "<string>",
"summary": "<string>"
},
"sponsors": [
{
"id": "<string>",
"name": "<string>",
"company": {
"id": "<string>",
"name": "<string>",
"description": "<string>",
"domain": "<string>",
"image_url": "<string>",
"slug": "<string>",
"ticker": "<string>"
}
}
]
}
],
"sponsors": [
{
"ad_count": 123,
"episode_count": 123,
"sponsor": {
"id": "<string>",
"name": "<string>",
"company": {
"id": "<string>",
"name": "<string>",
"description": "<string>",
"domain": "<string>",
"image_url": "<string>",
"slug": "<string>",
"ticker": "<string>"
}
},
"last_seen_at": "2023-11-07T05:31:56Z"
}
],
"last_seen_at": "2023-11-07T05:31:56Z"
}
],
"has_more": true,
"sponsors": [
{
"ad_count": 123,
"episode_count": 123,
"sponsor": {
"id": "<string>",
"name": "<string>",
"company": {
"id": "<string>",
"name": "<string>",
"description": "<string>",
"domain": "<string>",
"image_url": "<string>",
"slug": "<string>",
"ticker": "<string>"
}
},
"last_seen_at": "2023-11-07T05:31:56Z"
}
],
"cursor": "<string>"
}{
"detail": "<string>",
"error_code": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
],
"instance": "<string>",
"resolve": {
"message": "<string>",
"action": "<string>",
"endpoint": "<string>",
"method": "<string>",
"url": "<string>"
},
"status": 123,
"title": "<string>",
"type": "about:blank"
}Authorizations
Pass your API key in the X-API-Key header (recommended).
Path Parameters
Company slug (e.g. 'apple'), domain (e.g. 'apple.com'), or ID
Query Parameters
Results per page
1 <= x <= 100Opaque pagination cursor from previous response
Optional sponsor ID. Keeps the company constraint while narrowing rows to this sponsor identity.
Only include ads from episodes published on or after this ISO 8601 date or date-time
"2025-01-01T00:00:00Z"
Only include ads before this ISO 8601 date-time. A bare date includes that whole UTC day.
"2026-01-01"
Response
OK
Podcasts ranked by company ad count
Show child attributes
Show child attributes
Whether more ranked podcasts exist
Complete date-scoped sponsor roster for this company
Show child attributes
Show child attributes
Pass to the next request for more podcasts
Was this page helpful?