| name | creatordb-youtube-v3 |
| description | Can search and get YouTuber information |
| homepage | https://www.creatordb.app |
| metadata | {"moltbot":{"emoji":"🐽","requires":{"bins":["curl"],"env":["CREATORDB_API_KEY"]},"primaryEnv":"CREATORDB_API_KEY","install":[]}} |
CreatorDB YouTube API
Search and retrieve YouTuber information including subscribers, growth stats, pricing estimates, and more.
Search YouTubers by Name
curl --request POST \
--url https://apiv3.creatordb.app/youtube/search \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header "api-key: $CREATORDB_API_KEY" \
--data '{
"filters": [
{
"filterName": "displayName",
"op": "=",
"value": "MrBeast",
"isFuzzySearch": true
}
],
"desc": true,
"sortBy": "totalSubscribers",
"pageSize": 5,
"offset": 0
}'
Search Response:
{
"data": {
"creatorList": [
{
"displayName": "YouTube",
"uniqueId": "@youtube",
"channelId": "UCBR8-60-B28hp2BmDPdntcQ",
"avatarUrl": "https://yt3.googleusercontent.com/7cF22TRiceqQr2Cro_X4uhRVnwCdOa2HXiwdBGPnUEqJDuCyr2CykDfDw2rCWjbjaHEdTMUC=s900-c-k-c0x00ffffff-no-rj",
"totalSubscribers": 13900000
}
],
"hasNextPage": true,
"nextOffset": 100
},
"quotaUsed": 1,
"quotaUsedTotal": 241,
"remainingQuota": 99759,
"traceId": "f8e4a3b2c1d0e9f8a7b6c5d4e3f2a1b0",
"timestamp": 1750732453635,
"errorCode": "",
"errorDescription": "",
"success": true
}
Get YouTuber Profile
curl --request GET \
--url 'https://apiv3.creatordb.app/youtube/profile?channelId=UCBR8-60-B28hp2BmDPdntcQ' \
--header 'Accept: application/json' \
--header "api-key: $CREATORDB_API_KEY"
Profile Response:
{
"data": {
"channelId": "UCBR8-60-B28hp2BmDPdntcQ",
"uniqueId": "@youtube",
"displayName": "YouTube",
"categoryBreakdown": [
{
"category": "Gaming",
"share": 0.3241
}
],
"avatarUrl": "https://yt3.googleusercontent.com/7cF22TRiceqQr2Cro_X4uhRVnwCdOa2HXiwdBGPnUEqJDuCyr2CykDfDw2rCWjbjaHEdTMUC=s900-c-k-c0x00ffffff-no-rj",
"bio": "The Most Botted Channel EVER",
"isVerified": true,
"hasSponsors": true,
"hasMemberOnlyContents": true,
"country":
Get YouTuber performance
curl --request GET \
--url 'https://apiv3.creatordb.app/youtube/performance?channelId=UCBR8-60-B28hp2BmDPdntcQ' \
--header 'Accept: application/json' \
--header 'api-key: $CREATORDB_API_KEY'
Response
{
"data": {
"contentCountByDays": {
"7d": 1,
"30d": 2,
"90d": 2
},
"ranking": {
"totalSubscribers": {
"global": 0.9912,
"country": 0.9986,
"language": 0.9764
},
"avgEngagementRate": {
"global": 0.9912,
"country": 0.9986,
"language": 0.9764
}
},
"videosPerformanceRecent":
Get YouTuber content detail
curl --request GET \
--url 'https://apiv3.creatordb.app/youtube/content-detail?channelId=UCBR8-60-B28hp2BmDPdntcQ' \
--header 'Accept: application/json' \
--header 'api-key: $CREATORDB_API_KEY'
Response
{
"data": {
"recentVideos": [
{
"publishTime": 1755273600000,
"contentId": "FbCF_H4ZD64",
"title": "I hosted an ADMIN ABUSE on GROW A GARDEN",
"description": "Thanks @JandelTheGuy play grow a garden here support a small developer like Jandel. Today I hosted an admin abuse to 20 million people",
"length": 873,
"isSponsored": true,
"isMemberOnly": false,
"likes": 153000,
"comments": 15182,
"views": 5009695,
"engagementRate": 0.0336,
"hashtags"
Get YouTuber Sponsorship information
curl --request GET \
--url 'https://apiv3.creatordb.app/youtube/sponsorship?channelId=UCBR8-60-B28hp2BmDPdntcQ' \
--header 'Accept: application/json' \
--header 'api-key: $CREATORDB_API_KEY'
Response
{
"data": {
"sponsorList": [
{
"brandName": "Acer",
"brandId": "acer.com",
"brandIgIds": [
"acer"
],
"sponsoredVideos": [
{
"publishTime": 1754797869000,
"contentId": "eHnzGYHEdO0",
"title": "ROBLOX OP ADMIN IN STEAL A BRAINROT",
"description": "Roblox admin in steal a brainrot except way more OP. i gave almost everyone their stuff back its just fun to make these kids laugh in voice chat lol",
"length": 873,
"isSponsored": true,
"isMemberOnly":
Get YouTuber audience demographics
curl --request GET \
--url 'https://apiv3.creatordb.app/youtube/audience?channelId=UCBR8-60-B28hp2BmDPdntcQ' \
--header 'Accept: application/json' \
--header 'api-key: $CREATORDB_API_KEY'
Response
{
"data": {
"audienceLocations": [
{
"country": "USA",
"share": 0.5511
},
{
"country": "GBR",
"share": 0.1313
},
{
"country": "CAN",
"share": 0.0501
}
],
"audienceGender": {
"maleRatio": 0.5233,
"femaleRatio": 0.4412
},
"audienceAvgAge": 30,
"audienceAgeBreakdown": [
API Key
CREATORDB_API_KEY env var is required- Or set
skills."creatordb-youtube-v3".env.CREATORDB_API_KEY in ~/.clawdbot/moltbot.json
- Get your API key at https://www.creatordb.app
Notes
- Use
channelId from search results to get detailed profile
subscriberGrowth: g7/g30/g90 = growth rate over 7/30/90 daysvideoPrice/shortsPrice: estimated sponsorship pricing in USDcategoryBreakdown: channel content category distribution- Pagination: use
offset and pageSize for search results
