> ## 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. # List Sponsored Creators > Returns a paginated list of creators sponsored by a brand on a specified platform (YouTube or Instagram). ## OpenAPI ````yaml /api-v3/api-v3.yaml get /sponsor/creators 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/creators: get: tags: - Sponsor summary: List Sponsored Creators description: >- Returns a paginated list of creators sponsored by a brand on a specified platform (YouTube or Instagram). operationId: getSponsorCreators 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`. example: youtube - name: pageSize in: query required: false schema: type: string default: '50' description: 'Number of creators per page. Default: 50. Maximum: 100' example: '50' - name: offset in: query required: false schema: type: string default: '0' description: 'Number of records to skip before returning results. Default: 0' example: '0' - name: sortBy in: query required: false schema: type: string enum: - lastSponsoredDate - followers - avgRecentSponsoredEngagementRate - sponsoredCount default: lastSponsoredDate description: >- Field to sort brands by. Accepted values: `lastSponsoredDate`, `followers`, `avgRecentSponsoredEngagementRate`, `sponsoredCount` example: lastSponsoredDate - 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: Sponsored creators returned successfully. content: application/json: schema: type: object properties: data: type: object properties: creators: type: array items: type: object properties: creatorId: type: string description: >- Platform-specific creator identifier (`channelId` for YouTube, `uniqueId` for Instagram). example: UCm-X6o81nRsXQTmqpyArkBQ platform: type: string enum: - youtube - instagram description: >- Platform for which this creator's sponsored activity was queried. example: youtube displayName: type: string description: Creator's display name. example: Flamingo avatar: type: string description: Creator's avatar URL. example: https://yt3.ggpht.com/example sponsoredContent: type: array items: type: string description: >- URLs of this creator's sponsored content for the brand being queried. example: - https://www.youtube.com/watch?v=abc123 country: type: string description: Creator's country in ISO 3166-1 alpha-3 format. example: USA followers: type: number description: >- Creator's follower count (Instagram) or subscriber count (YouTube), depending on the queried platform. example: 12000000 avgRecentSponsoredEngagementRate: type: number description: >- Average engagement rate across this creator's recent sponsored content for the brand. Expressed as a decimal (e.g., 0.0452 = 4.52%), rounded to 4 decimal places. example: 0.0452 topics: type: array items: type: string description: Creator's content topics. example: - RPG niches: type: array items: type: string description: Creator's content niches. example: - gaming_Gaming sponsoredCount: type: integer minimum: 0 description: >- Number of sponsored content pieces from this creator for the queried brand. example: 3 lastSponsoredDate: type: integer description: >- Unix timestamp (in milliseconds) of this creator's most recent sponsored content for the queried brand. example: 1754797869000 required: - creatorId - platform - displayName - avatar - sponsoredContent - country - followers - avgRecentSponsoredEngagementRate - topics - niches - sponsoredCount - lastSponsoredDate description: >- Creator summary with sponsorship metrics for the queried brand. description: >- Returns a paginated list of creators sponsored by the queried brand on the specified platform (YouTube or Instagram). totalResults: type: integer minimum: 0 description: >- Total number of creators that match the queried brand and platform, across all pages. example: 30 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: - creators - totalResults - offset - pageSize description: >- Creator list 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 the request is successful. example: '' success: type: boolean description: '`true` if the request is successful.' required: - data - traceId - timestamp - creditsAvailable - creditsUsed - errorCode - errorDescription - success description: Sponsor Creators API response components: securitySchemes: ApiKeyAuth: type: apiKey description: The valid CreatorDB API key for authentication. name: api-key in: header ````