Skip to content

Get YouTube transcript (POST)

POST
/v1/youtube-transcript

Extract video transcript/captions with timestamps.

Provide either video_id or url.

Credits: 1 per request.

Accepts the same fields as JSON instead of query parameters.

object
video_id

YouTube video ID.

string
url

YouTube video URL.

string
lang

Language code (default en).

string
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.