> ## 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 Sponsored Creator Performance > Returns performance metrics for creators sponsored by a brand on YouTube or Instagram. For each creator, the response includes comparison stats (sponsored vs. overall performance), estimated cost and CPM (YouTube only), and performance details for their individual posts or videos. ## OpenAPI ````yaml /api-v3/api-v3.yaml get /sponsor/performance 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: /sponsor/performance: get: tags: - Sponsor summary: Get Sponsored Creator Performance description: >- Returns performance metrics for creators sponsored by a brand on YouTube or Instagram. For each creator, the response includes comparison stats (sponsored vs. overall performance), estimated cost and CPM (YouTube only), and performance details for their individual posts or videos. operationId: getSponsorPerformance parameters: - name: brandId in: query required: true schema: type: string minLength: 1 pattern: ^[a-zA-Z0-9._-]+$ description: >- Unique brand identifier, typically the brand's primary domain. Allowed characters: letters (a-z, A-Z), digits (0-9), periods (.), underscores (_), and hyphens (-). example: acer.com - name: platform in: query required: true schema: type: string enum: - youtube - instagram description: >- Social media platform to query. Accepted values: `youtube`, `instagram`. Only one platform is allowed per request. example: youtube - name: pageSize in: query required: false schema: type: string default: '50' description: >- Number of unique creators per page. All sponsored content for each creator is included. Default: 50. Maximum: 100 example: '50' - name: offset in: query required: false schema: type: string default: '0' description: >- Number of creators to skip before returning results. Pagination is creator-level. Default: 0 example: '0' - name: sortBy in: query required: false schema: type: string enum: - publishTime - views - likes - engagementRate default: publishTime description: >- Field for sorting creators. Accepted values: `publishTime`, `views`, `likes`, `engagementRate`. Numeric sort fields (`views`, `likes`, `engagementRate`) use per-creator averages across this brand's sponsored content. Default: `publishTime`. example: publishTime - name: desc in: query required: false schema: type: string default: 'true' description: >- Sort order for results. `true` for descending, `false` for ascending. Default: `true` example: 'true' responses: '200': description: 'Performance of sponsored creators returned successfully. ' content: application/json: schema: type: object properties: data: type: object properties: sponsoredCreators: type: array items: type: object properties: creatorId: type: string description: >- Platform-specific creator identifier (`channelId` for YouTube, `uniqueId` for Instagram). example: UCm-X6o81nRsXQTmqpyArkBQ displayName: type: string description: Creator's display name. example: Flamingo platform: type: string enum: - youtube - instagram description: >- Platform for which this creator's sponsored content performance was queried. Matches the `platform` request parameter. example: youtube creatorTotalStats: type: object properties: avgEngagementRate: type: number description: >- Average engagement rate across all of this creator's tracked content (sponsored and non-sponsored). Expressed as a decimal (e.g., 0.0452 = 4.52%). example: 0.0452 avgViews: type: - number - 'null' description: >- Average views per content piece across all of this creator's tracked content (sponsored and non-sponsored). example: 1600000 avgLikes: type: number description: >- Average likes per content piece across all of this creator's tracked content (sponsored and non-sponsored). example: 63700 avgComments: type: number description: >- Average comments per content piece across all of this creator's tracked content (sponsored and non-sponsored). example: 5200 contentCount: type: integer minimum: 0 description: >- Number of tracked content pieces used to calculate the averages in this `creatorTotalStats` object. example: 180 latestContentDate: type: integer description: >- Unix timestamp (in milliseconds) of this creator's most recent content, across all content types (sponsored or non-sponsored). example: 1741939200000 required: - avgEngagementRate - avgViews - avgLikes - avgComments - contentCount - latestContentDate description: >- This creator's overall performance stats across all tracked content (sponsored and non-sponsored). Use as a baseline to compare against `creatorAllSponsoredStats` and `creatorThisBrandSponsoredStats`. creatorAllSponsoredStats: type: object properties: avgEngagementRate: type: number description: >- Average engagement rate across all of this creator's sponsored content (any brand). Expressed as a decimal (e.g., 0.0412 = 4.12%). example: 0.0412 avgViews: type: - number - 'null' description: >- Average views per piece across all of this creator's sponsored content (any brand). May be null if view data is unavailable. example: 1950000 avgLikes: type: number description: >- Average likes per piece across all of this creator's sponsored content (any brand). example: 66500 avgComments: type: number description: >- Average comments per piece across all of this creator's sponsored content (any brand). example: 5350 sponsoredCount: type: integer minimum: 0 description: >- Number of this creator's sponsored content pieces (any brand) used to calculate the averages in this creatorAllSponsoredStats object. example: 42 latestSponsoredContentDate: type: integer description: >- Unix timestamp (in milliseconds) of this creator's most recent sponsored content (any brand). example: 1738569600000 required: - avgEngagementRate - avgViews - avgLikes - avgComments - sponsoredCount - latestSponsoredContentDate description: >- This creator's overall performance stats across all tracked content (sponsored and non-sponsored). creatorSpecificSponsoredStats: type: object properties: avgEngagementRate: type: number description: >- Average engagement rate across this creator's sponsored content for the queried brand. Expressed as a decimal (e.g., 0.0379 = 3.79%). example: 0.0379 avgViews: type: number description: >- Average views per piece across this creator's sponsored content for the queried brand. example: 2200000 avgLikes: type: number description: >- Average likes per piece across this creator's sponsored content for the queried brand. example: 69800 avgComments: type: number description: >- Average comments per piece across this creator's sponsored content for the queried brand. example: 5500 sponsoredCount: type: integer minimum: 0 description: >- Number of this creator's sponsored content pieces for the queried brand used to calculate the averages in this `creatorSpecificSponsoredStats` object. example: 3 latestSponsoredContentDate: type: integer description: >- Unix timestamp (in milliseconds) of this creator's most recent sponsored content for the queried brand. example: 1733529600000 required: - avgEngagementRate - avgViews - avgLikes - avgComments - sponsoredCount - latestSponsoredContentDate description: >- This creator's performance stats across their sponsored content for the queried brand. Compare against `creatorTotalStats` (overall baseline) and `creatorAllSponsoredStats` (all-brand sponsored performance) to evaluate brand-specific performance. estimatedCost: type: - number - 'null' description: >- Sum of estimated prices (in USD) across this creator's sponsored videos for the queried brand. YouTube only — returns `null` for Instagram queries. example: 4500 estimatedCreatorCPM: type: - number - 'null' description: >- Estimated cost per 1,000 views (in USD) for this creator's sponsored content for the queried brand. YouTube only. Calculated as 1000 × (`estimatedCost` ÷ `total views`), summed across this creator's sponsored videos for the brand. Returns null when: - Total views across the included videos are 0 - `estimatedCost` is `null` - No spend data is available for the platform example: 9.12 content: type: array items: type: object properties: contentId: type: string description: >- Platform-specific content identifier (`videoId` for YouTube, `mediaId` for Instagram). example: eHnzGYHEdO0 title: type: string description: >- Content title (for YouTube videos) or caption excerpt (for Instagram posts). example: ROBLOX OP ADMIN IN STEAL A BRAINROT publishTime: type: number description: >- Publish time, represented as a Unix timestamp in milliseconds. example: 1754797869000 views7d: type: - number - 'null' description: >- Cumulative view count 7 days after publication. Returns `null` if fewer than 7 days have passed since publication. example: 8200 views30d: type: - number - 'null' description: >- Cumulative view count 30 days after publication. Returns `null` if fewer than 30 days have passed since publication. example: 15000 views90d: type: - number - 'null' description: >- Cumulative view count 90 days after publication. Returns `null` if fewer than 90 days have passed since publication. example: 28500 viewsLifetime: type: number description: >- Total view count for this content piece since publication. example: 150000 likes: type: number description: >- Like count for this content piece. Calculation may vary depending on platform and content age. example: 10000 comments: type: number description: >- Comment count for this content piece. Calculation may vary depending on platform and content age. example: 100 engagementRate: type: number description: >- Engagement rate of this content piece. Expressed as a decimal and rounded to the 4th decimal place (e.g. 0.1202 = 12.02%). example: 0.1202 length: type: - number - 'null' description: >- Video length in seconds. Returns `null` for non-video content. example: 873 hashtags: type: array items: type: string description: Hashtags used in this content. example: - '#VLOG' estimatedContentCPM: type: - number - 'null' description:"Estimated cost per 1,000 views (in USD) for this sponsored content piece. YouTube only. Returns null when: - The content has 0 views - Cost data is unavailable - No spend data exists for the platform" example: 300 required: - contentId - title - publishTime - views7d - views30d - views90d - viewsLifetime - likes - comments - engagementRate - length - hashtags - estimatedContentCPM description: >- Performance data for one piece of this creator's sponsored content for the queried brand. required: - creatorId - displayName - platform - creatorTotalStats - creatorAllSponsoredStats - creatorSpecificSponsoredStats - estimatedCost - estimatedCreatorCPM - content description:"Array of creator groups. Each group contains: - Creator ID and identity information - >- Three parallel stats objects for comparison (`creatorTotalStats`, `creatorAllSponsoredStats`, `creatorSpecificSponsoredStats`) - >- A content array with the creator's sponsored content pieces for the queried brand - >- Filtered by the platform parameter and paginated via `pageSize` and `offset`. totalResults: type: integer minimum: 0 description: >- Total number of creators that match the queried brand and platform, across all pages. example: 156 offset: type: integer minimum: 0 description: >- Offset applied to this response (matches the request offset). example: 0 pageSize: type: integer minimum: 1 maximum: 100 description: >- Page size applied to this response (matches the request `pageSize`). example: 50 required: - sponsoredCreators - totalResults - offset - pageSize description: >- Sponsored creators with performance data for the queried brand and platform, along with pagination metadata (total count, current offset, and page size). traceId: type: string description: Unique trace ID for each request. example: f8e4a3b2c1d0e9f8a7b6c5d4e3f2a1b0 timestamp: type: integer description: >- Time the response was generated, represented as a Unix timestamp in milliseconds example: 1750732453635 creditsAvailable: type: number description: >- Remaining credits available for this API key after the current request. example: 975 creditsUsed: type: number description: Number of API credits consumed by this request. example: 25 errorCode: type: string description: >- Error code returned if the request fails. Empty if the request is successful. example: '' errorDescription: type: string description: Description of the error. Empty if successful. example: '' success: type: boolean description: '`true` if the request is successful.' example: true required: - data - traceId - timestamp - creditsAvailable - creditsUsed - errorCode - errorDescription - success description: >- Sponsor Performance API response. Contains creator performance data in data, along with credit usage, trace info, and error details. components: securitySchemes: ApiKeyAuth: type: apiKey description: The valid CreatorDB API key for authentication. name: api-key in: header ````