YouTube Video/Short Details API

Get complete information about a video or short. isPaidPromotion tells you whether YouTube marks the video as including paid promotion. Also includes YouTube's most-replayed heatmap when YouTube exposes it. most_replayed is null when the graph is not available. Age-restricted videos return 403 because we only use the public logged-out YouTube source.

1 creditper request
GET
/v1/youtube/video
View Code on GitHub
curl "https://api.scrapecreators.com/v1/youtube/video" \
  -H "x-api-key: "
{
  "success": true,
  "credits_remaining": 33851527,
  "credits_charged": 1,
  "id": "Y2Ah_DFr8cw",
  "thumbnail": "https://img.youtube.com/vi/Y2Ah_DFr8cw/maxresdefault.jpg",
  "url": "https://www.youtube.com/watch?v=Y2Ah_DFr8cw",
  "publishDate": "2019-02-22T03:19:54-08:00",
  "type": "video",
  "title": "Inside the NBA: Chuck Trolls Jussie Smollett "Do not commit crimes with checks, use cash!"",
  "description": null,
  "descriptionLinks": [],
  "commentCountText": "358",
  "commentCountInt": 358,
  "likeCountText": "4043",
  "likeCountInt": 4043,
  "viewCountText": "372,864",
  "viewCountInt": 372864,
  "publishDateText": "Feb 22, 2019",
  "collaborators": [],
  "channel": {
    "id": "UCWH3hing1Qb4LnkRfQdxsxQ",
    "url": "https://www.youtube.com/@afroballer8906",
    "handle": "afroballer8906",
    "title": "Afroballer"
  },
  "chapters": [],
  "watchNextVideos": [
    {
      "id": "lzDTK5kEdkM",
      "title": "Charles Barkley and Shaq FUNNIEST MOMENTS",
      "thumbnail": "https://i.ytimg.com/vi/lzDTK5kEdkM/hqdefault.jpg?sqp=-oaymwEmCKgBEF5IWvKriqkDGQgBFQAAiEIYAdgBAeIBCggYEAIYBjgBQAE=&rs=AOn4CLAq_osvQnsGV3A7uz4L1CPTaLqppg",
      "channel": {
        "title": "SkyHooked",
        "url": "https://www.youtube.com/@SkyHooked",
        "handle": "SkyHooked",
        "id": "UCrX8GD5f_O-Cu5Y2vQuSSvw"
      },
      "publishedTimeText": "11 months ago",
      "publishedTime": "2025-02-16T19:25:39.493Z",
      "publishDateText": "11 months ago",
      "publishDate": "2025-02-16T19:25:39.493Z",
      "viewCountText": "1.8M views",
      "viewCountInt": 1800000,
      "lengthText": "18:01",
      "lengthInSeconds": 1081,
      "videoUrl": "https://www.youtube.com/watch?v=lzDTK5kEdkM"
    },
    {
      "id": "B8m_XUPtF9o",
      "title": "15 NBA Legends Put An End To The GOAT Debate",
      "thumbnail": "https://i.ytimg.com/vi/B8m_XUPtF9o/hqdefault.jpg?sqp=-oaymwEmCKgBEF5IWvKriqkDGQgBFQAAiEIYAdgBAeIBCggYEAIYBjgBQAE=&rs=AOn4CLCrPDrAu52ZX2dclLkaEvMwuZtacw",
      "channel": {
        "title": "YounGala",
        "url": "https://www.youtube.com/@YounGala",
        "handle": "YounGala",
        "id": "UCNPl2SnE4FqafSjA7zmkN5w"
      },
      "publishedTimeText": "2 months ago",
      "publishedTime": "2025-11-16T19:25:39.493Z",
      "publishDateText": "2 months ago",
      "publishDate": "2025-11-16T19:25:39.493Z",
      "viewCountText": "807K views",
      "viewCountInt": 807000,
      "lengthText": "21:21",
      "lengthInSeconds": 1281,
      "videoUrl": "https://www.youtube.com/watch?v=B8m_XUPtF9o"
    }
  ],
  "keywords": [],
  "genre": "People & Blogs",
  "durationMs": 348000,
  "durationFormatted": "00:05:48",
  "isPaidPromotion": false,
  "most_replayed": null,
  "captionTracks": [
    {
      "baseUrl": "https://www.youtube.com/api/timedtext?v=Y2Ah_DFr8cw&ei=s5Bqab0gu8yS5w_pvOLIDw&caps=asr&opi=112496729&xoaf=5&xowf=1&hl=en&ip=0.0.0.0&ipbits=0&expire=1768616739&sparams=ip,ipbits,expire,v,ei,caps,opi,xoaf&signature=306A57ADE14FECC84B0DB13190761BCCC922AC9B.5C321C4FE7086F7AF851CA8463326E1869EE5255&key=yt8&kind=asr&lang=en",
      "name": {
        "simpleText": "English (auto-generated)"
      },
      "vssId": "a.en",
      "languageCode": "en",
      "kind": "asr",
      "isTranslatable": true,
      "trackName": ""
    }
  ]
}

Headers

x-api-key
string
required

Your Scrape Creators API key

Query Parameters

url
string
required

YouTube video or short URL

Example:
https://youtu.be/gTCi7PaOPLY
language
string

Preferred response language (mapped to Accept-Language header; not guaranteed due to YouTube localization behavior). 2 letter language code, ie 'en', 'es', 'fr' etc.

Example:
en
cache_max_age
string

If we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with "cached": true and a "cached_at" timestamp). Otherwise, scrape a live result (1 credit). See the Caching page for details.

Example:
7d
Available options:
1d,
3d,
7d,
14d,
30d

Response Field Explanations

isPaidPromotion
Boolean. True when YouTube marks the video as including paid promotion; otherwise false.
most_replayed
YouTube's public Most replayed heatmap, or null when YouTube does not show the graph for this video.
most_replayed.markers
Graph buckets with startMillis, durationMillis, and intensityScoreNormalized.
most_replayed.ranges
YouTube-highlighted replay ranges with visibleTimeRangeStartMillis, visibleTimeRangeEndMillis, decorationTimeMillis, and the localized label.