Skip to main content
GET
cURL

Authorizations

X-API-Key
string
header
required

Pass your API key in the X-API-Key header (recommended).

Path Parameters

id
string
required

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

Query Parameters

include
enum<string>[] | null

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.

Available options:
trend,
history

Response

OK

categories
object[] | null
required

Per-category breakdown across all 12 brand-safety categories. Always 12 entries even when prevalence is NONE — the assessment records that every category was actively considered.

confidence
string
required

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

evaluated_at
string<date-time>
required

When the assessment was performed.

methodology
string
required

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

overall_tier
string
required

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

sample_window_end_at
string<date-time>
required

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

sample_window_start_at
string<date-time>
required

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

summary
string
required

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

episodes_analyzed
integer<int64>

Number of episodes that informed the assessment.

history
object[] | null

Prior assessments ordered most-recent first. Present when include=history.

sample_episode_ids
string[] | null

Episode IDs in the contiguous window the agent analyzed.

trend
object

Deterministic comparison against the prior assessment. Present when include=trend; INSUFFICIENT_HISTORY before a second assessment exists.