> ## 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 Brands > Returns a paginated brand directory for catalog synchronization, dropdowns, or audits. Does not support filters — use /sponsor/search for filtered queries. Includes each brand's total sponsored content count and the platforms where sponsored content has been detected. ## OpenAPI ````yaml /api-v3/api-v3.yaml get /sponsor/list 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/list: get: tags: - Sponsor summary: List Brands description: >- Returns a paginated brand directory for catalog synchronization, dropdowns, or audits. Does not support filters — use /sponsor/search for filtered queries. Includes each brand's total sponsored content count and the platforms where sponsored content has been detected. operationId: getSponsorList parameters: - name: pageSize in: query required: false schema: type: string default: '100' description: 'Number of brands per page. Default: 100. Maximum: 100' example: '100' - name: offset in: query required: false schema: type: string default: '0' description: 'Number of brands to skip before returning results. Default: 0' example: '0' - name: sortBy in: query required: false schema: type: string enum: - name - totalSponsoredContent default: name description: >- Field to sort brands by. Accepted values: "name", "totalSponsoredContent" example: name - name: desc in: query required: false schema: type: string default: 'false' description: >- Sort order for results. `true` for descending, `false` for ascending order. Default: `false` example: 'false' responses: '200': description: Sponsoring brand list returned successfully. content: application/json: schema: type: object properties: data: type: object properties: brands: type: array items: type: object properties: brandId: type: string description: Unique brand identifier. example: acer.com name: type: string description: Brand's display name. example: Acer logo: type: string description: URL of the brand's logo. example: https://i.imgur.com/bazrFjP.png industries: type: array items: type: string description: Industries the brand operates in. example: - Computer - Consumer Electronics - Hardware country: type: string description: >- Headquarters country in ISO 3166-1 alpha-3 format (e.g., `USA`). example: TWN sponsoringPlatforms: type: array items: type: string description: >- Social media platforms where this brand has detected sponsored activity. example: - YouTube - Instagram totalSponsoredContent: type: integer minimum: 0 description: >- Total count of sponsored content pieces detected across the platforms in `sponsoringPlatforms`. Returns `0` when no sponsorships have been detected. required: - brandId - name - logo - industries - country - sponsoringPlatforms - totalSponsoredContent description: >- Brand summary returned in sponsor list results, including identity, industry classification, and detected sponsorship activity. description: Brand summary records. totalBrands: type: integer minimum: 0 description: Total number of brands in the database. example: 10342 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: 100 required: - brands - totalBrands - offset - pageSize description: >- Brand 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.' example: true required: - data - traceId - timestamp - creditsAvailable - creditsUsed - errorCode - errorDescription - success description: Sponsor List API response with paginated brands components: securitySchemes: ApiKeyAuth: type: apiKey description: The valid CreatorDB API key for authentication. name: api-key in: header ````