API Referenceinsights

Get an insight's quote

Reconstruct the verbatim transcript text for an insight.

The pipeline stores segment indices but not the underlying words — those live in the gzipped VTT payload in R2. This endpoint hits R2 on every call (no cache yet); fine for click-to-expand usage, would want episode-level caching if it ends up on a hot path.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

OR
X-API-Keystring
API Key authentication via header

Path parameters

insight_idstringRequired

Response

Successful Response
insight_idstring
quotestring
segmentslist of objects
took_msinteger
episode_idstring or nullOptional
sonic_ingest_idstring or nullOptional
segment_startinteger or nullOptional
segment_endinteger or nullOptional
timestamp_startstring or nullOptional
timestamp_endstring or nullOptional
speaker_labelstring or nullOptional
speaker_namestring or nullOptional
speaker_titlestring or nullOptional
insight_titlestring or nullOptional
insightstring or nullOptional
podcast_namestring or nullOptional
episode_titlestring or nullOptional
podscan_episode_idstring or nullOptional
transcript_total_segmentsinteger or nullOptional

Errors

400
Bad Request Error
401
Unauthorized Error
404
Not Found Error
422
Unprocessable Entity Error
429
Too Many Requests Error
500
Internal Server Error