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