YouTube Video

0.5 credits

Get detailed metadata for a YouTube video.

POST/api/v1/tools/youtube/video

Parameters

urlstringrequired

YouTube video URL or video ID.

fieldsstring[]

Fields to include in video. Omit for defaults: videoId, title, viewCount, likeCount, commentCount, duration, publishedAt, channel. Use ["*"] for all fields. Available fields: videoId, title, viewCount, likeCount, commentCount, duration, publishedAt, channel, description, thumbnailUrl, tags, category, isFamilySafe, isLiveContent, commentsDisabled, storyboards, endscreen.

Response Schema

dataobject

YouTube video result

videoIdstring

YouTube video ID

titlestring

Video title

viewCountnumber

Total view count

likeCountnumber

Total like count

commentCountnumber

Total comment count

durationnumber

Duration in seconds

publishedAtstring

ISO 8601 publish timestamp

channelobject

Channel info (name, id, subscriberCount, avatarUrl)

descriptionstring

Full video description

tagsstring[]

Video tags

categorystring

Video category name

chaptersobject[]

Video chapters with title, startMs, endMs, thumbnailUrl

heatMapobject[]

Engagement heatmap markers with startMs, durationMs, intensity

metaobject

Request metadata

toolstring

Tool name (youtube-video)

creditsUsednumber

Credits consumed (1)

requestIdstring

Unique request ID

Request

curl -X POST https://scraper.run/api/v1/tools/youtube/video \
  -H "Authorization: Bearer sc_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
  }'

Response Example

{
  "data": {
    "videoId": "dQw4w9WgXcQ",
    "title": "Rick Astley - Never Gonna Give You Up",
    "viewCount": 1500000000,
    "likeCount": 16000000,
    "commentCount": 2800000,
    "duration": 212,
    "publishedAt": "2009-10-25T06:57:33.000Z",
    "channel": {
      "name": "Rick Astley",
      "id": "UCuAXFkgsw1L7xaCfnd5JJOw",
      "subscriberCount": "3.8M",
      "avatarUrl": "https://yt3.ggpht.com/..."
    }
  },
  "meta": {
    "tool": "youtube-video",
    "creditsUsed": 0.5,
    "requestId": "req_abc123"
  }
}

curl -X POST https://scraper.run/api/v1/tools/youtube/video \

-H "Authorization: Bearer sc_live_..." \

-H "Content-Type: application/json" \

-d '{

"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"

{

"data": {

"videoId": "dQw4w9WgXcQ",

"title": "Rick Astley - Never Gonna Give You Up",

"viewCount": 1500000000,

"likeCount": 16000000,

"commentCount": 2800000,

"duration": 212,

"publishedAt": "2009-10-25T06:57:33.000Z",

"channel": {

"name": "Rick Astley",

"id": "UCuAXFkgsw1L7xaCfnd5JJOw",

"subscriberCount": "3.8M",

"avatarUrl": "https://yt3.ggpht.com/..."

}

"meta": {

"tool": "youtube-video",

"creditsUsed": 0.5,

"requestId": "req_abc123"

}