> ## 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 Brand Summary > Returns a non-paginated summary object for a brand, combining creator roster rollups and platform-level performance totals for both YouTube and Instagram. Includes YouTube-specific metrics: estimated brand spend, CPM, and CPE. ## OpenAPI ````yaml /api-v3/api-v3.yaml get /sponsor/summary 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/summary: get: tags: - Sponsor summary: Get Brand Summary description: >- Returns a non-paginated summary object for a brand, combining creator roster rollups and platform-level performance totals for both YouTube and Instagram. Includes YouTube-specific metrics: estimated brand spend, CPM, and CPE. operationId: getSponsorSummary 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 responses: '200': description: Brand summary data returned successfully. content: application/json: schema: type: object properties: data: type: object properties: summary: type: object properties: totalSponsoredCreators: type: integer description: >- Total number of creators this brand sponsors across YouTube and Instagram. Creators active on both platforms are counted twice. example: 49 totalSponsoredContent: type: integer description: >- Total number of sponsored content pieces this brand sponsors across YouTube and Instagram. example: 278 youtube: type: object properties: creators: type: object properties: sponsoredCreators: type: integer description: >- Total unique creators sponsored by this brand on YouTube. example: 34 sponsoredContent: type: integer description: >- Total number of sponsored content pieces from this brand on YouTube. example: 156 sponsoredContent30d: type: integer description: >- Sponsored content pieces from this brand published on YouTube in the last 30 days. example: 35 creatorLocationBreakdown: type: array items: type: object properties: key: type: string description: >- Country code in ISO 3166-1 alpha-3 format. count: type: integer description: >- Number of YouTube creators sponsored by this brand in this country. example: 12 share: type: number description: >- Proportion of this brand's sponsored YouTube creators that are based in this country. Expressed as a decimal rounded to 4 decimal places (e.g., 0.4 = 40%). example: 0.4 required: - key - count - share description: >- A single country with its sponsored YouTube creator count and share. description: >- Top 5 countries of this brand's sponsored YouTube creators, ranked by count. Shares across the top 5 may sum to less than 100%. creatorLanguageBreakdown: type: array items: type: object properties: key: type: string description: Language code in ISO-639 alpha-3 format. example: eng count: type: integer description: >- Number of sponsored YouTube creators, who primarily speak this language. example: 12 share: type: number description: >- Proportion of this brand's sponsored YouTube creators, who primarily speak this language. Expressed as a decimal rounded to 4 decimal places (e.g., 0.4 = 40%). example: 0.4 required: - key - count - share description: >- A single language with its sponsored YouTube creator count and share. description: >- Top 5 languages of this brand's sponsored YouTube creators, ranked by count. Share across the top 5 may sum to less than 100%. required: - sponsoredCreators - sponsoredContent - sponsoredContent30d - creatorLocationBreakdown - creatorLanguageBreakdown description: >- Summary of this brand's sponsored YouTube creators: total counts, recent sponsored content volume, and breakdowns by creator location and language. performance: type: object properties: estimatedTotalSpend7d: type: - number - 'null' description: >- Estimated amount (USD) spent by this brand on sponsored YouTube creators over a rolling 7-day window. Returns null when no sponsored creator has a price estimate available. example: 28000 estimatedTotalSpend30d: type: - number - 'null' description: >- Estimated amount (USD) spent by this brand on sponsored YouTube creators over a rolling 30-day window. Returns null when no sponsored creator has a price estimate available. example: 100000 estimatedTotalSpend90d: type: - number - 'null' description: >- Estimated amount (USD) spent by this brand on sponsored YouTube creators over a rolling 90-day window. Returns null when no sponsored creator has a price estimate available. example: 220000 estimatedCPM30d: type: - number - 'null' description: >- Cost per Mille (CPM, in USD) of the brand over a rolling 30-day window. < /br> CPM = `estimatedTotalSpend30d` /`views30d` x 1000 < /br> Returns `null` when the estimated total spend or the 30-day sponsored video views data is `null` or `0`. This is the brand's aggregate CPM across all sponsored content in the window. For per-video CPM, see the `sponsor/performance` endpoint. example: 8.51 estimatedCPE30d: type: - number - 'null' description: >- Cost per Engagement (CPE, in USD) for this brand over a rolling 30-day window. Engagement is defined as likes plus comments on sponsored content published in the window.< /b> CPE = `estimatedTotalSpend30d` / sum(`likes` + `comments`) < /br> Returns `null` when `estimatedTotalSpend30d` is `null` or the denominator is `0`. example: 0.31 views: type: object properties: total: type: number description: >- Total views across all of this brand's sponsored YouTube content (all-time). example: 452000000 avg: type: number description: >- Mean views per piece of this brand's sponsored YouTube content (all-time). example: 75374 median: type: number description: >- Median views per piece of this brand's sponsored YouTube content (all-time). example: 62000 min: type: number description: >- Minimum views on any single piece of this brand's sponsored YouTube content (all-time). example: 1200 max: type: number description: >- Maximum views on any single piece of this brand's sponsored YouTube content (all-time). example: 890000 views30d: type: number description: >- Sum of views on this brand's sponsored YouTube content over a rolling 30-day window. Unavailable on Instagram. example: 11758366 required: - total - avg - median - min - max - views30d description: >- Summary statistics of views on this brand's sponsored YouTube content. likes: type: object properties: total: type: number description: >- Total likes across all of this brand's sponsored YouTube content (all-time) example: 452000000 avg: type: number description: >- Mean likes per piece of this brand's sponsored YouTube content (all-time). example: 75374 median: type: number description: >- Median likes per piece of this brand's sponsored YouTube content (all-time). example: 62000 min: type: number description: >- Minimum likes on any single piece of this brand's sponsored YouTube content (all-time). example: 1200 max: type: number description: >- Maximum likes on any single piece of this brand's sponsored YouTube content (all-time). example: 890000 required: - total - avg - median - min - max description: >- Summary statistics of likes on this brand's sponsored YouTube content. comments: type: object properties: total: type: number description: >- Total comments across all of this brand's sponsored YouTube content (all-time) example: 452000000 avg: type: number description: >- Mean comments per piece of this brand's sponsored YouTube content (all-time). example: 75374 median: type: number description: >- Median comments per piece of this brand's sponsored YouTube content (all-time). example: 62000 min: type: number description: >- Minimum comments on any single piece of this brand's sponsored YouTube content (all-time). example: 1200 max: type: number description: >- Maximum comments on any single piece of this brand's sponsored YouTube content (all-time). example: 890000 required: - total - avg - median - min - max description: >- Summary statistics of comments on this brand's sponsored YouTube content. engagement: type: object properties: avgEngagementRate: type: number description: >- Average engagement rate across all of this brand's sponsored YouTube content. Expressed as a decimal and rounded up to 4 decimal places (e.g., 0.0352=3.52%). Engagement rate is defined as (likes + comments) / views. example: 0.0352 required: - avgEngagementRate description: >- Average engagement rate across this brand's sponsored YouTube content. growth30d: type: object properties: viewsGrowth: type: number description: >- Views growth ratio for this brand's sponsored YouTube content over a rolling 30-day window. Computed as `delta` / `(current - delta)`, where `delta` is the 30-day change in views and `current - delta` is the views count at the start of the window. Expressed as a decimal rounded to 4 decimal places (e.g., 0.3261 = 32.61%). example: 0.3261 likesGrowth: type: number description: >- Likes growth ratio for this brand's sponsored YouTube content over a rolling 30-day window. Computed as `delta` / `(current - delta)`, where `delta` is the 30-day change in likes and `current - delta` is the likes count at the start of the window. Expressed as a decimal rounded to 4 decimal places (e.g., 0.2119 = 21.19%). example: 0.2119 commentsGrowth: type: number description: >- Comments growth ratio for this brand's sponsored YouTube content over a rolling 30-day window. Computed as `delta` / `(current - delta)`, where `delta` is the 30-day change in comments and `current - delta` is the comments count at the start of the window. Expressed as a decimal rounded to 4 decimal places (e.g., 0.2976 = 29.76%). example: 0.2976 engagementGrowth: type: number description: >- Engagement growth ratio for this brand's sponsored YouTube content over a rolling 30-day window. Computed as `delta` / `(current - delta)`, where `delta` is the 30-day change in engagement and `current - delta` is the engagement count at the start of the window. Expressed as a decimal rounded to 4 decimal places (e.g., -0.0831 = -8.31%). example: -0.0831 required: - viewsGrowth - likesGrowth - commentsGrowth - engagementGrowth description: >- Rolling 30-day growth ratios for this brand's sponsored YouTube content, covering views, likes, comments, and engagement. required: - estimatedTotalSpend7d - estimatedTotalSpend30d - estimatedTotalSpend90d - estimatedCPM30d - estimatedCPE30d - views - likes - comments - engagement - growth30d description: >- Aggregate metrics for this brand's sponsored YouTube activity, covering estimated spend, efficiency ratios (CPM, CPE), engagement totals, and rolling growth. required: - creators - performance description: >- Creator roster and aggregate performance metrics for this brand's sponsored YouTube activity. instagram: type: object properties: creators: type: object properties: sponsoredCreators: type: integer description: >- Total unique creators sponsored by this brand on Instagram. example: 34 sponsoredContent: type: integer description: >- Total number of sponsored content pieces from this brand on Instagram (all-time). example: 156 sponsoredContent30d: type: integer description: >- Sponsored content pieces from this brand published on Instagram in the last 30 days. example: 35 creatorLocationBreakdown: type: array items: type: object properties: key: type: string description: >- Country code in ISO 3166-1 alpha-3 format. count: type: integer description: >- Number of Instagram creators sponsored by this brand in this country. example: 12 share: type: number description: >- Proportion of this brand's sponsored Instagram creators that are based in this country. Expressed as a decimal rounded to 4 decimal places (e.g., 0.4 = 40%). example: 0.4 required: - key - count - share description: >- A single country with its sponsored Instagram creator count and share. description: >- Top 5 countries of this brand's sponsored Instagram creators, ranked by count. Shares across the top 5 may sum to less than 100%. creatorLanguageBreakdown: type: array items: type: object properties: key: type: string description: Language code in ISO-639 alpha-3 format. count: type: integer description: >- Number of sponsored Instagram creators, who primarily speak this language. example: 12 share: type: number description: >- Proportion of this brand's sponsored Instagram creators that primarily speak this language. Expressed as a decimal rounded to 4 decimal places (e.g., 0.4 = 40%). example: 0.4 required: - key - count - share description: >- A single language with its sponsored Instagram creator count and share. description: >- Top 5 languages of this brand's sponsored Instagram creators, ranked by count. Share across the top 5 may sum to less than 100%. required: - sponsoredCreators - sponsoredContent - sponsoredContent30d - creatorLocationBreakdown - creatorLanguageBreakdown description: >- Summary of this brand's sponsored Instagram creators: total counts, recent sponsored content volume, and breakdowns by creator location and language. performance: type: object properties: estimatedTotalSpend7d: type: 'null' description: >- Not yet available for Instagram. Always returns `null`. See parent object description. example: null estimatedTotalSpend30d: type: 'null' description: >- Not yet available for Instagram. Always returns `null`. See parent object description. example: null estimatedTotalSpend90d: type: 'null' description: >- Not yet available for Instagram. Always returns `null`. See parent object description. example: null estimatedCPM30d: type: 'null' description: >- Not yet available for Instagram. Always returns `null`. See parent object description. example: null estimatedCPE30d: type: 'null' description: >- Not yet available for Instagram. Always returns `null`. See parent object description. example: null views: type: object properties: total: type: number description: >- Total views across all of this brand's sponsored Instagram posts (all-time). example: 452000000 avg: type: number description: >- Mean views per piece of this brand's sponsored Instagram posts (all-time). example: 75374 median: type: number description: >- Median views per piece of this brand's sponsored Instagram posts (all-time). example: 62000 min: type: number description: >- Minimum views per piece of this brand's sponsored Instagram posts (all-time). example: 1200 max: type: number description: >- Maximum views per piece of this brand's sponsored Instagram posts (all-time). example: 890000 required: - total - avg - median - min - max description: >- Summary statistics of views on this brand's sponsored Instagram posts. Sum of views on this brand's sponsored Instagram posts over a rolling 30-day window is unavailable. likes: type: object properties: total: type: number description: >- Total likes across all of this brand's sponsored Instagram posts (all-time) example: 452000000 avg: type: number description: >- Mean likes per piece of this brand's sponsored Instagram posts (all-time). example: 75374 median: type: number description: >- Median likes per piece of this brand's sponsored Instagram posts (all-time). example: 62000 min: type: number description: >- Minimum likes on any single piece of this brand's sponsored Instagram posts (all-time). example: 1200 max: type: number description: >- Maximum likes on any single piece of this brand's sponsored Instagram posts (all-time). example: 890000 required: - total - avg - median - min - max description: >- Summary statistics of likes on this brand's sponsored Instagram posts. comments: type: object properties: total: type: number description: >- Total comments across all of this brand's sponsored Instagram posts (all-time) example: 452000000 avg: type: number description: >- Mean comments per piece of this brand's sponsored Instagram posts (all-time). example: 75374 median: type: number description: >- Median comments per piece of this brand's sponsored Instagram posts (all-time). example: 62000 min: type: number description: >- Minimum comments on any single piece of this brand's sponsored Instagram posts (all-time). example: 1200 max: type: number description: >- Maximum comments on any single piece of this brand's sponsored Instagram posts (all-time). example: 890000 required: - total - avg - median - min - max description: >- Summary statistics of comments on this brand's sponsored Instagram posts. engagement: type: object properties: avgEngagementRate: type: number description: >- Average engagement rate across all of this brand's sponsored Instagram posts. Expressed as a decimal and rounded up to 4 decimal places (e.g., 0.0352=3.52%). Engagement rate is defined as (likes + comments) / views. required: - avgEngagementRate description: >- Average engagement rate across this brand's sponsored Instagram posts. growth30d: type: object properties: viewsGrowth: type: number description: >- Views growth ratio for this brand's sponsored Instagram posts over a rolling 30-day window. Computed as `delta` / `(current - delta)`, where `delta` is the 30-day change in views and `current - delta` is the views count at the start of the window. Expressed as a decimal rounded to 4 decimal places (e.g., 0.3261 = 32.61%). example: 0.3261 likesGrowth: type: number description: >- Likes growth ratio for this brand's sponsored Instagram posts over a rolling 30-day window. Computed as `delta` / `(current - delta)`, where `delta` is the 30-day change in views and `current - delta` is the views count at the start of the window. Expressed as a decimal rounded to 4 decimal places (e.g., 0.2119 = 21.19%). example: 0.2119 commentsGrowth: type: number description: >- Comments growth ratio for this brand's sponsored Instagram posts over a rolling 30-day window. Computed as `delta` / `(current - delta)`, where `delta` is the 30-day change in views and `current - delta` is the views count at the start of the window. Expressed as a decimal rounded to 4 decimal places (e.g.,0.2976 = 29.76%). example: 0.2976 engagementGrowth: type: number description: >- Engagement growth ratio for this brand's sponsored YouTube content over a rolling 30-day window. Computed as `delta` / `(current - delta)`, where `delta` is the 30-day change in engagement and `current - delta` is the engagement count at the start of the window. Expressed as a decimal rounded to 4 decimal places (e.g., -0.0831 = -8.31%). example: -0.0831 required: - viewsGrowth - likesGrowth - commentsGrowth - engagementGrowth description: >- Rolling 30-day growth ratios for this brand's sponsored Instagram content, covering views, likes, comments, and engagement. required: - estimatedTotalSpend7d - estimatedTotalSpend30d - estimatedTotalSpend90d - estimatedCPM30d - estimatedCPE30d - views - likes - comments - engagement - growth30d description: >- Aggregate metrics for this brand's sponsored Instagram activity, covering engagement totals, and rolling growth. Performance metrics for this brand's sponsored Instagram activity. Spend and efficiency fields are currently placeholders (always `null`) and will be populated when Instagram pricing data becomes available. required: - creators - performance description: >- Creator roster and aggregate performance metrics for this brand's sponsored Instagram activity. required: - totalSponsoredCreators - totalSponsoredContent - youtube - instagram description: >- Summary of this brand's sponsored activity: cross-platform totals and per-platform breakdowns (YouTube, Instagram). required: - summary description: Top-level response object containing the brand summary. 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 succeeds. example: '' errorDescription: type: string description: Description of the error if any. 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: >- Response body for a sponsor summary. Summary details are returned in `data`. components: securitySchemes: ApiKeyAuth: type: apiKey description: The valid CreatorDB API key for authentication. name: api-key in: header ````