What metadata does the details response include?

Title, full description, author, publish date, duration in seconds, view count, like count, tags array, content category, and five thumbnail sizes. It also includes the 20 related videos YouTube recommends after this one.

Can I get the transcript and details in the same request?

No, they are separate requests, but both use the same video URL. The transcript endpoint returns timestamped segments and the full text. The details endpoint returns metadata and related videos.

Does it accept youtu.be short links?

It accepts full watch URLs, youtu.be share links, and bare video IDs, and treats them all the same way.

Video details

YouTube Video Details API

Fetch a YouTube video's full metadata, stats, tags, and thumbnails in one call, with 20 related videos included.

Get an API key Read the docs

Pass a video URL and get back complete metadata: full description, view and like counts as integers, tags, content category, publish date, duration in seconds, and five thumbnail sizes up to 1920x1080 WebP.

The response also includes the 20 videos YouTube recommends after this one. Transcript, comments, and live chat share the same URL, so switching between data types is a single parameter change.

Endpoint

POST https://api.stophy.dev/v1/video

Request

1curl -X POST https://api.stophy.dev/v1/video \
2  -H "Authorization: Bearer $STOPHY_API_KEY" \
3  -H "Content-Type: application/json" \
4  -d '{"videoUrl":"https://youtu.be/YkOSUVzOAA4","type":"details"}'

Response

1{
2  "video": {
3    "id": "YkOSUVzOAA4",
4    "title": "T3 Stack Tutorial - FROM 0 TO PROD FOR $0",
5    "author": "Theo - t3.gg",
6    "description": "About a year and a half ago I made my first ever video...",
7    "viewCount": 537700,
8    "likeCount": 12060,
9    "durationSec": 10743,
10    "publishedAt": "2022-11-04T00:00:00Z",
11    "tags": ["typescript", "react", "t3 stack", "web development"],
12    "category": "Science & Technology",
13    "isLive": false
14  },
15  "related": [
16    { "id": "abc123", "title": "Next.js App Router Tutorial", "viewCount": 210000 }
17  ]
18}

What you can do

Full description

The complete video description, not a truncated preview. Creator chapters, timestamps, and links included.

Five thumbnail sizes

Thumbnails at 168x94, 196x110, 246x138, 336x188, and 1920x1080 WebP, all in one response.

Common use cases

Enrich a video record with stats, tags, and full description before ingesting it
Walk a recommendation graph by chaining the related videos array
Render rich video cards with the right thumbnail size for your layout
Filter which videos are worth transcribing based on view counts and tags

Frequently asked questions

What metadata does the details response include?: Title, full description, author, publish date, duration in seconds, view count, like count, tags array, content category, and five thumbnail sizes. It also includes the 20 related videos YouTube recommends after this one.
Can I get the transcript and details in the same request?: No, they are separate requests, but both use the same video URL. The transcript endpoint returns timestamped segments and the full text. The details endpoint returns metadata and related videos.
Does it accept youtu.be short links?: It accepts full watch URLs, youtu.be share links, and bare video IDs, and treats them all the same way.

Related APIs

YouTube Transcript API

Transcripts

YouTube Comments API

Comments

YouTube Search API

← All APIs