> ## Documentation Index > Fetch the complete documentation index at: https://docs.creatordb.app/llms.txt > Use this file to discover all available pages before exploring further. # Get Sponsorship Information > Retrieve recent YouTube videos identified as sponsored content for a specific creator, with metadata and engagement insights for influencer marketing analysis.

Optionally pass `fields` in the request body to limit how many sponsoring brands are returned. You are billed per brand returned, 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`). Per-brand costs are not published yet. For how fractional calls work, see [Fractional Calls](/api-v3/fractional-calls). ## OpenAPI ````yaml /api-v3/api-v3.yaml post /youtube/sponsorship openapi: 3.1.0 info: version: 1.0.0 title: CreatorDB Headless API V3 description: '# CreatorDB Headless API V3' contact: name: CreatorDB url: https://www.creatordb.app email: support@creatordb.app license: url: http://www.apache.org/licenses/LICENSE-2.0.html name: Apache 2.0 servers: - url: https://apiv3.creatordb.app description: Production Environment (CreatorDB Headless API V3) security: - ApiKeyAuth: [] tags: - name: Brand description: Brand analysis endpoints including sponsor search and brand reports. - name: Facebook description: Facebook creator data endpoints with metrics and search capabilities. - name: General Operations description: >- General-purpose endpoints such as API status, content retrieval, and cross-platform operations. - name: Instagram description: >- Instagram creator data endpoints with metrics and advanced search capabilities. - name: Niches description: >- Niche-related endpoints for content category analysis and related searches. - name: Threads description: Threads creator data endpoints with basic metrics and historical data. - name: TikTok description: >- TikTok creator data endpoints with metrics and advanced search functionality. - name: Topic description: Topic-based analysis and reporting endpoints for content categorization. - name: YouTube description: >- YouTube creator data endpoints including basic metrics, historical data, and detailed analytics. paths: /youtube/sponsorship: post: tags: - YouTube summary: Get Sponsorship Information description: >- Retrieve recent YouTube videos identified as sponsored content for a specific creator, with metadata and engagement insights for influencer marketing analysis.

Optionally pass `fields` in the request body to limit how many sponsoring brands are returned. You are billed per brand returned, 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`). Per-brand costs are not published yet. For how fractional calls work, see [Fractional Calls](/api-v3/fractional-calls). operationId: getYoutubeSponsorship requestBody: required: true content: application/json: schema: type: object required: - channelId properties: channelId: type: string description: Unique channel ID. pattern: ^UC[a-zA-Z0-9_-]{22}$ minLength: 1 maxLength: 50 examples: - UCBR8-60-B28hp2BmDPdntcQ fields: type: object description: >- Map `sponsorList` to the number of sponsoring brands to return. Omit or pass an empty object to return all brands at the full-bundle price. Per-brand costs are not published yet. properties: sponsorList: type: integer description: Number of sponsoring brands to return. examples: - 5 responses: '200': description: YouTube sponsorship data returned successfully. content: application/json: schema: type: object description: >- YouTube sponsorship API response with sponsor-grouped videos and performance metrics. properties: data: type: object description: >- Retrieve data of recently sponsored YouTube videos for a specified creator. properties: sponsorList: type: array description: List of sponsors and their associated branded content. items: type: object description: >- A sponsor's branded videos and aggregated performance metrics. properties: brandName: type: string description: The sponsor name. examples: - Acer brandId: type: string description: >- The official website URL or unique identifier of the sponsor. examples: - acer.com brandIgIds: type: array description: The Instagram handles of the sponsor. examples: - - acer items: type: string sponsoredVideos: type: array description: Recent sponsored YouTube videos data. items: type: object description: A recent sponsored YouTube video. properties: publishTime: type: integer description: >- Publish time, represented as a Unix timestamp in milliseconds. examples: - 1754797869000 contentId: type: string description: >- The unique identifier. Represented as follows: `https://www.youtube.com/watch?v={contentId}` examples: - eHnzGYHEdO0 title: type: string description: The sponsored video title. examples: - ROBLOX OP ADMIN IN STEAL A BRAINROT description: type: string description: >- The sponsored video description, including emojis, mentions, URLs, and line breaks. examples: - >- 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: type: integer description: Video length in seconds. examples: - 873 isSponsored: type: boolean description: '`true` if sponsored.' examples: - true isMemberOnly: type: boolean description: '`true` if member-only.' examples: - false likes: type: integer description: Number of likes. examples: - 10000 comments: type: integer description: Number of comments. examples: - 100 views: type: integer description: Number of views. examples: - 15000 engagementRate: type: number description: >- Engagement rate, rounded to 4th decimal place.
*Engagement Rate = (Likes + Comments + Views) / Subscribers* examples: - 0.1202 hashtags: type: array description: Keywords used in the video description. examples: - - '#VLOG' items: type: string required: - publishTime - contentId - title - description - length - isSponsored - isMemberOnly - likes - comments - views - engagementRate - hashtags sponsoredVideosPerformance: type: object description: >- Aggregated performance metrics for sponsored YouTube videos broken down by brands. properties: likes: type: object description: >- Likes statistics for sponsored YouTube videos broken down by brands. properties: all: type: integer description: >- Total number of likes across the last 20 sponsored YouTube videos. minimum: 0 examples: - 2944445 avg: type: integer description: >- Average likes per video for the last 20 sponsored YouTube videos, rounded to an integer. minimum: 0 examples: - 100 median: type: integer description: >- Median number of likes across the last 20 sponsored YouTube videos. minimum: 0 examples: - 48 min: type: integer description: >- Minimum number of likes across the last 20 sponsored YouTube videos. minimum: 0 examples: - 20 max: type: integer description: >- Maximum number of likes across the last 20 sponsored YouTube videos. minimum: 0 examples: - 149 required: - all - avg - median - min - max comments: type: object description: >- Comments statistics for sponsored YouTube videos broken down by brands. properties: all: type: integer description: >- Total number of comments across the last 20 sponsored YouTube videos. minimum: 0 examples: - 2944445 avg: type: integer description: >- Average comments per video for the last 20 sponsored YouTube videos, rounded to an integer. minimum: 0 examples: - 100 median: type: integer description: >- Median number of comments across the last 20 sponsored YouTube videos. minimum: 0 examples: - 48 min: type: integer description: >- Minimum number of comments across the last 20 sponsored YouTube videos. minimum: 0 examples: - 20 max: type: integer description: >- Maximum number of comments across the last 20 sponsored YouTube videos. minimum: 0 examples: - 149 required: - all - avg - median - min - max views: type: object description: >- View statistics for sponsored YouTube videos broken down by brands. properties: all: type: integer description: >- Total number of views across the last 20 sponsored YouTube videos. minimum: 0 examples: - 3599 avg: type: integer description: >- Average views per video for the last 20 sponsored YouTube videos, rounded to an integer. minimum: 0 examples: - 100 median: type: integer description: >- Median number of views across the last 20 sponsored YouTube videos. minimum: 0 examples: - 48 min: type: integer description: >- Minimum number of views across the last 20 sponsored YouTube videos. minimum: 0 examples: - 20 max: type: integer description: >- Maximum number of views across the last 20 sponsored YouTube videos. minimum: 0 examples: - 149 percentile25: type: integer description: >- The 25th percentile (first quartile) of views across the last 20 sponsored YouTube videos. minimum: 0 examples: - 35 percentile75: type: integer description: >- The 75th percentile (third quartile) of views across the last 20 sponsored YouTube videos. minimum: 0 examples: - 85 iqr: type: integer description: >- Interquartile range (IQR) of views, calculated as 25th to 75th percentile, representing the spread of the middle 50%. minimum: 0 examples: - 50 required: - all - avg - median - min - max - percentile25 - percentile75 - iqr length: type: object description: >- Length statistics for sponsored YouTube videos broken down by brands. properties: avg: type: integer description: >- The average sponsored video length in seconds, rounded to an integer. minimum: 0 examples: - 180 required: - avg engagement: type: object description: >- Engagement performance metrics for sponsored YouTube videos broken down by brands. properties: avgEngagementRate: type: number description: >- Average engagement rate per sponsored video, rounded to 4th decimal place.
- *Engagement Rate = (Likes + Comments + Views) / Subscribers* minimum: 0 examples: - 0.5201 likesPerSubscriber: type: number description: >- Average number of likes per subscriber for sponsored videos, rounded to 4th decimal place. minimum: 0 examples: - 0.1111 commentsPerSubscriber: type: number description: >- Average number of comments per subscriber for sponsored videos, rounded to 4th decimal place. minimum: 0 examples: - 0.1111 viewsPerSubscriber: type: number description: >- Average number of views per subscriber for sponsored videos, rounded to 4th decimal place. minimum: 0 examples: - 0.1111 engagementConsistency: type: object description: >- Consistency of engagement performance across sponsored videos broken down by brands. properties: cv: type: number description: >- *cv = Standard Deviation of Engagement Rate/ Mean Engagement Rate*
- The value is rounded to 4th decimal place.
- Lower values indicate more consistent performance.
- *A value of `0` indicates insufficient data.* minimum: 0 examples: - 0.1001 medianVsMean: type: number description: >- *medianVsMean = Median Engagement Rate/ Mean Engagement Rate*
- The value is rounded to 4th decimal place.
- Values closer to `1` indicate more consistent performance.
- *A value of `0` indicates insufficient data.* minimum: 0 examples: - 0.9001 topBottomRatio: type: number description: >- *topBottomRatio = avg(Top 3 Engagement)/avg(Bottom 3 Engagement)*
- The value is rounded to 4th decimal place.
- Lower ratios indicate more consistent performance.
- *A value of `0` indicates insufficient data.* minimum: 0 examples: - 1.2001 consistencyScore: type: - integer - 'null' description: >- *consistencyScore = 100 - [(cvScore\*weight_cv) + (topBottomScore\*weight_topBottom) + (medianVsMeanScore\*weight_medianVsMean)]*
- The score is rounded to an integer.
- A higher score indicates more stable and consistent performance.
- If any of the three indicators is `0`, the `consistencyScore` will be `null`. minimum: 0 maximum: 100 examples: - 63 consistencyLevel: type: string enum: - high - moderate - low - null description: >- A qualitative label based on the `consistencyScore`:
- high: 81 - 100
- moderate: 51 - 80
- low: 0 - 50
- Returns `null` when `consistencyScore` is `null`. examples: - moderate required: - cv - medianVsMean - topBottomRatio - consistencyScore - consistencyLevel required: - avgEngagementRate - likesPerSubscriber - commentsPerSubscriber - viewsPerSubscriber - engagementConsistency required: - likes - comments - views - length - engagement required: - brandName - brandId - brandIgIds - sponsoredVideos - sponsoredVideosPerformance required: - sponsorList creditsUsed: type: integer description: Number of API credits consumed by this request. examples: - 1 creditsAvailable: type: integer description: Number of API credits remaining. examples: - -1 traceId: type: string description: Unique trace ID for each request. examples: - f8e4a3b2c1d0e9f8a7b6c5d4e3f2a1b0 timestamp: type: integer description: >- Time the response was generated, represented as a Unix timestamp in milliseconds. examples: - 1750732453635 errorCode: type: string description: >- Error code returned if the request fails. Empty if the request is successful. examples: - '' errorDescription: type: string description: >- Description of the error. Empty if the request is successful. examples: - '' success: type: boolean description: '`true` if the request is successful.' examples: - true required: - data - traceId - timestamp - errorCode - errorDescription - success - creditsUsed - creditsAvailable examples: default: value: data: sponsorList: - brandName: Current brandId: current.com brandIgIds: - current sponsoredVideos: - publishTime: 1757779201000 contentId: 4l97aNza_Zc title: Survive 30 Days Chained To Your Ex, Win $250,000 description: '' length: 2224 isSponsored: true isMemberOnly: false likes: 3747936 comments: 59717 views: 188712721 engagementRate: 0.0202 hashtags: [] sponsoredVideosPerformance: likes: all: 3747936 avg: 3747936 median: 3747936 min: 3747936 max: 3747936 comments: all: 59717 avg: 59717 median: 59717 min: 59717 max: 59717 views: all: 188712721 avg: 188712721 median: 188712721 min: 188712721 max: 188712721 engagement: avgEngagementRate: 0.0202 likesPerSubscriber: 0.0082 commentsPerSubscriber: 0.0001 viewsPerSubscriber: 0.4111 engagementConsistency: cv: 0 medianVsMean: 1 topBottomRatio: 0 consistencyScore: null consistencyLevel: null - brandName: Feastables brandId: feastables.com brandIgIds: - feastables sponsoredVideos: - publishTime: 1757779201000 contentId: 4l97aNza_Zc title: Survive 30 Days Chained To Your Ex, Win $250,000 description: '' length: 2224 isSponsored: true isMemberOnly: false likes: 3747936 comments: 59717 views: 188712721 engagementRate: 0.0202 hashtags: [] - publishTime: 1756934693370 contentId: _AbFXuGDRTs title: $1 vs $1,000,000,000 Nuclear Bunker! description: '' length: 1038 isSponsored: true isMemberOnly: false likes: 2700000 comments: 35478 views: 137386751 engagementRate: 0.0199 hashtags: [] - publishTime: 1751750691470 contentId: hTSaweR8qMI title: $1 vs $500,000 Date description: '' length: 1042 isSponsored: true isMemberOnly: false likes: 3400000 comments: 60488 views: 157421489 engagementRate: 0.022 hashtags: [] - publishTime: 1743974692270 contentId: aKq8bkY5eTU title: I Survived The 5 Deadliest Places On Earth description: '' length: 803 isSponsored: true isMemberOnly: false likes: 3100000 comments: 54565 views: 165951430 engagementRate: 0.019 hashtags: [] sponsoredVideosPerformance: likes: all: 12947936 avg: 3236984 median: 3250000 min: 2700000 max: 3747936 comments: all: 210248 avg: 52562 median: 57141 min: 35478 max: 60488 views: all: 649472391 avg: 162368098 median: 161686460 min: 137386751 max: 188712721 engagement: avgEngagementRate: 0.0203 likesPerSubscriber: 0.0071 commentsPerSubscriber: 0.0001 viewsPerSubscriber: 0.3537 engagementConsistency: cv: 0.0532 medianVsMean: 0.9889 topBottomRatio: 0 consistencyScore: null consistencyLevel: null - brandName: Moose Toys brandId: moosetoys.com brandIgIds: - moosetoys sponsoredVideos: - publishTime: 1756934691413 contentId: TDv56whosPQ title: Survive 100 Days In Prison, Win $500,000 description: '' length: 2376 isSponsored: true isMemberOnly: false likes: 2900000 comments: 41450 views: 137375010 engagementRate: 0.0214 hashtags: [] - publishTime: 1741382692107 contentId: NDsO1LT_0lw title: I Spent 100 Hours Inside The Pyramids! description: '' length: 1303 isSponsored: true isMemberOnly: false likes: 5300000 comments: 100512 views: 223248378 engagementRate: 0.0242 hashtags: [] sponsoredVideosPerformance: likes: all: 8200000 avg: 4100000 median: 4100000 min: 2900000 max: 5300000 comments: all: 141962 avg: 70981 median: 70981 min: 41450 max: 100512 views: all: 360623388 avg: 180311694 median: 180311694 min: 137375010 max: 223248378 engagement: avgEngagementRate: 0.0228 likesPerSubscriber: 0.0089 commentsPerSubscriber: 0.0002 viewsPerSubscriber: 0.3928 engagementConsistency: cv: 0.0609 medianVsMean: 1 topBottomRatio: 0 consistencyScore: null consistencyLevel: null - brandName: DoorDash brandId: doordash.com brandIgIds: - doordash sponsoredVideos: - publishTime: 1754342692574 contentId: pzBi1nwDn8U title: >- Survive 100 Days Trapped In A Private Jet, Keep It description: '' length: 1983 isSponsored: true isMemberOnly: false likes: 3400000 comments: 45636 views: 136277760 engagementRate: 0.0253 hashtags: [] - publishTime: 1746566692069 contentId: figrl0aOULs title: Click This Video To Feed 1 Person description: '' length: 629 isSponsored: true isMemberOnly: false likes: 4200000 comments: 73423 views: 74746546 engagementRate: 0.0572 hashtags: [] sponsoredVideosPerformance: likes: all: 7600000 avg: 3800000 median: 3800000 min: 3400000 max: 4200000 comments: all: 119059 avg: 59530 median: 59530 min: 45636 max: 73423 views: all: 211024306 avg: 105512153 median: 105512153 min: 74746546 max: 136277760 engagement: avgEngagementRate: 0.0412 likesPerSubscriber: 0.0083 commentsPerSubscriber: 0.0001 viewsPerSubscriber: 0.2299 engagementConsistency: cv: 0.3867 medianVsMean: 1 topBottomRatio: 0 consistencyScore: null consistencyLevel: null - brandName: Lenovo Group Limited brandId: lenovo.com brandIgIds: - lenovo sponsoredVideos: - publishTime: 1754342692408 contentId: FWAdfuPpLOc title: World's Fastest Car Vs Cheetah! description: '' length: 1237 isSponsored: true isMemberOnly: false likes: 3300000 comments: 45929 views: 199699308 engagementRate: 0.0168 hashtags: [] sponsoredVideosPerformance: likes: all: 3300000 avg: 3300000 median: 3300000 min: 3300000 max: 3300000 comments: all: 45929 avg: 45929 median: 45929 min: 45929 max: 45929 views: all: 199699308 avg: 199699308 median: 199699308 min: 199699308 max: 199699308 engagement: avgEngagementRate: 0.0168 likesPerSubscriber: 0.0072 commentsPerSubscriber: 0.0001 viewsPerSubscriber: 0.4351 engagementConsistency: cv: 0 medianVsMean: 1 topBottomRatio: 0 consistencyScore: null consistencyLevel: null - brandName: T-Mobile brandId: t-mobile.com brandIgIds: - tmobile sponsoredVideos: - publishTime: 1749158692180 contentId: DZIASl9q90s title: Beat Neymar, Win $500,000 description: '' length: 1673 isSponsored: true isMemberOnly: false likes: 3500000 comments: 80356 views: 155611225 engagementRate: 0.023 hashtags: [] - publishTime: 1736343792866 contentId: Pv0iVoSZzN8 title: In 10 Minutes This Room Will Explode! description: '' length: 600 isSponsored: true isMemberOnly: false likes: 4100000 comments: 77174 views: 163264294 engagementRate: 0.0256 hashtags: [] sponsoredVideosPerformance: likes: all: 7600000 avg: 3800000 median: 3800000 min: 3500000 max: 4100000 comments: all: 157530 avg: 78765 median: 78765 min: 77174 max: 80356 views: all: 318875519 avg: 159437760 median: 159437760 min: 155611225 max: 163264294 engagement: avgEngagementRate: 0.0243 likesPerSubscriber: 0.0083 commentsPerSubscriber: 0.0002 viewsPerSubscriber: 0.3474 engagementConsistency: cv: 0.053 medianVsMean: 1 topBottomRatio: 0 consistencyScore: null consistencyLevel: null - brandName: Jack Link's brandId: jacklinks.com brandIgIds: - jacklinksjerky sponsoredVideos: - publishTime: 1749158692027 contentId: '-4GmbBoYQjE' title: I Survived 100 Hours In An Ancient Temple description: '' length: 946 isSponsored: true isMemberOnly: false likes: 2900000 comments: 77685 views: 124496850 engagementRate: 0.0239 hashtags: [] sponsoredVideosPerformance: likes: all: 2900000 avg: 2900000 median: 2900000 min: 2900000 max: 2900000 comments: all: 77685 avg: 77685 median: 77685 min: 77685 max: 77685 views: all: 124496850 avg: 124496850 median: 124496850 min: 124496850 max: 124496850 engagement: avgEngagementRate: 0.0239 likesPerSubscriber: 0.0063 commentsPerSubscriber: 0.0002 viewsPerSubscriber: 0.2712 engagementConsistency: cv: 0 medianVsMean: 1 topBottomRatio: 0 consistencyScore: null consistencyLevel: null - brandName: Lovesac brandId: lovesac.com brandIgIds: - lovesac sponsoredVideos: - publishTime: 1741382692318 contentId: zajUgQLviwk title: Last to Leave Their Circle Wins $500,000 description: '' length: 2318 isSponsored: true isMemberOnly: false likes: 3000000 comments: 83517 views: 192581549 engagementRate: 0.016 hashtags: [] sponsoredVideosPerformance: likes: all: 3000000 avg: 3000000 median: 3000000 min: 3000000 max: 3000000 comments: all: 83517 avg: 83517 median: 83517 min: 83517 max: 83517 views: all: 192581549 avg: 192581549 median: 192581549 min: 192581549 max: 192581549 engagement: avgEngagementRate: 0.016 likesPerSubscriber: 0.0065 commentsPerSubscriber: 0.0002 viewsPerSubscriber: 0.4196 engagementConsistency: cv: 0 medianVsMean: 1 topBottomRatio: 0 consistencyScore: null consistencyLevel: null - brandName: Prime Video brandId: primevideo.com brandIgIds: - primevideo sponsoredVideos: - publishTime: 1737824401000 contentId: sF5LYGgKbUA title: Every Minute One Person Is Eliminated description: '' length: 2086 isSponsored: true isMemberOnly: false likes: 3091967 comments: 75443 views: 153625027 engagementRate: 0.0206 hashtags: [] sponsoredVideosPerformance: likes: all: 3091967 avg: 3091967 median: 3091967 min: 3091967 max: 3091967 comments: all: 75443 avg: 75443 median: 75443 min: 75443 max: 75443 views: all: 153625027 avg: 153625027 median: 153625027 min: 153625027 max: 153625027 engagement: avgEngagementRate: 0.0206 likesPerSubscriber: 0.0067 commentsPerSubscriber: 0.0002 viewsPerSubscriber: 0.3347 engagementConsistency: cv: 0 medianVsMean: 1 topBottomRatio: 0 consistencyScore: null consistencyLevel: null - brandName: Samsung Group brandId: samsung.com brandIgIds: - samsungmobileusa sponsoredVideos: - publishTime: 1736343792709 contentId: 4SNThp0YiU4 title: 50 YouTubers Fight For $1,000,000 description: '' length: 2487 isSponsored: true isMemberOnly: false likes: 9600000 comments: 348633 views: 436135898 engagementRate: 0.0228 hashtags: - '#galaxyai' - publishTime: 1717257600000 contentId: U_LlX4t0A9I title: $10,000 Every Day You Survive In The Wilderness description: '' length: 1570 isSponsored: true isMemberOnly: false likes: 8785340 comments: 338387 views: 349556858 engagementRate: 0.0261 hashtags: [] sponsoredVideosPerformance: likes: all: 18385340 avg: 9192670 median: 9192670 min: 8785340 max: 9600000 comments: all: 687020 avg: 343510 median: 343510 min: 338387 max: 348633 views: all: 785692756 avg: 392846378 median: 392846378 min: 349556858 max: 436135898 engagement: avgEngagementRate: 0.0245 likesPerSubscriber: 0.02 commentsPerSubscriber: 0.0007 viewsPerSubscriber: 0.8559 engagementConsistency: cv: 0.0673 medianVsMean: 1 topBottomRatio: 0 consistencyScore: null consistencyLevel: null - brandName: Zaxby's brandId: zaxbys.com brandIgIds: - realzaxbys sponsoredVideos: - publishTime: 1717257600000 contentId: U_LlX4t0A9I title: $10,000 Every Day You Survive In The Wilderness description: '' length: 1570 isSponsored: true isMemberOnly: false likes: 8785340 comments: 338387 views: 349556858 engagementRate: 0.0261 hashtags: [] sponsoredVideosPerformance: likes: all: 8785340 avg: 8785340 median: 8785340 min: 8785340 max: 8785340 comments: all: 338387 avg: 338387 median: 338387 min: 338387 max: 338387 views: all: 349556858 avg: 349556858 median: 349556858 min: 349556858 max: 349556858 engagement: avgEngagementRate: 0.0261 likesPerSubscriber: 0.0191 commentsPerSubscriber: 0.0007 viewsPerSubscriber: 0.7616 engagementConsistency: cv: 0 medianVsMean: 1 topBottomRatio: 0 consistencyScore: null consistencyLevel: null creditsUsed: 1 creditsAvailable: -1 traceId: 46985d83e466fcf19bd7b6a0fb4bd0d3 timestamp: 1767923973919 errorCode: '' errorDescription: '' success: true '400': description: Validation error. content: application/json: schema: type: object title: ValidationErrorResponse properties: success: const: false error: type: string message: type: string timestamp: type: integer required: - success - error - message - timestamp examples: missing identifier: summary: No identifier provided value: success: false error: VALIDATION_ERROR message: 'Missing required identifier: ''channelId'' or ''uniqueId''.' timestamp: 1770099403116 invalid channelId: summary: Invalid channelId format value: success: false error: VALIDATION_ERROR message: >- Invalid 'channelId' format. YouTube channel IDs must start with 'UC' followed by 22 characters. timestamp: 1770099403116 '429': description: Exceeded quota or rate limit. content: application/json: schema: type: object title: QuotaErrorResponse properties: success: const: false error: type: string message: type: string remainingPlanCredit: type: number required: - success - error - message - remainingPlanCredit examples: rate limit: summary: Rate limit exceeded value: success: false error: RATE_LIMIT_EXCEEDED message: Too many requests. Please try again later. quota exceeded: summary: Credit quota exceeded value: success: false error: QUOTA_EXCEEDED message: Not enough credits to complete this request. security: - ApiKeyAuth: [] servers: - url: https://apiv3.creatordb.app description: Production Environment (CreatorDB Headless API V3) x-codeSamples: - lang: bash label: cURL source: | curl -X POST "https://apiv3.creatordb.app/youtube/sponsorship" \ -H "Content-Type: application/json" \ -H "api-key: " \ -d '{ "channelId": "UCX6OQ3DkcsbYNE6H8uQQuVA", "fields": { "sponsorList": 5 } }' components: securitySchemes: ApiKeyAuth: type: apiKey description: The valid CreatorDB API key for authentication. name: api-key in: header ````