Search APIs
Loading…
← API Store
Social

YouTube

YouTube

One YouTube short

GET /youtube/v1/shorts
Test this endpoint

Every response includes credits_used: the credits this call cost.

Each call costs 1 credits; failed calls are free. Run it in the console playground to see a live result.

Parameters

NameTypeDescription
idrequiredstring Example: dQw4w9WgXcQ

Every endpoint also takes: raw、fields、fresh、output、records

{
  "allow_ratings": true,
  "available_countries": [
    "AD",
    "AE",
    "… 247 more"
  ],
  "cached": false,
  "category": "Music",
  "channel": "Rick Astley",
  "channel_avatar": "https://yt3.ggpht.com/_ShEGOdg-t5YGJse14Ooq6FYBZqX_QSlhaTNjG06miYusm5lWm1UroLyVxnYtahADfRTVLtuVQ=s176-c-k-c0x00ffffff-no-rj",
  "channel_id": "UCuAXFkgsw1L7xaCfnd5JJOw",
  "channel_url": "https://www.youtube.com/@RickAstleyYT",
  "credits_used": 1,
  "date_text": "Oct 24, 2009",
  "description": "The official video for “Never Gonna Give You Up” by Rick Astley. \n\nNever: The Autobiography 📚 OUT NOW! \nFollow this link to get your copy an…",
  "embed": {
    "height": 720,
    "iframeUrl": "https://www.youtube.com/embed/dQw4w9WgXcQ",
    "width": 1280
  },
  "has_ypc_metadata": false,
  "hashtags": [
    "#RickAstley",
    "#NeverGonnaGiveYouUp",
    "… 1 more"
  ],
  "id": "dQw4w9WgXcQ",
  "is_crawlable": true,
  "is_family_safe": true,
  "is_live": false,
  "is_live_content": false,
  "is_private": false,
  "is_shorts_eligible": false,
  "is_unlisted": false,
  "is_upcoming": false,
  "keywords": [
    "rick astley",
    "Never Gonna Give You Up",
    "… 25 more"
  ],
  "length_seconds": 213,
  "like_count": 19493167,
  "likes": "19M",
  "live_broadcast": null,
  "owner_channel_name": "Rick Astley",
  "owner_profile_url": "http://www.youtube.com/@RickAstleyYT",
  "publish_date": "2009-10-24T23:57:33-07:00",
  "published": "Oct 24, 2009",
  "relative_date": "16 years ago",
  "super_title": "#RickAstley #NeverGonnaGiveYouUp #OfficialMusicVideo",
  "thumbnail": "https://i.ytimg.com/vi_webp/dQw4w9WgXcQ/maxresdefault.webp",
  "thumbnail_max": "https://i.ytimg.com/vi/dQw4w9WgXcQ/maxresdefault.jpg",
  "thumbnails": [
    {
      "height": 94,
      "url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/hqdefault.jpg?sqp=-oaymwEbCKgBEF5IVfKriqkDDggBFQAAiEIYAXABwAEG&rs=AOn4CLDd2KtelLHaNSXrI9_5K-NvTscKNw",
      "width": 168
    },
    {
      "height": 110,
      "url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/hqdefault.jpg?sqp=-oaymwEbCMQBEG5IVfKriqkDDggBFQAAiEIYAXABwAEG&rs=AOn4CLBUpEOOWUXWkNyijQuZ4UPzp2BE-w",
      "width": 196
    },
    "… 3 more"
  ],
  "title": "Rick Astley - Never Gonna Give You Up (Official Video) (4K Remaster)",
  "upload_date": "2009-10-24T23:57:33-07:00",
  "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
  "view_count_text": "1,829,743,592 views",
  "views": 1829743592,
  "…": "17 more fields"
}
Response fields (54)

Field paths and types observed in the sample response; the live response is authoritative.

$object
$.allow_ratingsboolean
$.available_countriesarray
$.available_countries[]string
$.cachedboolean
$.categorystring
$.channelstring
$.channel_avatarstring
$.channel_idstring
$.channel_urlstring
$.credits_usedinteger
$.date_textstring
$.descriptionstring
$.embedobject
$.embed.heightinteger
$.embed.iframeUrlstring
$.embed.widthinteger
$.has_ypc_metadataboolean
$.hashtagsarray
$.hashtags[]string
$.idstring
$.is_crawlableboolean
$.is_family_safeboolean
$.is_liveboolean
$.is_live_contentboolean
$.is_privateboolean
$.is_shorts_eligibleboolean
$.is_unlistedboolean
$.is_upcomingboolean
$.keywordsarray
$.keywords[]string
$.length_secondsinteger
$.like_countinteger
$.likesstring
$.live_broadcastnull
$.owner_channel_namestring
$.owner_profile_urlstring
$.publish_datestring
$.publishedstring
$.relative_datestring
$.super_titlestring
$.thumbnailstring
$.thumbnail_maxstring
$.thumbnailsarray
$.thumbnails[]object | string
$.thumbnails[].heightinteger
$.thumbnails[].urlstring
$.thumbnails[].widthinteger
$.titlestring
$.upload_datestring
$.urlstring
$.view_count_textstring
$.viewsinteger
$.…string