API referenceYouTube
YouTube details (v1)
One YouTube video or Short, in the standard content shape.
Reads a single video from its URL. View counts, like counts and the upload timestamp come back exact rather than as the rounded figures shown on the page.
Set include_transcript to attach the caption track as flattened text.
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" \ -H "Content-Type: application/json" \ -d '{ "url": "https://www.youtube.com/watch?v=KQK5JhMk7nE" }'{ "request_id": "req_8f2c1d94e7b0", "success": true, "status": { "code": "OK", "message": "Scrape completed.", "retryable": false }, "data": { "data": { "additional": { "allow_ratings": true, "available_countries": [ "AD", "AE", "… 247 more items in the full response" ], "category": "Education", "channel_id": "UCmTM_hPCeckqN3cPWtYZZcg", "description": null, "duration_seconds": "1509", "is_family_safe": true, "is_live_content": false, "is_private": false, "is_unlisted": false, "is_unplugged_corpus": false, "keywords": [ "Akash Banerjee", "akash", "… 30 more items in the full response" ], "top_comments": [ { "author": "@thedeshbhakt", "id": "UgypUJ5BTXS_zPBUD9N4AaABAg", "like_count": 40, "reply_count": 13, "text": "thanks to our Deshbhakt members on YT and patreon.com/thedeshbhakt who made this detailed episode possible. In 2026 - we would encourage you to become an monthly / annual member of The Deshbhakt", "timestamp": 1769342567 }, { "author": "@SitabjaBiswas-f1v", "id": "UgyCJ7hfX2XJvLBEQoR4AaABAg", "like_count": 1100, "reply_count": 19, "text": "Gig economy can never be considered as an employable sector.", "timestamp": 1769342567 }, "… 3 more items in the full response" ] }, "main": { "audio_url": "https://rr3---sn-qjp5q5-5x.googlevideo.com/videoplayback?expire=1787508160&ei=YOGKaturA8e_kucPwqvduQQ&ip=0.0.0.0&id=o-AMdRbTJscHC99zjiD9DTK_O-Spf98NqWrzBVNSkjYPZR&itag=18&source=youtube&requiressl=yes&xpc=EgVo2aDSNQ%3D%3D&met=1787486560%2C&mh=aI&mm=31%2C26&mn=sn-qjp5q5-5x%2Csn-vgqsknde&ms=au%2Conr&mv=m&mvi=3&pl=20… (+797 chars)", "caption": "Gig Economy Debate | Can Companies Like Zomato Be Blamed For Worker Exploitation? | Akash Banerjee\n\nThe New Year has seen the Gig Economy Debate reignite like never before. Unions are trying to strike and demand better pay - activists are blaming new-age companies for practising techno-feudalism.... on the other hand e… (+1263 chars)", "comment_count": 1950, "creator_handle": "The Deshbhakt", "hashtags": [ "Zomato", "workerempowerment", "… 1 more item in the full response" ], "high_quality_video_url": "https://rr3---sn-qjp5q5-5x.googlevideo.com/videoplayback?expire=1787508160&ei=YOGKaturA8e_kucPwqvduQQ&ip=0.0.0.0&id=o-AMdRbTJscHC99zjiD9DTK_O-Spf98NqWrzBVNSkjYPZR&itag=18&source=youtube&requiressl=yes&xpc=EgVo2aDSNQ%3D%3D&met=1787486560%2C&mh=aI&mm=31%2C26&mn=sn-qjp5q5-5x%2Csn-vgqsknde&ms=au%2Conr&mv=m&mvi=3&pl=20… (+797 chars)", "like_count": 22576, "low_quality_video_url": "https://rr3---sn-qjp5q5-5x.googlevideo.com/videoplayback?expire=1787508160&ei=YOGKaturA8e_kucPwqvduQQ&ip=0.0.0.0&id=o-AMdRbTJscHC99zjiD9DTK_O-Spf98NqWrzBVNSkjYPZR&itag=18&source=youtube&requiressl=yes&xpc=EgVo2aDSNQ%3D%3D&met=1787486560%2C&mh=aI&mm=31%2C26&mn=sn-qjp5q5-5x%2Csn-vgqsknde&ms=au%2Conr&mv=m&mvi=3&pl=20… (+797 chars)", "post_id": "KQK5JhMk7nE", "post_url": "https://www.youtube.com/watch?v=KQK5JhMk7nE", "profile_picture_url": "https://yt3.ggpht.com/DfVqzaxetTmlyiL2oZHng3i9nKBEKJWWjQoPVUYf3U9Qq6rxDeCtaXjCUj9ARjqdluzwbv_r=s88-c-k-c0x00ffffff-no-rj", "save_count": null, "share_count": null, "thumbnail_url": "https://i.ytimg.com/vi/KQK5JhMk7nE/maxresdefault.jpg", "upload_timestamp": 1767457284, "video_url": "https://rr3---sn-qjp5q5-5x.googlevideo.com/videoplayback?expire=1787508160&ei=YOGKaturA8e_kucPwqvduQQ&ip=0.0.0.0&id=o-AMdRbTJscHC99zjiD9DTK_O-Spf98NqWrzBVNSkjYPZR&itag=18&source=youtube&requiressl=yes&xpc=EgVo2aDSNQ%3D%3D&met=1787486560%2C&mh=aI&mm=31%2C26&mn=sn-qjp5q5-5x%2Csn-vgqsknde&ms=au%2Conr&mv=m&mvi=3&pl=20… (+797 chars)", "video_urls_by_quality": { "high": "https://rr3---sn-qjp5q5-5x.googlevideo.com/videoplayback?expire=1787508160&ei=YOGKaturA8e_kucPwqvduQQ&ip=0.0.0.0&id=o-AMdRbTJscHC99zjiD9DTK_O-Spf98NqWrzBVNSkjYPZR&itag=18&source=youtube&requiressl=yes&xpc=EgVo2aDSNQ%3D%3D&met=1787486560%2C&mh=aI&mm=31%2C26&mn=sn-qjp5q5-5x%2Csn-vgqsknde&ms=au%2Conr&mv=m&mvi=3&pl=20… (+797 chars)", "low": "https://rr3---sn-qjp5q5-5x.googlevideo.com/videoplayback?expire=1787508160&ei=YOGKaturA8e_kucPwqvduQQ&ip=0.0.0.0&id=o-AMdRbTJscHC99zjiD9DTK_O-Spf98NqWrzBVNSkjYPZR&itag=18&source=youtube&requiressl=yes&xpc=EgVo2aDSNQ%3D%3D&met=1787486560%2C&mh=aI&mm=31%2C26&mn=sn-qjp5q5-5x%2Csn-vgqsknde&ms=au%2Conr&mv=m&mvi=3&pl=20… (+797 chars)", "medium": "https://rr3---sn-qjp5q5-5x.googlevideo.com/videoplayback?expire=1787508160&ei=YOGKaturA8e_kucPwqvduQQ&ip=0.0.0.0&id=o-AMdRbTJscHC99zjiD9DTK_O-Spf98NqWrzBVNSkjYPZR&itag=18&source=youtube&requiressl=yes&xpc=EgVo2aDSNQ%3D%3D&met=1787486560%2C&mh=aI&mm=31%2C26&mn=sn-qjp5q5-5x%2Csn-vgqsknde&ms=au%2Conr&mv=m&mvi=3&pl=20… (+797 chars)", "watermarked": null }, "view_count": 899594 } } }, "error": null, "meta": { "client_id": "client_abc123", "scraper": "youtube-details", "billable": true, "duration_ms": 15437 }}