particle_podcast_list_suitability_category_publishers

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

Field	Type	Required	Default	Description
`code`	string	yes	—	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`.
`direction`	string	no	`most_exposed`	`most_exposed` ranks publishers by the share of their analyzed catalog exposed to the category; `least_exposed` inverts it.
`min_prevalence`	string	no	`INCIDENTAL`	Only count a podcast as exposed at or above this prevalence (default `INCIDENTAL` — any non-NONE). One of `INCIDENTAL`, `OCCASIONAL`, `FREQUENT`, `PERVASIVE`.
`treatment`	string	no	—	Only count exposures with this treatment — e.g. `GLAMORIZING` to surface the worst handling. One of `DOCUMENTARY`, `EDITORIAL`, `PROMOTIONAL`, `GLAMORIZING`.
`min_analyzed_podcasts`	integer (1–1000)	no	5	Exclude publishers with fewer analyzed podcasts.
`limit`	integer (1–50)	no	10	Publishers per page.
`cursor`	string	no	—	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
}

REST equivalent: GET /v1/podcasts/suitability/categories/{code}/publishers.
For cross-category tier composition, use particle_podcast_get_suitability_leaderboard.
For one podcast’s breakdown, use particle_podcast_resolve with include: ["suitability"].

Get started

Tools

particle_podcast_list_suitability_category_publishers

Inputs

Output

Example

​Inputs

​Output

​Example

​Related

Inputs

Output

Example

Related