> ## 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 Profile Information

> Retrieve the profile information of a specified YouTube creator, including metadata such as subscriber count, account type, language, hashtags, and more.<br /><br />Optionally pass `fields` in the request body to return only a subset of profile fields. You are billed the sum of the requested fields' costs, capped at the full-bundle price. Fractional calls must be enabled on your API key. Otherwise, requests that include a fields parameter return a `400` error (`FractionalCallsNotEnabled`). Per-field pricing is not published yet. For how fractional calls work, see [Fractional Calls](/api-v3/fractional-calls).



## OpenAPI

````yaml /api-v3/api-v3.yaml post /youtube/profile
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/profile:
    post:
      tags:
        - YouTube
      summary: Get Profile Information
      description: >-
        Retrieve the profile information of a specified YouTube creator,
        including metadata such as subscriber count, account type, language,
        hashtags, and more.<br /><br />Optionally pass `fields` in the request
        body to return only a subset of profile fields. You are billed the sum
        of the requested fields' costs, capped at the full-bundle price.
        Fractional calls must be enabled on your API key. Otherwise, requests
        that include a fields parameter return a `400` error
        (`FractionalCallsNotEnabled`). Per-field pricing is not published yet.
        For how fractional calls work, see [Fractional
        Calls](/api-v3/fractional-calls).
      operationId: getYoutubeProfile
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - channelId
              properties:
                channelId:
                  type: string
                  description: Unique channel ID.
                  pattern: ^UC[a-zA-Z0-9_-]{22}$
                  minLength: 1
                  maxLength: 50
                  examples:
                    - UCX6OQ3DkcsbYNE6H8uQQuVA
                fields:
                  type: array
                  description: >-
                    Subset of profile fields to return for fractional billing.
                    Omit or pass an empty array to return the full profile at
                    the full-bundle price. Per-field costs are not published
                    yet.
                  items:
                    type: string
                  examples:
                    - - displayName
                      - country
                      - totalSubscribers
      responses:
        '200':
          description: YouTube creator profile information returned successfully.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    description: Profile information of the specified creator.
                    properties:
                      channelId:
                        type: string
                        description: Unique channel ID.
                        examples:
                          - UCBR8-60-B28hp2BmDPdntcQ
                      uniqueId:
                        type: string
                        description: Channel handle.
                        examples:
                          - '@youtube'
                      displayName:
                        type: string
                        description: Channel display name.
                        examples:
                          - YouTube
                      categoryBreakdown:
                        type: array
                        description: Distribution of the creator's content by category.
                        items:
                          type: object
                          properties:
                            category:
                              type: string
                              examples:
                                - Gaming
                            share:
                              type: number
                              examples:
                                - 0.3241
                          required:
                            - category
                            - share
                      avatarUrl:
                        type: string
                        description: Channel profile picture URL.
                        examples:
                          - >-
                            https://yt3.googleusercontent.com/7cF22TRiceqQr2Cro_X4uhRVnwCdOa2HXiwdBGPnUEqJDuCyr2CykDfDw2rCWjbjaHEdTMUC=s900-c-k-c0x00ffffff-no-rj
                      bio:
                        type: string
                        description: The channel biography.
                        examples:
                          - The Most Botted Channel EVER
                      isVerified:
                        type: boolean
                        description: '`true` if the account is verified by YouTube.'
                        examples:
                          - true
                      hasSponsors:
                        type: boolean
                        description: '`true` if there is sponsored content.'
                        examples:
                          - true
                      hasMemberOnlyContents:
                        type: boolean
                        description: '`true` if there is member-only content.'
                        examples:
                          - true
                      country:
                        type: string
                        description: >-
                          The country represented in **ISO 3166-1 alpha-3**
                          format. For the country code list, see
                          [here](https://docs.creatordb.app/api-v2/country-code).
                        examples:
                          - TWN
                      mainLanguage:
                        type: string
                        description: >-
                          The primary language used in contents, represented in
                          **ISO 639-3** format. For language code list, see
                          [here](https://docs.creatordb.app/api-v3/language-code).
                        examples:
                          - zht
                      languages:
                        type: array
                        description: >-
                          All languages used in contents, represented in **ISO
                          639-3** format. For language code list, see
                          [here](https://docs.creatordb.app/api-v3/language-code).
                        examples:
                          - - zht
                            - eng
                        items:
                          type: string
                      secondLanguage:
                        type: string
                        description: >-
                          The secondary language used in contents, represented
                          in **ISO 639-3** format. For language code list, see
                          [here](https://docs.creatordb.app/api-v3/language-code).
                        examples:
                          - eng
                      totalContents:
                        type: integer
                        description: Total number of videos and shorts.
                        minimum: 0
                        examples:
                          - 399
                      totalSubscribers:
                        type: integer
                        description: Total number of subscribers.
                        minimum: 0
                        examples:
                          - 13900000
                      subscriberGrowth:
                        type: object
                        description: >-
                          Subscriber growth metrics over 7, 30, and 90-day
                          periods.
                        properties:
                          g7:
                            type: number
                            description: >-
                              Subscriber growth over 7 days, rounded to 4th
                              decimal place.
                            examples:
                              - 0.1234
                          g30:
                            type: number
                            description: >-
                              Subscriber growth over 30 days, rounded to 4th
                              decimal place.
                            examples:
                              - 0.2345
                          g90:
                            type: number
                            description: >-
                              Subscriber growth over 90 days, rounded to 4th
                              decimal place.
                            examples:
                              - 0.3456
                        required:
                          - g7
                          - g30
                          - g90
                      hashtags:
                        type: array
                        description: Hashtags used in content and related statistics.
                        maxItems: 100
                        items:
                          type: object
                          description: Hashtag information and usage statistics.
                          properties:
                            name:
                              type: string
                              description: Keywords used in video captions or descriptions.
                              examples:
                                - '#starrailsimulator'
                            contentCount:
                              type: integer
                              description: Number of videos and shorts using the hashtag.
                              minimum: 0
                              examples:
                                - 250
                          required:
                            - name
                            - contentCount
                      topics:
                        type: array
                        description: >-
                          Content subcategories generated by CreatorDB's AI
                          model that classifies creators into about 400 dynamic
                          themes based on their content.
                        examples:
                          - - id_freegames_Gaming
                        items:
                          type: string
                      niches:
                        type: array
                        description: >-
                          Granular subcategories of content topics identified by
                          CreatorDB's AI model, which analyzes and groups
                          keywords, hashtags, and tags used by creators.
                        examples:
                          - - id_roblox_Gaming
                        items:
                          type: string
                      otherLinks:
                        type: array
                        description: Linked websites.
                        items:
                          type: object
                          description: Information of external platform links.
                          properties:
                            title:
                              type: string
                              description: The link name.
                              examples:
                                - Instagram
                            url:
                              type: string
                              description: URL of the social media profile page.
                              format: uri
                              examples:
                                - https://www.instagram.com/instagram
                          required:
                            - title
                            - url
                      lastPublishTime:
                        type: integer
                        description: >-
                          Upload time of the last uploaded content, represented
                          as a Unix timestamp in milliseconds.
                        examples:
                          - 1755142212000
                      relatedCreators:
                        type: array
                        description: >-
                          Creators recommended by YouTube, returned as channel
                          IDs.
                        examples:
                          - - UCBR8-60-B28hp2BmDPdntcQ
                            - UC4PooiX37Pld1T8J5SYT-SQ
                        items:
                          type: string
                      videoPrice:
                        type: object
                        description: >-
                          Estimated video prices, including Cost Per Mille (CPM)
                          and per-video rate ranges.
                        properties:
                          cpmLow:
                            type: number
                            description: >-
                              Lower bound of the estimated Cost Per Mille (CPM)
                              range.
                            minimum: 0
                            examples:
                              - 5.5
                          cpmRaw:
                            type: number
                            description: Estimated average Cost Per Mille (CPM).
                            minimum: 0
                            examples:
                              - 8.2
                          cpmHigh:
                            type: number
                            description: >-
                              Upper bound of the estimated Cost Per Mille (CPM)
                              range.
                            minimum: 0
                            examples:
                              - 12
                          priceLow:
                            type: number
                            description: >-
                              Lower bound of the estimated media value for a
                              single piece of content.
                            minimum: 0
                            examples:
                              - 1000
                          priceRaw:
                            type: number
                            description: >-
                              Estimated media value for a single piece of
                              content.
                            minimum: 0
                            examples:
                              - 1500
                          priceHigh:
                            type: number
                            description: >-
                              Upper bound of the estimated media value for a
                              single piece of content.
                            minimum: 0
                            examples:
                              - 2200
                        required:
                          - cpmLow
                          - cpmRaw
                          - cpmHigh
                          - priceLow
                          - priceRaw
                          - priceHigh
                        examples:
                          - cpmLow: 5.5
                            cpmRaw: 8.2
                            cpmHigh: 12
                            priceLow: 1000
                            priceRaw: 1500
                            priceHigh: 2200
                      shortsPrice:
                        type: object
                        description: >-
                          Estimated YouTube Shorts prices, including CPM and
                          per-video rate ranges.
                        properties:
                          cpmLow:
                            type: number
                            description: >-
                              Lower bound of the estimated Cost Per Mille (CPM)
                              range.
                            minimum: 0
                            examples:
                              - 5.5
                          cpmRaw:
                            type: number
                            description: >-
                              Estimated average Cost Per Mille (CPM) for the
                              creator.
                            minimum: 0
                            examples:
                              - 8.2
                          cpmHigh:
                            type: number
                            description: >-
                              Upper bound of the estimated Cost Per Mille (CPM)
                              range.
                            minimum: 0
                            examples:
                              - 12
                          priceLow:
                            type: number
                            description: >-
                              Lower bound of the estimated media value for a
                              single piece of content.
                            minimum: 0
                            examples:
                              - 1000
                          priceRaw:
                            type: number
                            description: >-
                              Estimated media value for a single piece of
                              content.
                            minimum: 0
                            examples:
                              - 1500
                          priceHigh:
                            type: number
                            description: >-
                              Upper bound of the estimated media value for a
                              single piece of content.
                            minimum: 0
                            examples:
                              - 2200
                        required:
                          - cpmLow
                          - cpmRaw
                          - cpmHigh
                          - priceLow
                          - priceRaw
                          - priceHigh
                        examples:
                          - cpmLow: 3
                            cpmRaw: 5
                            cpmHigh: 8
                            priceLow: 500
                            priceRaw: 750
                            priceHigh: 1100
                      lastDbUpdateTime:
                        type: integer
                        description: >-
                          Last update time of the creator profile and statistics
                          in the CreatorDB database, represented as a Unix
                          timestamp in milliseconds.
                        examples:
                          - 1753179002000
                    required:
                      - channelId
                      - uniqueId
                      - displayName
                      - categoryBreakdown
                      - avatarUrl
                      - bio
                      - isVerified
                      - hasSponsors
                      - hasMemberOnlyContents
                      - country
                      - mainLanguage
                      - languages
                      - secondLanguage
                      - totalContents
                      - totalSubscribers
                      - subscriberGrowth
                      - hashtags
                      - topics
                      - niches
                      - otherLinks
                      - lastPublishTime
                      - relatedCreators
                      - videoPrice
                      - shortsPrice
                      - lastDbUpdateTime
                  creditsUsed:
                    type: integer
                    description: Number of API credits consumed by this request.
                    examples:
                      - 1
                  creditsAvailable:
                    type: integer
                    description: Number of API credits remaining.
                    examples:
                      - -1
                  traceId:
                    type: string
                    description: Unique trace ID for each request.
                    examples:
                      - f8e4a3b2c1d0e9f8a7b6c5d4e3f2a1b0
                  timestamp:
                    type: integer
                    description: >-
                      Time the response was generated, represented as a Unix
                      timestamp in milliseconds.
                    examples:
                      - 1750732453635
                  errorCode:
                    type: string
                    description: >-
                      Error code returned if the request fails. Empty if the
                      request is successful.
                    examples:
                      - ''
                  errorDescription:
                    type: string
                    description: >-
                      Description of the error. Empty if the request is
                      successful.
                    examples:
                      - ''
                  success:
                    type: boolean
                    description: '`true` if the request is successful.'
                    examples:
                      - true
                required:
                  - data
                  - traceId
                  - timestamp
                  - errorCode
                  - errorDescription
                  - success
                  - creditsUsed
                  - creditsAvailable
              examples:
                default:
                  value:
                    data:
                      channelId: UCsTcErHg8oDvUnTzoqsYeNw
                      uniqueId: '@unboxtherapy'
                      displayName: Unbox Therapy
                      categoryBreakdown:
                        - category: Science & Technology
                          share: 1
                      avatarUrl: >-
                        https://yt3.googleusercontent.com/ytc/AIdro_mrdFKrYUtuMEqVUWPmtKSzy0weSdlawiMI2VPqP9yq1ks=s900-c-k-c0x00ffffff-no-rj
                      bio: >-
                        Where products get naked.


                        Here you will find a variety of videos showcasing the
                        coolest products on the planet. From the newest
                        smartphone to surprising gadgets and technology you
                        never knew existed. It's all here on Unbox Therapy.


                        Business / professional inquiries ONLY - jack [at]
                        unboxtherapy.com

                        (please don't use YouTube inbox)
                      isVerified: true
                      hasSponsors: true
                      hasMemberOnlyContents: false
                      country: ''
                      mainLanguage: eng
                      languages:
                        - eng
                        - ''
                      secondLanguage: ''
                      totalContents: 2476
                      totalSubscribers: 24900000
                      subscriberGrowth:
                        g7: 0.004
                        g30: 0.0122
                        g90: 0.0081
                      hashtags:
                        - name: '#poolcleaner'
                          contentCount: 1
                        - name: '#aiper'
                          contentCount: 1
                        - name: '#seagullpro'
                          contentCount: 1
                        - name: '#insta360'
                          contentCount: 1
                        - name: '#insta360go3'
                          contentCount: 1
                        - name: '#tesla'
                          contentCount: 1
                        - name: '#elonmusk'
                          contentCount: 1
                        - name: '#ev'
                          contentCount: 1
                        - name: '#car'
                          contentCount: 1
                        - name: '#electriccar'
                          contentCount: 1
                        - name: '#cybertruck'
                          contentCount: 1
                        - name: '#elon'
                          contentCount: 1
                        - name: '#cyber'
                          contentCount: 1
                        - name: '#technology'
                          contentCount: 1
                        - name: '#gadgets'
                          contentCount: 1
                        - name: '#tech'
                          contentCount: 1
                        - name: '#gaming'
                          contentCount: 1
                        - name: '#ai'
                          contentCount: 1
                        - name: '#4k'
                          contentCount: 1
                        - name: '#vankyov700w'
                          contentCount: 1
                        - name: '#livehouseprojector'
                          contentCount: 1
                        - name: '#applewatch'
                          contentCount: 1
                        - name: '#smartwatch'
                          contentCount: 1
                        - name: '#apple'
                          contentCount: 1
                        - name: '#iphone'
                          contentCount: 1
                        - name: '#vankyo'
                          contentCount: 1
                        - name: '#enabotebox'
                          contentCount: 1
                        - name: '#ultra'
                          contentCount: 1
                        - name: '#iphone15'
                          contentCount: 1
                        - name: '#promax'
                          contentCount: 1
                        - name: '#timcook'
                          contentCount: 1
                        - name: '#asusrogally'
                          contentCount: 1
                        - name: '#asus'
                          contentCount: 1
                        - name: '#videogames'
                          contentCount: 1
                        - name: '#game'
                          contentCount: 1
                        - name: '#xbox'
                          contentCount: 1
                        - name: '#games'
                          contentCount: 1
                        - name: '#nintendo'
                          contentCount: 1
                        - name: '#esports'
                          contentCount: 1
                        - name: '#steam'
                          contentCount: 1
                        - name: '#steamdeck'
                          contentCount: 1
                        - name: '#battlenet'
                          contentCount: 1
                        - name: '#lightsaber'
                          contentCount: 1
                        - name: '#disney'
                          contentCount: 1
                        - name: '#jedi'
                          contentCount: 1
                        - name: '#themandalorian'
                          contentCount: 1
                        - name: '#darthvader'
                          contentCount: 1
                        - name: '#yoda'
                          contentCount: 1
                        - name: '#lukeskywalker'
                          contentCount: 1
                        - name: '#vivo'
                          contentCount: 1
                        - name: '#vivox90series'
                          contentCount: 1
                        - name: '#vivox90pro'
                          contentCount: 1
                        - name: '#shorts'
                          contentCount: 1
                        - name: '#ironman'
                          contentCount: 1
                        - name: '#marvel'
                          contentCount: 1
                        - name: '#avengers'
                          contentCount: 1
                        - name: '#tonystark'
                          contentCount: 1
                        - name: '#blackpanther'
                          contentCount: 1
                        - name: '#electronics'
                          contentCount: 1
                        - name: '#keyboard'
                          contentCount: 1
                        - name: '#music'
                          contentCount: 1
                        - name: '#mechanicalkeyboard'
                          contentCount: 1
                        - name: '#pcgaming'
                          contentCount: 1
                        - name: '#keyboards'
                          contentCount: 1
                        - name: '#keycaps'
                          contentCount: 1
                        - name: '#gamer'
                          contentCount: 1
                        - name: '#mechanicalkeyboards'
                          contentCount: 1
                        - name: '#gamingkeyboard'
                          contentCount: 1
                        - name: '#customkeyboard'
                          contentCount: 1
                        - name: '#computer'
                          contentCount: 1
                        - name: '#laptop'
                          contentCount: 1
                        - name: '#products'
                          contentCount: 1
                        - name: '#tozox1'
                          contentCount: 1
                        - name: '#lyriq'
                          contentCount: 1
                        - name: '#beiconic'
                          contentCount: 1
                        - name: '#ad'
                          contentCount: 1
                        - name: '#airpods'
                          contentCount: 1
                        - name: '#typec'
                          contentCount: 1
                        - name: '#unboxing'
                          contentCount: 1
                        - name: '#lgultragear'
                          contentCount: 1
                        - name: '#lgultragearoled'
                          contentCount: 1
                        - name: '#gamingmonitor'
                          contentCount: 1
                        - name: '#oledgamingmonitor'
                          contentCount: 1
                        - name: '#oppowimbledon'
                          contentCount: 1
                        - name: '#oraimo'
                          contentCount: 1
                        - name: '#oraimoopencirclet'
                          contentCount: 1
                        - name: '#opencirclet'
                          contentCount: 1
                        - name: '#smartphone'
                          contentCount: 1
                        - name: '#smartphones'
                          contentCount: 1
                        - name: '#batman'
                          contentCount: 1
                        - name: '#joker'
                          contentCount: 1
                        - name: '#android'
                          contentCount: 1
                        - name: '#monsterinside'
                          contentCount: 1
                        - name: '#tablet'
                          contentCount: 1
                        - name: '#3d'
                          contentCount: 1
                        - name: '#spyra'
                          contentCount: 1
                        - name: '#waterblaster'
                          contentCount: 1
                        - name: '#gift'
                          contentCount: 1
                        - name: '#toys'
                          contentCount: 1
                        - name: '#gelblaster'
                          contentCount: 1
                      topics:
                        - id_apple_ScienceTechnology
                        - id_smartphone_ScienceTechnology
                        - id_android_ScienceTechnology
                        - id_smartphone_ScienceTechnology
                        - id_unboxing_UniversalTopics
                        - id_review_UniversalTopics
                        - id_gadget_ScienceTechnology
                        - id_firstlook_ScienceTechnology
                        - id_electrichybridvehicles_AutoVehicles
                      niches:
                        - id_smartphone_ScienceTechnology
                        - id_gadget_ScienceTechnology
                        - id_samsung_ScienceTechnology
                        - id_iphone15_ScienceTechnology
                        - id_technology_ScienceTechnology
                        - id_iphone15promax_ScienceTechnology
                        - id_s23ultra_ScienceTechnology
                        - id_s23_ScienceTechnology
                        - id_tech_ScienceTechnology
                        - id_headphone_ScienceTechnology
                      otherLinks:
                        - title: Twitter
                          url: https://twitter.com/unboxtherapy
                        - title: Facebook
                          url: http://facebook.com/unboxtherapy
                        - title: Instagram
                          url: http://instagram.com/unboxtherapy
                        - title: The Official Website
                          url: http://www.unboxtherapy.com
                      lastPublishTime: 1771519500000
                      relatedCreators:
                        - UCEdjL1kbZ0K8nFu519vE5LQ
                        - UCMiJRAwDNSNzuYeN2uWa0pA
                        - UCat6bC0Wrqq9Bcq7EkH_yQw
                        - UCEwxAWaXt-6VVsgq3HZrtSw
                        - UCWFKCr40YwOZQx8FHU_ZqqQ
                        - UCOqLHxtUgG4JjE088iidj2g
                        - UCU5RDMQQEORJplvHC2_RtHA
                        - UCS0DKBnrqNadljxEuQ6QZqA
                        - UCBJycsmduvYEL83R_U4JriQ
                        - UCM11nNeppMvEcmI3kwfT7Vw
                        - UCuhF-BMyIDCILd4QND0VuAw
                        - UCXuqSBlHAE6Xw-yeJA0Tunw
                        - UC2OJvv_LGa54SoCsYJPtQrA
                        - UCdBK94H6oZT2Q7l0-b0xmMg
                        - UCUENouMddvr011UzaBNkB8w
                        - UCCiqMGlSWHNmFZDJA4Thc1Q
                        - UCD_-CQZEcIgmwMA9msp0C2w
                        - UCUQo7nzH1sXVpzL92VesANw
                        - UCRzQysbPOLz5SAXO8uTK50A
                        - UC0bcmAq3kWUgp8W3HcQlUkA
                        - UCPkdOzRWTXeIqCthZUUMvJg
                        - UCeBoFG76S36uI1rSUj98YzA
                        - UCzlXf-yUIaOpOjEjPrOO9TA
                        - UCbNeU6MiUdbzxiv_YK3EjQg
                        - UC6ktP3PLU5sAJxN9Rb0TALg
                        - UCzZOF5BnSi3MSM5AvBQ3vnw
                        - UCYdy92EvOSSgDYm5odItffA
                        - UCCsREoj8rSRkEvxWqxr74rQ
                        - UCB0vtAYL-WnCk_ze80STHDQ
                        - UCk2Oi0gykpdWgOMORu3TCjA
                        - UCIxLxlan8q9WA7sjuq6LdTQ
                        - UCjFCdrQ6-b0qREJ5YKkr_lg
                        - UCxfkOonfIpu6XCba7W0LbcQ
                        - UCha1U9CVS2f_zJY-yynte8A
                        - UCwYQXYfPHTZKANHzBHdYo2w
                        - UCbzzMQ1mNKjAaDwbELsVYcQ
                        - UCA06PZr2S4xv9bvxVMbE7VQ
                        - UCnUdm0u-2FRffBnxQYHuTHA
                        - UCEgm-3RvRn4nCR-fGGVsfdQ
                        - UCcLYOTz3ct6_lk9iLToxxAw
                        - UCBjr2QgkUNToRbwVecMgX3Q
                        - UCbR6jJpva9VIIAHTse4C3hw
                        - UCVLN0tY51ewH44wUtx3YZTA
                        - UCkK4Tzb9ieuAhcyWUZnLBBQ
                        - UC_oVYDT613F6viE3JENV-Yg
                        - UCYenDLnIHsoqQ6smwKXQ7Hg
                        - UC5lsLYgacl1dnZViTm6EsIA
                        - UCDkEYb-TXJVWLvOokshtlsw
                        - UCLVihavmaUONy0SeOX_F7aw
                        - UCjmBfhI-PIbIFu9AFF4D-Sg
                        - UCxA-y9vN2QTRTCSbwCJBPAA
                        - UC7g2N5Wq9q4nDORe3x49Ftw
                        - UC1NVjuwLxA_x5GI6jQ_DMsQ
                        - UC2bT0XuFvbImcLmkUgAvEqw
                        - UCsOoG6SdV7Bhb6wPrxZVNWQ
                        - UCnO6a9cX6ocochhzA8-BdoA
                        - UC4Tklxku1yPcRIH0VVCKoeA
                        - UCAzENhYrSStrpBL91zt6U0Q
                        - UCwOCcE4enBgo4DenWHv0JYA
                        - UCIfMka3q_tcPOYeiEZr3zjA
                        - UCHnyfMqiRRG1u-2MsSQLbXA
                        - UC3cRUKVHL5tk44KzyXbV7Cg
                        - UCplkXsPCqBvbZOsi9AYvvug
                        - UCAwjnLdBvZPVuCJU_8RHg_w
                        - UC_uTfDg6RRJ4cdxUI7nlFXw
                        - UCUhFaUpnq31m6TNX2VKVSVA
                        - UCdpNcdUH9ObL4XpNx-eDQ2g
                        - UCa6vGFO9ty8v5KZJXQxdhaw
                        - UCAszOEwa5CS4WFwYpkjdaUQ
                        - UC9M1vEGhRgd28qniDu-pDew
                        - UCSOpcUkE-is7u7c4AkLgqTw
                        - UCTecoCovL-9_f59o888a1cA
                        - UC7bPCZOmR8xc_8UjBgP_8pg
                        - UCf-z09Umbl8I21CwMpTLoyQ
                        - UCT_yBgKSiwb3WP4ACPnF5nA
                        - UCXIJgqnII2ZOINSWNOGFThA
                        - UCE_M8A5yxnLfW0KghEeajjw
                        - UCGxjDWAN1KwrkXYVi8CXtjQ
                        - UC3lJL1pUvQ2Ih2qZ-4ozrLw
                        - UCHOMwu9rsESLsDNSB8XgCUw
                        - UCptwuAv0XQHo1OQUSaO6NHw
                        - UCWVuy4NPohItH9-Gr7e8wqw
                        - UC7ozdvRD7Y0kbwFot4LmxAw
                        - UCal5H0vgmsKcwMKiUflVpEw
                        - UCHy8QSSJ1gXu-zbDlwwsE-w
                        - UCJNb9g5cwEzDV6syWZ0eK9Q
                        - UCaLCRvvau4acqQ4eLGZUywA
                        - UCptInZZydTD2gh_-Fttg_VQ
                        - UCtjiRW7g8WFVg_tiFX-9gsA
                        - UCPrfNyL7yN-15Q6Eu7UYkOA
                        - UCJx6JZSEJClyQVm75bQL-5Q
                        - UCVlMUh4WsDQvOxCJJXmWwdw
                        - UCtHm9ai5zSb-yfRnnUBopAg
                        - UCGvF47lmhFeNQvj03puADVg
                        - UC-8zGhJaeJ9kF0Y8QaKeTYw
                        - UC6AJUYrb8hqhHCSVtjelI0w
                        - UC-v54XQalOcx5yco3aTixrg
                        - UCTyuUxbflOZ0nESSnJBMpbg
                        - UClQQoervgLHV2pAOxHJ16NA
                        - UC5rUOvW9aEf_aUQ8UqzBfSg
                        - UCIrrRLyFMVmmL9NDAU2obJA
                        - UCCKsD3Azc7XEjzyMFI8DsBw
                        - UCiDJtJKMICpb9B1qf7qjEOA
                        - UCX6OQ3DkcsbYNE6H8uQQuVA
                        - UCeKONRFwOduYBHDxOAN9InQ
                        - UCgyBw9Y_aniBcnEq0eJPN0w
                        - UCpUUMhWg5GPD5ynP_vhnMJg
                        - UCzdxkyQb0W6Bo07X9ScbUeg
                        - UCl_LO48OHG9K8A3Js8Hj40g
                        - UCHJ-02TEGNS2GeD2wYetHSQ
                        - UCXAi-pPpdtc9uxU39E-PBEQ
                        - UCwMbSEgxhmOB5dXcxRTKHJQ
                        - UCWeaE5csOqxVMIW99q69BlQ
                        - UCfpCQ89W9wjkHc8J_6eTbBg
                        - UCQZ3j4faZQir7U4rvW4ItUA
                        - UC2gyzKcHbYfqoXA5xbyGXtQ
                        - UCwOBG77Tm8cE24FPxHb_abw
                        - UCtT2VnurQKOAA0I1EKKHSPA
                        - UCv9ingiPmqKs6ejZV2Pt6Dw
                        - UCoKMBuQ8YejlCbNm77ZL8jg
                        - UCaxWAd6mcrL1CWZdkUR4Kwg
                        - UCT6AJiTYspOILBK3hMWEq2g
                        - UCcZOERILmVmAWsFuxiG6n0g
                        - UCSWZxpzUTkriCZRe0Nl0UqA
                        - UC-U0quP8-RF1pvyCessLg0g
                        - UCJQjhL019_F0nckUU88JAJA
                        - UCYQ3utUKDWA8ekHBgY7ozuQ
                        - UCJOl2JvledP26K2OQ_HLgnQ
                        - UCXlDgfWY2JbsYEam2m68Hyw
                        - UCZZ4ivUawsXRktLKej8d6Xw
                        - UCugxX7vCPZZPPRCXYdbQY3g
                        - UCUun7jLOtkOcLuSC9KADjuw
                        - UCxDJbNtgLYUwjPg_xYjvSwQ
                        - UCrp2It0yWUC7XcrWyBIQeKw
                        - UCZRoNJu1OszFqABP8AuJIuw
                        - UCbW5tOCMJcgGGK6YtVqCLuA
                        - UC-ir42iPxsfz9MeDysH1MRw
                        - UCe_5cyghC66jIC64KnUs77w
                        - UC1Cp5caGwHvJZxHoevGoDdA
                        - UCGq7ov9-Xk9fkeQjeeXElkQ
                        - UCIzFYGAPkHURyo92D9ihs_g
                        - UCK1VlJid7ANJqEPDTM1RSoA
                        - UCvovNqrWdU7lQYRu_POX_bA
                        - UC-HMXSuM25Hw7EDMrbYg_bg
                        - UCmqH_QmPilpOwMCx-Xfde0g
                        - UCgyvzxg11MtNDfgDQKqlPvQ
                        - UCDWYbhR94ZYFUXd4NJvAHYQ
                        - UCe_Fx4EZAgKjDz0aQ_Y7hSA
                        - UCilMMM9A1l92ikebc-_gQgA
                        - UCr4-yFNgc44teZJ4DtD5mhg
                        - UCWWq67D7TofEPq_eBiaYCWw
                        - UCiL63uEtvDlbzpfmvs5dTHg
                        - UCKJgBJcJkc0Q4kZeGIyNTYA
                        - UCzVGVs_ridRZmU7qkltuY0w
                        - UCK81mcGq-hLp3oqYG6dOcaw
                        - UCET2WeWCR3BTTuKjJIFCyeQ
                        - UCpZy-Hfqcxf-R7nQzlv9Bvw
                        - UCd677p-lzplbTusvCU3NYYQ
                        - UCAjSHLRJcDfhDSu7WRpOu-w
                        - UC_Nql0AlGzl7dSAuTqBUPEA
                        - UCOmcA3f_RrH6b9NmcNa4tdg
                        - UC073quTeFarhKNe8ZuC6Qig
                        - UCgjkiGfJvgV6XWZy9EHwrjw
                        - UCEIwxahdLz7bap-VDs9h35A
                        - UClEWtMDCXO-_FXS15aAh_pg
                        - UCmJ5a16-2dJ8uvAA-1aj-hg
                        - UC14Rzu4t0lHRngM_VX5HWYw
                        - UCTIFIULcxN0sh8b3uXgDX6g
                        - UC5lDVbmgb-sAcx2fjwy3KQA
                        - UCgDqL4yzXb4BflimZaxL4Vg
                        - UCwBnXlOxxt2MC5tZhyr2JQw
                        - UClXdQLTwoi_hOP_36EtdF1g
                        - UCwWhs_6x42TyRM4Wstoq8HA
                        - UCSvD1S5kHsr9tvD3gDXkPkQ
                        - UC6H07z6zAwbHRl4Lbl0GSsw
                        - UCdp4_l1vPmpN-gDbUwhaRUQ
                        - UCqh8w-GY6v0vgwIn_iWt87A
                        - UC18WQbNSfrqxlIjKeIW3bGQ
                        - UC2VrA-oteANZQ07TquwBvAQ
                        - UC0MYNOsIrz6jmXfIMERyRHQ
                        - UCXXnwJW6WTK2b3i3p6GLaPw
                        - UCqFzWxSCi39LnW1JKFR3efg
                        - UCh_q04rXuPAFlBS9LqStx5A
                        - UChWB95_-n9rUc3H9srsn9bQ
                        - UCH5Ina9r-fPgb28W3qx_nNA
                        - UCiO0K2xt5irIN6x13FNzYTg
                        - UCswqv-OXePrufGSxIbE9_Jg
                        - UCklLqgV4VVXZyM3lXITC-Fw
                      videoPrice:
                        cpmLow: 9
                        cpmRaw: 13
                        cpmHigh: 17
                        priceLow: 13240
                        priceRaw: 18914
                        priceHigh: 24588
                      shortsPrice:
                        cpmLow: 8
                        cpmRaw: 11
                        cpmHigh: 14
                        priceLow: 12655
                        priceRaw: 18079
                        priceHigh: 23502
                      lastDbUpdateTime: 1771893695410
                    traceId: 15a56a8f5462e75e8b12c1baf88d83c7
                    timestamp: 1772012370616
                    errorCode: ''
                    errorDescription: ''
                    success: true
        '400':
          description: Validation error.
          content:
            application/json:
              schema:
                type: object
                title: ValidationErrorResponse
                properties:
                  success:
                    const: false
                  error:
                    type: string
                  message:
                    type: string
                  timestamp:
                    type: integer
                required:
                  - success
                  - error
                  - message
                  - timestamp
              examples:
                missing identifier:
                  summary: No identifier provided
                  value:
                    success: false
                    error: VALIDATION_ERROR
                    message: 'Missing required identifier: ''channelId'' or ''uniqueId''.'
                    timestamp: 1770099403116
                invalid channelId:
                  summary: Invalid channelId format
                  value:
                    success: false
                    error: VALIDATION_ERROR
                    message: >-
                      Invalid `channelId` format. YouTube channel IDs must start
                      with 'UC' followed by 22 characters.
                    timestamp: 1770099403116
        '429':
          description: Exceeded quota or rate limit.
          content:
            application/json:
              schema:
                type: object
                title: QuotaErrorResponse
                properties:
                  success:
                    const: false
                  error:
                    type: string
                  message:
                    type: string
                  remainingPlanCredit:
                    type: number
                required:
                  - success
                  - error
                  - message
                  - remainingPlanCredit
              examples:
                rate limit:
                  summary: Rate limit exceeded
                  value:
                    success: false
                    error: RATE_LIMIT_EXCEEDED
                    message: Too many requests. Please try again later.
                quota exceeded:
                  summary: Credit quota exceeded
                  value:
                    success: false
                    error: QUOTA_EXCEEDED
                    message: Not enough credits to complete this request.
      security:
        - ApiKeyAuth: []
      servers:
        - url: https://apiv3.creatordb.app
          description: Production Environment (CreatorDB Headless API V3)
      x-codeSamples:
        - lang: bash
          label: cURL
          source: |
            curl -X POST "https://apiv3.creatordb.app/youtube/profile" \
              -H "Content-Type: application/json" \
              -H "api-key: <YOUR_API-KEY_HERE>" \
              -d '{ "channelId": "UCsTcErHg8oDvUnTzoqsYeNw", "fields": ["displayName", "country"] }'
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      description: The valid CreatorDB API key for authentication.
      name: api-key
      in: header

````