Skip to content

Get YouTube video (POST)

POST
/v1/youtube-video

Extract video metadata, view/like counts, and tags from a YouTube video.

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

Extracted data.

object
id
string
type
string
title
string
description
string
thumbnail
string
channel
object
id
string
url
string
handle
string
title
string
viewCountText
string
viewCountInt
number
likeCountText
string
likeCountInt
number
commentCountText
string
commentCountInt
number
publishDateText
string
publishDate
string
durationMs
number
durationFormatted
string
keywords
Array<string>
watchNextVideos
Array<object>
object
id
string
title
string
thumbnail
string
videoUrl
string
channel
object
id
string
url
string
handle
string
title
string
viewCountText
string
viewCountInt
number
publishDateText
string
publishDate
string
lengthText
string
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.