> ## 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 Creators

> Submit new YouTube creators to the CreatorDB database for indexing. Accepted creators enter a processing queue and become available via the other YouTube endpoints once first scraped. You are billed per newly accepted creator. Creators already indexed (`done`) or rejected (`rejected`) are not charged. For the current per-creator cost, see [API Credit Usage](/api-v3/api-credit-usage).



## OpenAPI

````yaml /api-v3/api-v3.yaml post /youtube/submitCreators
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:
  /youtube/submitCreators:
    post:
      tags:
        - YouTube
      summary: Submit Creators
      description: >-
        Submit new YouTube creators to the CreatorDB database for indexing.
        Accepted creators enter a processing queue and become available via the
        other YouTube endpoints once first scraped. You are billed per newly
        accepted creator. Creators already indexed (`done`) or rejected
        (`rejected`) are not charged. For the current per-creator cost, see [API
        Credit Usage](/api-v3/api-credit-usage).
      operationId: submitYoutubeCreators
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - channelIds
              properties:
                channelIds:
                  type: array
                  description: >-
                    YouTube channel IDs to submit for indexing. The array
                    accepts 1-100 channel IDs.
                  items:
                    type: string
                  minItems: 1
                  maxItems: 100
                  examples:
                    - - UCm-X6o81nRsXQTmqpyArkBQ
                      - UCX6OQ3DkcsbYNE6H8uQQuVA
      responses:
        '200':
          description: Returns the indexing status for each submitted creator.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      results:
                        type: array
                        description: >-
                          Per-creator results, one entry per submitted YouTube
                          channel ID, in the same submission order.
                        items:
                          type: object
                          properties:
                            channelId:
                              type: string
                              description: The submitted YouTube channel ID.
                            status:
                              type: string
                              description: >-
                                The creator's indexing status. - `accepted`:
                                entered the processing queue (billable).<br/> -
                                `done`: already indexed in the database (not
                                charged). <br/> - `rejected`: invalid or
                                blacklisted (not charged). <br/> For the current
                                per-creator cost, see [API Credit
                                Usage](/api-v3/api-credit-usage).
                              enum:
                                - accepted
                                - done
                                - rejected
                            existingChannelId:
                              type: string
                              nullable: true
                              description: >-
                                Returns the existing CreatorDB identifier when
                                the indexing status is `done`. Otherwise,
                                `null`.
                  creditsUsed:
                    type: number
                    examples:
                      - 1
                  creditsAvailable:
                    type: number
                  traceId:
                    type: string
                  timestamp:
                    type: number
                  errorCode:
                    type: string
                  errorDescription:
                    type: string
                  success:
                    type: boolean
      x-codeSamples:
        - lang: bash
          label: cURL
          source: |
            curl -X POST "https://apiv3.creatordb.app/youtube/submitCreators" \
              -H "Content-Type: application/json" \
              -H "api-key: <YOUR_API-KEY_HERE>" \
              -d '{ "channelIds": ["UCm-X6o81nRsXQTmqpyArkBQ", "UCX6OQ3DkcsbYNE6H8uQQuVA"] }'
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      description: The valid CreatorDB API key for authentication.
      name: api-key
      in: header

````