API referenceYouTube
YouTube details (v3)
One YouTube video with a richer set of fields.
The same target as youtube-details, with more of the video's metadata
filled in, including the full description and hashtags.
Shorts and long-form video are returned from the same channel endpoint and are labelled by content type rather than by duration.
The example response below is real output from this endpoint, not an illustration. Long lists and long strings are shortened to keep the page readable, and each place that happens is marked. This example took 14.2s.
Authorization
ApiKeyAuth X-API-Key<token>
Your API key. Sent on every request.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/scrapers/youtube-details-v3" \ -H "Content-Type: application/json" \ -d '{ "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ", "include_transcript": true }'{ "request_id": "req_8f2c1d94e7b0", "success": true, "status": { "code": "OK", "message": "Scrape completed.", "retryable": false }, "data": { "post": { "age_restriction_status": false, "author_id": "UCuAXFkgsw1L7xaCfnd5JJOw", "author_name": "Rick Astley", "author_username": "Rick Astley", "available_countries": [ "AD", "AE", "… 247 more items in the full response" ], "caption": "Rick Astley - Never Gonna Give You Up (Official Video) (4K Remaster)\n\nThe official video for “Never Gonna Give You Up” by Rick Astley. \n\nNever: The Autobiography 📚 OUT NOW! \nFollow this link to get your copy and listen to Rick’s ‘Never’ playlist ❤️ #RickAstleyNever\nhttps://linktr.ee/rickastleynever\n\n“Never Gonna Give Y… (+2125 chars)", "category": "Music", "comment_count": 2455020, "content_code": "dQw4w9WgXcQ", "content_id": "dQw4w9WgXcQ", "content_language": "en", "content_link": "https://www.youtube.com/watch?v=dQw4w9WgXcQ", "content_type": "video", "first_comment": { "author_id": null, "author_name": "@YouTube", "author_profile_image": null, "author_username": "@YouTube", "author_verification_status": null, "comment_id": "Ugzge340dBgB75hWBm54AaABAg", "comment_text": "can confirm: he never gave us up", "is_creator": null, "like_count": 305000, "pinned_status": null, "published_date": 1755950564, "replies": [], "reply_count": 963 }, "hashtags": [ "WheneverYouNeedSomebody", "OfficialMusicVideo", "… 3 more items in the full response" ], "images": [], "is_family_safe": true, "is_live_content": false, "is_private": false, "is_unlisted": false, "keywords": [ "rick astley", "Never Gonna Give You Up", "… 25 more items in the full response" ], "like_count": 19348007, "media_links": { "audio": "https://rr6---sn-bvvbaxivnuxq5uu-p5il.googlevideo.com/videoplayback?expire=1787508159&ei=X-GKap3sJuGZ-coP_uLoqAQ&ip=0.0.0.0&id=o-AMPHg-oavTyDK1TRVgZ0L-igVi9BFcN8gi_wMCgCp5lV&itag=140&source=youtube&requiressl=yes&xpc=EgVo2aDSNQ%3D%3D&cps=1322&met=1787486559%2C&mh=7c&mm=18%2C29&mn=sn-bvvbaxivnuxq5uu-p5il%2Csn-q4f… (+769 chars)", "high": "https://rr6---sn-bvvbaxivnuxq5uu-p5il.googlevideo.com/videoplayback?expire=1787508159&ei=X-GKap3sJuGZ-coP_uLoqAQ&ip=0.0.0.0&id=o-AMPHg-oavTyDK1TRVgZ0L-igVi9BFcN8gi_wMCgCp5lV&itag=401&source=youtube&requiressl=yes&xpc=EgVo2aDSNQ%3D%3D&cps=1322&met=1787486559%2C&mh=7c&mm=18%2C29&mn=sn-bvvbaxivnuxq5uu-p5il%2Csn-q4f… (+769 chars)", "low": "https://rr6---sn-bvvbaxivnuxq5uu-p5il.googlevideo.com/videoplayback?expire=1787508159&ei=X-GKap3sJuGZ-coP_uLoqAQ&ip=0.0.0.0&id=o-AMPHg-oavTyDK1TRVgZ0L-igVi9BFcN8gi_wMCgCp5lV&itag=160&source=youtube&requiressl=yes&xpc=EgVo2aDSNQ%3D%3D&cps=1322&met=1787486559%2C&mh=7c&mm=18%2C29&mn=sn-bvvbaxivnuxq5uu-p5il%2Csn-q4f… (+769 chars)", "medium": "https://rr6---sn-bvvbaxivnuxq5uu-p5il.googlevideo.com/videoplayback?expire=1787508159&ei=X-GKap3sJuGZ-coP_uLoqAQ&ip=0.0.0.0&id=o-AMPHg-oavTyDK1TRVgZ0L-igVi9BFcN8gi_wMCgCp5lV&itag=400&source=youtube&requiressl=yes&xpc=EgVo2aDSNQ%3D%3D&cps=1322&met=1787486559%2C&mh=7c&mm=18%2C29&mn=sn-bvvbaxivnuxq5uu-p5il%2Csn-q4f… (+771 chars)", "watermarked": null }, "mentions": [], "published_date": 1256453853, "slideshow_status": false, "subtitles": [ { "is_auto_generated": false, "kind": "manual", "language_code": "en", "language_name": "English", "url": "https://www.youtube.com/api/timedtext?v=dQw4w9WgXcQ&ei=YeGKaomeCrXnir4P1L6_iA4&caps=asr&opi=112496729&exp=xpe&xoaf=5&xowf=1&hl=en&ip=0.0.0.0&ipbits=0&expire=1787511761&sparams=ip,ipbits,expire,v,ei,caps,opi,exp,xoaf&signature=010D8C33DA77EAF0572DEE8DC79ED8D6C8F3A5E4.2BECB3BAB589F8B022B77346175635994BC995C2&key=yt8&lang… (+3 chars)" }, { "is_auto_generated": true, "kind": "auto", "language_code": "en", "language_name": "English (auto-generated)", "url": "https://www.youtube.com/api/timedtext?v=dQw4w9WgXcQ&ei=YeGKaomeCrXnir4P1L6_iA4&caps=asr&opi=112496729&exp=xpe&xoaf=5&xowf=1&hl=en&ip=0.0.0.0&ipbits=0&expire=1787511761&sparams=ip,ipbits,expire,v,ei,caps,opi,exp,xoaf&signature=010D8C33DA77EAF0572DEE8DC79ED8D6C8F3A5E4.2BECB3BAB589F8B022B77346175635994BC995C2&key=yt8&kind… (+12 chars)" }, "… 4 more items in the full response" ], "thumbnail_image": "https://i.ytimg.com/vi/dQw4w9WgXcQ/maxresdefault.jpg", "transcript": "[♪♪♪] ♪ We're no strangers to love ♪ ♪ You know the rules and so do I ♪ ♪ A full commitment's what I'm thinking of ♪ ♪ You wouldn't get this from any other guy ♪ ♪ I just wanna tell you how I'm feeling ♪ ♪ Gotta make you understand ♪ ♪ Never gonna give you up ♪ ♪ Never gonna let you down ♪ ♪ Never gonna run around and … (+1769 chars)", "transcript_language": "en", "video_duration_seconds": "213", "video_link": "https://rr6---sn-bvvbaxivnuxq5uu-p5il.googlevideo.com/videoplayback?expire=1787508159&ei=X-GKap3sJuGZ-coP_uLoqAQ&ip=0.0.0.0&id=o-AMPHg-oavTyDK1TRVgZ0L-igVi9BFcN8gi_wMCgCp5lV&itag=18&source=youtube&requiressl=yes&xpc=EgVo2aDSNQ%3D%3D&cps=1322&met=1787486559%2C&mh=7c&mm=18%2C29&mn=sn-bvvbaxivnuxq5uu-p5il%2Csn-q4fl… (+769 chars)", "view_count": 1807211233 } }, "error": null, "meta": { "client_id": "client_abc123", "scraper": "youtube-details-v3", "billable": true, "duration_ms": 13456 }}