Youtube Reporter by CreatorDB

Can search and get YouTuber information

Security Scan

The skill's runtime instructions match its description (it calls CreatorDB's YouTube API), but the published registry metadata omits required artifacts (an API key and curl) declared inside SKILL.md — this mismatch should be resolved before trusting the skill.

Purpose & Capability

The name/description match the SKILL.md: the instructions show explicit curl calls to apiv3.creatordb.app to search and fetch YouTuber profiles and performance metrics. Those capabilities are coherent with the stated purpose. However, the registry metadata provided to the platform claims no required env vars or binaries, while the SKILL.md metadata declares a required CREATORDB_API_KEY and curl — an inconsistency worth flagging.

Instruction Scope

The SKILL.md only instructs the agent to call CreatorDB API endpoints using curl with an api-key header. It does not ask the agent to read local files, other environment variables, or other system configuration, nor to transmit data to unexpected external endpoints. Scope stays within fetching YouTuber data from CreatorDB.

Install Mechanism

There is no install spec and no code files; this is an instruction-only skill. That minimizes disk-write/execution risk (the runtime behavior depends on the runtime environment having curl).

Credentials

SKILL.md metadata requires CREATORDB_API_KEY (declared as primaryEnv) and the curl binary, which are proportionate to calling a third‑party API. But the registry metadata advertises no required env vars/binaries — that mismatch is suspicious because it could hide that the skill needs a secret (API key). Confirming which metadata is authoritative is important before installing or providing credentials.

Persistence & Privilege

The skill is not always-enabled and is user-invocable; it allows autonomous invocation (the platform default) but does not request elevated persistence or modify other skills or system settings. Nothing here indicates elevated long-term privileges.

What to consider before installing

This skill appears to simply wrap CreatorDB's YouTube API and legitimately needs an API key and curl to function. However, the platform registry lists no required env vars while the SKILL.md requires CREATORDB_API_KEY and curl — that's an inconsistency you should resolve before installing. Actions to take: 1) Ask the publisher or registry maintainer to correct the published metadata so required env vars and binaries are visible. 2) Only provide a CREATORDB API key (not other credentials). 3) Verify the api endpoint (apiv3.creatordb.app) and the vendor (https://www.creatordb.app) match expectations and trustworthiness. 4) If you allow autonomous invocation, be aware the agent may call the external API whenever the skill is triggered; limit scope or permissions if you want tighter control. If the metadata mismatch can't be clarified, avoid installing or providing secrets.

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

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": {
      "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

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": [
          "#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",
        "length": 60,
        "likes": 10000,
        "comments": 100,
        "views": 15000,
        "engagementRate": 0.0517,
        "hashtags": [
          "#cosmeticmedicine"
        ]
      }
    ]
  },
  "quotaUsed": 1,
  "quotaUsedTotal": 241,
  "remainingQuota": 99759,
  "traceId": "f8e4a3b2c1d0e9f8a7b6c5d4e3f2a1b0",
  "timestamp": 1750732453635,
  "errorCode": "",
  "errorDescription": "",
  "success": true
}

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": false,
            "likes": 10000,
            "comments": 100,
            "views": 15000,
            "engagementRate": 0.1202,
            "hashtags": [
              "#VLOG"
            ]
          }
        ],
        "sponsoredVideosPerformance": {
          "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"
            }
          }
        }
      }
    ]
  },
  "quotaUsed": 1,
  "quotaUsedTotal": 241,
  "remainingQuota": 99759,
  "traceId": "f8e4a3b2c1d0e9f8a7b6c5d4e3f2a1b0",
  "timestamp": 1750732453635,
  "errorCode": "",
  "errorDescription": "",
  "success": true
}

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": [
      {
        "ageRange": "13-17",
        "share": 0.0123
      },
      {
        "ageRange": "18-24",
        "share": 0.1871
      },
      {
        "ageRange": "25-34",
        "share": 0.2818
      },
      {
        "ageRange": "35-44",
        "share": 0.2025
      },
      {
        "ageRange": "45-54",
        "share": 0.1398
      },
      {
        "ageRange": "55-64",
        "share": 0.1
      },
      {
        "ageRange": "65+",
        "share": 0.0765
      }
    ]
  },
  "quotaUsed": 1,
  "quotaUsedTotal": 241,
  "remainingQuota": 99759,
  "traceId": "f8e4a3b2c1d0e9f8a7b6c5d4e3f2a1b0",
  "timestamp": 1750732453635,
  "errorCode": "",
  "errorDescription": "",
  "success": true
}

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 days
• videoPrice/shortsPrice: estimated sponsorship pricing in USD
• categoryBreakdown: channel content category distribution
• Pagination: use offset and pageSize for search results