curl -H "X-API-Key: $PARTICLE_API_KEY" \
"https://api.particle.pro/v1/podcasts/suitability/categories/{code}/publishers?limit=25&direction=most_exposed&min_prevalence=INCIDENTAL&min_analyzed_podcasts=5"{
"data": [
{
"category_code": "<string>",
"coverage": {
"analyzed_coverage": 123,
"analyzed_podcasts": 123,
"quality": "<string>",
"total_podcasts": 123
},
"description": "<string>",
"exposed_count": 123,
"exposure_share": 123,
"high_risk_count": 123,
"prevalence_breakdown": {
"frequent": 123,
"incidental": 123,
"none": 123,
"occasional": 123,
"pervasive": 123
},
"publisher": {
"id": "<string>",
"name": "<string>",
"slug": "<string>"
},
"rank": 123,
"treatment_breakdown": {
"glamorizing": 123,
"promotional": 123
},
"example_podcasts": [
{
"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"
}{
"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"
}Get publishers ranked by exposure to a brand-safety category
For one of the 12 GARM brand-safety categories, returns a paginated ranking of podcast publishers by exposure across their catalog. The killer view for regulated brands: an alcohol advertiser pivots on illegal_drugs_alcohol_tobacco and immediately sees which publishers carry the highest catalog-level exposure (and at what prevalence + treatment); a family brand pivots on adult_sexual or hate_speech_aggression to build an exclusion list. min_prevalence + treatment narrow what counts as ‘exposed’. Each row includes prevalence + treatment breakdowns and up to three example podcasts in the publisher’s catalog that exhibit the highest exposure.
curl -H "X-API-Key: $PARTICLE_API_KEY" \
"https://api.particle.pro/v1/podcasts/suitability/categories/{code}/publishers?limit=25&direction=most_exposed&min_prevalence=INCIDENTAL&min_analyzed_podcasts=5"{
"data": [
{
"category_code": "<string>",
"coverage": {
"analyzed_coverage": 123,
"analyzed_podcasts": 123,
"quality": "<string>",
"total_podcasts": 123
},
"description": "<string>",
"exposed_count": 123,
"exposure_share": 123,
"high_risk_count": 123,
"prevalence_breakdown": {
"frequent": 123,
"incidental": 123,
"none": 123,
"occasional": 123,
"pervasive": 123
},
"publisher": {
"id": "<string>",
"name": "<string>",
"slug": "<string>"
},
"rank": 123,
"treatment_breakdown": {
"glamorizing": 123,
"promotional": 123
},
"example_podcasts": [
{
"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"
}{
"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
The GARM brand-safety category code to pivot on (IAB Tech Lab Content Taxonomy 3.x). One of: adult_sexual, arms_ammunition, crime_harmful_acts, death_injury_military_conflict, online_piracy, hate_speech_aggression, obscenity_profanity, illegal_drugs_alcohol_tobacco, spam_harmful, terrorism, debated_social_issues, misinformation.
adult_sexual, arms_ammunition, crime_harmful_acts, death_injury_military_conflict, online_piracy, hate_speech_aggression, obscenity_profanity, illegal_drugs_alcohol_tobacco, spam_harmful, terrorism, debated_social_issues, misinformation Query Parameters
Results per page
1 <= x <= 100Opaque pagination cursor from previous response
Sort order. most_exposed ranks publishers whose analyzed catalog has the highest share of exposure to the category (exposure_share, desc), with absolute exposed_count and publisher_id as deterministic tiebreakers. least_exposed inverts the share ordering. Use min_analyzed_podcasts to guard against tiny catalogs dominating the share-based ranking.
most_exposed, least_exposed Only count a podcast as 'exposed' when its prevalence in the category is at or above this threshold. Defaults to INCIDENTAL — any non-NONE prevalence.
INCIDENTAL, OCCASIONAL, FREQUENT, PERVASIVE When set, only count exposures whose treatment equals this value. Useful for surfacing publishers with PROMOTIONAL or GLAMORIZING treatment in a regulated category.
DOCUMENTARY, EDITORIAL, PROMOTIONAL, GLAMORIZING Exclude publishers with fewer than this many analyzed podcasts.
1 <= x <= 1000Was this page helpful?