YouTube
Get Content Details
Retrieve the most recent YouTube videos and shorts of a specified creator, including publish time, video or short description, and engagement metrics.
Optionally pass fields in the request body to limit how many items each content-detail array returns. Each item returned is billed individually, capped at the full-bundle price. Fractional calls must be enabled on your API key. Otherwise, a request that includes fields returns a 400 error (FractionalCallsNotEnabled). For per-item costs, see Field and Item Costs. For how fractional calls work, see Fractional Calls.
POST
/
youtube
/
content-detail
cURL
curl -X POST "https://apiv3.creatordb.app/youtube/content-detail" \
-H "Content-Type: application/json" \
-H "api-key: <YOUR_API_KEY_HERE>" \
-d '{ "channelId": "UCX6OQ3DkcsbYNE6H8uQQuVA", "fields": { "recentVideos": 5 } }'const options = {
method: 'POST',
headers: {'api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
channelId: 'UCBR8-60-B28hp2BmDPdntcQ',
uniqueId: '@youtube',
fields: {recentVideos: 5, recentShorts: 5}
})
};
fetch('https://apiv3.creatordb.app/youtube/content-detail', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://apiv3.creatordb.app/youtube/content-detail"
payload = {
"channelId": "UCBR8-60-B28hp2BmDPdntcQ",
"uniqueId": "@youtube",
"fields": {
"recentVideos": 5,
"recentShorts": 5
}
}
headers = {
"api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://apiv3.creatordb.app/youtube/content-detail",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'channelId' => 'UCBR8-60-B28hp2BmDPdntcQ',
'uniqueId' => '@youtube',
'fields' => [
'recentVideos' => 5,
'recentShorts' => 5
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}require 'uri'
require 'net/http'
url = URI("https://apiv3.creatordb.app/youtube/content-detail")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"channelId\": \"UCBR8-60-B28hp2BmDPdntcQ\",\n \"uniqueId\": \"@youtube\",\n \"fields\": {\n \"recentVideos\": 5,\n \"recentShorts\": 5\n }\n}"
response = http.request(request)
puts response.read_bodypackage main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://apiv3.creatordb.app/youtube/content-detail"
payload := strings.NewReader("{\n \"channelId\": \"UCBR8-60-B28hp2BmDPdntcQ\",\n \"uniqueId\": \"@youtube\",\n \"fields\": {\n \"recentVideos\": 5,\n \"recentShorts\": 5\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("api-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://apiv3.creatordb.app/youtube/content-detail")
.header("api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"channelId\": \"UCBR8-60-B28hp2BmDPdntcQ\",\n \"uniqueId\": \"@youtube\",\n \"fields\": {\n \"recentVideos\": 5,\n \"recentShorts\": 5\n }\n}")
.asString();{
"data": {
"recentVideos": [
{
"publishTime": 1767816009000,
"contentId": "QJI0an6irrA",
"title": "30 Celebrities Fight For $1,000,000!",
"description": "",
"length": 2518,
"isSponsored": false,
"isMemberOnly": false,
"likes": 955450,
"comments": 49482,
"views": 26424459,
"engagementRate": 0.03803037178547345,
"hashtags": []
},
{
"publishTime": 1767793392562,
"contentId": "mktYW177p6U",
"title": "Guess the Animal",
"description": "",
"length": 0,
"isSponsored": false,
"isMemberOnly": false,
"likes": 1800000,
"comments": 9252,
"views": 99117362,
"engagementRate": 0.01825363350570206,
"hashtags": []
},
{
"publishTime": 1766840991701,
"contentId": "7aE4EhHXzlA",
"title": "I Paid Everyone Stuck in Traffic",
"description": "",
"length": 27,
"isSponsored": false,
"isMemberOnly": false,
"likes": 1700000,
"comments": 28341,
"views": 54959130,
"engagementRate": 0.031447750355582414,
"hashtags": []
},
{
"publishTime": 1766393469410,
"contentId": "IJkB-oapuks",
"title": "Giving Away $1,000,000 in Gifts To My Subscribers",
"description": "",
"length": 19,
"isSponsored": false,
"isMemberOnly": false,
"likes": 3100000,
"comments": 162485,
"views": 239192519,
"engagementRate": 0.01363957791673242,
"hashtags": []
},
{
"publishTime": 1766307069104,
"contentId": "ZFoNBxpXen4",
"title": "Survive 30 Days Trapped In The Sky, Win $250,000",
"description": "",
"length": 2246,
"isSponsored": false,
"isMemberOnly": false,
"likes": 2000000,
"comments": 79625,
"views": 102587634,
"engagementRate": 0.02027169278511677,
"hashtags": []
},
{
"publishTime": 1766220668425,
"contentId": "RB71Z-vVvCc",
"title": "Find The Real Celebrity, Win $10,000",
"description": "",
"length": 33,
"isSponsored": false,
"isMemberOnly": false,
"likes": 2500000,
"comments": 10043,
"views": 109409690,
"engagementRate": 0.022941688254486416,
"hashtags": []
},
{
"publishTime": 1765961468685,
"contentId": "fO5FwBcCJBY",
"title": "Would You Date Him for $10,000?",
"description": "",
"length": 33,
"isSponsored": false,
"isMemberOnly": false,
"likes": 2500000,
"comments": 17257,
"views": 90966291,
"engagementRate": 0.02767241548850222,
"hashtags": []
},
{
"publishTime": 1765614282036,
"contentId": "U-x6KxH1kB4",
"title": "How Many People to Pull a Plane?",
"description": "",
"length": 27,
"isSponsored": false,
"isMemberOnly": false,
"likes": 656000,
"comments": 10727,
"views": 29312779,
"engagementRate": 0.02274526751625972,
"hashtags": []
},
{
"publishTime": 1765356668965,
"contentId": "8bMh8azh3CY",
"title": "100 Pilots Fight For A Private Jet",
"description": "",
"length": 1726,
"isSponsored": false,
"isMemberOnly": false,
"likes": 1600000,
"comments": 67912,
"views": 113619821,
"engagementRate": 0.014679762609377813,
"hashtags": []
},
{
"publishTime": 1765298530722,
"contentId": "SE9xF1l3ZwE",
"title": "Hit The Target, Keep The Prize",
"description": "",
"length": 0,
"isSponsored": false,
"isMemberOnly": false,
"likes": 855000,
"comments": 7642,
"views": 37441474,
"engagementRate": 0.02303974464253197,
"hashtags": []
},
{
"publishTime": 1765287793167,
"contentId": "tAwzBYE18Us",
"title": "How I Became MrBeef",
"description": "",
"length": 46,
"isSponsored": false,
"isMemberOnly": false,
"likes": 1000000,
"comments": 14316,
"views": 26793336,
"engagementRate": 0.03785702534391387,
"hashtags": []
},
{
"publishTime": 1765114608606,
"contentId": "LyFMbY-c_Lc",
"title": "I Raced Noah Lyles",
"description": "",
"length": 32,
"isSponsored": false,
"isMemberOnly": false,
"likes": 3100000,
"comments": 9310,
"views": 231836574,
"engagementRate": 0.013411645739726986,
"hashtags": []
},
{
"publishTime": 1765114608508,
"contentId": "WROMyJAJmp4",
"title": "Can I Beat An F1 Driver?",
"description": "",
"length": 11,
"isSponsored": false,
"isMemberOnly": false,
"likes": 2100000,
"comments": 11034,
"views": 236595618,
"engagementRate": 0.008922540568777566,
"hashtags": []
},
{
"publishTime": 1764853792555,
"contentId": "rF00lQ_upzg",
"title": "Whatever You Hold Onto, You Keep",
"description": "",
"length": 26,
"isSponsored": false,
"isMemberOnly": false,
"likes": 710000,
"comments": 9654,
"views": 52366887,
"engagementRate": 0.01374253925004173,
"hashtags": []
},
{
"publishTime": 1764579068743,
"contentId": "3RmOvxilbPM",
"title": "100 People Vs World’s Biggest Trap!",
"description": "",
"length": 1843,
"isSponsored": true,
"isMemberOnly": false,
"likes": 1800000,
"comments": 81548,
"views": 93596233,
"engagementRate": 0.02010281759950745,
"hashtags": []
},
{
"publishTime": 1764579068623,
"contentId": "uZY9xr-QAk0",
"title": "Flip a Coin, I’ll Pay For Your College",
"description": "",
"length": 34,
"isSponsored": false,
"isMemberOnly": false,
"likes": 3400000,
"comments": 17333,
"views": 217610072,
"engagementRate": 0.015703928446841375,
"hashtags": []
},
{
"publishTime": 1763830801000,
"contentId": "Ah_uuTwGOYU",
"title": "World's Fastest Man Vs Robot!",
"description": "",
"length": 1104,
"isSponsored": false,
"isMemberOnly": false,
"likes": 1751534,
"comments": 62432,
"views": 87593702,
"engagementRate": 0.020708863292477352,
"hashtags": []
},
{
"publishTime": 1762695792744,
"contentId": "yWEUL3crU_E",
"title": "I Baked a Cake In a Race Car",
"description": "",
"length": 38,
"isSponsored": false,
"isMemberOnly": false,
"likes": 742000,
"comments": 7399,
"views": 39417432,
"engagementRate": 0.019011867642722134,
"hashtags": []
}
],
"recentShorts": [
{
"publishTime": 1764090000000,
"contentId": "AWBsoArakNY",
"title": "Who Has The Fastest Reaction Time?",
"description": "",
"length": 31,
"likes": 1390397,
"comments": 7470,
"views": 60879007,
"engagementRate": 0.022961396200171267,
"hashtags": []
},
{
"publishTime": 1763754001000,
"contentId": "HISfrcjiNPM",
"title": "I Surprised 50 Make-A-Wish Kids With Disneyland",
"description": "",
"length": 29,
"likes": 785027,
"comments": 11022,
"views": 30168415,
"engagementRate": 0.026386835370701443,
"hashtags": []
}
]
},
"creditsUsed": 1,
"creditsAvailable": 975,
"planCreditsAvailable": 900,
"purchasedCreditsAvailable": 75,
"traceId": "f6a08c6e27e6413b8d224eb809c1c3d0",
"timestamp": 1767923892280,
"errorCode": "",
"errorDescription": "",
"success": true
}Authorizations
The valid CreatorDB API key for authentication.
Body
application/json
Unique channel ID. Provide exactly one of channelId or uniqueId.
Required string length:
1 - 50Pattern:
^UC[a-zA-Z0-9_-]{22}$Example:
"UCBR8-60-B28hp2BmDPdntcQ"
YouTube channel handle. Accepts youtube or @youtube format (the @ prefix is optional). Provide exactly one of channelId or uniqueId.
Required string length:
1 - 100Example:
"@youtube"
Map each content array to the number of items to return. Omit or pass an empty object to return all items at the full-bundle price. For per-item costs, see Field and Item Costs.
Show child attributes
Show child attributes
Response
YouTube content details returned successfully.
Retrieved YouTube content details of a specified creator.
Show child attributes
Show child attributes
Number of API credits consumed by this request.
Example:
1
Number of API credits remaining. Equals planCreditsAvailable plus purchasedCreditsAvailable.
Example:
-1
Remaining plan credits after this request, in credits.
Example:
900
Remaining purchased-bucket credits after this request, in display units.
Example:
75
Unique trace ID for each request.
Example:
"f8e4a3b2c1d0e9f8a7b6c5d4e3f2a1b0"
Time the response was generated, represented as a Unix timestamp in milliseconds.
Example:
1750732453635
Error code returned if the request fails. Empty if the request is successful.
Example:
""
Description of the error. Empty if the request is successful.
Example:
""
true if the request is successful.
Example:
true
Remaining credits this API key can spend after this request, before reaching its spend limit. Present only when the key has a spend limit.
Example:
4975
⌘I
cURL
curl -X POST "https://apiv3.creatordb.app/youtube/content-detail" \
-H "Content-Type: application/json" \
-H "api-key: <YOUR_API_KEY_HERE>" \
-d '{ "channelId": "UCX6OQ3DkcsbYNE6H8uQQuVA", "fields": { "recentVideos": 5 } }'const options = {
method: 'POST',
headers: {'api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
channelId: 'UCBR8-60-B28hp2BmDPdntcQ',
uniqueId: '@youtube',
fields: {recentVideos: 5, recentShorts: 5}
})
};
fetch('https://apiv3.creatordb.app/youtube/content-detail', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://apiv3.creatordb.app/youtube/content-detail"
payload = {
"channelId": "UCBR8-60-B28hp2BmDPdntcQ",
"uniqueId": "@youtube",
"fields": {
"recentVideos": 5,
"recentShorts": 5
}
}
headers = {
"api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://apiv3.creatordb.app/youtube/content-detail",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'channelId' => 'UCBR8-60-B28hp2BmDPdntcQ',
'uniqueId' => '@youtube',
'fields' => [
'recentVideos' => 5,
'recentShorts' => 5
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}require 'uri'
require 'net/http'
url = URI("https://apiv3.creatordb.app/youtube/content-detail")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"channelId\": \"UCBR8-60-B28hp2BmDPdntcQ\",\n \"uniqueId\": \"@youtube\",\n \"fields\": {\n \"recentVideos\": 5,\n \"recentShorts\": 5\n }\n}"
response = http.request(request)
puts response.read_bodypackage main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://apiv3.creatordb.app/youtube/content-detail"
payload := strings.NewReader("{\n \"channelId\": \"UCBR8-60-B28hp2BmDPdntcQ\",\n \"uniqueId\": \"@youtube\",\n \"fields\": {\n \"recentVideos\": 5,\n \"recentShorts\": 5\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("api-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://apiv3.creatordb.app/youtube/content-detail")
.header("api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"channelId\": \"UCBR8-60-B28hp2BmDPdntcQ\",\n \"uniqueId\": \"@youtube\",\n \"fields\": {\n \"recentVideos\": 5,\n \"recentShorts\": 5\n }\n}")
.asString();{
"data": {
"recentVideos": [
{
"publishTime": 1767816009000,
"contentId": "QJI0an6irrA",
"title": "30 Celebrities Fight For $1,000,000!",
"description": "",
"length": 2518,
"isSponsored": false,
"isMemberOnly": false,
"likes": 955450,
"comments": 49482,
"views": 26424459,
"engagementRate": 0.03803037178547345,
"hashtags": []
},
{
"publishTime": 1767793392562,
"contentId": "mktYW177p6U",
"title": "Guess the Animal",
"description": "",
"length": 0,
"isSponsored": false,
"isMemberOnly": false,
"likes": 1800000,
"comments": 9252,
"views": 99117362,
"engagementRate": 0.01825363350570206,
"hashtags": []
},
{
"publishTime": 1766840991701,
"contentId": "7aE4EhHXzlA",
"title": "I Paid Everyone Stuck in Traffic",
"description": "",
"length": 27,
"isSponsored": false,
"isMemberOnly": false,
"likes": 1700000,
"comments": 28341,
"views": 54959130,
"engagementRate": 0.031447750355582414,
"hashtags": []
},
{
"publishTime": 1766393469410,
"contentId": "IJkB-oapuks",
"title": "Giving Away $1,000,000 in Gifts To My Subscribers",
"description": "",
"length": 19,
"isSponsored": false,
"isMemberOnly": false,
"likes": 3100000,
"comments": 162485,
"views": 239192519,
"engagementRate": 0.01363957791673242,
"hashtags": []
},
{
"publishTime": 1766307069104,
"contentId": "ZFoNBxpXen4",
"title": "Survive 30 Days Trapped In The Sky, Win $250,000",
"description": "",
"length": 2246,
"isSponsored": false,
"isMemberOnly": false,
"likes": 2000000,
"comments": 79625,
"views": 102587634,
"engagementRate": 0.02027169278511677,
"hashtags": []
},
{
"publishTime": 1766220668425,
"contentId": "RB71Z-vVvCc",
"title": "Find The Real Celebrity, Win $10,000",
"description": "",
"length": 33,
"isSponsored": false,
"isMemberOnly": false,
"likes": 2500000,
"comments": 10043,
"views": 109409690,
"engagementRate": 0.022941688254486416,
"hashtags": []
},
{
"publishTime": 1765961468685,
"contentId": "fO5FwBcCJBY",
"title": "Would You Date Him for $10,000?",
"description": "",
"length": 33,
"isSponsored": false,
"isMemberOnly": false,
"likes": 2500000,
"comments": 17257,
"views": 90966291,
"engagementRate": 0.02767241548850222,
"hashtags": []
},
{
"publishTime": 1765614282036,
"contentId": "U-x6KxH1kB4",
"title": "How Many People to Pull a Plane?",
"description": "",
"length": 27,
"isSponsored": false,
"isMemberOnly": false,
"likes": 656000,
"comments": 10727,
"views": 29312779,
"engagementRate": 0.02274526751625972,
"hashtags": []
},
{
"publishTime": 1765356668965,
"contentId": "8bMh8azh3CY",
"title": "100 Pilots Fight For A Private Jet",
"description": "",
"length": 1726,
"isSponsored": false,
"isMemberOnly": false,
"likes": 1600000,
"comments": 67912,
"views": 113619821,
"engagementRate": 0.014679762609377813,
"hashtags": []
},
{
"publishTime": 1765298530722,
"contentId": "SE9xF1l3ZwE",
"title": "Hit The Target, Keep The Prize",
"description": "",
"length": 0,
"isSponsored": false,
"isMemberOnly": false,
"likes": 855000,
"comments": 7642,
"views": 37441474,
"engagementRate": 0.02303974464253197,
"hashtags": []
},
{
"publishTime": 1765287793167,
"contentId": "tAwzBYE18Us",
"title": "How I Became MrBeef",
"description": "",
"length": 46,
"isSponsored": false,
"isMemberOnly": false,
"likes": 1000000,
"comments": 14316,
"views": 26793336,
"engagementRate": 0.03785702534391387,
"hashtags": []
},
{
"publishTime": 1765114608606,
"contentId": "LyFMbY-c_Lc",
"title": "I Raced Noah Lyles",
"description": "",
"length": 32,
"isSponsored": false,
"isMemberOnly": false,
"likes": 3100000,
"comments": 9310,
"views": 231836574,
"engagementRate": 0.013411645739726986,
"hashtags": []
},
{
"publishTime": 1765114608508,
"contentId": "WROMyJAJmp4",
"title": "Can I Beat An F1 Driver?",
"description": "",
"length": 11,
"isSponsored": false,
"isMemberOnly": false,
"likes": 2100000,
"comments": 11034,
"views": 236595618,
"engagementRate": 0.008922540568777566,
"hashtags": []
},
{
"publishTime": 1764853792555,
"contentId": "rF00lQ_upzg",
"title": "Whatever You Hold Onto, You Keep",
"description": "",
"length": 26,
"isSponsored": false,
"isMemberOnly": false,
"likes": 710000,
"comments": 9654,
"views": 52366887,
"engagementRate": 0.01374253925004173,
"hashtags": []
},
{
"publishTime": 1764579068743,
"contentId": "3RmOvxilbPM",
"title": "100 People Vs World’s Biggest Trap!",
"description": "",
"length": 1843,
"isSponsored": true,
"isMemberOnly": false,
"likes": 1800000,
"comments": 81548,
"views": 93596233,
"engagementRate": 0.02010281759950745,
"hashtags": []
},
{
"publishTime": 1764579068623,
"contentId": "uZY9xr-QAk0",
"title": "Flip a Coin, I’ll Pay For Your College",
"description": "",
"length": 34,
"isSponsored": false,
"isMemberOnly": false,
"likes": 3400000,
"comments": 17333,
"views": 217610072,
"engagementRate": 0.015703928446841375,
"hashtags": []
},
{
"publishTime": 1763830801000,
"contentId": "Ah_uuTwGOYU",
"title": "World's Fastest Man Vs Robot!",
"description": "",
"length": 1104,
"isSponsored": false,
"isMemberOnly": false,
"likes": 1751534,
"comments": 62432,
"views": 87593702,
"engagementRate": 0.020708863292477352,
"hashtags": []
},
{
"publishTime": 1762695792744,
"contentId": "yWEUL3crU_E",
"title": "I Baked a Cake In a Race Car",
"description": "",
"length": 38,
"isSponsored": false,
"isMemberOnly": false,
"likes": 742000,
"comments": 7399,
"views": 39417432,
"engagementRate": 0.019011867642722134,
"hashtags": []
}
],
"recentShorts": [
{
"publishTime": 1764090000000,
"contentId": "AWBsoArakNY",
"title": "Who Has The Fastest Reaction Time?",
"description": "",
"length": 31,
"likes": 1390397,
"comments": 7470,
"views": 60879007,
"engagementRate": 0.022961396200171267,
"hashtags": []
},
{
"publishTime": 1763754001000,
"contentId": "HISfrcjiNPM",
"title": "I Surprised 50 Make-A-Wish Kids With Disneyland",
"description": "",
"length": 29,
"likes": 785027,
"comments": 11022,
"views": 30168415,
"engagementRate": 0.026386835370701443,
"hashtags": []
}
]
},
"creditsUsed": 1,
"creditsAvailable": 975,
"planCreditsAvailable": 900,
"purchasedCreditsAvailable": 75,
"traceId": "f6a08c6e27e6413b8d224eb809c1c3d0",
"timestamp": 1767923892280,
"errorCode": "",
"errorDescription": "",
"success": true
}