Skip to main content
In the podcast_suitability category, which is opt-in — it is callable by name on any connection, but only advertised on tools/list when selected via ?include=podcast_suitability. See Tool sets & discovery.
Which publishers’ catalogs are most (or least) exposed to one IAB/GARM brand-safety category — e.g. misinformation, debated social issues, illegal drugs/alcohol/tobacco. Tighten with min_prevalence (how often the content appears) and treatment (how it’s handled — GLAMORIZING is the worst). Each entry carries example podcast slugs anchoring the shares to recognizable shows. Publisher slugs feed particle_podcast_get_publisher; for cross-category tier composition use particle_podcast_get_suitability_leaderboard.

​
Inputs

FieldTypeRequiredDefaultDescription
codestringyes—GARM brand-safety category code to pivot on. 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.
directionstringnomost_exposedmost_exposed ranks publishers by the share of their analyzed catalog exposed to the category; least_exposed inverts it.
min_prevalencestringnoINCIDENTALOnly count a podcast as exposed at or above this prevalence (default INCIDENTAL — any non-NONE). One of INCIDENTAL, OCCASIONAL, FREQUENT, PERVASIVE.
treatmentstringno—Only count exposures with this treatment — e.g. GLAMORIZING to surface the worst handling. One of DOCUMENTARY, EDITORIAL, PROMOTIONAL, GLAMORIZING.
min_analyzed_podcastsinteger (1–1000)no5Exclude publishers with fewer analyzed podcasts.
limitinteger (1–50)no10Publishers per page.
cursorstringno—Opaque pagination cursor.

​
Output

A markdown document with ## Publisher exposure to <code> (N) and a flat bullet list — one bullet per ranked publisher, formatted #<rank> Publisher name (publisher-slug) — N of M analyzed exposed (X%), K high-risk — e.g. slug-a, slug-b. The example podcast slugs anchor the shares to recognizable shows and round-trip into the podcast tools. When more pages exist, a horizontal rule and a **Cursor:** <value> line are appended. Sample (code="misinformation", limit=3): 
## Publisher exposure to misinformation (3)

- #1 Infowars Network (infowars-network) — 6 of 7 analyzed exposed (86%), 5 high-risk — e.g. the-alex-jones-show, war-room
- #2 The Daily Wire (the-daily-wire) — 4 of 11 analyzed exposed (36%), 2 high-risk — e.g. the-ben-shapiro-show
- #3 iHeartPodcasts (iheartpodcasts) — 18 of 260 analyzed exposed (7%), 6 high-risk — e.g. stuff-they-dont-want-you-to-know
The parenthesized publisher-slug feeds particle_podcast_get_publisher.

​
Example

Agent calls: particle_podcast_list_suitability_category_publishers {
  "code": "illegal_drugs_alcohol_tobacco",
  "min_prevalence": "OCCASIONAL",
  "treatment": "GLAMORIZING",
  "limit": 25
}