Insight Social
GET /v1/youtube/video/transcript

YouTube Video Transcript API

Returns the spoken transcript of a video as timestamped segments, each with text, start time and duration, plus language, word count, and speech rate.

30 credits a call · single call · failed calls free · 10 free calls to start

curl "https://api.insightsocial.app/v1/youtube/video/transcript?url=https%3A%2F%2Fwww.youtube.com%2Fwatch%3Fv%3DdQw4w9WgXcQ" \
-H "x-api-key: $INSIGHTSOCIAL_API_KEY"
200 OKJSON
{
"success": true,
"platform": "youtube",
"endpoint": "/v1/youtube/video/transcript",
"schema_version": "2",
"data": {
"transcript": {
"language": "<string | null>",
"text": "<string | null>",
"segments": "<array | null>"
}
},
"unavailable": [],
"credits_used": "<integer>"
}

When to use it

Use it for a single video URL; when the video has no captions the reply is a 404 naming the reason, which is expected rather than a failure.

Parameters

Query parameters for GET /v1/youtube/video/transcript. Send your key in the x-api-key header.

NameRequiredDescription
urlYesFull URL of the YouTube video
languageNo2 letter language code, ie 'en', 'es', 'fr' etc. If no caption track matches the language you specify, the request returns 404 RESOURCE_NOT_FOUND (reason no_captions).

Response fields

The same unified schema every platform returns, so code written for YouTube works on the other eight. A field the platform did not provide is null and listed in unavailable.

FieldTypeNotes
languagestring | nullThe content's language as the platform states it, e.g. en, pt-BR. Detected languages come later (§7.1).
textstring | null
segmentsarray | null

Every field, error and example is in the YouTube Video Transcript API reference.

How much does the YouTube Video Transcript API cost?

30 credits per successful call.

  • Failed calls are free

    A call that errors or finds nothing costs 0 credits.

  • Know the price first

    Add dry_run=1 and the response quotes the call without making it. Nothing is charged.

  • One balance

    API calls and Chrome extension exports share the same credits, on the free plan too.

YouTube Video Transcript API: frequently asked questions

Send GET /v1/youtube/video/transcript with the url parameter and your key in the x-api-key header. Returns the spoken transcript of a video as timestamped segments, each with text, start time and duration, plus language, word count, and speech rate.