Get a podcast's latest brand suitability assessment

Returns the most recent brand suitability assessment for a podcast against the IAB Tech Lab Content Taxonomy 3.x Brand Safety & Suitability Framework (the industry-standard 12-category taxonomy formerly stewarded by GARM): overall tier, per-category prevalence and treatment, evidence excerpts from sampled episodes, and the methodology that produced the rating. Pass include=trend for a deterministically-derived comparison against the prior assessment, or include=history for the list of prior assessments. Returns 404 when the podcast is not found or has not yet been analyzed.

get/v1/podcasts/{id}/suitability

Request

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

Path parameters

idstring required

Podcast slug (e.g., 'all-in'), internal ID, or numeric iTunes ID

Query parameters

includestring[] nullable

Optional response sections. Pass include=trend for a deterministically-derived comparison against the prior assessment, include=history for the list of prior assessments, or include=trend,history for both.

Response

confidencestring required

Agent confidence in the verdict: LOW, MEDIUM, or HIGH.

episodes_analyzedinteger

Number of episodes that informed the assessment.

evaluated_atstring date-time required

When the assessment was performed.

methodologystring required

Note on what the agent sampled (segments + transcripts read, sponsor cross-checks).

overall_tierstring required

Suitability verdict: SAFE (Low Risk), LIMITED (Medium), SENSITIVE (High), or UNSAFE (Brand Safety Floor).

sample_episode_idsstring[] nullable

Episode IDs in the contiguous window the agent analyzed.

sample_window_end_atstring date-time required

Published-at of the newest episode in the assessment window.

sample_window_start_atstring date-time required

Published-at of the oldest episode in the assessment window.

summarystring required

Customer-facing 2-4 sentence explanation of the verdict.

Changes

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