← API Store
Social
YouTube
YouTube
One YouTube short
GET /youtube/v1/shortsEvery 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
| Name | Type | Description |
|---|---|---|
idrequired | string | 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_ratings | boolean |
$.available_countries | array |
$.available_countries[] | string |
$.cached | boolean |
$.category | string |
$.channel | string |
$.channel_avatar | string |
$.channel_id | string |
$.channel_url | string |
$.credits_used | integer |
$.date_text | string |
$.description | string |
$.embed | object |
$.embed.height | integer |
$.embed.iframeUrl | string |
$.embed.width | integer |
$.has_ypc_metadata | boolean |
$.hashtags | array |
$.hashtags[] | string |
$.id | string |
$.is_crawlable | boolean |
$.is_family_safe | boolean |
$.is_live | boolean |
$.is_live_content | boolean |
$.is_private | boolean |
$.is_shorts_eligible | boolean |
$.is_unlisted | boolean |
$.is_upcoming | boolean |
$.keywords | array |
$.keywords[] | string |
$.length_seconds | integer |
$.like_count | integer |
$.likes | string |
$.live_broadcast | null |
$.owner_channel_name | string |
$.owner_profile_url | string |
$.publish_date | string |
$.published | string |
$.relative_date | string |
$.super_title | string |
$.thumbnail | string |
$.thumbnail_max | string |
$.thumbnails | array |
$.thumbnails[] | object | string |
$.thumbnails[].height | integer |
$.thumbnails[].url | string |
$.thumbnails[].width | integer |
$.title | string |
$.upload_date | string |
$.url | string |
$.view_count_text | string |
$.views | integer |
$.… | string |