Podcast Brand Suitability
tier:premium

Get a cross-publisher suitability leaderboard

Returns a paginated, ranked list of podcast publishers by IAB/GARM brand-suitability composition. Pick a metric (safest, riskiest, most_placeable, most_analyzed) to choose how the ranking is constructed. min_analyzed_podcasts guards against tiny catalogs dominating share-based metrics. The ranking reflects each publisher's current catalog composition; paginate the audit history per show via GET /v1/podcasts/{id}/suitability?include=history when you need point-in-time analysis. Each row carries the full tier_breakdown (counts + shares) plus the metric_value the row was ranked by.

get/v1/podcasts/suitability/publishers/leaderboard

Request

  • Base URL: https://api.particle.pro
  • URL: https://api.particle.pro/v1/podcasts/suitability/publishers/leaderboard
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer

Query parameters

limitinteger

Results per page

cursorstring

Opaque pagination cursor from previous response

metric'safest' | 'riskiest' | 'most_placeable' | 'most_analyzed'

How to rank publishers. safest sorts by SAFE share of the analyzed catalog (desc); riskiest sorts by UNSAFE share (desc); most_placeable sorts by combined SAFE + LIMITED share (desc) — the 'broadly buyable' slice; most_analyzed sorts by absolute analyzed_podcasts count (desc).

min_analyzed_podcastsinteger

Exclude publishers with fewer than this many analyzed podcasts. Guards against tiny catalogs dominating share-based metrics.

Response

OK

cursorstring

Pass to next request for more results

has_moreboolean required

Whether more results exist

Changes

No recorded changes to this operation across all 2 revisions of this API.