> ## 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. # Submit Brand > Submits a brand for review and addition to the CreatorDB database. Submitted brands are not immediately available through other `/v3/sponsor` endpoints — each submission is reviewed before indexing. Each API key can make up to 100 submissions per day (resets at 00:00 UTC). The response `status` field returns one of: * `accepted` — The brand submission was accepted. * `done` — The brand is already indexed. The existing record ID is returned in `existingBrandId`.(No costs) * `rejected` — The submission was invalid or the brand is blacklisted.(No costs) For per submitted brand cost, see [API Credit Usage](/api-v3/api-credit-usage). ## OpenAPI ````yaml /api-v3/api-v3.yaml post /sponsor/submit 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/submit: post: tags: - Sponsor summary: Submit Brand description: >- Submits a brand for review and addition to the CreatorDB database. Submitted brands are not immediately available through other `/v3/sponsor` endpoints — each submission is reviewed before indexing. Each API key can make up to 100 submissions per day (resets at 00:00 UTC). The response `status` field returns one of: * `accepted` — The brand submission was accepted. * `done` — The brand is already indexed. The existing record ID is returned in `existingBrandId`.(No costs) * `rejected` — The submission was invalid or the brand is blacklisted.(No costs) For per submitted brand cost, see [API Credit Usage](/api-v3/api-credit-usage). operationId: submitSponsor requestBody: content: application/json: schema: type: object properties: brandName: type: string minLength: 1 maxLength: 100 description: Display name of the brand (1-100 characters). example: Notion brandUrl: type: string format: uri description: >- The brand's official website URL. Must include the http/https protocol. example: https://www.notion.so competitors: type: array items: type: string maxItems: 10 default: [] description: Up to 10 competitor brand names or domains. example: - Odoo - Everything App notes: type: string maxLength: 500 description: >- Optional context to help reviewers process the submission, such as known social handles or reasons the brand should be indexed. example: Frequently sponsors productivity and tech YouTube channels required: - brandName - brandUrl description: Request body for submitting a brand to the CreatorDB database. example: brandName: Notion brandUrl: https://www.notion.so competitors: - Odoo - Everything App notes: Frequently sponsors productivity and tech YouTube channels responses: '200': description: Submitted brand for processing into CreatorDB database successfully content: application/json: schema: type: object properties: data: type: object properties: submissionId: type: string description: Unique submission identifier for this submission. example: 69dc931e8015d8a4a41ad288 status: type: string enum: - accepted - done - rejected description: > The current status of the submission. One of: * `accepted` — The brand submission was accepted. Costs 1 credit. * `done` — The brand already exists in CreatorDB. The existing record ID is returned in `existingBrandId`. Costs 0 credits. * `rejected` — The submission was invalid or the brand is blacklisted. Costs 0 credits. example: accepted existingBrandId: type: - string - 'null' default: null description: >- When `status` is `done`, the `brandId` of the existing brand in CreatorDB. `null` for all other statuses, and may also be `null` while the brand record is being prepared. example: notion.so required: - submissionId - status description: Response body for a sponsor submission. 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 submission. Submission details are returned in `data`. components: securitySchemes: ApiKeyAuth: type: apiKey description: The valid CreatorDB API key for authentication. name: api-key in: header ````