API Referenceinsights

Get an insight

Resolve one insight id directly — the id every hit carries as `id`. The GET-per-entity leg of "every id is resolvable": episodes and podcasts already had theirs; the object customers actually store and cite did not. `include_quotes` attaches the verbatim passage; `include_similar` embeds up to 10 related insights as full objects, ordered most-similar first (order is the contract — similarity scores are internal calibration and never exposed).

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

Query parameters

include_quotesbooleanOptionalDefaults to false
include_similarbooleanOptionalDefaults to false

Response

Successful Response
idstring or nullOptional
speaker_namestring or nullOptional
speaker_titlestring or nullOptional
mentionslist of objects or nullOptional
published_atstring or nullOptional
podcast_namestring or nullOptional
episode_titlestring or nullOptional
episode_audio_urlstring or nullOptional
episode_image_urlstring or nullOptional
podcast_image_urlstring or nullOptional
episode_urlstring or nullOptional
episode_idstring or nullOptional
podcast_idstring or nullOptional
quotestring or nullOptional
titlestringOptional

One-line headline of the extracted claim.

textstringOptional

The extracted claim — our one-paragraph paraphrase. quote is the verbatim transcript.

typeenumOptional

thesis = forward-looking argument, observation = qualitative read on the present, data_point = a concrete number.

speaker_roleenumOptional
What the speaker does professionally.
start_secondsdoubleOptional
Position of the claim in the episode audio, seconds from the start.
end_secondsdoubleOptional
similarlist of objectsOptional

Present only when include_similar=true: up to 10 related insights, most-similar first (ordering is the similarity contract; no scores).

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