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.
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 }}