curl -H "X-API-Key: $PARTICLE_API_KEY" \
"https://api.particle.pro/v1/companies/{id}/podcast/advertising/podcasts?limit=24&include_sponsors=true&include_previews=true&preview_limit=3"{
"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,
"source": "apple",
"category_slug": "<string>",
"country": "<string>"
},
"bias": "<string>",
"image_url": "<string>",
"popularity": 123,
"publisher": {
"id": "<string>",
"name": "<string>",
"slug": "<string>"
},
"slug": "<string>",
"suitability_tier": "<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>",
"end_line": 123,
"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>"
},
"bias": "<string>",
"image_url": "<string>",
"popularity": 123,
"publisher": {
"id": "<string>",
"name": "<string>",
"slug": "<string>"
},
"slug": "<string>",
"suitability_tier": "<string>"
},
"published_at": "2023-11-07T05:31:56Z",
"slug": "<string>",
"web_url": "<string>"
},
"read_type": "<string>",
"start_line": 123,
"summary": "<string>",
"url": "<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>",
"facets": {
"podcast_count": 123,
"podcasts": [
{
"ad_count": 123,
"podcast": {
"id": "<string>",
"title": "<string>",
"publisher": {
"id": "<string>",
"name": "<string>",
"slug": "<string>"
},
"slug": "<string>"
}
}
],
"publisher_count": 123,
"publishers": [
{
"ad_count": 123,
"podcast_count": 123,
"publisher": {
"id": "<string>",
"name": "<string>",
"slug": "<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"
}{
"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"
}Companies
List podcasts carrying company advertising
Returns podcasts ranked by exact company-linked ad count, then episode count, with company-wide sponsor filters, per-podcast sponsor breakdowns, recent preview segments, and cursor pagination. Counts cover every ad attributed to the company across all of its sponsors (brand names, spellings, sub-brands); each sponsors entry counts only that sponsor’s ads naming the company, so it is at most the sponsor’s count for the show in GET /v1/podcasts/advertising/sponsors//podcasts, which counts all of one sponsor’s ads. An ad is one detected read, so a break reading two products counts two ads and one placement.
GET
/
v1
/
companies
/
{id}
/
podcast
/
advertising
/
podcasts
curl -H "X-API-Key: $PARTICLE_API_KEY" \
"https://api.particle.pro/v1/companies/{id}/podcast/advertising/podcasts?limit=24&include_sponsors=true&include_previews=true&preview_limit=3"{
"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,
"source": "apple",
"category_slug": "<string>",
"country": "<string>"
},
"bias": "<string>",
"image_url": "<string>",
"popularity": 123,
"publisher": {
"id": "<string>",
"name": "<string>",
"slug": "<string>"
},
"slug": "<string>",
"suitability_tier": "<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>",
"end_line": 123,
"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>"
},
"bias": "<string>",
"image_url": "<string>",
"popularity": 123,
"publisher": {
"id": "<string>",
"name": "<string>",
"slug": "<string>"
},
"slug": "<string>",
"suitability_tier": "<string>"
},
"published_at": "2023-11-07T05:31:56Z",
"slug": "<string>",
"web_url": "<string>"
},
"read_type": "<string>",
"start_line": 123,
"summary": "<string>",
"url": "<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>",
"facets": {
"podcast_count": 123,
"podcasts": [
{
"ad_count": 123,
"podcast": {
"id": "<string>",
"title": "<string>",
"publisher": {
"id": "<string>",
"name": "<string>",
"slug": "<string>"
},
"slug": "<string>"
}
}
],
"publisher_count": 123,
"publishers": [
{
"ad_count": 123,
"podcast_count": 123,
"publisher": {
"id": "<string>",
"name": "<string>",
"slug": "<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"
}{
"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"
}Prefer the terminal? This endpoint is also a command in the Particle CLI: pick Particle CLI in the request example’s language menu. Install the Particle CLI.
Authorizations
ApiKeyHeaderBearerAuth
Query Parameters
Response
OK
Was this page helpful?