> ## 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 Demographics > Returns audience demographics for a brand's sponsored YouTube and Instagram creators when available. Using optional platform filters returns a single key. ## OpenAPI ````yaml /api-v3/api-v3.yaml get /sponsor/audience 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/audience: get: tags: - Sponsor summary: Get Sponsored Creator Demographics description: >- Returns audience demographics for a brand's sponsored YouTube and Instagram creators when available. Using optional platform filters returns a single key. operationId: getSponsorAudience 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: false schema: type: string enum: - youtube - instagram description: >- Filter audience demographics by social media platform. If empty, returns data for both platforms (either may be absent if unavailable). example: youtube responses: '200': description: Audience data of sponsored creators returned successfully. content: application/json: schema: type: object properties: data: type: object properties: youtube: type: - object - 'null' properties: audienceLocations: type: array items: type: object properties: country: type: string description: Country code in ISO 3166-1 alpha-3 format. example: THA share: type: number description: >- Proportion of this brand's sponsored audience on YouTube that is from this country. Expressed as a decimal rounded to 4 decimal places (e.g., 0.1446 = 14.46%). example: 0.1446 required: - country - share description: >- A single country and its share of the sponsored audience pool. description: >- Top 5 countries for this brand's sponsored audience on YouTube, ranked by share. audienceGender: type: object properties: maleRatio: type: number description: >- Proportion of this brand's sponsored audience on YouTube that identifies as male. Expressed as a decimal rounded to 4 decimal places (e.g., 0.6705 = 67.05%). example: 0.6705 femaleRatio: type: number description: >- Proportion of this brand's sponsored audience on YouTube that identifies as female. Expressed as a decimal rounded to 4 decimal places (e.g., 0.3295 = 32.95%). example: 0.3295 required: - maleRatio - femaleRatio description: >- Gender distribution of this brand's sponsored audience pool on YouTube. audienceAvgAge: type: integer description: >- Average age of the sponsored audience on YouTube, rounded to an integer. example: 28 audienceAgeBreakdown: type: array items: type: object properties: ageRange: type: string enum: - 13-17 - 18-24 - 25-34 - 35-44 - 45-54 - 55-64 - 65+ description: Age range bucket for this breakdown item. example: 18-24 share: type: number description: >- Proportion of this brand's sponsored audience in this age group, rounded to 4 decimal places (e.g., 0.2450 = 24.50%). example: 0.245 required: - ageRange - share description: >- Age bucket in the sponsored audience pool on YouTube. example: 18-24 description: >- Distribution of sponsored audience by age range on YouTube. required: - audienceLocations - audienceGender - audienceAvgAge - audienceAgeBreakdown description: >- Audience data for this brand's YouTube sponsored creators. Returns `null` when the brand has no sponsored YouTube channels. instagram: type: - object - 'null' properties: audienceLocations: type: array items: type: object properties: country: type: string description: Country code in ISO 3166-1 alpha-3 format. example: THA share: type: number description: >- Proportion of this brand's sponsored audience on Instagram that is from this country. Expressed as a decimal rounded to 4 decimal places (e.g., 0.1446 = 14.46%). example: 0.1446 required: - country - share description: >- A single country and its share of the sponsored audience pool. description: >- Top 5 countries for this brand's sponsored audience on Instagram, ranked by share. audienceGender: type: object properties: maleRatio: type: number description: >- Proportion of this brand's sponsored audience on Instagram that identifies as male. Expressed as a decimal rounded to 4 decimal places (e.g., 0.6705 = 67.05%). example: 0.6705 femaleRatio: type: number description: >- Proportion of this brand's sponsored audience on Instagram that identifies as female. Expressed as a decimal rounded to 4 decimal places (e.g., 0.3295 = 32.95%). example: 0.3295 required: - maleRatio - femaleRatio description: >- Gender distribution of this brand's sponsored audience pool on Instagram. audienceAvgAge: type: integer description: >- Average age of this brand's sponsored audience on Instagram, rounded to integer. example: 28 audienceAgeBreakdown: type: array items: type: object properties: ageRange: type: string enum: - 13-17 - 18-24 - 25-34 - 35-44 - 45-54 - 55-64 - 65+ description: Age range bucket for this breakdown item. example: 18-24 share: type: number description: >- Proportion of audience in this age group, rounded to 4th decimal. example: 0.245 required: - ageRange - share description: >- Age bucket in the sponsored audience pool on Instagram. description: >- Distribution of sponsored audience by age range on Instagram. required: - audienceLocations - audienceGender - audienceAvgAge - audienceAgeBreakdown description: >- Audience demographics keyed by platform. When the platform parameter filters the query, only the matching platform's key is returned. Keys for platforms without data are absent from the response. 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: >- Sponsor Audience API response. Contains audience demographics 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 ````