Skip to main content
GET
/
v1
/
podcasts
/
suitability
/
categories
/
{code}
/
publishers
cURL
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>",
          "image_url": "<string>",
          "slug": "<string>"
        }
      ]
    }
  ],
  "has_more": true,
  "cursor": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.particle.pro/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
X-API-Key
string
header
required

Pass your API key in the X-API-Key header (recommended).

Path Parameters

​
code
enum<string>
required

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.

Available options:
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

​
limit
integer<int64>
default:25

Results per page

Required range: 1 <= x <= 100
​
cursor
string

Opaque pagination cursor from previous response

​
direction
enum<string>
default:most_exposed

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.

Available options:
most_exposed,
least_exposed
​
min_prevalence
enum<string>
default:INCIDENTAL

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.

Available options:
INCIDENTAL,
OCCASIONAL,
FREQUENT,
PERVASIVE
​
treatment
enum<string>

When set, only count exposures whose treatment equals this value. Useful for surfacing publishers with PROMOTIONAL or GLAMORIZING treatment in a regulated category.

Available options:
DOCUMENTARY,
EDITORIAL,
PROMOTIONAL,
GLAMORIZING
​
min_analyzed_podcasts
integer<int64>
default:5

Exclude publishers with fewer than this many analyzed podcasts.

Required range: 1 <= x <= 1000

Response

OK

​
data
object[] | null
required

List of results

​
has_more
boolean
required

Whether more results exist

​
cursor
string

Pass to next request for more results