YouTube Video/Short Details API

Get YouTube video or Short details, description cards, AI disclosures, owner/uploader identities, paid-promotion status and replay heatmaps. Age-restricted videos return 403. No hosted video downloads.

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,
  "descriptionCards": [],
  "isMadeWithAI": false,
  "aiDisclosure": "Auto-dubbed
Audio tracks for some languages were automatically generated. Learn more",
  "ownerByline": {
    "channelId": "UCWH3hing1Qb4LnkRfQdxsxQ",
    "name": "Afroballer",
    "url": "https://www.youtube.com/@afroballer8906",
    "subscriberCountText": "1.01K subscribers",
    "badges": []
  },
  "uploader": {
    "channelId": "UCWH3hing1Qb4LnkRfQdxsxQ",
    "author": "Afroballer",
    "url": "http://www.youtube.com/@afroballer8906"
  },
  "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 two-letter response language, such as en, es, or fr. Sets Accept-Language; YouTube may ignore it.

Example:
en
cache_max_age
string

Use a cached response this old or newer for 0 credits. If none is available, fetch live at the endpoint’s normal price.

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