Video details
Exact views, likes and comment count, description, tags, chapters and channel for one video.
GET/v1/youtube/video
Costs 1 credit per request. Only requests that return data are charged.
Parameters
| Name | Type | Description |
|---|---|---|
videorequired |
string | Video URL or 11-character video id. Watch, youtu.be, Shorts, embed and live links all work. |
Example request
curl "https://pipefetch.com/v1/youtube/video?video=jNQXAC9IVRw" \
-H "x-api-key: YOUR_API_KEY"const res = await fetch('https://pipefetch.com/v1/youtube/video?video=jNQXAC9IVRw', {
headers: { 'x-api-key': process.env.PIPEFETCH_API_KEY },
});
const { data, credits } = await res.json();import os, requests
res = requests.get(
"https://pipefetch.com/v1/youtube/video",
params={"video": "jNQXAC9IVRw"},
headers={"x-api-key": os.environ["PIPEFETCH_API_KEY"]},
)
data = res.json()["data"]Example response
A real answer to the request above. Long texts and lists are shortened here.
{
"data": {
"videoId": "jNQXAC9IVRw",
"url": "https://www.youtube.com/watch?v=jNQXAC9IVRw",
"title": "Me at the zoo",
"description": "Microplastics are accumulating in human brains at an alarming rate\nhttps://www.youtube.com/watch?v=0PT5c1z3LL8\n\n“Nanoplastics and Human Health” with M…",
"publishedAt": "2005-04-24T03:31:52.000Z",
"durationSeconds": 19,
"viewCount": 448773635,
"likeCount": 20141346,
"commentCount": 10644331,
"category": "Film & Animation",
"keywords": [
"me at the zoo",
"jawed karim"
],
"hashtags": [],
"chapters": [
{
"title": "Intro",
"startSeconds": 0
},
{
"title": "The cool thing",
"startSeconds": 5
}
],
"thumbnailUrl": "https://i.ytimg.com/vi/jNQXAC9IVRw/hqdefault.jpg",
"isLive": false,
"isUpcoming": false,
"isFamilySafe": true,
"isAgeRestricted": false,
"commentsTurnedOff": false,
"channel": {
"id": "UC4QobU6STFB0P71PMvOGN5A",
"name": "jawed",
"handle": "@jawed",
"url": "https://www.youtube.com/@jawed",
"isVerified": true,
"avatarUrl": "https://yt3.ggpht.com/uI3VE4PVqvCy0xnWLqMJnEzyBUm3T8VHOCp4ee-1RxdHqKXCdUE_qXYQnpf9AfuEoIPactVyDhM=s800-c-k-c0x00ffffff-no-rj",
"subscriberCount": 6740000
}
},
"credits": {
"used": 1,
"remaining": 99
}
}Good to know
- View, like and comment counts are the exact numbers, not the rounded labels YouTube displays.
Errors
Every error has the same shape, and none of them is charged. The full list is in the error reference.
Looking for an overview and use cases? See the YouTube Video API page.