creatordb-youtube-v3

---
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

```bash
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:
```json
{
  "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

```bash
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:
```json
{
  "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": "TWN",
    "mainLanguage": "zht",
    "languages": [
      "zht",
      "eng"
    ],
    "secondLanguage": "eng",
    "totalContents": 399,
    "totalSubscribers": 13900000,
    "subscriberGrowth": {
      "g7": 0.1234,
      "g30": 0.2345,
      "g90": 0.3456
    },
    "hashtags": [
      {
        "name": "#starrailsimulator",
        "contentCount": 250
      }
    ],
    "topics": [
      "freegames_Gaming"
    ],
    "niches": [
      "roblox_Gaming"
    ],
    "otherLinks": [
      {
        "title": "Instagram",
        "url": "https://www.instagram.com/instagram"
      }
    ],
    "lastPublishTime": 1755142212000,
    "relatedCreators": [
      "UCBR8-60-B28hp2BmDPdntcQ",
      "UC4PooiX37Pld1T8J5SYT-SQ"
    ],
    "videoPrice": {
      "cpmLow": 5.5,
      "cpmRaw": 8.2,
      "cpmHigh": 12,
      "priceLow": 1000,
      "priceRaw": 1500,
      "priceHigh": 2200
    },
    "shortsPrice": {
      "cpmLow": 3,
      "cpmRaw": 5,
      "cpmHigh": 8,
      "priceLow": 500,
      "priceRaw": 750,
      "priceHigh": 1100
    },
    "lastDbUpdateTime": 1753179002000
  },
  "quotaUsed": 1,
  "quotaUsedTotal": 241,
  "remainingQuota": 99759,
  "traceId": "f8e4a3b2c1d0e9f8a7b6c5d4e3f2a1b0",
  "timestamp": 1750732453635,
  "errorCode": "",
  "errorDescription": "",
  "success": true
}
```

## Get YouTuber performance

```bash
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
```json
{
  "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": {
      "likes": {
        "all": 2944445,
        "avg": 100,
        "median": 48,
        "min": 20,
        "max": 149
      },
      "comments": {
        "all": 2944445,
        "avg": 100,
        "median": 48,
        "min": 20,
        "max": 149
      },
      "views": {
        "all": 3599,
        "avg": 100,
        "median": 48,
        "min": 20,
        "max": 149,
        "percentile25": 35,
        "percentile75": 85,
        "iqr": 50
      },
      "length": {
        "avg": 180
      },
      "engagement": {
        "avgEngagementRate": 0.5201,
        "likesPerSubscriber": 0.1111,
        "commentsPerSubscriber": 0.1111,
        "viewsPerSubscriber": 0.1111,
        "engagementConsistency": {
          "cv": 0.1001,
          "medianVsMean": 0.9001,
          "topBottomRatio": 1.2001,
          "consistencyScore": 63,
          "consistencyLevel": "high"
        }
      }
    },
    "shortsPerformanceRecent": {
      "likes": {
        "all": 2459,
        "avg": 100,
        "median": 120,
        "min": 50,
        "max": 988
      },
      "comments": {
        "all": 2459,
        "avg": 100,
        "median": 120,
        "min": 50,
        "max": 988
      },
      "views": {
        "all": 2459,
        "avg": 100,
        "median": 120,
        "min": 50,
        "max": 988,
        "percentile25": 80,
        "percentile75": 250,
        "iqr": 170
      },
      "length": {
        "avg": 180
      },
      "engagement": {
        "avgEngagementRate": 0.5201,
        "likesPerSubscriber": 0.1111,
        "commentsPerSubscriber": 0.1111,
        "viewsPerSubscriber": 0.1111,
        "engagementConsistency": {
          "cv": 0.1001,
          "medianVsMean": 0.9001,
          "topBottomRatio": 1.2001,
          "consistencyScore": 63,
          "consistencyLevel": "high"
        }
      }
    },
    "videosPerformanceAll": {
      "likes": {
        "all": 2944445,
        "avg": 100,
        "median": 48,
        "min": 20,
        "max": 149
      },
      "comments": {
        "all": 2944445,
        "avg": 100,
        "median": 48,
        "min": 20,
        "max": 149
      },
      "views": {
        "all": 3599,
        "avg": 100,
        "median": 48,
        "min": 20,
        "max": 149,
        "percentile25": 35,
        "percentile75": 85,
        "iqr": 50
      },
      "length": {
        "avg": 180
      },
      "engagement": {
        "avgEngagementRate": 0.5201,
        "likesPerSubscriber": 0.1111,
        "commentsPerSubscriber": 0.1111,
        "viewsPerSubscriber": 0.1111,
        "engagementConsistency": {
          "cv": 0.1001,
          "medianVsMean": 0.9001,
          "topBottomRatio": 1.2001,
          "consistencyScore": 63,
          "consistencyLevel": "high"
        }
      }
    },
    "shortsPerformanceAll": {
      "likes": {
        "all": 2459,
        "avg": 100,
        "median": 120,
        "min": 50,
        "max": 988
      },
      "comments": {
        "all": 2459,
        "avg": 100,
        "median": 120,
        "min": 50,
        "max": 988
      },
      "views": {
        "all": 2459,
        "avg": 100,
        "median": 120,
        "min": 50,
        "max": 988,
        "percentile25": 80,
        "percentile75": 250,
        "iqr": 170
      },
      "length": {
        "avg": 180
      },
      "engagement": {
        "avgEngagementRate": 0.5201,
        "likesPerSubscriber": 0.1111,
        "commentsPerSubscriber": 0.1111,
        "viewsPerSubscriber": 0.1111,
        "engagementConsistency": {
          "cv": 0.1001,
          "medianVsMean": 0.9001,
          "topBottomRatio": 1.2001,
          "consistencyScore": 63,
          "consistencyLevel": "high"
        }
      }
    },
    "recentVideosGrowth": {
      "g7": {
        "avgViews": 0.2345,
        "engagementRate": 0.0567
      },
      "g30": {
        "avgViews": 0.2345,
        "engagementRate": 0.0567
      },
      "g90": {
        "avgViews": 0.2345,
        "engagementRate": 0.0567
      }
    },
    "recentShortsGrowth": {
      "g7": {
        "avgViews": 0.2345,
        "engagementRate": 0.0567
      },
      "g30": {
        "avgViews": 0.2345,
        "engagementRate": 0.0567
      },
      "g90": {
        "avgViews": 0.2345,
        "engagementRate": 0.0567
      }
    }
  },
  "quotaUsed": 1,
  "quotaUsedTotal": 241,
  "remainingQuota": 99759,
  "traceId": "f8e4a3b2c1d0e9f8a7b6c5d4e3f2a1b0",
  "timestamp": 1750732453635,
  "errorCode": "",
  "errorDescription": "",
  "success": true
}
```

## Get YouTuber content detail

```base
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

```json
{
  "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": [
          "#VLOG"
        ]
      }
    ],
    "recentShorts": [
      {
        "publishTime": 1754928000000,
        "contentId": "6tlVsknqy9M",
        "title": "Customized skin care clinics available in Japan #cosmeticmedicine",
        "description": "Recommended for those looking for skin care in Tokyo. Shimokitazawa Cosmetic Dermatology Clinic @oneup_clinic",
      

... (truncated)