📺

YouTube Video Metadata

Get detailed metadata for a YouTube video including stats and tags

GET 1 credit /v1/youtube/video

curl "https://youtube.toolkitapi.io/v1/youtube/video?url=https://www.youtube.com/watch?v=dQw4w9WgXcQ"

import httpx

resp = httpx.get(
    "https://youtube.toolkitapi.io/v1/youtube/video?url=https://www.youtube.com/watch?v=dQw4w9WgXcQ",
)
print(resp.json())

const resp = await fetch("https://youtube.toolkitapi.io/v1/youtube/video?url=https://www.youtube.com/watch?v=dQw4w9WgXcQ", {
});
const data = await resp.json();
console.log(data);

# See curl example

Response 200 OK

{
  "id": "dQw4w9WgXcQ",
  "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
  "title": "Rick Astley - Never Gonna Give You Up (Official Music Video)",
  "description": "The official video for "Never Gonna Give You Up" by Rick Astley.",
  "thumbnailUrl": "https://i.ytimg.com/vi/dQw4w9WgXcQ/maxresdefault.jpg",
  "channelId": "UCuAXFkgsw1L7xaCfnd5JJOw",
  "channelName": "Rick Astley",
  "channelUrl": "https://www.youtube.com/channel/UCuAXFkgsw1L7xaCfnd5JJOw",
  "duration": 212,
  "viewCount": 1500000000,
  "likeCount": 18000000,
  "commentCount": 3200000,
  "publishedAt": "2009-10-25T06:57:33Z",
  "tags": ["rick astley", "never gonna give you up", "80s", "music video", "pop"],
  "isLive": false
}

Try It Live

Description

Get detailed metadata for a YouTube video including stats and tags

How to Use

1

1. Pass a YouTube video URL or video ID in the `url` query parameter.

2

2. The API resolves the video and returns its full metadata in a single response.

3

3. Use `viewCount`, `likeCount`, and `commentCount` for engagement analysis. Use `duration` (in seconds) for content length filtering.

4

4. Access `channelId` and `channelUrl` to navigate to related channel endpoints for deeper analysis.

About This Tool

The YouTube Video Metadata endpoint returns comprehensive information about a YouTube video, including title, description, channel details, engagement statistics, duration, tags, and publication date.

Use this to enrich video URLs with structured data for analytics dashboards, content catalogues, or automated monitoring. The response includes everything you need to display a rich video card or feed video metadata into downstream processing.

The endpoint accepts video URLs in any standard format as well as bare video IDs.

Why Use This Tool

Video analytics — Track view counts, likes, and engagement ratios over time
Content curation — Filter and rank videos by metadata for recommendation systems
Thumbnail extraction — Get high-resolution thumbnail URLs for display
Channel research — Identify which channel published a video and cross-reference with channel data
Live stream detection — Use the `isLive` field to identify active live streams

Frequently Asked Questions

Does this work with YouTube Shorts?

Yes. YouTube Shorts have the same video ID format and return the same metadata fields. The `duration` field will reflect the short video length (typically under 60 seconds).

Are view counts real-time?

View counts are sourced from YouTube's public data and may lag real-time by a few minutes to hours. They represent YouTube's official public count, not an independent measurement.

What if the video is private or deleted?

Private or deleted videos return an error. Only publicly accessible videos can be queried.

Start using YouTube Video Metadata now

Get your free API key and make your first request in under a minute.

Get Free API Key View Docs