Skip to main content
GET
/
v1
/
podcasts
/
publishers
/
{id}
/
suitability
cURL
curl -H "X-API-Key: $PARTICLE_API_KEY" \
  "https://api.particle.pro/v1/podcasts/publishers/{id}/suitability"
{
  "category_breakdown": [
    {
      "code": "<string>",
      "description": "<string>",
      "exposure_share": 123,
      "frequent": 123,
      "glamorizing": 123,
      "high_risk_count": 123,
      "incidental": 123,
      "none": 123,
      "occasional": 123,
      "pervasive": 123,
      "promotional": 123
    }
  ],
  "confidence_breakdown": {
    "high": 123,
    "low": 123,
    "medium": 123
  },
  "coverage": {
    "analyzed_coverage": 123,
    "analyzed_podcasts": 123,
    "quality": "<string>",
    "total_podcasts": 123
  },
  "publisher": {
    "id": "<string>",
    "name": "<string>",
    "slug": "<string>"
  },
  "tier_breakdown": {
    "limited": 123,
    "limited_share": 123,
    "placeable_share": 123,
    "safe": 123,
    "safe_share": 123,
    "sensitive": 123,
    "sensitive_share": 123,
    "unsafe": 123,
    "unsafe_share": 123
  },
  "last_evaluated_at": "2023-11-07T05:31:56Z",
  "top_concerns": [
    {
      "code": "<string>",
      "description": "<string>",
      "exposure_share": 123,
      "high_risk_count": 123
    }
  ]
}

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

id
string
required

Podcast publisher slug (e.g., 'iheartpodcasts', 'bbc-radio-4', 'bloomberg') or ID. Slugs are the recommended identifier.

Response

OK

category_breakdown
object[] | null
required

Per-GARM-category roll-up across the publisher's analyzed catalog. Always 12 entries in canonical order so callers don't need to merge against the canonical category list. For an analyzed publisher with no exposure in a given category, none equals analyzed_podcasts and every other bucket is 0; only when the publisher has zero analyzed podcasts are all five prevalence buckets 0.

confidence_breakdown
object
required

How confident the agent was in the verdicts that produced this rollup, summed across analyzed podcasts.

coverage
object
required

Catalog size and how much of it has been analyzed.

publisher
object
required

The publisher whose catalog is summarized.

tier_breakdown
object
required

Distribution of analyzed podcasts across the four IAB/GARM tiers (SAFE, LIMITED, SENSITIVE, UNSAFE), with counts and shares.

last_evaluated_at
string<date-time>

Most recent evaluation timestamp across the publisher's analyses. Omitted when the publisher has zero analyzed podcasts.

top_concerns
object[] | null

Up to three highest-exposure GARM categories ranked by high_risk_count, surfaced separately so advertisers can scan the publisher's worst dimensions without traversing the full breakdown.