Skip to content
Gridlode
Docs · Reference

YouTube Video Details

GET /v1/youtube/video1 credit / requestcache 360 min

Public metadata of one YouTube video from its watch page, as a signed-out visitor sees it: title, description, channel with subscriber count, exact views and likes, comment count, publish and upload dates, duration, category, keywords, hashtags, thumbnails, chapters, live and family-safe flags, and the caption languages on offer. Accepts a video ID or any YouTube video, Shorts or live URL. Removed or private videos, verification pages, blocks and failures are free.

Query parameters

video_id
string · required
YouTube video ID (11 characters) or any youtube.com / youtu.be video, Shorts or live URL.
hl
string
Interface language for texts such as dates.
Default: "en"
gl
string
Two-letter country code to view the video from.
Default: "us"
max_age
integer
Accept a cached answer up to this many seconds old, billed at 50%.

Response data fields

    Example

    curl "https://api.gridlode.com/v1/youtube/video?video_id=aircAruvnKk" \
  -H "Authorization: Bearer $GRIDLODE_KEY"

    Try it without code on the YouTube Video Details API page.