InsightSocial
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
languageNoTwo-letter language code, such as en, es or fr. If no caption track matches the language you specify, the request returns 404 RESOURCE_NOT_FOUND (reason no_captions). Omit it to get the video's original spoken language.
max_age_sNoThe oldest cached copy you accept, in seconds. A copy that old or younger is served, with its age in age_s and the X-Cache-Age header. Without it a copy up to 2592000 seconds old is served. A lower value fetches fresh (billed) when the copy is older, and 0 always fetches live, like Cache-Control: no-cache.

Response fields

The same unified schema every typed endpoint returns, so code written for YouTube reads the other platforms too. 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.