Get an insight
Retrieve one insight by id — the id every search hit and ask
source carries.
include_quotes attaches the verbatim transcript passage as quote;
include_similar embeds up to 10 related insights under similar,
most-similar first.
Authentication
Bearer authentication of the form Bearer <token>, where token is your auth token.
Path parameters
Query parameters
Attach the verbatim transcript passage as quote.
Embed up to 10 related insights under similar, most-similar first.
Response headers
Response
Stable insight id, format in-.... Resolvable via GET /v1/insights/{insight_id} and accepted by the ids search filter.
Who made the claim. null when the speaker could not be identified.
The speaker’s role and organization as stated on the appearance — e.g. CEO, Ritholtz Wealth Management.
When the episode aired — ISO 8601 UTC. This is the point-in-time anchor for the claim, not when we indexed it.
Full episode audio. Combine with start_seconds to play the claim itself.
Id of the source episode. Resolvable via GET /v1/episodes/{episode_id} and accepted by the episode_ids search filter.
Id of the source show. Resolvable via GET /v1/podcasts/{podcast_id} and accepted by the podcast_ids search filter.
Verbatim transcript passage behind body. Populated only when include_quotes is true, and null when the transcript is unavailable.
One-line headline of the extracted claim.
The extracted claim — our one-paragraph paraphrase. quote is the verbatim transcript.
thesis = forward-looking argument, observation = qualitative read on the present, data_point = a concrete number.
What the speaker does professionally: operator runs a business, investor deploys capital, researcher produces research, commentator is a journalist or host, government is a public official. unknown when it can’t be determined; the field is always present.
Present only when include_similar=true: up to 10 related insights, most-similar first.