Skip to content

Get YouTube video

GET
/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.

video_id
string

YouTube video ID.

Example
dQw4w9WgXcQ
url
string

YouTube video URL.

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.