Skip to content

Get YouTube transcript

GET
/v1/youtube-transcript

Extract video transcript/captions with timestamps.

Provide either video_id or url.

Credits: 1 per request.

video_id
string

YouTube video ID.

url
string

YouTube video URL.

lang
string
default: en

Language code (default en).

Extracted data.

object
videoId
string
type
string
url
string
language
string
auto_generated
boolean
transcript
Array<object>
object
text
string
startMs
string
endMs
string
startTimeText
string
transcript_only_text
string
X-Credits-Used
integer

Credits consumed.

X-Credits-Remaining
integer

Remaining credit balance.

Missing or invalid API key.

object
error
required
string
Example
invalid request
field

Field that failed validation.

string
detail
string
hint
string

Insufficient unreserved credits.

object
error
required
string
Example
insufficient credits
required
required
integer
available
required
integer

Request, concurrency, or plan limit exceeded.

One of:
object
error
required
string
Example
invalid request
field

Field that failed validation.

string
detail
string
hint
string
Retry-After
integer

Seconds to wait when supplied.