particle_podcast_get_suitability_leaderboard

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.

Rank podcast publishers by IAB/GARM brand-suitability composition across their analyzed catalogs: safest (highest SAFE share), riskiest (highest UNSAFE share), most_placeable (highest SAFE+LIMITED share — the broadly buyable slice), or most_analyzed (coverage). Publisher slugs feed particle_podcast_get_publisher (use include: ["suitability"] there for one publisher’s full profile). For exposure to one specific GARM category, use particle_podcast_list_suitability_category_publishers. A single podcast’s breakdown is particle_podcast_resolve with include: ["suitability"].

Inputs

Field	Type	Required	Default	Description
`metric`	string	no	`safest`	How to rank publishers: `safest` (SAFE share), `riskiest` (UNSAFE share), `most_placeable` (combined SAFE+LIMITED share), `most_analyzed` (absolute analyzed-podcast count).
`min_analyzed_podcasts`	integer (1–1000)	no	5	Exclude publishers with fewer analyzed podcasts (guards against tiny catalogs dominating share metrics).
`limit`	integer (1–50)	no	10	Publishers per page.
`cursor`	string	no	—	Opaque pagination cursor.

Output

A markdown document with ## Publisher suitability leaderboard — <metric> (N) and a flat bullet list — one bullet per ranked publisher, formatted #<rank> Publisher name (publisher-slug) — N analyzed; SAFE n, LIMITED n, SENSITIVE n, UNSAFE n; metric X.XX. When more pages exist, a horizontal rule and a **Cursor:** <value> line are appended. Sample (metric="safest", limit=3):

## Publisher suitability leaderboard — safest (3)

- #1 BBC Radio 4 (bbc-radio-4) — 22 analyzed; SAFE 20, LIMITED 2, SENSITIVE 0, UNSAFE 0; metric 0.91
- #2 NPR (npr) — 41 analyzed; SAFE 35, LIMITED 5, SENSITIVE 1, UNSAFE 0; metric 0.85
- #3 Goalhanger (goalhanger) — 14 analyzed; SAFE 11, LIMITED 3, SENSITIVE 0, UNSAFE 0; metric 0.79

The parenthesized publisher-slug feeds particle_podcast_get_publisher.

Example

Agent calls: particle_podcast_get_suitability_leaderboard {
  "metric": "most_placeable",
  "min_analyzed_podcasts": 10,
  "limit": 25
}

REST equivalent: GET /v1/podcasts/suitability/publishers/leaderboard.
For exposure to one specific GARM category, use particle_podcast_list_suitability_category_publishers.
For one publisher’s full profile, use particle_podcast_get_publisher with include: ["suitability"].

Get started

Tools

particle_podcast_get_suitability_leaderboard

Inputs

Output

Example

​Inputs

​Output

​Example

​Related

Inputs

Output

Example

Related