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)"
paths:
  /usage:
    get:
      tags:
        - General Operations
      summary: Get API Usage
      description: "Retrieve your API usage statistics within the specified date range (maximum 365 days). Defaults to 7 days ago when no start or end dates are provided."
      operationId: getApiUsage
      parameters:
        - name: start
          in: query
          description: "Start date, represented as a Unix timestamp in milliseconds. Defaults to 7 days ago."
          required: false
          schema:
            type: string
            examples:
              - "1737312000000"
        - name: end
          in: query
          description: "End date, represented as a Unix timestamp in milliseconds. Defaults to current time."
          required: false
          schema:
            type: string
            examples:
              - "1737398400000"
      x-codeSamples:
        - lang: bash
          label: cURL
          source: |
            curl -X GET "https://apiv3.creatordb.app/usage" \
              -H "api-key: <YOUR_API_KEY_HERE>"
      responses:
        "200":
          description: "API credit usage results returned successfully."
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    description: "API usage data containing records and count."
                    properties:
                      records:
                        type: array
                        description: "API usage records for the requested date range."
                        items:
                          type: object
                          properties:
                            date:
                              type: string
                              description: "Date in YYYYMMDD format (UTC±0)."
                              pattern: '^\d{8}$'
                              examples:
                                - "20260120"
                            requestCount:
                              type: integer
                              description: "Total number of API requests for this API key."
                              minimum: 0
                              examples:
                                - 47
                            totalQuotaUsed:
                              type: number
                              description: "Total credits consumed for this API key."
                              minimum: 0
                              examples:
                                - 47
                            totalQuotaAdded:
                              type: number
                              description: "Total credits added by admin custom operations for this API key."
                              minimum: 0
                              examples:
                                - 12
                            endpoints:
                              type: object
                              description: "Request count and quota usage per endpoint."
                              additionalProperties:
                                type: object
                                properties:
                                  count:
                                    type: integer
                                    description: "Number of requests made to this endpoint, including both full and fractional requests."
                                    minimum: 0
                                  quotaUsed:
                                    type: number
                                    description: "Total API credits consumed by this endpoint."
                                    minimum: 0
                                  quotaAdded:
                                    type: number
                                    description: "Total API credits added by this endpoint."
                                    minimum: 0
                                  fractional:
                                    type: object
                                    description: "Portion of this endpoint's total `count` and `quotaUsed` attributable to fractional calls, which return only the fields the caller requested. Absent when no fractional calls were made to this endpoint on this day."
                                    properties:
                                      count:
                                        type: integer
                                        description: "Number of fractional requests made to this endpoint."
                                        minimum: 0
                                      quotaUsed:
                                        type: number
                                        description: "API credits consumed by fractional requests to this endpoint."
                                        minimum: 0
                                    required:
                                      - count
                                      - quotaUsed
                                required:
                                  - count
                                  - quotaUsed
                                  - quotaAdded
                              examples:
                                - searchInstagram:
                                    count: 12
                                    quotaUsed: 12
                                    quotaAdded: 0
                                  getInstagramProfile:
                                    count: 8
                                    quotaUsed: 8
                                    quotaAdded: 0
                                  getYoutubeProfile:
                                    count: 15
                                    quotaUsed: 22
                                    quotaAdded: 0
                                    fractional:
                                      count: 9
                                      quotaUsed: 4
                                  custom:
                                    count: 3
                                    quotaUsed: 5
                                    quotaAdded: 12
                            platforms:
                              type: object
                              description: "Number of requests per social media platform. Empty when no platform-specific calls were made."
                              additionalProperties:
                                type: integer
                                minimum: 0
                              default: {}
                              examples:
                                - instagram: 20
                                  tiktok: 10
                                  youtube: 17
                            quotaByPlatform:
                              type: object
                              description: "API credits consumed per social media platform. Empty when no platform-specific calls were made."
                              additionalProperties:
                                type: number
                                minimum: 0
                              default: {}
                              examples:
                                - instagram: 20
                                  tiktok: 10
                                  youtube: 17
                          required:
                            - date
                            - requestCount
                            - totalQuotaUsed
                            - totalQuotaAdded
                            - endpoints
                      count:
                        type: integer
                        description: "Total number of records returned."
                        minimum: 0
                        examples:
                          - 7
                      key:
                        type: object
                        description: "The calling API key's spendlimit status."
                        properties:
                          creditLimit:
                            type:
                              - number
                              - "null"
                            description: "The lifetime credit limit for this API key, in credits. `null` when the key has no limit."
                            examples:
                              - 5000
                          creditsRemaining:
                            type:
                              - number
                              - "null"
                            description: "Remaining credits this API key can spend before reaching its limit, calculated as credit limit minus cumulative spend. A negative value means cumulative spend has exceeded the limit, and further requests are rejected. `null` when the key has no limit of its own, in which case spending is bounded only by the account's available credits."
                            examples:
                              - 4975
                              - -1205
                              - null
                          active:
                            type: boolean
                            description: "Whether this API key is currently active."
                            examples:
                              - true
                        required:
                          - creditLimit
                          - creditsRemaining
                          - active
                    required:
                      - records
                      - count
                      - key
                  creditsUsed:
                    type: number
                    description: "Total number of API credits consumed across all requests in this session."
                    examples:
                      - 1
                  creditsAvailable:
                    type: number
                    description: "Number of API credits remaining. Calculated as: `planCreditsAvailable` + `purchasedCreditsAvailable`."
                    examples:
                      - -1
                  planCreditsAvailable:
                    type: number
                    description: "Remaining plan credits after this request, in credits."
                    examples:
                      - 900
                  purchasedCreditsAvailable:
                    type: number
                    description: "Remaining purchased credits after this request, in credits."
                    examples:
                      - 75
                  keyCreditsAvailable:
                    type: number
                    description: "Remaining credits this API key can spend after this request, before reaching its spend limit. Present only when the key has a spend limit."
                    examples:
                      - 4975
                  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
                  - planCreditsAvailable
                  - purchasedCreditsAvailable
        "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:
                invalid date range:
                  summary: Date range exceeds 365 days
                  value:
                    success: false
                    error: "VALIDATION_ERROR"
                    message: "The 'start' and 'end' date range cannot exceed 365 days."
                    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 limited:
                  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)"
  #YouTube
  # Natural language search (unified, cross-platform)
  /nls:
    post:
      tags:
        - AI Search
      summary: Natural Language Search
      description: >-
        Search for creators across YouTube, Instagram, and TikTok using natural language descriptions.
        The AI determines the appropriate platform from your query and converts it into structured search filters.
        Results are delivered via Server-Sent Events (SSE) streaming.
      operationId: getNLS
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              description: "Natural language search parameters."
              properties:
                description:
                  type: string
                  description: "A natural language description of the creators you are looking for."
                  minLength: 1
                  maxLength: 1000
                  example: "Find US-based YouTube beauty creators that own makeup brands and have more than 15 million subscribers"
              required:
                - description
      x-codeSamples:
        - lang: bash
          label: cURL
          source: |
            curl -X POST "https://apiv3.creatordb.app/nls" \
              -H "Content-Type: application/json" \
              -H "api-key: <YOUR_API_KEY_HERE>" \
              -d '{
                "description": "Find US-based YouTube beauty creators that own makeup brands and have more than 15 million subscribers"
              }'
        - lang: python
          label: Python
          source: |
            import requests

            url = "https://apiv3.creatordb.app/nls"

            payload = { "description": "Find US-based YouTube beauty creators that own makeup brands and have more than 15 million subscribers" }
            headers = {
                "api-key": "<YOUR_API_KEY_HERE>",
                "Content-Type": "application/json"
            }

            response = requests.post(url, json=payload, headers=headers, stream=True)

            for line in response.iter_lines(decode_unicode=True):
                print(line)
      responses:
        "200":
          description: >-
            NLS results are delivered via Server-Sent Events (SSE). The stream emits multiple `event: progress` messages with status updates (e.g., `{"message":"Loading..."}`, `{"message":"Analyzing intent..."}`, `{"message":"Query ready..."}`), followed by a final `event: result` containing the response object shown below. Connect using an SSE-capable client or `stream=True` in your HTTP library.
          content:
            text/event-stream:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      creatorList:
                        type: array
                        description: "Matching creators. Present when the query returns results."
                        items:
                          type: object
                          properties:
                            displayName:
                              type: string
                              description: "The creator display name."
                            uniqueId:
                              type: string
                              description: "The creator handle."
                            channelId:
                              type: string
                              description: "YouTube channel ID."
                            avatarUrl:
                              type: string
                              description: "Profile picture URL."
                            totalSubscribers:
                              type: integer
                              description: "YouTube subscriber count."
                            totalFollowers:
                              type: integer
                              description: "Instagram or Tiktok follower count."
                      platform:
                        type: string
                        description: "The platform detected from the query."
                        enum:
                          - youtube
                          - instagram
                          - tiktok
                      message:
                        type: string
                        description: "Explanation when the query is too broad (suggestion response)."
                      suggestion:
                        type: array
                        items:
                          type: string
                        description: "Refined query suggestions when the original query is too broad."
                  creditsUsed:
                    type: number
                    description: "Credits consumed for this request (dynamic, based on token usage)."
                    examples:
                      - 3.04
                  creditsAvailable:
                    type: number
                    description: "Number of API credits remaining. Equals planCreditsAvailable plus purchasedCreditsAvailable."
                    examples:
                      - 2627.89
                  planCreditsAvailable:
                    type: number
                    description: "Remaining plan credits after this request, in credits."
                    examples:
                      - 900
                  purchasedCreditsAvailable:
                    type: number
                    description: "Remaining purchased credits after this request, in credits."
                    examples:
                      - 75
                  keyCreditsAvailable:
                    type: number
                    description: "Remaining credits this API key may still spend before reaching its spend limit, in credits. Present only when the key has a spend limit."
                    examples:
                      - 4975
                  traceId:
                    type: string
                    description: "Unique trace ID for each request."
                    examples:
                      - "6ddf6c22a7a84b83e9a98f70a06e6235"
                  timestamp:
                    type: integer
                    description: "Time the response was generated, represented as a Unix timestamp in milliseconds."
                    examples:
                      - 1774586488186
                  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
                  - planCreditsAvailable
                  - purchasedCreditsAvailable
              examples:
                default:
                  summary: SSE stream with progress events and final result
                  value:
                    - event: progress
                      data:
                        message: "Loading..."
                    - event: progress
                      data:
                        message: "Query validated..."
                    - event: progress
                      data:
                        message: "Analyzing intent..."
                    - event: progress
                      data:
                        message: "Processing request..."
                    - event: progress
                      data:
                        message: "Identifying filters..."
                    - event: progress
                      data:
                        message: "Working on it..."
                    - event: progress
                      data:
                        message: "Getting the right filters..."
                    - event: progress
                      data:
                        message: "Analysis complete..."
                    - event: progress
                      data:
                        message: "Putting it all together..."
                    - event: progress
                      data:
                        message: "Building query..."
                    - event: progress
                      data:
                        message: "Query ready..."
                    - event: result
                      data:
                        creatorList:
                          - displayName: YouTube
                            uniqueId: "@youtube"
                            channelId: "UCBR8-60-B28hp2BmDPdntcQ"
                            avatarUrl: "https://yt3.googleusercontent.com/3s6evpqAiDU9tQR4sC2siJippbH2RWVPnwHgyl4V0th2iuQz0VDQZbUhQBGmsxLYo-mjG6TqZQ=s900-c-k-c0x00ffffff-no-rj"
                            totalSubscribers: 45000000
                          - displayName: 5-Minute Crafts DIY
                            uniqueId: "@5minutecraftsdiy"
                            channelId: "UC2etEuPIfohP4P53wM0KImA"
                            avatarUrl: "https://yt3.googleusercontent.com/dpw85Qj9vAdE4iX_yr0wUcoZkuBZqPBrlovIkePsgOzmywZdQeJpUQARG1to6mEEeqmUQlMtR-o=s900-c-k-c0x00ffffff-no-rj"
                            totalSubscribers: 20100000
                          - displayName: 5-Minute Crafts FAMILY
                            uniqueId: "@5minutecraftsfamily"
                            channelId: "UC63mNFJR8EAb8wAIJwoCmTA"
                            avatarUrl: "https://yt3.googleusercontent.com/jPrniMECPSuIG45SMTj4VlCxtYqQ4E4RqnZIPxJPPhm_mb1ZHV2X0MFwCh3X6R_3lLvIooVxbNE=s900-c-k-c0x00ffffff-no-rj"
                            totalSubscribers: 15800000
                          - displayName: Kids Diana Show
                            uniqueId: "@kidsdianashow"
                            channelId: "UCk8GzjMOrta8yxDcKfylJYw"
                            avatarUrl: "https://yt3.googleusercontent.com/G88LBGqFoBWMos0glZEdCvQ7uEMPnhBYsPRMOFX5b5z6tuqWaD6ZcscslaKu0zLO37v8sMUA=s900-c-k-c0x00ffffff-no-rj"
                            totalSubscribers: 138000000
                          - displayName: Maria Clara & JP
                            uniqueId: "@mariaclaraejp"
                            channelId: "UCKe6w0exI94U-RzqAyoY1VA"
                            avatarUrl: "https://yt3.googleusercontent.com/ytc/AIdro_n8EDt3qdYql9Dt6WAZDlb_7Af8wIukpc3h3cAbCptHNUg=s900-c-k-c0x00ffffff-no-rj"
                            totalSubscribers: 50200000
                          - displayName: Mr DegrEE
                            uniqueId: "@mrdegreeofficial"
                            channelId: "UCeYTfGpNCmVhlxjQxBDrGPA"
                            avatarUrl: "https://yt3.googleusercontent.com/ytc/AIdro_k8LXkXtQX2Skbr0NZ2jzNO-_j-Bu2T80hWwDUs3eL2ZCg=s900-c-k-c0x00ffffff-no-rj"
                            totalSubscribers: 40400000
                          - displayName: SMOL
                            uniqueId: "@smol_official"
                            channelId: "UCBBZ7No0AzEJ3qiatjSa-mg"
                            avatarUrl: "https://yt3.googleusercontent.com/QSq4dqpufwELLxjadoLE8CghxJ12tfu4vGUM8t2YiwztzAyYtPvSKN59nH_lEd02vPQfnQ3L2Q=s900-c-k-c0x00ffffff-no-rj"
                            totalSubscribers: 27200000
                          - displayName: Fabiosa Best Lifehacks
                            uniqueId: "@fabiosabestlifehacks"
                            channelId: "UCF5Rp2ghzXsX6vwYqa7aepg"
                            avatarUrl: "https://yt3.googleusercontent.com/g9YIHarU8-wUSH5lnFRNg9e9RBT9EHv21rlP7r10lHwmpALsDzt-jiSkVzBxTUyDBQjK3Hz1hA=s900-c-k-c0x00ffffff-no-rj"
                            totalSubscribers: 25900000
                          - displayName: James Charles
                            uniqueId: "@jamescharles"
                            channelId: "UCucot-Zp428OwkyRm2I7v2Q"
                            avatarUrl: "https://yt3.googleusercontent.com/6WC8rRE_1ME7Sza7y-Z75g_wGahOKlyRevH2hOE9DNMrHM37ZYCmNGBnJpJWqhUpy0-c05xQcjk=s900-c-k-c0x00ffffff-no-rj"
                            totalSubscribers: 23900000
                          - displayName: Troom Troom
                            uniqueId: "@troomtroom"
                            channelId: "UCWwqHwqLSrdWMgp5DZG5Dzg"
                            avatarUrl: "https://yt3.googleusercontent.com/KxkUWubksdvmkXC6dKk_JuJF40McZgmDYWcclmNJHAuhDnZGpVA9-sdW75q9MTCZ-NE2z3yBfY0=s900-c-k-c0x00ffffff-no-rj"
                            totalSubscribers: 23800000
                          - displayName: Marusya Outdoors
                            uniqueId: "@marusya_outdoors"
                            channelId: "UCRR3vpGoVKF3q_vZI7mCfjQ"
                            avatarUrl: "https://yt3.googleusercontent.com/JNVo_OhRKlrCe4lTIehltRomjHGhAwADSeliVky8KSpwqfeaZ2Y7QCCUiOPVIfFt6XLzCwNE=s900-c-k-c0x00ffffff-no-rj"
                            totalSubscribers: 20600000
                          - displayName: Dr Ryan
                            uniqueId: "@itsdrryan"
                            channelId: "UC26FEMwAAjj8jfNbuVdFMBQ"
                            avatarUrl: "https://yt3.googleusercontent.com/8XsSINxf0myiTvCb-KByq8eLOQMDg7en6Mxdap1YlbddXyvyBypr5lCaSi98KJhSOCwD9z5gxQ=s900-c-k-c0x00ffffff-no-rj"
                            totalSubscribers: 20000000
                          - displayName: VICE
                            uniqueId: "@vice"
                            channelId: "UCn8zNIfYAQNdrFRrr8oibKw"
                            avatarUrl: "https://yt3.googleusercontent.com/9AgWUnohXk3gFYvmvAZemlr1q6yd7NxHozeEqrPpJhYf9Crjrvqml0ulZ4PL4v38I4XDoLEhaw=s900-c-k-c0x00ffffff-no-rj"
                            totalSubscribers: 19100000
                          - displayName: Crafty Panda
                            uniqueId: "@craftypanda"
                            channelId: "UC03RvJoIhm_fMwlUpm9ZvFw"
                            avatarUrl: "https://yt3.googleusercontent.com/ytc/AIdro_kI-gjxVAiZh-LDX0ayqKKSQL-qIxrCG7qi3Q2IQNeTamk=s900-c-k-c0x00ffffff-no-rj"
                            totalSubscribers: 19000000
                          - displayName: Ray William Johnson
                            uniqueId: "@raywilliamjohnson"
                            channelId: "UCGt7X90Au6BV8rf49BiM6Dg"
                            avatarUrl: "https://yt3.googleusercontent.com/y_myu5CoUFndBkJ5sZFCiSoi-rM6UY-x-Wog6C7nl_6pgXt9M0Z-YPfVCHSvIYS5PlyRidhE=s900-c-k-c0x00ffffff-no-rj"
                            totalSubscribers: 18700000
                          - displayName: JULIA GISELLA
                            uniqueId: "@juliagisella"
                            channelId: "UCCPsBYxLUykj5xbgOGTRzKQ"
                            avatarUrl: "https://yt3.googleusercontent.com/2n0OZs6fyMF6lvszolH4Pe5s-4koRhrWR7R2julWoeKwnAsLgUTS_6COm0CnGzuf5vIhLvepsNw=s900-c-k-c0x00ffffff-no-rj"
                            totalSubscribers: 18100000
                          - displayName: Jennifer Lopez
                            uniqueId: "@jenniferlopez"
                            channelId: "UCr8RjWUQ_9KYcIPmWiqBroQ"
                            avatarUrl: "https://yt3.googleusercontent.com/u0IEPhk-hqU3pbeBNAPf5EQRwQs2mnT1-3rRQaGt3pXhf6lhQgFk3j6LQfupRNV0iYIU4BeIQJw=s900-c-k-c0x00ffffff-no-rj"
                            totalSubscribers: 17500000
                          - displayName: Vogue
                            uniqueId: "@vogue"
                            channelId: "UCRXiA3h1no_PFkb1JCP0yMA"
                            avatarUrl: "https://yt3.googleusercontent.com/pjWEB6VpO5GmzI7aGg6pAjkNSdLf75LKoUXmmj2HAs1Fq1V1zlcevvR4hf7J9VtV7fYxaYJHS8g=s900-c-k-c0x00ffffff-no-rj"
                            totalSubscribers: 16200000
                          - displayName: MrBeast
                            uniqueId: "@mrbeast"
                            channelId: "UCX6OQ3DkcsbYNE6H8uQQuVA"
                            avatarUrl: "https://yt3.googleusercontent.com/nxYrc_1_2f77DoBadyxMTmv7ZpRZapHR5jbuYe7PlPd5cIRJxtNNEYyOC0ZsxaDyJJzXrnJiuDE=s900-c-k-c0x00ffffff-no-rj"
                            totalSubscribers: 473000000
                          - displayName: "Alan's Universe"
                            uniqueId: "@alanchikinchow"
                            channelId: "UC5gxP-2QqIh_09djvlm9Xcg"
                            avatarUrl: "https://yt3.googleusercontent.com/QYrADJNN_BMJSYm0LkqAs13ehWHjtxITE7kSBPsEIB_I_VFeDvujpH4aJfHfJO3FsFMsYa6Oig=s900-c-k-c0x00ffffff-no-rj"
                            totalSubscribers: 100000000
                        platform: youtube
                      traceId: "6ddf6c22a7a84b83e9a98f70a06e6235"
                      timestamp: 1774586488186
                      creditsAvailable: 2627.89
                      creditsUsed: 3.04
                      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 description:
                  summary: Missing description field
                  value:
                    success: false
                    error: "VALIDATION_ERROR"
                    message: "Missing required field: 'description'."
                    timestamp: 1770099403116
                description too long:
                  summary: Description exceeds 1000 characters
                  value:
                    success: false
                    error: "VALIDATION_ERROR"
                    message: "The 'description' field must be between 1 and 1000 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)"
  #YouTube custom filter search
  /youtube/search:
    post:
      tags:
        - YouTube
      summary: Search Creators
      description: "Search for YouTube creators using advanced filters such as `displayName`, subscriber count, video performance, and more. Supports fuzzy search, pagination, and multiple filter combinations. At least one filter is required. By default the `creatorList` is sorted by `displayName`. Custom sorting can be applied using the `sortBy` parameter. <br /><br />Optionally pass `fields` to enrich each search result with data from other endpoints. Enrichment is billed per result returned, using each endpoint's own pricing rules. Fractional calls must be enabled on your API key. For details, see [Fractional Calls](/api-v3/fractional-calls)."
      operationId: searchYoutube
      requestBody:
        content:
          application/json:
            schema:
              type: object
              description: "YouTube search request parameters."
              properties:
                filters:
                  type: array
                  description: "Filter objects, each with `filterName`, `op`, and `value`. For all accepted `filterName` values and their data types, see [Configuring Custom Search Filters and Examples](/api-v3/configuring_advanced_search_filters#configuring-custom-youtube-filter-search-criteria). You can combine multiple filters in a single request to narrow your search results. Unlimited number of filters. Filters are billed in blocks of 10 at **1 credit** per block, and a partial block counts as a full one (1–10 filters = 1 credit, 11–20 = 2, and so on)."
                  minItems: 1
                  items:
                    type: object
                    properties:
                      filterName:
                        type: string
                        description: "The field to apply the filter on."
                      op:
                        type: string
                        enum:
                          - in
                          - ">"
                          - "="
                          - "<"
                        description: "The comparison operator. Accepted values include: `in`, `>`, `=`, `<`. <br /> - String fields accept: `=`, `in`. <br /> - Number fields accept: `>`, `=`, `<`. <br /> - Boolean fields accept: `=` "
                      value:
                        description: "Type depends on the `filterName`. <br /> - String fields accept `string` or `string[]`. <br /> - Number fields accept `number`. <br /> - Boolean fields accept `boolean`. <br /> - Operator `in` accepts `string[]`, operator `=` accepts string for `string` fields."
                        anyOf:
                          - type: string
                          - type: number
                          - type: array
                            maxItems: 100
                            items:
                              type: string
                          - type: boolean
                      isFuzzySearch:
                        type: boolean
                        description: "When `true`, performs a fuzzy match for `string` type `filterName`."
                        default: false
                    required:
                      - filterName
                      - op
                      - value
                desc:
                  type: boolean
                  description: "Sort order for results. `true` for descending, `false` for ascending order."
                sortBy:
                  type: string
                  description: "Field to sort creators by. For example, `totalSubscribers` sorts by subscriber count."
                pageSize:  
                  type: integer
                  description: "Number of results per page. Maximum: 100."
                  minimum: 1
                  maximum: 100
                offset:
                  type: integer
                  description: "Number of records to skip before returning results."
                  minimum: 0
                fields:
                  type: object
                  description: "Enrich each search result with data from other endpoints on the same platform (e.g. `profile`, `contact`). Enrichment is billed per result returned, using each endpoint's pricing rules. Each key is a bare endpoint name, and each key's value follows that endpoint's fractional shape. For details, see [Field and Item Costs](/api-v3/field-and-item-costs#youtube/search)."
                  properties:
                    profile:
                      type: array
                      items:
                        type: string
                      description: "Profile fields to add to each search result."
                    performance:
                      type: array
                      items:
                        type: string
                      description: "Performance blocks to add to each search result."
                    audience:
                      type: array
                      items:
                        type: string
                      description: "Audience fields to add to each search result."
                    contact:
                      type: array
                      items:
                        type: string
                      description: "Contact fields to add to each search result."
                    content-detail:
                      type: object
                      description: "Per-item counts, e.g. `{ \"recentVideos\": 3 }`. `0`, `null`, or omission returns zero items for that field. Valid field names vary by platform. For details, see [Fractional Calls](/api-v3/fractional-calls)."
                    performance-history:
                      type: object
                      required: [pastDayRange]
                      properties:
                        pastDayRange:
                          type: integer
                          minimum: 1
                          maximum: 400
                          description: "Number of past days of daily snapshots, from 1 to 400, as a JSON number (for example `90`, not `\"90\"`)."
                      description: "Date range bucket, e.g. `{ \"pastDayRange\": 90 }`. For pricing, see [Performance history pricing](/api-v3/api-credit-usage#performance-history-pricing)."
                    sponsorship:
                      type: object
                      description: "Per-brand counts, e.g. `{ \"sponsorList\": 5 }`. `0`, `null`, or omission returns zero brands. Available for YouTube and Instagram search only. For details, see [Fractional Calls](/api-v3/fractional-calls)."
                  additionalProperties: false
                  examples:
                    - profile:
                        - country
                      content-detail:
                          recentVideos: 3
                      performance-history:
                          pastDayRange: 90
                      sponsorship: 
                          sponsorList: 5      
              required:
                - filters
                - pageSize
                - offset
              examples:
                - filters:
                    - filterName: displayName
                      op: "="
                      value: beast
                      isFuzzySearch: true
                  desc: true
                  sortBy: displayName
                  pageSize: 10
                  offset: 0
            examples:
              default:
                value:
                  filters:
                    - filterName: totalSubscribers
                      op: ">"
                      value: 1000000
                      isFuzzySearch: true
                  desc: true
                  sortBy: displayName
                  pageSize: 10
                  offset: 0
      x-codeSamples:
        - lang: bash
          label: cURL
          source: |
            curl -X POST "https://apiv3.creatordb.app/youtube/search" \
              -H "Content-Type: application/json" \
              -H "api-key: <YOUR_API_KEY_HERE>" \
              -d '{
                "filters":[
                {
                  "filterName":
                    "totalSubscribers",
                    "op":">",
                    "value":1000000
                }
                ],
                "pageSize":10,
                "offset":0
                }'
      responses:
        "200":
          description: "YouTube search results returned successfully."
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    description: "Search results containing YouTube creators and pagination information."
                    properties:
                      creatorList:
                        type: array
                        description: "Creator objects matching the search query."
                        items:
                          type: object
                          description: "Creator details in search results."
                          properties:
                            displayName:
                              type: string
                              description: "Channel display name."
                              examples:
                                - YouTube
                            uniqueId:
                              type: string
                              description: "Unique handle."
                              examples:
                                - "@youtube"
                            channelId:
                              type: string
                              description: "Unique channel ID."
                              examples:
                                - UCBR8-60-B28hp2BmDPdntcQ
                            avatarUrl:
                              type: string
                              description: "Channel profile picture URL."
                              examples:
                                - "https://yt3.googleusercontent.com/7cF22TRiceqQr2Cro_X4uhRVnwCdOa2HXiwdBGPnUEqJDuCyr2CykDfDw2rCWjbjaHEdTMUC=s900-c-k-c0x00ffffff-no-rj"
                            totalSubscribers:
                              type: integer
                              description: "Total number of subscribers."
                              minimum: 0
                              examples:
                                - 13900000
                            profile:
                              $ref: "#/components/schemas/YoutubeProfileData"
                              description: "Profile data for this creator. Present only when requested via `fields.profile`."
                            performance:
                              $ref: "#/components/schemas/YoutubePerformanceData"
                              description: "Performance data for this creator. Present only when requested via `fields.performance`."
                            audience:
                              $ref: "#/components/schemas/YoutubeAudienceData"
                              description: "Audience demographics for this creator. Present only when requested via `fields.audience`."
                            contact:
                              $ref: "#/components/schemas/YoutubeContactData"
                              description: "Contact information for this creator. Present only when requested via `fields.contact`."
                            content-detail:
                              $ref: "#/components/schemas/YoutubeContentDetailData"
                              description: "Recent content published by this creator. Present only when requested via `fields.content-detail`."
                            sponsorship:
                              $ref: "#/components/schemas/YoutubeSponsorshipData"
                              description: "Sponsorship data for this creator. Present only when requested via `fields.sponsorship`."
                            performance-history:
                              $ref: "#/components/schemas/YoutubePerformanceHistoryData"
                              description: "Daily performance snapshots for this creator. Present only when requested via `fields.performance-history`."
                          required:
                            - displayName
                            - uniqueId
                            - channelId
                            - avatarUrl
                            - totalSubscribers
                      totalResults:
                        type: integer
                        description: "Number of results for this search query."
                        minimum: 0
                        examples:
                          - 1
                      hasNextPage:
                        type: boolean
                        description: "`true` if there is a next page of results."
                        examples:
                          - true
                      nextOffset:
                        type: integer
                        description: "The offset value for retrieving the next page of results."
                        minimum: 0
                        examples:
                          - 100
                    required:
                      - creatorList
                      - totalResults
                      - hasNextPage
                      - nextOffset
                  creditsUsed:
                    type: number
                    description: "Number of API credits consumed by this request."
                    examples:
                      - 1
                  creditsAvailable:
                    type: number
                    description: "Number of API credits remaining. Equals planCreditsAvailable plus purchasedCreditsAvailable."
                    examples:
                      - -1
                  planCreditsAvailable:
                    type: number
                    description: "Remaining plan credits after this request, in credits."
                    examples:
                      - 900
                  purchasedCreditsAvailable:
                    type: number
                    description: "Remaining purchased-bucket credits after this request, in display units."
                    examples:
                      - 75
                  keyCreditsAvailable:
                    type: number
                    description: "Remaining credits this API key can spend after this request, before reaching its spend limit. Present only when the key has a spend limit."
                    examples:
                      - 4975
                  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
                  enrichment:
                    type: object
                    description: "Enrichment status for this request. Present only when `fields` was supplied."
                    properties:
                      applied:
                        type: boolean
                        description: "Whether each result was enriched with the requested `fields`. `false` when enrichment was skipped because the remaining credits could not cover it, in which case only the standard search fields are returned."
                        examples:
                          - true
                      message:
                        type: string
                        description: "Note explaining the enrichment outcome. Present when enrichment was skipped."
                    required:
                      - applied
                required:
                  - data
                  - traceId
                  - timestamp
                  - errorCode
                  - errorDescription
                  - success
                  - creditsUsed
                  - creditsAvailable
                  - planCreditsAvailable
                  - purchasedCreditsAvailable
              examples:
                default:
                  value:
                    data:
                      creatorList:
                        - displayName: 🪐🌍Gallivud_prod
                          uniqueId: "@gallivud_prod"
                          channelId: UCMS8ONu5i0tKTyZ4_lLD1DA
                          avatarUrl: "https://yt3.googleusercontent.com/geeG3ok-_7PzCBlXDEW8Ro2m0QNl_XRH4AekEVvPqBhgmrFJbn2iKzn06lSnI2GnkybvaJY7=s900-c-k-c0x00ffffff-no-rj"
                          totalSubscribers: 1400000
                        - displayName: 🪐MILENA MARS🪐
                          uniqueId: "@milenamars"
                          channelId: UCjTWFYn4s7fzsonX3Jtw_Ig
                          avatarUrl: "https://yt3.googleusercontent.com/kFfAtp8wQM5wTqRzFn1wiZWdcJ5atGU1u-BnzpadbVFQJBThObAYNZTxsagdHnzW5m79G5A4pg=s900-c-k-c0x00ffffff-no-rj"
                          totalSubscribers: 2170000
                        - displayName: 🩷La Barbie Jimenez 🩷
                          uniqueId: "@labarbiejimenez"
                          channelId: UC2Z5u_Azat1RoqK-7-Sy4Tg
                          avatarUrl: "https://yt3.googleusercontent.com/h6_4n7pOk4AAn93qpxZl0abQZjYtg4PtzxXnsPO3l4wF7p3d8271Q_F_TqeUDsvuQKA6aIPaxYo=s900-c-k-c0x00ffffff-no-rj"
                          totalSubscribers: 1050000
                        - displayName: "🦋wishkhanna_🦋"
                          uniqueId: "@wishkhanna____"
                          channelId: UC32P0rFNpMhz97Oast8Mdgg
                          avatarUrl: "https://yt3.googleusercontent.com/rubd3-FNnl6pEpm5po_t6J67FE0IV_p452ujgAlxs1QITLGzi-nObStp06dbR3Qz96RJ5gm1=s900-c-k-c0x00ffffff-no-rj"
                          totalSubscribers: 1450000
                        - displayName: 🥜𝐀𝐧𝐲𝐚 𝐂𝐡𝐚𝐧🥜
                          uniqueId: "@yandere79"
                          channelId: UCVYsu-OqwXh9wF9eHERXcNg
                          avatarUrl: "https://yt3.googleusercontent.com/kOFqPM33m-b9YLSSjS499UciWpwZMJ0-MLmTjycnBUoGr3OCF2-yH8lMrT4VDgi4XznVX7TA9w=s900-c-k-c0x00ffffff-no-rj"
                          totalSubscribers: 2250000
                        - displayName: 🤍cloudy express 🤍
                          uniqueId: "@cloudyexpress-cb3pf"
                          channelId: UCo7-sHv2yP_tk2FFbfwmILQ
                          avatarUrl: "https://yt3.googleusercontent.com/c5pVxWtJhkU12B3D_MS_pfEV-9wpwyxsCHHrOLP67tEQgAf5uNwreDaPHxIqIqS81LIRbjX8w8A=s900-c-k-c0x00ffffff-no-rj"
                          totalSubscribers: 1030000
                        - displayName: 🙏Jay shri shyam🙏
                          uniqueId: "@bhaktisagar609"
                          channelId: UC2e-a4J25uO7Vqdz5s9D39w
                          avatarUrl: "https://yt3.googleusercontent.com/1onewDKzTDXArcN-SSOogr_-eGczRvnWi2jlcxMGaxSJq9e8DDMgFwfs7BpaXogQwfFt2Cm3=s900-c-k-c0x00ffffff-no-rj"
                          totalSubscribers: 1810000
                        - displayName: 🙏 Pray Together 🙏
                          uniqueId: "@frastefano"
                          channelId: UCEISS2bKsVnyvPSGvK-q_mg
                          avatarUrl: "https://yt3.googleusercontent.com/lqbSpiP1yWva-3v1pbFlZ--tVLaQJuCwGP1vvoAi75-w-VqJe0QDzUxqtfwUfE25Qem15nxy3w=s900-c-k-c0x00ffffff-no-rj"
                          totalSubscribers: 1270000
                        - displayName: 🖤BRK
                          uniqueId: "@mr.say3ed"
                          channelId: UCCQ7XwHCZetFk0zJWadP1Ww
                          avatarUrl: "https://yt3.googleusercontent.com/kr5zTRyltQF-7K7iCIiB9iMV1wOmvpRPYvUeIqa_KdxmzRwAe_FdEiS7heUG7bTJLibMP7HHUg=s900-c-k-c0x00ffffff-no-rj"
                          totalSubscribers: 1160000
                        - displayName: 🖤 everytime BTS 🖤
                          uniqueId: "@everytimebts2517"
                          channelId: UCEi2lZb1oSZ7tDP5vi4U9tg
                          avatarUrl: "https://yt3.googleusercontent.com/YGNUzzRXD7hvz6Swqgs-NR7sZGiuKodJr15sLdf4tYPMyVXvw3M2ZTN9RJ3psNn5sHmJ3dhxxw=s900-c-k-c0x00ffffff-no-rj"
                          totalSubscribers: 1110000
                    hasNextPage: true
                    nextOffset: 10
                    creditsUsed: 1
                    creditsAvailable: 975
                    planCreditsAvailable: 900
                    purchasedCreditsAvailable: 75
                    traceId: "f3430ba969f51fc42d633cb4fd00f86d"
                    timestamp: 1767923571340
                    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 filters:
                  summary: Missing filters field
                  value:
                    success: false
                    error: "VALIDATION_ERROR"
                    message: "At least 1 filter object is required."
                    timestamp: 1770099403116
                invalid filterName:
                  summary: Invalid filterName
                  value:
                    success: false
                    error: "VALIDATION_ERROR"
                    message: "Invalid 'filterName'. For accepted values, see: https://docs.creatordb.app/api-v3/configuring_advanced_search_filters#configuring-custom-youtube-filter-search-criteria."
                    timestamp: 1770099403116
                invalid pageSize:
                  summary: pageSize exceeds upper limit
                  value:
                    success: false
                    error: "VALIDATION_ERROR"
                    message: "Exceeded max pageSize of 100. Must be between 1 and 100."
                    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)"
  /youtube/content-search:
    post:
      summary: "Search Content"
      description: "Search YouTube videos, Shorts, and streams across every creator in the CreatorDB database, using content-level and creator-level filters. Returns individual content items, each with a short summary of its creator. Without `timeRange` or a `publishTime` filter, the search covers the last 30 days. <br /><br />Each call costs 1–97 credits, set by the time window, a `description` filter, a 100K+ `followers` floor, and the content type. A search with no matches is still charged. For filters, pricing, and examples, see [Using Content Search](/api-v3/content-search)."
      operationId: "searchYoutubeContent"
      tags:
        - "YouTube"
      requestBody:
        content:
          application/json:
            schema:
              type: "object"
              properties:
                filters:
                  type: "array"
                  items:
                    type: "object"
                    properties:
                      filterName:
                        type: "string"
                        description: "The field to apply the filter on."
                      op:
                        type: "string"
                        enum:
                          - "in"
                          - ">"
                          - "="
                          - "<"
                        description: "The comparison operator. Available values include `in`, `>`, `=`, `<`. String fields support: =, in. Number fields support: >, =, <. Boolean fields support: ="
                      value:
                        anyOf:
                          - type: "string"
                          - type: "number"
                          - type: "array"
                            items:
                              type: "string"
                            minItems: 1
                            maxItems: 100
                          - type: "boolean"
                        description: "Type depends on the `filterName`. - String fields accept `string` or `string[]`. - Number fields accept `number`. - Boolean fields accept `boolean`. - Operator `in` accepts `string[]`, operator `=` accepts string for `string` fields."
                      isFuzzySearch:
                        type: "boolean"
                        default: false
                        description: "When `true`, matches the value anywhere in the text. Only accepted on `title`, `description`, `hashtag`, `creatorDisplayName`, `creatorBio`. With `in`, matches content that contains any of the values (at most 10)."
                    required:
                      - "filterName"
                      - "op"
                      - "value"
                  minItems: 1
                  maxItems: 10
                  description: "Filter objects that include `filterName`, `op`, and `value`. For all accepted `filterName` values, see [Using Content Search](/api-v3/content-search#content-search-by-platform). Use `channelId` to search one creator's content."
                desc:
                  type: "boolean"
                  description: "Sort order for results. `true` for descending, `false` for ascending order. Default is `true`."
                sortBy:
                  type: "string"
                  enum:
                    - "views"
                    - "likes"
                    - "comments"
                    - "engagement"
                    - "publishTime"
                    - "lengthSec"
                    - "performanceViews"
                    - "performanceEngagement"
                    - "followers"
                  default: "publishTime"
                  description: "The field to sort results by. Default is `publishTime`."
                pageSize:
                  type: "integer"
                  minimum: 1
                  maximum: 100
                  description: "Number of results per page. Maximum: 100."
                offset:
                  type: "integer"
                  minimum: 0
                  description: "Number of records to skip before returning results."
                timeRange:
                  type: "object"
                  properties:
                    from:
                      type: "integer"
                      minimum: 1000000000000
                      maximum: 253402300799999
                      description: "Start of the range, Unix milliseconds, **inclusive**."
                      example: 1767225600000
                    to:
                      type: "integer"
                      minimum: 1000000000000
                      maximum: 253402300799999
                      description: "End of the range, Unix milliseconds, **exclusive**. Defaults to the time of the request."
                      example: 1775001600000
                  required:
                    - "from"
                  description: "The publish-date range to search, as absolute times. Only content published inside the range is returned. Without `timeRange` or any `publishTime` filter, the search covers the last 30 days."
              required:
                - "filters"
                - "pageSize"
                - "offset"
              description: "YouTube content search request parameters. Search for YouTube content (videos, shorts, streams) across all creators in the CreatorDB database using content-level and creator-level filters."
              example:
                filters:
                  - filterName: "isSponsored"
                    op: "="
                    value: true
                  - filterName: "views"
                    op: ">"
                    value: 1000000
                  - filterName: "publishTime"
                    op: "<"
                    value: 30
                  - filterName: "postType"
                    op: "="
                    value: "video"
                sortBy: "views"
                desc: true
                pageSize: 20
                offset: 0
      responses:
        "200":
          description: "Content search results."
          content:
            application/json:
              schema:
                type: "object"
                properties:
                  data:
                    type: "object"
                    properties:
                      contentList:
                        type: "array"
                        items:
                          type: "object"
                          properties:
                            contentId:
                              type: "string"
                              description: "The unique content ID. URL: `https://www.youtube.com/watch?v={contentId}`"
                              example: "FbCF_H4ZD64"
                            contentType:
                              type: "string"
                              enum:
                                - "video"
                                - "shorts"
                                - "stream"
                              description: "Content type: `video`, `shorts`, or `stream`."
                              example: "video"
                            title:
                              type: "string"
                              description: "The video title."
                              example: "I hosted an ADMIN ABUSE on GROW A GARDEN"
                            description:
                              type: "string"
                              description: "The video description."
                              example: "Thanks @JandelTheGuy play grow a garden here..."
                            thumbnail:
                              type: "string"
                              description: "Thumbnail URL of the video."
                              example: "https://i.ytimg.com/vi/FbCF_H4ZD64/hqdefault.jpg"
                            url:
                              type: "string"
                              description: "Direct URL of the content."
                              example: "https://www.youtube.com/watch?v=FbCF_H4ZD64"
                            publishTime:
                              type: "integer"
                              minimum: 0
                              description: "Publish time, represented as a Unix timestamp in milliseconds."
                              example: 1755273600000
                            lengthSec:
                              type: "integer"
                              minimum: 0
                              description: "Duration of the video in seconds."
                              example: 873
                            isSponsored:
                              type: "boolean"
                              description: "`true` if sponsored."
                              example: true
                            partneredBrands:
                              type: "array"
                              items:
                                type: "string"
                              description: "Brand IDs (returned as domains) associated with the sponsored content. Empty if the content is not sponsored."
                              example:
                                - "acer.com"
                            views:
                              type: "integer"
                              minimum: 0
                              description: "Number of views."
                              example: 5009695
                            likes:
                              type: "integer"
                              minimum: 0
                              description: "Number of likes."
                              example: 153000
                            comments:
                              type: "integer"
                              minimum: 0
                              description: "Number of comments."
                              example: 15182
                            engagementRate:
                              type: "number"
                              description: "Engagement rate, rounded to 4 decimal places. *Engagement rate = (likes + comments) / views.*"
                              example: 0.0336
                            hashtags:
                              type: "array"
                              items:
                                type: "string"
                              description: "Keywords in the video title or description."
                              example:
                                - "#VLOG"
                            language:
                              type: "string"
                              description: "Language used in the content, represented in **ISO 639-3** format. For language code list, see [here](https://docs.creatordb.app/api-v3/language-code)."
                              example: "eng"
                            category:
                              type: "string"
                              description: "Predefined YouTube content category."
                              example: "Gaming"
                            creator:
                              type: "object"
                              properties:
                                channelId:
                                  type: "string"
                                  description: "Channel ID."
                                  example: "UCm-X6o81nRsXQTmqpyArkBQ"
                                displayName:
                                  type: "string"
                                  description: "Channel display name."
                                  example: "Flamingo"
                                avatarUrl:
                                  type: "string"
                                  description: "Channel profile picture URL."
                                  example: "https://yt3.googleusercontent.com/7cF22TRiceqQr2Cro_X4uhRVnwCdOa2HXiwdBGPnUEqJDuCyr2CykDfDw2rCWjbjaHEdTMUC=s900-c-k-c0x00ffffff-no-rj"
                                totalSubscribers:
                                  type: "integer"
                                  minimum: 0
                                  description: "Total subscriber count."
                                  example: 13900000
                              required:
                                - "channelId"
                                - "displayName"
                                - "avatarUrl"
                                - "totalSubscribers"
                              description: "Creator information for the content."
                          required:
                            - "contentId"
                            - "contentType"
                            - "title"
                            - "description"
                            - "thumbnail"
                            - "url"
                            - "publishTime"
                            - "lengthSec"
                            - "isSponsored"
                            - "partneredBrands"
                            - "views"
                            - "likes"
                            - "comments"
                            - "engagementRate"
                            - "hashtags"
                            - "language"
                            - "category"
                            - "creator"
                          description: "A content item matching the search query"
                        description: "Content items matching the search filters."
                      totalResults:
                        type: "integer"
                        minimum: 0
                        description: "Approximate total number of content items matching the search filters. It can include a few items that no longer load."
                        example: 1250
                      hasNextPage:
                        type: "boolean"
                        description: "`true` if there is a next page of results."
                        example: true
                      nextOffset:
                        type: "integer"
                        minimum: 0
                        description: "The offset value for retrieving the next page of results."
                        example: 20
                      timeRange:
                        type: "object"
                        properties:
                          from:
                            type:
                              - "integer"
                              - "null"
                            description: "Start, Unix milliseconds, inclusive. `null` only when the caller asked for a window with no start."
                            example: 1790812800000
                          to:
                            type: "integer"
                            description: "End, Unix milliseconds, exclusive."
                            example: 1792713600000
                          isDefault:
                            type: "boolean"
                            description: "`true` when the request set neither `timeRange` nor a `publishTime` filter, so the 30-day default was searched."
                            example: false
                        required:
                          - "from"
                          - "to"
                          - "isDefault"
                        description: "The publish-date window that was searched, on every response: `timeRange` narrowed by any `publishTime` filter, the `publishTime` filters alone, or the 30-day default when the request set neither. `to` is filled in with the request time when open."
                    required:
                      - "contentList"
                      - "totalResults"
                      - "hasNextPage"
                      - "nextOffset"
                      - "timeRange"
                    description: "Content search results with pagination details."
                  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: "Number of API credits remaining. Equals planCreditsAvailable plus purchasedCreditsAvailable."
                    example: 975
                  creditsUsed:
                    type: "number"
                    description: "Number of API credits consumed by this request, from the content search price grid. For details, see [Using Content Search](/api-v3/content-search#credit-cost)."
                    example: 25
                  planCreditsAvailable:
                    type: "number"
                    description: "Remaining plan credits after this request, in credits."
                    example: 900
                  purchasedCreditsAvailable:
                    type: "number"
                    description: "Remaining purchased-bucket credits after this request, in display units."
                    example: 75
                  keyCreditsAvailable:
                    type: "number"
                    description: "Remaining credits this API key can spend after this request, before reaching its spend limit. Present only when the key has a spend limit."
                    example: 4975
                  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"
                  - "planCreditsAvailable"
                  - "purchasedCreditsAvailable"
                  - "errorCode"
                  - "errorDescription"
                  - "success"
                description: "YouTube content search response."
        "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:
                fuzzy on a non-text field:
                  summary: "isFuzzySearch on a filter that is not free text"
                  value:
                    success: false
                    error: "ValidationError"
                    message: "Request validation failed"
                    errorCode: "VALIDATION_ERROR"
                    timestamp: 1793603319958
                    details:
                      - field: "filters.0.isFuzzySearch"
                        message: "isFuzzySearch is not supported for field 'country'. Allowed fields: title, description, hashtag, creatorDisplayName, creatorBio"
                missing offset:
                  summary: "offset is required"
                  value:
                    success: false
                    error: "ValidationError"
                    message: "Request validation failed"
                    errorCode: "VALIDATION_ERROR"
                    timestamp: 1793603319958
                    details:
                      - field: "offset"
                        message: "Invalid input: expected number, received undefined"
                window does not overlap:
                  summary: "timeRange and publishTime do not overlap"
                  value:
                    success: false
                    error: "ValidationError"
                    message: "Request validation failed"
                    errorCode: "VALIDATION_ERROR"
                    timestamp: 1793603319958
                    details:
                      - field: "timeRange"
                        message: "timeRange does not overlap the publishTime filter"
        "429":
          description: "Exceeded quota or rate limit."
          content:
            application/json:
              schema:
                type: "object"
                title: "QuotaErrorResponse"
                description: "Quota error response format."
                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)"
  # YouTube creator profile
  /youtube/submitCreators:
    post:
      tags:
        - YouTube
      summary: Submit Creators
      description: "Submit new YouTube creators to the CreatorDB database for indexing. You can identify creators by channel ID, by handle, or both in one request. Accepted creators enter a processing queue and become available through the other YouTube endpoints after their first scrape. Submissions are free of charge. You can submit up to 10,000 identifiers per API key per UTC day. This limit is shared across the YouTube, Instagram, and TikTok submit endpoints. For details, see [API Credit Usage](/api-v3/api-credit-usage). Send bare identifiers, not profile URLs. Handles work with or without the `@` prefix. A URL doesn't cause the request to fail. Instead, the request succeeds and the response marks that entry with status `rejected`, so check the status of every entry."
      operationId: submitYoutubeCreators
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                channelIds:
                  type: array
                  description: "YouTube channel IDs to submit. Each ID is 24 characters and starts with `UC`. Can be combined with `uniqueIds` (handles). `channelIds` and `uniqueIds` together must contain 1 to 100 identifiers."
                  items:
                    type: string
                  maxItems: 100
                  examples:
                    - ["UCm-X6o81nRsXQTmqpyArkBQ", "UCX6OQ3DkcsbYNE6H8uQQuVA"]
                uniqueIds:
                  type: array
                  description: "YouTube channel handles to submit. Handles are case-insensitive, and the leading `@` is optional, so `@MrBeast` and `mrbeast` are the same handle. Leading and trailing whitespace is trimmed. Each handle is up to 30 characters and can contain letters, digits, periods (`.`), underscores (`_`), and hyphens (`-`). Can be combined with `channelIds`. `channelIds` and `uniqueIds` together must contain 1 to 100 identifiers."
                  items:
                    type: string
                  maxItems: 100
                  examples:
                    - ["@mrbeast", "youtube"]
      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"], "uniqueIds": ["@mrbeast"] }'
      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: "Results for each submitted identifier across `channelIds` and `uniqueIds`, one entry per identifier. All `channelIds` results come first, in the order sent, followed by all `uniqueIds` results, in the order sent. This holds regardless of the order of the two keys in the request body. Repeated identifiers aren't merged. Each occurrence gets its own entry. To match results to your input, use the position within each group, or match on `channelId` and `uniqueId` (see each field for how the value is echoed)."
                        items:
                          type: object
                          properties:
                            channelId:
                              type:
                                - string
                                - "null"
                              description: "The submitted channel ID, echoed as sent with surrounding whitespace trimmed. Case is preserved because channel IDs are case-sensitive. `null` if this entry came from `uniqueIds`."
                            uniqueId:
                              type:
                                - string
                                - "null"
                              description: "The submitted handle in normalized form. Handles are lowercased, and a leading `@` is added if it's missing. For example, `MrBeast` is echoed as `@mrbeast`. Normalize your input the same way before matching. `null` if this entry came from `channelIds`."
                            status:
                              type: string
                              description: "This entry's indexing status. Entries aren't charged, regardless of their status.<br/> - `accepted`: entered the processing queue.<br/> - `done`: already indexed in the database.<br/> - `rejected`: not a valid channel ID or handle, such as a profile URL.<br/> For details, see [API Credit Usage](/api-v3/api-credit-usage)."
                              enum:
                                - accepted
                                - done
                                - rejected
                            existingChannelId:
                              type:
                                - string
                                - "null"
                              description: "Returns the existing CreatorDB identifier when the indexing status is `done`. Otherwise, `null`."
                          required:
                            - channelId
                            - uniqueId
                            - status
                            - existingChannelId
                    required:
                      - results
                  creditsUsed:
                    type: number
                    description: Number of API credits consumed by this request.
                    example: 0
                  creditsAvailable:
                    type: number
                    description: Number of API credits remaining. Returns `-1` if the quota is unlimited. Equals planCreditsAvailable plus purchasedCreditsAvailable.
                    example: 975
                  planCreditsAvailable:
                    type: number
                    description: "Remaining plan credits after this request, in credits."
                    examples:
                      - 900
                  purchasedCreditsAvailable:
                    type: number
                    description: "Remaining purchased-bucket credits after this request, in display units."
                    examples:
                      - 75
                  keyCreditsAvailable:
                    type: number
                    description: "Remaining credits this API key can spend after this request, before reaching its spend limit. Present only when the key has a spend limit."
                    examples:
                      - 4975
                  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
                  - creditsAvailable
                  - creditsUsed
                  - planCreditsAvailable
                  - purchasedCreditsAvailable
                  - errorCode
                  - errorDescription
                  - success
#YouTube_Subtitles_Meta
  /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`). For per-field pricing, see [Field and Item Costs](/api-v3/field-and-item-costs#youtube/profile). For how fractional calls work, see [Fractional Calls](/api-v3/fractional-calls)."
      operationId: getYoutubeProfile
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                channelId:
                  type: string
                  description: "Unique channel ID. Provide exactly one of `channelId` or `uniqueId`."
                  pattern: "^UC[a-zA-Z0-9_-]{22}$"
                  minLength: 1
                  maxLength: 50
                  examples:
                    - "UCX6OQ3DkcsbYNE6H8uQQuVA"
                uniqueId:
                  type: string
                  description: "YouTube channel handle. Accepts `youtube` or `@youtube` format (the `@` prefix is optional). Provide exactly one of `channelId` or `uniqueId`."
                  minLength: 1
                  maxLength: 100
                  examples:
                    - "@youtube"
                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. For details, see [Field and Item Costs](/api-v3/field-and-item-costs#youtube/profile)."
                  items:
                    type: string
                    enum:
                      - channelId
                      - uniqueId
                      - displayName
                      - categoryBreakdown
                      - avatarUrl
                      - bio
                      - isVerified
                      - hasSponsors
                      - hasMemberOnlyContents
                      - isPodcast
                      - country
                      - mainLanguage
                      - languages
                      - secondLanguage
                      - totalContents
                      - totalSubscribers
                      - subscriberGrowth
                      - hashtags
                      - topics
                      - niches
                      - otherLinks
                      - lastPublishTime
                      - relatedCreators
                      - lastDbUpdateTime
                  examples:
                    - ["displayName", "country", "totalSubscribers"]
      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"] }'
      responses:
        "200":
          description: "YouTube creator profile information returned successfully."
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: "#/components/schemas/YoutubeProfileData"
                    required:
                      - channelId
                      - uniqueId
                      - displayName
                      - categoryBreakdown
                      - avatarUrl
                      - bio
                      - isVerified
                      - hasSponsors
                      - hasMemberOnlyContents
                      - isPodcast
                      - country
                      - mainLanguage
                      - languages
                      - secondLanguage
                      - totalContents
                      - totalSubscribers
                      - subscriberGrowth
                      - hashtags
                      - topics
                      - niches
                      - otherLinks
                      - lastPublishTime
                      - relatedCreators
                      - lastDbUpdateTime
                  creditsUsed:
                    type: number
                    description: "Number of API credits consumed by this request."
                    examples:
                      - 1
                  creditsAvailable:
                    type: number
                    description: "Number of API credits remaining. Equals planCreditsAvailable plus purchasedCreditsAvailable."
                    examples:
                      - -1
                  planCreditsAvailable:
                    type: number
                    description: "Remaining plan credits after this request, in credits."
                    examples:
                      - 900
                  purchasedCreditsAvailable:
                    type: number
                    description: "Remaining purchased-bucket credits after this request, in display units."
                    examples:
                      - 75
                  keyCreditsAvailable:
                    type: number
                    description: "Remaining credits this API key can spend after this request, before reaching its spend limit. Present only when the key has a spend limit."
                    examples:
                      - 4975
                  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
                  - planCreditsAvailable
                  - purchasedCreditsAvailable
              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
                      isPodcast: 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
                    creditsUsed: 1
                    creditsAvailable: 975
                    planCreditsAvailable: 900
                    purchasedCreditsAvailable: 75
                    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)"
  # YouTube creator contact
  /youtube/contact:
    post:
      tags:
        - YouTube
      summary: Get Contact
      description: "Retrieve the contact information of the specified YouTube creator.<br /><br />Optionally pass `fields` in the request body to return a creator's contact information. The single available field, `emails`, is billed at the full-bundle price. The contact endpoint currently exposes only this one billable field, so fractional calls do not offer any savings yet. Fractional calls must be enabled on your API key. Otherwise, a request that includes `fields` returns a `400` error (`FractionalCallsNotEnabled`). For per-field costs, see [Field and Item Costs](/api-v3/field-and-item-costs#youtube/contact). For how fractional calls work, see [Fractional Calls](/api-v3/fractional-calls)."
      operationId: getYoutubeContact
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                channelId:
                  type: string
                  description: "Unique channel ID. Provide exactly one of `channelId` or `uniqueId`."
                  pattern: "^UC[a-zA-Z0-9_-]{22}$"
                  minLength: 1
                  maxLength: 50
                  examples:
                    - UCBR8-60-B28hp2BmDPdntcQ
                uniqueId:
                  type: string
                  description: "YouTube channel handle. Accepts `youtube` or `@youtube` format (the `@` prefix is optional). Provide exactly one of `channelId` or `uniqueId`."
                  minLength: 1
                  maxLength: 100
                  examples:
                    - "@youtube"
                fields:
                  type: array
                  description: "Subset of contact fields to return. Omit or pass an empty array to return the full response at the full-bundle price. For details, see [Field and Item Costs](/api-v3/field-and-item-costs#youtube/contact)."
                  items:
                    type: string
                    enum:
                      - emails
      x-codeSamples:
        - lang: bash
          label: cURL
          source: |
            curl -X POST "https://apiv3.creatordb.app/youtube/contact" \
              -H "Content-Type: application/json" \
              -H "api-key: <YOUR_API_KEY_HERE>" \
              -d '{ "channelId": "UCX6OQ3DkcsbYNE6H8uQQuVA" }'
      responses:
        "200":
          description: "YouTube creator contact information returned successfully."
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: "#/components/schemas/YoutubeContactData"
                    required:
                      - emails
                  creditsUsed:
                    type: number
                    description: "Number of API credits consumed by this request."
                    examples:
                      - 1
                  creditsAvailable:
                    type: number
                    description: "Number of API credits remaining. Equals planCreditsAvailable plus purchasedCreditsAvailable."
                    examples:
                      - -1
                  planCreditsAvailable:
                    type: number
                    description: "Remaining plan credits after this request, in credits."
                    examples:
                      - 900
                  purchasedCreditsAvailable:
                    type: number
                    description: "Remaining purchased-bucket credits after this request, in display units."
                    examples:
                      - 75
                  keyCreditsAvailable:
                    type: number
                    description: "Remaining credits this API key can spend after this request, before reaching its spend limit. Present only when the key has a spend limit."
                    examples:
                      - 4975
                  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
                  - planCreditsAvailable
                  - purchasedCreditsAvailable
              examples:
                default:
                  value:
                    data:
                      emails:
                        - contact@mrbeastbusiness.com
                    creditsUsed: 1
                    creditsAvailable: 975
                    planCreditsAvailable: 900
                    purchasedCreditsAvailable: 75
                    traceId: 1565d8d07cc82917f4cc22bd240d1adc
                    timestamp: 1767934354696
                    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)"
  # YouTube creator performance
  /youtube/performance:
    post:
      tags:
        - YouTube
      summary: Get Performance Information
      description: "Retrieve advanced performance information of a specified YouTube creator, including upload activity, subscriber growth, engagement metrics, and video performance.<br /><br />Optionally pass `fields` in the request body to return only a subset of performance blocks. Requesting a subset bills fractionally, capped at the full-bundle price. Fractional calls must be enabled on your API key. Otherwise, a request that includes `fields` returns a `400` error (`FractionalCallsNotEnabled`). For per-field costs, see [Field and Item Costs](/api-v3/field-and-item-costs#youtube/performance). For how fractional costs work, see [Fractional Costs](/api-v3/fractional-calls)."
      operationId: getYoutubePerformance
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                channelId:
                  type: string
                  description: "Unique channel ID. Provide exactly one of `channelId` or `uniqueId`."
                  pattern: "^UC[a-zA-Z0-9_-]{22}$"
                  minLength: 1
                  maxLength: 50
                  examples:
                    - UCBR8-60-B28hp2BmDPdntcQ
                uniqueId:
                  type: string
                  description: "YouTube channel handle. Accepts `youtube` or `@youtube` format (the `@` prefix is optional). Provide exactly one of `channelId` or `uniqueId`."
                  minLength: 1
                  maxLength: 100
                  examples:
                    - "@youtube"
                fields:
                  type: array
                  description: "Subset of performance blocks to return. Omit or pass an empty array to return the full response at the full-bundle price. For per-field costs, see [Field and Item Costs](/api-v3/field-and-item-costs#youtube/performance)."
                  items:
                    type: string
                    enum:
                      - contentCountByDays
                      - ranking
                      - videosPerformanceRecent
                      - shortsPerformanceRecent
                      - videosPerformanceAll
                      - shortsPerformanceAll
                      - recentVideosGrowth
                      - recentShortsGrowth
                      - videoPrice
                      - shortsPrice
                  examples:
                    - ["contentCountByDays", "ranking"]
      x-codeSamples:
        - lang: bash
          label: cURL
          source: |
            curl -X POST "https://apiv3.creatordb.app/youtube/performance" \
              -H "Content-Type: application/json" \
              -H "api-key: <YOUR_API_KEY_HERE>" \
              -d '{ "channelId": "UCX6OQ3DkcsbYNE6H8uQQuVA", "fields": ["ranking"] }'
      responses:
        "200":
          description: "Performance data of the specified YouTube creator returned successfully."
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: "#/components/schemas/YoutubePerformanceData"
                    required:
                      - contentCountByDays
                      - ranking
                      - videosPerformanceRecent
                      - shortsPerformanceRecent
                      - videosPerformanceAll
                      - shortsPerformanceAll
                      - recentVideosGrowth
                      - recentShortsGrowth
                      - videoPrice
                      - shortsPrice
                  creditsUsed:
                    type: number
                    description: "Number of API credits consumed by this request."
                    examples:
                      - 1
                  creditsAvailable:
                    type: number
                    description: "Number of API credits remaining. Equals planCreditsAvailable plus purchasedCreditsAvailable."
                    examples:
                      - -1
                  planCreditsAvailable:
                    type: number
                    description: "Remaining plan credits after this request, in credits."
                    examples:
                      - 900
                  purchasedCreditsAvailable:
                    type: number
                    description: "Remaining purchased-bucket credits after this request, in display units."
                    examples:
                      - 75
                  keyCreditsAvailable:
                    type: number
                    description: "Remaining credits this API key can spend after this request, before reaching its spend limit. Present only when the key has a spend limit."
                    examples:
                      - 4975
                  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
                  - planCreditsAvailable
                  - purchasedCreditsAvailable
              examples:
                default:
                  value:
                    data:
                      contentCountByDays:
                        7d: 3
                        30d: 8
                        90d: 26
                      ranking:
                        totalSubscribers:
                          global: 1
                          country: 1
                          language: 1
                        avgEngagementRate:
                          global: 0.5279
                          country: 0.5036
                          language: 0.4221
                      videosPerformanceRecent:
                        likes:
                          all: 71621680
                          avg: 3581084
                          median: 2669037
                          min: 1300000
                          max: 22000000
                        comments:
                          all: 1174720
                          avg: 58736
                          median: 53951
                          min: 8770
                          max: 115035
                        views:
                          all: 3050115040
                          avg: 152505752
                          median: 131558084
                          min: 56885878
                          max: 603517253
                          percentile25: 104827304
                          percentile75: 149680016
                          iqr: 44852712
                        length:
                          avg: 1167
                        engagement:
                          avgEngagementRate: 0.0231
                          likesPerSubscriber: 0.0077
                          commentsPerSubscriber: 0.0001
                          viewsPerSubscriber: 0.3259
                          engagementConsistency:
                            cv: 0.4606
                            medianVsMean: 0.856
                            topBottomRatio: 2.6884
                            consistencyScore: 53
                            consistencyLevel: moderate
                      shortsPerformanceRecent:
                        likes:
                          all: 51069500
                          avg: 2553475
                          median: 2059098
                          min: 463000
                          max: 6200000
                        comments:
                          all: 635020
                          avg: 31751
                          median: 14155
                          min: 5115
                          max: 186830
                        views:
                          all: 3881469200
                          avg: 194073460
                          median: 80108228
                          min: 12298373
                          max: 968276492
                          percentile25: 50286890
                          percentile75: 201918051
                          iqr: 151631161
                        length:
                          avg: 29
                        engagement:
                          avgEngagementRate: 0.0207
                          likesPerSubscriber: 0.0055
                          commentsPerSubscriber: 0.0001
                          viewsPerSubscriber: 0.4147
                          engagementConsistency:
                            cv: 0.3732
                            medianVsMean: 1.0541
                            topBottomRatio: 3.6335
                            consistencyScore: 53
                            consistencyLevel: moderate
                      videosPerformanceAll:
                        likes:
                          all: 222423708
                          avg: 4835298
                          median: 3400000
                          min: 1300000
                          max: 28000000
                        comments:
                          all: 4020078
                          avg: 87393
                          median: 71759
                          min: 8770
                          max: 349397
                        views:
                          all: 8897761232
                          avg: 193429592
                          median: 165616724
                          min: 56885878
                          max: 603517253
                          percentile25: 130697086
                          percentile75: 220213535
                          iqr: 89516449
                        length:
                          avg: 1280
                        engagement:
                          avgEngagementRate: 0.0249
                          likesPerSubscriber: 0.0103
                          commentsPerSubscriber: 0.0002
                          viewsPerSubscriber: 0.4133
                          engagementConsistency:
                            cv: 0.5654
                            medianVsMean: 0.8656
                            topBottomRatio: 4.6788
                            consistencyScore: 47
                            consistencyLevel: low
                      shortsPerformanceAll:
                        likes:
                          all: 1650228640
                          avg: 10313929
                          median: 8150000
                          min: 461000
                          max: 57000000
                        comments:
                          all: 5172480
                          avg: 32328
                          median: 17060
                          min: 2772
                          max: 822627
                        views:
                          all: 60515376800
                          avg: 378221105
                          median: 338464804
                          min: 6532098
                          max: 1692388343
                          percentile25: 136813142
                          percentile75: 537217514
                          iqr: 400404372
                        length:
                          avg: 31
                        engagement:
                          avgEngagementRate: 0.0279
                          likesPerSubscriber: 0.022
                          commentsPerSubscriber: 0.0001
                          viewsPerSubscriber: 0.8082
                          engagementConsistency:
                            cv: 0.4515
                            medianVsMean: 0.9376
                            topBottomRatio: 14.6975
                            consistencyScore: 41
                            consistencyLevel: low
                      recentVideosGrowth:
                        g7:
                          avgViews: 0.0158
                          engagementRate: -0.0156
                        g30:
                          avgViews: -0.0063
                          engagementRate: -0.0189
                        g90:
                          avgViews: 0.0952
                          engagementRate: -0.1305
                      recentShortsGrowth:
                        g7:
                          avgViews: 0.0342
                          engagementRate: 0.0002
                        g30:
                          avgViews: 0.4128
                          engagementRate: -0.0281
                        g90:
                          avgViews: 0.2758
                          engagementRate: -0.2429
                    creditsUsed: 1
                    creditsAvailable: 975
                    planCreditsAvailable: 900
                    purchasedCreditsAvailable: 75
                    traceId: 3d69e43ce36749693badd422e38ccc28
                    timestamp: 1771887295991
                    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)"
  #YouTube creator performance history
  /youtube/performance-history:
    get:
      tags:
        - YouTube
      summary: Get Performance History
      description: "Retrieve daily performance snapshots for a specified YouTube creator, including upload activity, subscriber growth, engagement metrics, and video performance. Dates are returned as Unix timestamps in milliseconds."
      operationId: getYoutubePerformanceHistory
      parameters:
        - name: channelId
          in: query
          description: "Unique channel ID. Provide exactly one of `channelId` or `uniqueId`."
          required: false
          schema:
            type: string
            pattern: "^UC[a-zA-Z0-9_-]{22}$"
            minLength: 1
            maxLength: 50
            examples:
              - UCBR8-60-B28hp2BmDPdntcQ
        - name: uniqueId
          in: query
          description: "YouTube channel handle. Accepts `youtube` or `@youtube` format (the `@` prefix is optional). Provide exactly one of `channelId` or `uniqueId`."
          required: false
          schema:
            type: string
            minLength: 1
            maxLength: 100
            examples:
              - "@youtube"
        - name: pastDayRange
          in: query
          description: "Returns one data point per day over the requested range. For example, `30` returns the past 30 days of daily snapshots. Valid range: `1`-`400`."
          required: true
          schema:
            type: string
            pattern: '^[1-9]\d*$'
            examples:
              - "30"
      x-codeSamples:
        - lang: bash
          label: cURL
          source: |
            curl -X GET "https://apiv3.creatordb.app/youtube/performance-history?channelId=UCX6OQ3DkcsbYNE6H8uQQuVA&pastDayRange=7" \
              -H "Content-Type: application/json" \
              -H "api-key: <YOUR_API_KEY_HERE>"
      responses:
        "200":
          description: "YouTube creator performance historical data returned successfully."
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: "#/components/schemas/YoutubePerformanceHistoryData"
                  creditsUsed:
                    type: number
                    description: "Number of API credits consumed by this request."
                    examples:
                      - 1
                  creditsAvailable:
                    type: number
                    description: "Number of API credits remaining. Equals planCreditsAvailable plus purchasedCreditsAvailable."
                    examples:
                      - -1
                  planCreditsAvailable:
                    type: number
                    description: "Remaining plan credits after this request, in credits."
                    examples:
                      - 900
                  purchasedCreditsAvailable:
                    type: number
                    description: "Remaining purchased-bucket credits after this request, in display units."
                    examples:
                      - 75
                  keyCreditsAvailable:
                    type: number
                    description: "Remaining credits this API key can spend after this request, before reaching its spend limit. Present only when the key has a spend limit."
                    examples:
                      - 4975
                  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
                  - planCreditsAvailable
                  - purchasedCreditsAvailable
              examples:
                default:
                  value:
                    data:
                      histories:
                        - timestamp: 1767837367237
                          totalSubscribers: 459000000
                          totalContents: 940
                          videosPerformanceAll:
                            likes:
                              all: 710746666
                              avg: 7252517
                              median: 3550000
                              min: 0
                              max: 0
                            comments:
                              all: 4968208
                              avg: 50696
                              median: 0
                              min: 0
                              max: 0
                            views:
                              all: 26294349424
                              avg: 268309688
                              median: 192170860
                              min: 26793336
                              max: 1601867355
                            engagement:
                              avgEngagementRate: 0.0267
                              likesPerSubscriber: 0.0158
                              commentsPerSubscriber: 0.0001
                              viewsPerSubscriber: 0.5846
                              engagementConsistency:
                                cv: 0.4962
                                medianVsMean: 0.8586
                                topBottomRatio: 0
                                consistencyScore:
                                consistencyLevel:
                          shortsPerformanceAll:
                            likes:
                              all: 1100753505
                              avg: 11586879
                              median: 10021835
                              min: 0
                              max: 0
                            comments:
                              all: 3370220
                              avg: 35476
                              median: 0
                              min: 0
                              max: 0
                            views:
                              all: 36964836775
                              avg: 389103545
                              median: 361915758
                              min: 0
                              max: 0
                            engagement:
                              avgEngagementRate: 0.0304
                              likesPerSubscriber: 0.0252
                              commentsPerSubscriber: 0.0001
                              viewsPerSubscriber: 0.8477
                              engagementConsistency:
                                cv: 0.4424
                                medianVsMean: 0.9726
                                topBottomRatio: 0
                                consistencyScore:
                                consistencyLevel:
                        - timestamp: 1767750967237
                          totalSubscribers: 459000000
                          totalContents: 939
                          videosPerformanceAll:
                            likes:
                              all: 711273549
                              avg: 7332717
                              median: 3600000
                              min: 0
                              max: 0
                            comments:
                              all: 4988419
                              avg: 51427
                              median: 0
                              min: 0
                              max: 0
                            views:
                              all: 26338437548
                              avg: 271530284
                              median: 192581549
                              min: 29219413
                              max: 1601867355
                            engagement:
                              avgEngagementRate: 0.0266
                              likesPerSubscriber: 0.016
                              commentsPerSubscriber: 0.0001
                              viewsPerSubscriber: 0.5916
                              engagementConsistency:
                                cv: 0.4985
                                medianVsMean: 0.8618
                                topBottomRatio: 0
                                consistencyScore:
                                consistencyLevel:
                          shortsPerformanceAll:
                            likes:
                              all: 1100070624
                              avg: 11459069
                              median: 10010917
                              min: 0
                              max: 0
                            comments:
                              all: 3346944
                              avg: 34864
                              median: 0
                              min: 0
                              max: 0
                            views:
                              all: 36904779936
                              avg: 384424791
                              median: 358022029
                              min: 0
                              max: 0
                            engagement:
                              avgEngagementRate: 0.0304
                              likesPerSubscriber: 0.025
                              commentsPerSubscriber: 0.0001
                              viewsPerSubscriber: 0.8375
                              engagementConsistency:
                                cv: 0.4403
                                medianVsMean: 0.952
                                topBottomRatio: 0
                                consistencyScore:
                                consistencyLevel:
                        - timestamp: 1767664567237
                          totalSubscribers: 458000000
                          totalContents: 938
                          videosPerformanceAll:
                            likes:
                              all: 708832544
                              avg: 7307552
                              median: 3600000
                              min: 0
                              max: 0
                            comments:
                              all: 4980659
                              avg: 51347
                              median: 0
                              min: 0
                              max: 0
                            views:
                              all: 26164009529
                              avg: 269732057
                              median: 192581549
                              min: 6390619
                              max: 1601867355
                            engagement:
                              avgEngagementRate: 0.0272
                              likesPerSubscriber: 0.016
                              commentsPerSubscriber: 0.0001
                              viewsPerSubscriber: 0.5889
                              engagementConsistency:
                                cv: 0.5163
                                medianVsMean: 0.8455
                                topBottomRatio: 0
                                consistencyScore:
                                consistencyLevel:
                          shortsPerformanceAll:
                            likes:
                              all: 1101100992
                              avg: 11469802
                              median: 10010917
                              min: 0
                              max: 0
                            comments:
                              all: 3346368
                              avg: 34858
                              median: 0
                              min: 0
                              max: 0
                            views:
                              all: 36961343808
                              avg: 385013998
                              median: 358022029
                              min: 0
                              max: 0
                            engagement:
                              avgEngagementRate: 0.0299
                              likesPerSubscriber: 0.025
                              commentsPerSubscriber: 0.0001
                              viewsPerSubscriber: 0.8406
                              engagementConsistency:
                                cv: 0.4251
                                medianVsMean: 0.958
                                topBottomRatio: 0
                                consistencyScore:
                                consistencyLevel:
                        - timestamp: 1767578167237
                          totalSubscribers: 458000000
                          totalContents: 938
                          videosPerformanceAll:
                            likes:
                              all: 715032590
                              avg: 7371470
                              median: 3600000
                              min: 0
                              max: 0
                            comments:
                              all: 4990941
                              avg: 51453
                              median: 0
                              min: 0
                              max: 0
                            views:
                              all: 26369612960
                              avg: 271851680
                              median: 197386359
                              min: 6390619
                              max: 1601867355
                            engagement:
                              avgEngagementRate: 0.0273
                              likesPerSubscriber: 0.0161
                              commentsPerSubscriber: 0.0001
                              viewsPerSubscriber: 0.5936
                              engagementConsistency:
                                cv: 0.5135
                                medianVsMean: 0.8443
                                topBottomRatio: 0
                                consistencyScore:
                                consistencyLevel:
                          shortsPerformanceAll:
                            likes:
                              all: 1094445024
                              avg: 11400469
                              median: 10010917
                              min: 0
                              max: 0
                            comments:
                              all: 3334368
                              avg: 34733
                              median: 0
                              min: 0
                              max: 0
                            views:
                              all: 36704292384
                              avg: 382336379
                              median: 351685332
                              min: 0
                              max: 0
                            engagement:
                              avgEngagementRate: 0.0298
                              likesPerSubscriber: 0.0249
                              commentsPerSubscriber: 0.0001
                              viewsPerSubscriber: 0.8348
                              engagementConsistency:
                                cv: 0.4274
                                medianVsMean: 0.9599
                                topBottomRatio: 0
                                consistencyScore:
                                consistencyLevel:
                        - timestamp: 1767491767237
                          totalSubscribers: 458000000
                          totalContents: 938
                          videosPerformanceAll:
                            likes:
                              all: 715032590
                              avg: 7371470
                              median: 3600000
                              min: 0
                              max: 0
                            comments:
                              all: 4990844
                              avg: 51452
                              median: 0
                              min: 0
                              max: 0
                            views:
                              all: 26368952681
                              avg: 271844873
                              median: 197386359
                              min: 6390619
                              max: 1601867355
                            engagement:
                              avgEngagementRate: 0.0273
                              likesPerSubscriber: 0.0161
                              commentsPerSubscriber: 0.0001
                              viewsPerSubscriber: 0.5935
                              engagementConsistency:
                                cv: 0.5136
                                medianVsMean: 0.8441
                                topBottomRatio: 0
                                consistencyScore:
                                consistencyLevel:
                          shortsPerformanceAll:
                            likes:
                              all: 1094312928
                              avg: 11399093
                              median: 10010917
                              min: 0
                              max: 0
                            comments:
                              all: 3334080
                              avg: 34730
                              median: 0
                              min: 0
                              max: 0
                            views:
                              all: 36701212704
                              avg: 382304299
                              median: 351685332
                              min: 0
                              max: 0
                            engagement:
                              avgEngagementRate: 0.0298
                              likesPerSubscriber: 0.0249
                              commentsPerSubscriber: 0.0001
                              viewsPerSubscriber: 0.8347
                              engagementConsistency:
                                cv: 0.4276
                                medianVsMean: 0.9601
                                topBottomRatio: 0
                                consistencyScore:
                                consistencyLevel:
                        - timestamp: 1767405367237
                          totalSubscribers: 458000000
                          totalContents: 938
                          videosPerformanceAll:
                            likes:
                              all: 715032590
                              avg: 7371470
                              median: 3600000
                              min: 0
                              max: 0
                            comments:
                              all: 4990456
                              avg: 51448
                              median: 0
                              min: 0
                              max: 0
                            views:
                              all: 26350045926
                              avg: 271649958
                              median: 197386359
                              min: 6390619
                              max: 1601867355
                            engagement:
                              avgEngagementRate: 0.0273
                              likesPerSubscriber: 0.0161
                              commentsPerSubscriber: 0.0001
                              viewsPerSubscriber: 0.5931
                              engagementConsistency:
                                cv: 0.5133
                                medianVsMean: 0.8438
                                topBottomRatio: 0
                                consistencyScore:
                                consistencyLevel:
                          shortsPerformanceAll:
                            likes:
                              all: 1094312928
                              avg: 11399093
                              median: 10010917
                              min: 0
                              max: 0
                            comments:
                              all: 3333984
                              avg: 34729
                              median: 0
                              min: 0
                              max: 0
                            views:
                              all: 36699433152
                              avg: 382285762
                              median: 351685332
                              min: 0
                              max: 0
                            engagement:
                              avgEngagementRate: 0.0298
                              likesPerSubscriber: 0.0249
                              commentsPerSubscriber: 0.0001
                              viewsPerSubscriber: 0.8347
                              engagementConsistency:
                                cv: 0.4275
                                medianVsMean: 0.96
                                topBottomRatio: 0
                                consistencyScore:
                                consistencyLevel:
                    creditsUsed: 1
                    creditsAvailable: 975
                    planCreditsAvailable: 900
                    purchasedCreditsAvailable: 75
                    traceId: 1b18529129b283dea751c6aac22445d5
                    timestamp: 1767923767306
                    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 pastDayRange:
                  summary: pastDayRange out of bounds
                  value:
                    success: false
                    error: "VALIDATION_ERROR"
                    message: "Request validation failed"
                    details:
                      - field: "pastDayRange"
                        message: "pastDayRange must be between 1 and 400 days"
                    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)"
  #YouTube audience demographics
  /youtube/audience:
    post:
      tags:
        - YouTube
      summary: Get Audience Demographics
      description: "Retrieve audience demographic insights for a specified YouTube creator, including country distribution, gender breakdown, and age composition. This endpoint provides detailed audience analytics to help understand creator reach, evaluate audience alignment, and support data‑driven influencer selection and campaign targeting.<br /><br />Optionally pass `fields` in the request body to return only a subset of demographic fields. You are billed for the fields you request, capped at the full-bundle price. Fractional calls must be enabled on your API key. Otherwise, a request that includes `fields` returns a `400` error (`FractionalCallsNotEnabled`). For per-field costs, see [Field and Item Costs](/api-v3/field-and-item-costs#youtube/audience). For how fractional calls work, see [Fractional Calls](/api-v3/fractional-calls)."
      operationId: getYoutubeAudience
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                channelId:
                  type: string
                  description: "Unique channel ID. Provide exactly one of `channelId` or `uniqueId`."
                  pattern: "^UC[a-zA-Z0-9_-]{22}$"
                  minLength: 1
                  maxLength: 50
                  examples:
                    - UCBR8-60-B28hp2BmDPdntcQ
                uniqueId:
                  type: string
                  description: "YouTube channel handle. Accepts `youtube` or `@youtube` format (the `@` prefix is optional). Provide exactly one of `channelId` or `uniqueId`."
                  minLength: 1
                  maxLength: 100
                  examples:
                    - "@youtube"
                fields:
                  type: array
                  description: "Subset of demographic fields to return. Omit or pass an empty array to return the full response at the full-bundle price. For per-field costs, see [Field and Item Costs](/api-v3/field-and-item-costs#youtube/audience)."
                  items:
                    type: string
                    enum:
                      - audienceLocations
                      - audienceGender
                      - audienceAvgAge
                      - audienceAgeBreakdown
      x-codeSamples:
        - lang: bash
          label: cURL
          source: |
            curl -X POST "https://apiv3.creatordb.app/youtube/audience" \
              -H "Content-Type: application/json" \
              -H "api-key: <YOUR_API_KEY_HERE>" \
              -d '{ "channelId": "UCX6OQ3DkcsbYNE6H8uQQuVA" }'
      responses:
        "200":
          description: "YouTube audience demographic data returned successfully."
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: "#/components/schemas/YoutubeAudienceData"
                    required:
                      - audienceLocations
                      - audienceGender
                      - audienceAvgAge
                      - audienceAgeBreakdown
                  creditsUsed:
                    type: number
                    description: "Number of API credits consumed by this request."
                    examples:
                      - 1
                  creditsAvailable:
                    type: number
                    description: "Number of API credits remaining. Equals planCreditsAvailable plus purchasedCreditsAvailable."
                    examples:
                      - -1
                  planCreditsAvailable:
                    type: number
                    description: "Remaining plan credits after this request, in credits."
                    examples:
                      - 900
                  purchasedCreditsAvailable:
                    type: number
                    description: "Remaining purchased-bucket credits after this request, in display units."
                    examples:
                      - 75
                  keyCreditsAvailable:
                    type: number
                    description: "Remaining credits this API key can spend after this request, before reaching its spend limit. Present only when the key has a spend limit."
                    examples:
                      - 4975
                  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
                  - planCreditsAvailable
                  - purchasedCreditsAvailable
              examples:
                default:
                  value:
                    data:
                      audienceLocations:
                        - country: USA
                          share: 0.7795
                        - country: GBR
                          share: 0.0716
                        - country: CAN
                          share: 0.0433
                      audienceGender:
                        maleRatio: 0.5833
                        femaleRatio: 0.4167
                      audienceAvgAge: 35
                      audienceAgeBreakdown:
                        - ageRange: 13-17
                          share: 0.0328
                        - ageRange: 18-24
                          share: 0.2022
                        - ageRange: 25-34
                          share: 0.2988
                        - ageRange: 35-44
                          share: 0.2585
                        - ageRange: 45-54
                          share: 0.1274
                        - ageRange: 55-64
                          share: 0.0532
                        - ageRange: 65+
                          share: 0.0271
                    creditsUsed: 1
                    creditsAvailable: 975
                    planCreditsAvailable: 900
                    purchasedCreditsAvailable: 75
                    traceId: fd5e5b27302d80f119671196c628e094
                    timestamp: 1767924063347
                    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
                description: "Quota error response format."
                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)"
  #YouTube content details
  /youtube/content-detail:
    post:
      tags:
        - YouTube
      summary: Get Content Details
      description: "Retrieve the most recent YouTube videos and shorts of a specified creator, including publish time, video or short description, and engagement metrics.<br /><br />Optionally pass `fields` in the request body to limit how many items each content-detail array returns. Each item returned is billed individually, capped at the full-bundle price. Fractional calls must be enabled on your API key. Otherwise, a request that includes `fields` returns a `400` error (`FractionalCallsNotEnabled`). For per-item costs, see [Field and Item Costs](/api-v3/field-and-item-costs#youtube/content-detail). For how fractional calls work, see [Fractional Calls](/api-v3/fractional-calls)."
      operationId: getYoutubeContentDetail
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                channelId:
                  type: string
                  description: "Unique channel ID. Provide exactly one of `channelId` or `uniqueId`."
                  pattern: "^UC[a-zA-Z0-9_-]{22}$"
                  minLength: 1
                  maxLength: 50
                  examples:
                    - UCBR8-60-B28hp2BmDPdntcQ
                uniqueId:
                  type: string
                  description: "YouTube channel handle. Accepts `youtube` or `@youtube` format (the `@` prefix is optional). Provide exactly one of `channelId` or `uniqueId`."
                  minLength: 1
                  maxLength: 100
                  examples:
                    - "@youtube"
                fields:
                  type: object
                  description: "Map each content array to the number of items to return. Omit or pass an empty object to return all items at the full-bundle price. For per-item costs, see [Field and Item Costs](/api-v3/field-and-item-costs#youtube/content-detail)."
                  properties:
                    recentVideos:
                      anyOf:
                        - type: integer
                          minimum: 0
                        - type: "null"
                      description: "Number of recent videos to return. Pass `null` to skip this field and be charged 0 for it."
                      examples:
                        - 5
                    recentShorts:
                      anyOf:
                        - type: integer
                          minimum: 0
                        - type: "null"
                      description: "Number of recent shorts to return. Pass `null` to skip this field and be charged 0 for it."
                      examples:
                        - 5
                  additionalProperties: false
      x-codeSamples:
        - lang: bash
          label: cURL
          source: |
            curl -X POST "https://apiv3.creatordb.app/youtube/content-detail" \
              -H "Content-Type: application/json" \
              -H "api-key: <YOUR_API_KEY_HERE>" \
              -d '{ "channelId": "UCX6OQ3DkcsbYNE6H8uQQuVA", "fields": { "recentVideos": 5 } }'
      responses:
        "200":
          description: "YouTube content details returned successfully."
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: "#/components/schemas/YoutubeContentDetailData"
                    required:
                      - recentVideos
                      - recentShorts
                  creditsUsed:
                    type: number
                    description: "Number of API credits consumed by this request."
                    examples:
                      - 1
                  creditsAvailable:
                    type: number
                    description: "Number of API credits remaining. Equals planCreditsAvailable plus purchasedCreditsAvailable."
                    examples:
                      - -1
                  planCreditsAvailable:
                    type: number
                    description: "Remaining plan credits after this request, in credits."
                    examples:
                      - 900
                  purchasedCreditsAvailable:
                    type: number
                    description: "Remaining purchased-bucket credits after this request, in display units."
                    examples:
                      - 75
                  keyCreditsAvailable:
                    type: number
                    description: "Remaining credits this API key can spend after this request, before reaching its spend limit. Present only when the key has a spend limit."
                    examples:
                      - 4975
                  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
                  - planCreditsAvailable
                  - purchasedCreditsAvailable
              examples:
                default:
                  value:
                    data:
                      recentVideos:
                        - publishTime: 1767816009000
                          contentId: QJI0an6irrA
                          title: 30 Celebrities Fight For $1,000,000!
                          description: ""
                          length: 2518
                          isSponsored: false
                          isMemberOnly: false
                          likes: 955450
                          comments: 49482
                          views: 26424459
                          engagementRate: 0.03803037178547345
                          hashtags: []
                        - publishTime: 1767793392562
                          contentId: mktYW177p6U
                          title: Guess the Animal
                          description: ""
                          length: 0
                          isSponsored: false
                          isMemberOnly: false
                          likes: 1800000
                          comments: 9252
                          views: 99117362
                          engagementRate: 0.01825363350570206
                          hashtags: []
                        - publishTime: 1766840991701
                          contentId: 7aE4EhHXzlA
                          title: I Paid Everyone Stuck in Traffic
                          description: ""
                          length: 27
                          isSponsored: false
                          isMemberOnly: false
                          likes: 1700000
                          comments: 28341
                          views: 54959130
                          engagementRate: 0.031447750355582414
                          hashtags: []
                        - publishTime: 1766393469410
                          contentId: IJkB-oapuks
                          title: Giving Away $1,000,000 in Gifts To My Subscribers
                          description: ""
                          length: 19
                          isSponsored: false
                          isMemberOnly: false
                          likes: 3100000
                          comments: 162485
                          views: 239192519
                          engagementRate: 0.01363957791673242
                          hashtags: []
                        - publishTime: 1766307069104
                          contentId: ZFoNBxpXen4
                          title: Survive 30 Days Trapped In The Sky, Win $250,000
                          description: ""
                          length: 2246
                          isSponsored: false
                          isMemberOnly: false
                          likes: 2000000
                          comments: 79625
                          views: 102587634
                          engagementRate: 0.02027169278511677
                          hashtags: []
                        - publishTime: 1766220668425
                          contentId: RB71Z-vVvCc
                          title: Find The Real Celebrity, Win $10,000
                          description: ""
                          length: 33
                          isSponsored: false
                          isMemberOnly: false
                          likes: 2500000
                          comments: 10043
                          views: 109409690
                          engagementRate: 0.022941688254486416
                          hashtags: []
                        - publishTime: 1765961468685
                          contentId: fO5FwBcCJBY
                          title: Would You Date Him for $10,000?
                          description: ""
                          length: 33
                          isSponsored: false
                          isMemberOnly: false
                          likes: 2500000
                          comments: 17257
                          views: 90966291
                          engagementRate: 0.02767241548850222
                          hashtags: []
                        - publishTime: 1765614282036
                          contentId: U-x6KxH1kB4
                          title: How Many People to Pull a Plane?
                          description: ""
                          length: 27
                          isSponsored: false
                          isMemberOnly: false
                          likes: 656000
                          comments: 10727
                          views: 29312779
                          engagementRate: 0.02274526751625972
                          hashtags: []
                        - publishTime: 1765356668965
                          contentId: 8bMh8azh3CY
                          title: 100 Pilots Fight For A Private Jet
                          description: ""
                          length: 1726
                          isSponsored: false
                          isMemberOnly: false
                          likes: 1600000
                          comments: 67912
                          views: 113619821
                          engagementRate: 0.014679762609377813
                          hashtags: []
                        - publishTime: 1765298530722
                          contentId: SE9xF1l3ZwE
                          title: Hit The Target, Keep The Prize
                          description: ""
                          length: 0
                          isSponsored: false
                          isMemberOnly: false
                          likes: 855000
                          comments: 7642
                          views: 37441474
                          engagementRate: 0.02303974464253197
                          hashtags: []
                        - publishTime: 1765287793167
                          contentId: tAwzBYE18Us
                          title: How I Became MrBeef
                          description: ""
                          length: 46
                          isSponsored: false
                          isMemberOnly: false
                          likes: 1000000
                          comments: 14316
                          views: 26793336
                          engagementRate: 0.03785702534391387
                          hashtags: []
                        - publishTime: 1765114608606
                          contentId: LyFMbY-c_Lc
                          title: I Raced Noah Lyles
                          description: ""
                          length: 32
                          isSponsored: false
                          isMemberOnly: false
                          likes: 3100000
                          comments: 9310
                          views: 231836574
                          engagementRate: 0.013411645739726986
                          hashtags: []
                        - publishTime: 1765114608508
                          contentId: WROMyJAJmp4
                          title: Can I Beat An F1 Driver?
                          description: ""
                          length: 11
                          isSponsored: false
                          isMemberOnly: false
                          likes: 2100000
                          comments: 11034
                          views: 236595618
                          engagementRate: 0.008922540568777566
                          hashtags: []
                        - publishTime: 1764853792555
                          contentId: rF00lQ_upzg
                          title: Whatever You Hold Onto, You Keep
                          description: ""
                          length: 26
                          isSponsored: false
                          isMemberOnly: false
                          likes: 710000
                          comments: 9654
                          views: 52366887
                          engagementRate: 0.01374253925004173
                          hashtags: []
                        - publishTime: 1764579068743
                          contentId: 3RmOvxilbPM
                          title: 100 People Vs World’s Biggest Trap!
                          description: ""
                          length: 1843
                          isSponsored: true
                          isMemberOnly: false
                          likes: 1800000
                          comments: 81548
                          views: 93596233
                          engagementRate: 0.02010281759950745
                          hashtags: []
                        - publishTime: 1764579068623
                          contentId: uZY9xr-QAk0
                          title: Flip a Coin, I’ll Pay For Your College
                          description: ""
                          length: 34
                          isSponsored: false
                          isMemberOnly: false
                          likes: 3400000
                          comments: 17333
                          views: 217610072
                          engagementRate: 0.015703928446841375
                          hashtags: []
                        - publishTime: 1763830801000
                          contentId: Ah_uuTwGOYU
                          title: World's Fastest Man Vs Robot!
                          description: ""
                          length: 1104
                          isSponsored: false
                          isMemberOnly: false
                          likes: 1751534
                          comments: 62432
                          views: 87593702
                          engagementRate: 0.020708863292477352
                          hashtags: []
                        - publishTime: 1762695792744
                          contentId: yWEUL3crU_E
                          title: I Baked a Cake In a Race Car
                          description: ""
                          length: 38
                          isSponsored: false
                          isMemberOnly: false
                          likes: 742000
                          comments: 7399
                          views: 39417432
                          engagementRate: 0.019011867642722134
                          hashtags: []
                      recentShorts:
                        - publishTime: 1764090000000
                          contentId: AWBsoArakNY
                          title: Who Has The Fastest Reaction Time?
                          description: ""
                          length: 31
                          likes: 1390397
                          comments: 7470
                          views: 60879007
                          engagementRate: 0.022961396200171267
                          hashtags: []
                        - publishTime: 1763754001000
                          contentId: HISfrcjiNPM
                          title: I Surprised 50 Make-A-Wish Kids With Disneyland
                          description: ""
                          length: 29
                          likes: 785027
                          comments: 11022
                          views: 30168415
                          engagementRate: 0.026386835370701443
                          hashtags: []
                    creditsUsed: 1
                    creditsAvailable: 975
                    planCreditsAvailable: 900
                    purchasedCreditsAvailable: 75
                    traceId: f6a08c6e27e6413b8d224eb809c1c3d0
                    timestamp: 1767923892280
                    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)"
  # YouTube sponsorship info
  /youtube/sponsorship:
    post:
      tags:
        - YouTube
      summary: Get Sponsorship Information
      operationId: getYoutubeSponsorship
      description: "Retrieve recent YouTube videos identified as sponsored content for a specific creator, with metadata and engagement insights for influencer marketing analysis.<br /><br />Optionally pass `fields` in the request body to limit how many sponsoring brands are returned. You are billed per brand returned, capped at the full-bundle price. Fractional calls must be enabled on your API key. Otherwise, a request that includes `fields` returns a `400` error (`FractionalCallsNotEnabled`). For per-brand costs, see [Field and Item Costs](/api-v3/field-and-item-costs#youtube/sponsorship). For how fractional calls work, see [Fractional Calls](/api-v3/fractional-calls)."
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                channelId:
                  type: string
                  description: "Unique channel ID. Provide exactly one of `channelId` or `uniqueId`."
                  pattern: "^UC[a-zA-Z0-9_-]{22}$"
                  minLength: 1
                  maxLength: 50
                  examples:
                    - UCBR8-60-B28hp2BmDPdntcQ
                uniqueId:
                  type: string
                  description: "YouTube channel handle. Accepts `youtube` or `@youtube` format (the `@` prefix is optional). Provide exactly one of `channelId` or `uniqueId`."
                  minLength: 1
                  maxLength: 100
                  examples:
                    - "@youtube"
                fields:
                  type: object
                  description: "Map `sponsorList` to the number of sponsoring brands to return. Omit or pass an empty object to return all brands at the full-bundle price. For per-brand costs, see [Field and Item Costs](/api-v3/field-and-item-costs#youtube/sponsorship)."
                  properties:
                    sponsorList:
                      anyOf:
                        - type: integer
                          minimum: 0
                        - type: "null"
                      description: "Number of sponsoring brands to return. Pass `null` to skip this field and be charged 0 for it."
                      examples:
                        - 5
                  additionalProperties: false
      x-codeSamples:
        - lang: bash
          label: cURL
          source: |
            curl -X POST "https://apiv3.creatordb.app/youtube/sponsorship" \
              -H "Content-Type: application/json" \
              -H "api-key: <YOUR_API_KEY_HERE>" \
              -d '{ "channelId": "UCX6OQ3DkcsbYNE6H8uQQuVA", "fields": { "sponsorList": 5 } }'
      responses:
        "200":
          description: "YouTube sponsorship data returned successfully."
          content:
            application/json:
              schema:
                type: object
                description: "YouTube sponsorship API response with sponsor-grouped videos and performance metrics."
                properties:
                  data:
                    $ref: "#/components/schemas/YoutubeSponsorshipData"
                    required:
                      - sponsorList
                  creditsUsed:
                    type: number
                    description: "Number of API credits consumed by this request."
                    examples:
                      - 1
                  creditsAvailable:
                    type: number
                    description: "Number of API credits remaining. Equals planCreditsAvailable plus purchasedCreditsAvailable."
                    examples:
                      - -1
                  planCreditsAvailable:
                    type: number
                    description: "Remaining plan credits after this request, in credits."
                    examples:
                      - 900
                  purchasedCreditsAvailable:
                    type: number
                    description: "Remaining purchased-bucket credits after this request, in display units."
                    examples:
                      - 75
                  keyCreditsAvailable:
                    type: number
                    description: "Remaining credits this API key can spend after this request, before reaching its spend limit. Present only when the key has a spend limit."
                    examples:
                      - 4975
                  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
                  - planCreditsAvailable
                  - purchasedCreditsAvailable
              examples:
                default:
                  value:
                    data:
                      sponsorList:
                        - brandName: Current
                          brandId: current.com
                          brandIgIds:
                            - current
                          sponsoredVideos:
                            - publishTime: 1757779201000
                              contentId: 4l97aNza_Zc
                              title: "Survive 30 Days Chained To Your Ex, Win $250,000"
                              description: ""
                              length: 2224
                              isSponsored: true
                              isMemberOnly: false
                              likes: 3747936
                              comments: 59717
                              views: 188712721
                              engagementRate: 0.0202
                              hashtags: []
                          sponsoredVideosPerformance:
                            likes:
                              all: 3747936
                              avg: 3747936
                              median: 3747936
                              min: 3747936
                              max: 3747936
                            comments:
                              all: 59717
                              avg: 59717
                              median: 59717
                              min: 59717
                              max: 59717
                            views:
                              all: 188712721
                              avg: 188712721
                              median: 188712721
                              min: 188712721
                              max: 188712721
                            engagement:
                              avgEngagementRate: 0.0202
                              likesPerSubscriber: 0.0082
                              commentsPerSubscriber: 0.0001
                              viewsPerSubscriber: 0.4111
                              engagementConsistency:
                                cv: 0
                                medianVsMean: 1
                                topBottomRatio: 0
                                consistencyScore: null
                                consistencyLevel: null
                        - brandName: Feastables
                          brandId: feastables.com
                          brandIgIds:
                            - feastables
                          sponsoredVideos:
                            - publishTime: 1757779201000
                              contentId: 4l97aNza_Zc
                              title: "Survive 30 Days Chained To Your Ex, Win $250,000"
                              description: ""
                              length: 2224
                              isSponsored: true
                              isMemberOnly: false
                              likes: 3747936
                              comments: 59717
                              views: 188712721
                              engagementRate: 0.0202
                              hashtags: []
                            - publishTime: 1756934693370
                              contentId: _AbFXuGDRTs
                              title: "$1 vs $1,000,000,000 Nuclear Bunker!"
                              description: ""
                              length: 1038
                              isSponsored: true
                              isMemberOnly: false
                              likes: 2700000
                              comments: 35478
                              views: 137386751
                              engagementRate: 0.0199
                              hashtags: []
                            - publishTime: 1751750691470
                              contentId: hTSaweR8qMI
                              title: "$1 vs $500,000 Date"
                              description: ""
                              length: 1042
                              isSponsored: true
                              isMemberOnly: false
                              likes: 3400000
                              comments: 60488
                              views: 157421489
                              engagementRate: 0.022
                              hashtags: []
                            - publishTime: 1743974692270
                              contentId: aKq8bkY5eTU
                              title: I Survived The 5 Deadliest Places On Earth
                              description: ""
                              length: 803
                              isSponsored: true
                              isMemberOnly: false
                              likes: 3100000
                              comments: 54565
                              views: 165951430
                              engagementRate: 0.019
                              hashtags: []
                          sponsoredVideosPerformance:
                            likes:
                              all: 12947936
                              avg: 3236984
                              median: 3250000
                              min: 2700000
                              max: 3747936
                            comments:
                              all: 210248
                              avg: 52562
                              median: 57141
                              min: 35478
                              max: 60488
                            views:
                              all: 649472391
                              avg: 162368098
                              median: 161686460
                              min: 137386751
                              max: 188712721
                            engagement:
                              avgEngagementRate: 0.0203
                              likesPerSubscriber: 0.0071
                              commentsPerSubscriber: 0.0001
                              viewsPerSubscriber: 0.3537
                              engagementConsistency:
                                cv: 0.0532
                                medianVsMean: 0.9889
                                topBottomRatio: 0
                                consistencyScore: null
                                consistencyLevel: null
                        - brandName: Moose Toys
                          brandId: moosetoys.com
                          brandIgIds:
                            - moosetoys
                          sponsoredVideos:
                            - publishTime: 1756934691413
                              contentId: TDv56whosPQ
                              title: "Survive 100 Days In Prison, Win $500,000"
                              description: ""
                              length: 2376
                              isSponsored: true
                              isMemberOnly: false
                              likes: 2900000
                              comments: 41450
                              views: 137375010
                              engagementRate: 0.0214
                              hashtags: []
                            - publishTime: 1741382692107
                              contentId: NDsO1LT_0lw
                              title: I Spent 100 Hours Inside The Pyramids!
                              description: ""
                              length: 1303
                              isSponsored: true
                              isMemberOnly: false
                              likes: 5300000
                              comments: 100512
                              views: 223248378
                              engagementRate: 0.0242
                              hashtags: []
                          sponsoredVideosPerformance:
                            likes:
                              all: 8200000
                              avg: 4100000
                              median: 4100000
                              min: 2900000
                              max: 5300000
                            comments:
                              all: 141962
                              avg: 70981
                              median: 70981
                              min: 41450
                              max: 100512
                            views:
                              all: 360623388
                              avg: 180311694
                              median: 180311694
                              min: 137375010
                              max: 223248378
                            engagement:
                              avgEngagementRate: 0.0228
                              likesPerSubscriber: 0.0089
                              commentsPerSubscriber: 0.0002
                              viewsPerSubscriber: 0.3928
                              engagementConsistency:
                                cv: 0.0609
                                medianVsMean: 1
                                topBottomRatio: 0
                                consistencyScore: null
                                consistencyLevel: null
                        - brandName: DoorDash
                          brandId: doordash.com
                          brandIgIds:
                            - doordash
                          sponsoredVideos:
                            - publishTime: 1754342692574
                              contentId: pzBi1nwDn8U
                              title: "Survive 100 Days Trapped In A Private Jet, Keep It"
                              description: ""
                              length: 1983
                              isSponsored: true
                              isMemberOnly: false
                              likes: 3400000
                              comments: 45636
                              views: 136277760
                              engagementRate: 0.0253
                              hashtags: []
                            - publishTime: 1746566692069
                              contentId: figrl0aOULs
                              title: Click This Video To Feed 1 Person
                              description: ""
                              length: 629
                              isSponsored: true
                              isMemberOnly: false
                              likes: 4200000
                              comments: 73423
                              views: 74746546
                              engagementRate: 0.0572
                              hashtags: []
                          sponsoredVideosPerformance:
                            likes:
                              all: 7600000
                              avg: 3800000
                              median: 3800000
                              min: 3400000
                              max: 4200000
                            comments:
                              all: 119059
                              avg: 59530
                              median: 59530
                              min: 45636
                              max: 73423
                            views:
                              all: 211024306
                              avg: 105512153
                              median: 105512153
                              min: 74746546
                              max: 136277760
                            engagement:
                              avgEngagementRate: 0.0412
                              likesPerSubscriber: 0.0083
                              commentsPerSubscriber: 0.0001
                              viewsPerSubscriber: 0.2299
                              engagementConsistency:
                                cv: 0.3867
                                medianVsMean: 1
                                topBottomRatio: 0
                                consistencyScore: null
                                consistencyLevel: null
                        - brandName: Lenovo Group Limited
                          brandId: lenovo.com
                          brandIgIds:
                            - lenovo
                          sponsoredVideos:
                            - publishTime: 1754342692408
                              contentId: FWAdfuPpLOc
                              title: World's Fastest Car Vs Cheetah!
                              description: ""
                              length: 1237
                              isSponsored: true
                              isMemberOnly: false
                              likes: 3300000
                              comments: 45929
                              views: 199699308
                              engagementRate: 0.0168
                              hashtags: []
                          sponsoredVideosPerformance:
                            likes:
                              all: 3300000
                              avg: 3300000
                              median: 3300000
                              min: 3300000
                              max: 3300000
                            comments:
                              all: 45929
                              avg: 45929
                              median: 45929
                              min: 45929
                              max: 45929
                            views:
                              all: 199699308
                              avg: 199699308
                              median: 199699308
                              min: 199699308
                              max: 199699308
                            engagement:
                              avgEngagementRate: 0.0168
                              likesPerSubscriber: 0.0072
                              commentsPerSubscriber: 0.0001
                              viewsPerSubscriber: 0.4351
                              engagementConsistency:
                                cv: 0
                                medianVsMean: 1
                                topBottomRatio: 0
                                consistencyScore: null
                                consistencyLevel: null
                        - brandName: T-Mobile
                          brandId: t-mobile.com
                          brandIgIds:
                            - tmobile
                          sponsoredVideos:
                            - publishTime: 1749158692180
                              contentId: DZIASl9q90s
                              title: "Beat Neymar, Win $500,000"
                              description: ""
                              length: 1673
                              isSponsored: true
                              isMemberOnly: false
                              likes: 3500000
                              comments: 80356
                              views: 155611225
                              engagementRate: 0.023
                              hashtags: []
                            - publishTime: 1736343792866
                              contentId: Pv0iVoSZzN8
                              title: In 10 Minutes This Room Will Explode!
                              description: ""
                              length: 600
                              isSponsored: true
                              isMemberOnly: false
                              likes: 4100000
                              comments: 77174
                              views: 163264294
                              engagementRate: 0.0256
                              hashtags: []
                          sponsoredVideosPerformance:
                            likes:
                              all: 7600000
                              avg: 3800000
                              median: 3800000
                              min: 3500000
                              max: 4100000
                            comments:
                              all: 157530
                              avg: 78765
                              median: 78765
                              min: 77174
                              max: 80356
                            views:
                              all: 318875519
                              avg: 159437760
                              median: 159437760
                              min: 155611225
                              max: 163264294
                            engagement:
                              avgEngagementRate: 0.0243
                              likesPerSubscriber: 0.0083
                              commentsPerSubscriber: 0.0002
                              viewsPerSubscriber: 0.3474
                              engagementConsistency:
                                cv: 0.053
                                medianVsMean: 1
                                topBottomRatio: 0
                                consistencyScore: null
                                consistencyLevel: null
                        - brandName: Jack Link's
                          brandId: jacklinks.com
                          brandIgIds:
                            - jacklinksjerky
                          sponsoredVideos:
                            - publishTime: 1749158692027
                              contentId: "-4GmbBoYQjE"
                              title: I Survived 100 Hours In An Ancient Temple
                              description: ""
                              length: 946
                              isSponsored: true
                              isMemberOnly: false
                              likes: 2900000
                              comments: 77685
                              views: 124496850
                              engagementRate: 0.0239
                              hashtags: []
                          sponsoredVideosPerformance:
                            likes:
                              all: 2900000
                              avg: 2900000
                              median: 2900000
                              min: 2900000
                              max: 2900000
                            comments:
                              all: 77685
                              avg: 77685
                              median: 77685
                              min: 77685
                              max: 77685
                            views:
                              all: 124496850
                              avg: 124496850
                              median: 124496850
                              min: 124496850
                              max: 124496850
                            engagement:
                              avgEngagementRate: 0.0239
                              likesPerSubscriber: 0.0063
                              commentsPerSubscriber: 0.0002
                              viewsPerSubscriber: 0.2712
                              engagementConsistency:
                                cv: 0
                                medianVsMean: 1
                                topBottomRatio: 0
                                consistencyScore: null
                                consistencyLevel: null
                        - brandName: Lovesac
                          brandId: lovesac.com
                          brandIgIds:
                            - lovesac
                          sponsoredVideos:
                            - publishTime: 1741382692318
                              contentId: zajUgQLviwk
                              title: "Last to Leave Their Circle Wins $500,000"
                              description: ""
                              length: 2318
                              isSponsored: true
                              isMemberOnly: false
                              likes: 3000000
                              comments: 83517
                              views: 192581549
                              engagementRate: 0.016
                              hashtags: []
                          sponsoredVideosPerformance:
                            likes:
                              all: 3000000
                              avg: 3000000
                              median: 3000000
                              min: 3000000
                              max: 3000000
                            comments:
                              all: 83517
                              avg: 83517
                              median: 83517
                              min: 83517
                              max: 83517
                            views:
                              all: 192581549
                              avg: 192581549
                              median: 192581549
                              min: 192581549
                              max: 192581549
                            engagement:
                              avgEngagementRate: 0.016
                              likesPerSubscriber: 0.0065
                              commentsPerSubscriber: 0.0002
                              viewsPerSubscriber: 0.4196
                              engagementConsistency:
                                cv: 0
                                medianVsMean: 1
                                topBottomRatio: 0
                                consistencyScore: null
                                consistencyLevel: null
                        - brandName: Prime Video
                          brandId: primevideo.com
                          brandIgIds:
                            - primevideo
                          sponsoredVideos:
                            - publishTime: 1737824401000
                              contentId: sF5LYGgKbUA
                              title: Every Minute One Person Is Eliminated
                              description: ""
                              length: 2086
                              isSponsored: true
                              isMemberOnly: false
                              likes: 3091967
                              comments: 75443
                              views: 153625027
                              engagementRate: 0.0206
                              hashtags: []
                          sponsoredVideosPerformance:
                            likes:
                              all: 3091967
                              avg: 3091967
                              median: 3091967
                              min: 3091967
                              max: 3091967
                            comments:
                              all: 75443
                              avg: 75443
                              median: 75443
                              min: 75443
                              max: 75443
                            views:
                              all: 153625027
                              avg: 153625027
                              median: 153625027
                              min: 153625027
                              max: 153625027
                            engagement:
                              avgEngagementRate: 0.0206
                              likesPerSubscriber: 0.0067
                              commentsPerSubscriber: 0.0002
                              viewsPerSubscriber: 0.3347
                              engagementConsistency:
                                cv: 0
                                medianVsMean: 1
                                topBottomRatio: 0
                                consistencyScore: null
                                consistencyLevel: null
                        - brandName: Samsung Group
                          brandId: samsung.com
                          brandIgIds:
                            - samsungmobileusa
                          sponsoredVideos:
                            - publishTime: 1736343792709
                              contentId: 4SNThp0YiU4
                              title: "50 YouTubers Fight For $1,000,000"
                              description: ""
                              length: 2487
                              isSponsored: true
                              isMemberOnly: false
                              likes: 9600000
                              comments: 348633
                              views: 436135898
                              engagementRate: 0.0228
                              hashtags:
                                - "#galaxyai"
                            - publishTime: 1717257600000
                              contentId: U_LlX4t0A9I
                              title: "$10,000 Every Day You Survive In The Wilderness"
                              description: ""
                              length: 1570
                              isSponsored: true
                              isMemberOnly: false
                              likes: 8785340
                              comments: 338387
                              views: 349556858
                              engagementRate: 0.0261
                              hashtags: []
                          sponsoredVideosPerformance:
                            likes:
                              all: 18385340
                              avg: 9192670
                              median: 9192670
                              min: 8785340
                              max: 9600000
                            comments:
                              all: 687020
                              avg: 343510
                              median: 343510
                              min: 338387
                              max: 348633
                            views:
                              all: 785692756
                              avg: 392846378
                              median: 392846378
                              min: 349556858
                              max: 436135898
                            engagement:
                              avgEngagementRate: 0.0245
                              likesPerSubscriber: 0.02
                              commentsPerSubscriber: 0.0007
                              viewsPerSubscriber: 0.8559
                              engagementConsistency:
                                cv: 0.0673
                                medianVsMean: 1
                                topBottomRatio: 0
                                consistencyScore: null
                                consistencyLevel: null
                        - brandName: Zaxby's
                          brandId: zaxbys.com
                          brandIgIds:
                            - realzaxbys
                          sponsoredVideos:
                            - publishTime: 1717257600000
                              contentId: U_LlX4t0A9I
                              title: "$10,000 Every Day You Survive In The Wilderness"
                              description: ""
                              length: 1570
                              isSponsored: true
                              isMemberOnly: false
                              likes: 8785340
                              comments: 338387
                              views: 349556858
                              engagementRate: 0.0261
                              hashtags: []
                          sponsoredVideosPerformance:
                            likes:
                              all: 8785340
                              avg: 8785340
                              median: 8785340
                              min: 8785340
                              max: 8785340
                            comments:
                              all: 338387
                              avg: 338387
                              median: 338387
                              min: 338387
                              max: 338387
                            views:
                              all: 349556858
                              avg: 349556858
                              median: 349556858
                              min: 349556858
                              max: 349556858
                            engagement:
                              avgEngagementRate: 0.0261
                              likesPerSubscriber: 0.0191
                              commentsPerSubscriber: 0.0007
                              viewsPerSubscriber: 0.7616
                              engagementConsistency:
                                cv: 0
                                medianVsMean: 1
                                topBottomRatio: 0
                                consistencyScore: null
                                consistencyLevel: null
                    creditsUsed: 1
                    creditsAvailable: 975
                    planCreditsAvailable: 900
                    purchasedCreditsAvailable: 75
                    traceId: 46985d83e466fcf19bd7b6a0fb4bd0d3
                    timestamp: 1767923973919
                    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)"
  # YouTube topics
  /youtube/topics:
    get:
      tags:
        - YouTube
      summary: List Topics
      description: "Retrieve all available YouTube topics with their categories and creator count. Topics are used for categorizing YouTube creators based on their content themes."
      operationId: getYoutubeTopics
      x-codeSamples:
        - lang: bash
          label: cURL
          source: |
            curl -X GET "https://apiv3.creatordb.app/youtube/topics" \
              -H "api-key: <YOUR_API_KEY_HERE>"
      responses:
        "200":
          description: "YouTube topics. data returned successfully."
          content:
            application/json:
              schema:
                type: object
                description: "YouTube Topics API response with all available topics."
                properties:
                  data:
                    type: array
                    description: "YouTube topics."
                    items:
                      type: object
                      description: "YouTube topic item with metadata."
                      properties:
                        id:
                          type: string
                          description: "The unique identifier of the topic."
                          examples:
                            - id_letsplay_Gaming_youtube
                        name:
                          type: string
                          description: "The topic name."
                          examples:
                            - "Let's play"
                        category:
                          type: string
                          description: "Category classifications."
                          examples:
                            - Gaming
                        channelCount:
                          type: integer
                          description: "Number of creators associated with this YouTube topic."
                          minimum: 0
                          examples:
                            - 98586
                      required:
                        - id
                        - name
                        - category
                        - channelCount
                  creditsUsed:
                    type: number
                    description: "Number of API credits consumed by this request."
                    examples:
                      - 1
                  creditsAvailable:
                    type: number
                    description: "Number of API credits remaining. Equals planCreditsAvailable plus purchasedCreditsAvailable."
                    examples:
                      - -1
                  planCreditsAvailable:
                    type: number
                    description: "Remaining plan credits after this request, in credits."
                    examples:
                      - 900
                  purchasedCreditsAvailable:
                    type: number
                    description: "Remaining purchased-bucket credits after this request, in display units."
                    examples:
                      - 75
                  keyCreditsAvailable:
                    type: number
                    description: "Remaining credits this API key can spend after this request, before reaching its spend limit. Present only when the key has a spend limit."
                    examples:
                      - 4975
                  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
                  - planCreditsAvailable
                  - purchasedCreditsAvailable
              examples:
                default:
                  value:
                    data:
                      - id: id_academic_Education_youtube
                        name: Academic
                        category: Education
                        channelCount: 67967
                      - id: id_lesson_Education_youtube
                        name: Lesson
                        category: Education
                        channelCount: 67428
                      - id: id_spiritualeducation_Education_youtube
                        name: Spiritual Education
                        category: Education
                        channelCount: 48730
                      - id: id_culturaleducation_Education_youtube
                        name: Cultural Education
                        category: Education
                        channelCount: 46214
                      - id: id_healtheducation_Education_youtube
                        name: Health Education
                        category: Education
                        channelCount: 31749
                      - id: id_academichistory_Education_youtube
                        name: Academic History
                        category: Education
                        channelCount: 29702
                      - id: id_economics_Education_youtube
                        name: Economics
                        category: Education
                        channelCount: 28665
                      - id: id_finance_Education_youtube
                        name: Finance
                        category: Education
                        channelCount: 24347
                      - id: id_science_Education_youtube
                        name: Science
                        category: Education
                        channelCount: 22539
                    creditsUsed: 1
                    creditsAvailable: 975
                    planCreditsAvailable: 900
                    purchasedCreditsAvailable: 75
                    traceId: 0f58e95d22ea888a76166ecf6bb251ef
                    timestamp: 1772075633067
                    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:
                unexpected parameter:
                  summary: Unexpected query parameter
                  value:
                    success: false
                    error: "VALIDATION_ERROR"
                    message: "Unrecognized query parameter."
                    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)"
  /youtube/niches:
    get:
      tags:
        - YouTube
      summary: List Niches
      description: "Retrieve all available YouTube niches with their categories and the number of creators. Niches provide more granular categorization of YouTube creators than topics."
      operationId: getYoutubeNiches
      x-codeSamples:
        - lang: bash
          label: cURL
          source: |
            curl -X GET "https://apiv3.creatordb.app/youtube/niches" \
              -H "api-key: <YOUR_API_KEY_HERE>"
      responses:
        "200":
          description: "YouTube niches data returned successfully."
          content:
            application/json:
              schema:
                type: object
                description: "YouTube Niches API response with all available niches."
                properties:
                  data:
                    type: array
                    description: "YouTube niches."
                    items:
                      type: object
                      description: "Niche with metadata."
                      properties:
                        id:
                          type: string
                          description: "The unique identifier."
                          examples:
                            - id_entertainment_Gaming
                        name:
                          type: string
                          description: "The niche name."
                          examples:
                            - Gaming
                        category:
                          type: string
                          description: "Category classifications."
                          examples:
                            - Entertainment
                        channelCount:
                          type: integer
                          description: "Number of creators associated with this niche."
                          minimum: 0
                          examples:
                            - 1234
                      required:
                        - id
                        - name
                        - category
                        - channelCount
                  creditsUsed:
                    type: number
                    description: "Number of API credits consumed by this request."
                    examples:
                      - 1
                  creditsAvailable:
                    type: number
                    description: "Number of API credits remaining. Equals planCreditsAvailable plus purchasedCreditsAvailable."
                    examples:
                      - -1
                  planCreditsAvailable:
                    type: number
                    description: "Remaining plan credits after this request, in credits."
                    examples:
                      - 900
                  purchasedCreditsAvailable:
                    type: number
                    description: "Remaining purchased-bucket credits after this request, in display units."
                    examples:
                      - 75
                  keyCreditsAvailable:
                    type: number
                    description: "Remaining credits this API key can spend after this request, before reaching its spend limit. Present only when the key has a spend limit."
                    examples:
                      - 4975
                  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
                  - planCreditsAvailable
                  - purchasedCreditsAvailable
              examples:
                default:
                  value:
                    data:
                      - id: id_vlog_PeopleBlogs
                        name: Vlog
                        category: People Blogs
                        channelCount: 13004
                      - id: id_shorts_PeopleBlogs
                        name: Shorts
                        category: People Blogs
                        channelCount: 7709
                      - id: id_love_PeopleBlogs
                        name: Love
                        category: People Blogs
                        channelCount: 4153
                      - id: id_news_PeopleBlogs
                        name: News
                        category: People Blogs
                        channelCount: 2605
                      - id: id_asmr_PeopleBlogs
                        name: Asmr
                        category: People Blogs
                        channelCount: 4490
                      - id: id_viral_PeopleBlogs
                        name: Viral
                        category: People Blogs
                        channelCount: 6626
                      - id: id_tiktok_PeopleBlogs
                        name: Tiktok
                        category: People Blogs
                        channelCount: 4898
                      - id: id_food_PeopleBlogs
                        name: Food
                        category: People Blogs
                        channelCount: 5136
                      - id: id_funny_PeopleBlogs
                        name: Funny
                        category: People Blogs
                        channelCount: 4719
                      - id: id_family_PeopleBlogs
                        name: Family
                        category: People Blogs
                        channelCount: 3208
                    creditsUsed: 1
                    creditsAvailable: 975
                    planCreditsAvailable: 900
                    purchasedCreditsAvailable: 75
                    traceId: aabd94f7ff9e2d0f3fc4e218abd692d0
                    timestamp: 1772076193778
                    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:
                unexpected parameter:
                  summary: Unexpected query parameter
                  value:
                    success: false
                    error: "VALIDATION_ERROR"
                    message: "Unrecognized query parameter."
                    timestamp: 1770099403116
        "429":
          description: "Exceeded quota or rate limit."
          content:
            application/json:
              schema:
                type: object
                title: QuotaErrorResponse
                description: "Quota error response format."
                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)"
 # YouTube submit creators
  /youtube/subtitles/meta:
    get:
      summary: Get Video Subtitles
      description: "Retrieve available subtitle metadata for a video including `vssId`, `lang`, `langCode`. Returns a 404 error if the video does not exist."
      operationId: getYoutubeSubtitleMeta
      tags:
        - YouTube
      parameters:
        - name: videoId
          in: query
          description: "The unique YouTube video ID (length: 11 characters)."
          required: true
          schema:
            type: string
            minLength: 11
            maxLength: 11
            pattern: '^[a-zA-Z0-9_-]{11}$'
            examples:
              - icxrUIGoEg8
      x-codeSamples:
        - lang: bash
          label: cURL
          source: |
            curl -X GET "https://apiv3.creatordb.app/youtube/subtitles/meta?videoId=icxrUIGoEg8" \
            -H "api-key: <YOUR_API_KEY_HERE>"
      responses:
        "200":
          description: "Metadata of YouTube subtitles returned successfully."
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      videoId:
                        type: string
                        description: "The video ID."
                        examples:
                          - icxrUIGoEg8
                      channelId:
                        type: string
                        description: "The channel ID."
                        examples:
                          - UCuAXFkgsw1L7xaCfnd5JJOw
                      availableSubtitles:
                        type: array
                        items:
                          type: object
                          properties:
                            vssId:
                              type: string
                              description: "The subtitle language record code."
                              examples:
                                - a.en
                            lang:
                              type: string
                              description: "Full language name."
                              examples:
                                - English (Auto-generated)
                            langCode:
                              type: string
                              description: "The language code in **ISO 639-1** two-letter format."
                              examples:
                                - en
                          required:
                            - vssId
                            - lang
                            - langCode
                          description: "Available subtitle metadata."
                        description: "List of available subtitle languages with metadata."
                    required:
                      - videoId
                      - channelId
                      - availableSubtitles
                    description: "Subtitle metadata for the video."
                  creditsUsed:
                    type: number
                    description: "Number of API credits consumed by this request."
                    examples:
                      - 1
                  creditsAvailable:
                    type: number
                    description: "Number of API credits remaining. Equals planCreditsAvailable plus purchasedCreditsAvailable."
                    examples:
                      - -1
                  planCreditsAvailable:
                    type: number
                    description: "Remaining plan credits after this request, in credits."
                    examples:
                      - 900
                  purchasedCreditsAvailable:
                    type: number
                    description: "Remaining purchased-bucket credits after this request, in display units."
                    examples:
                      - 75
                  keyCreditsAvailable:
                    type: number
                    description: "Remaining credits this API key can spend after this request, before reaching its spend limit. Present only when the key has a spend limit."
                    examples:
                      - 4975
                  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
                  - planCreditsAvailable
                  - purchasedCreditsAvailable
                description: "YouTube Subtitle Meta API response - available subtitle metadata for a video"
              examples:
                default:
                  summary: Subtitle metadata for a video
                  value:
                    data:
                      videoId: "icxrUIGoEg8"
                      channelId: "UCuAXFkgsw1L7xaCfnd5JJOw"
                      availableSubtitles:
                        - vssId: "a.en"
                          lang: "English (Auto-generated)"
                          langCode: "en"
                        - vssId: ".en"
                          lang: "English"
                          langCode: "en"
                        - vssId: ".zh-Hant"
                          lang: "Chinese (Traditional)"
                          langCode: "zh-Hant"
                    creditsUsed: 1
                    creditsAvailable: 975
                    planCreditsAvailable: 900
                    purchasedCreditsAvailable: 75
                    traceId: "f8e4a3b2c1d0e9f8a7b6c5d4e3f2a1b0"
                    timestamp: 1750732453635
                    errorCode: ""
                    errorDescription: ""
                    success: true
        "400":
          description: "Validation error."
          content:
            application/json:
              schema:
                type: object
                title: ValidationErrorResponse
                description: "Parameter validation error response format."
                properties:
                  success:
                    type: boolean
                    enum:
                      - false
                  error:
                    type: string
                  message:
                    type: string
                  timestamp:
                    type: integer
                required:
                  - success
                  - error
                  - message
                  - timestamp
              examples:
                missing videoId:
                  summary: Missing videoId
                  value:
                    success: false
                    error: "VALIDATION_ERROR"
                    message: "Missing required field: 'videoId'."
                    timestamp: 1770099403116
                invalid video id:
                  summary: Invalid videoId format
                  value:
                    success: false
                    error: "VALIDATION_ERROR"
                    message: "Invalid `videoId` format. The YouTube videoIds must be 11 characters."
                    timestamp: 1770099403116
        "429":
          description: "Exceeded quota or rate limit."
          content:
            application/json:
              schema:
                type: object
                title: QuotaErrorResponse
                description: "Quota error response format."
                properties:
                  success:
                    type: boolean
                    enum:
                      - 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."
  /youtube/subtitles/download:
    get:
      summary: Download Video Subtitles
      description: "Streams the specified YouTube video's subtitle data as a JSON file download with the filename format `{videoId}-{vssId}.json`. Returns a `content-disposition` attachment. Returns `404` if the video or subtitle ID is not found."
      operationId: getYoutubeSubtitleDownload
      tags:
        - YouTube
      parameters:
        - name: videoId
          in: query
          description: "The unique YouTube video ID (length: 11 characters)."
          required: true
          schema:
            type: string
            minLength: 11
            maxLength: 11
            pattern: '^[a-zA-Z0-9_-]{11}$'
            examples:
              - icxrUIGoEg8
        - name: vssId
          in: query
          description: "The subtitle language record code (example: `a.en`, `.en`, `.zh-Hant`)."
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 20
            examples:
              - .en
      x-codeSamples:
        - lang: bash
          label: cURL
          source: |
            curl -X GET "https://apiv3.creatordb.app/youtube/subtitles/download?videoId=icxrUIGoEg8&vssId=.en" \
              -H "api-key: <YOUR_API_KEY_HERE>"
      responses:
        "200":
          description: "Subtitle data of the specified YouTube video downloaded successfully."
          content:
            application/json:
              schema:
                type: object
                properties:
                  _streaming:
                    type: boolean
                    enum:
                      - true
                description: "Streams subtitle data as a JSON file download (chunked transfer encoding). Content-Type: application/json, Content-Disposition: attachment; filename=\"{videoId}-{vssId}.json\""
        "400":
          description: "Validation error."
          content:
            application/json:
              schema:
                type: object
                title: ValidationErrorResponse
                description: "Parameter validation error response format."
                properties:
                  success:
                    type: boolean
                    enum:
                      - false
                  error:
                    type: string
                  message:
                    type: string
                  timestamp:
                    type: integer
                required:
                  - success
                  - error
                  - message
                  - timestamp
              examples:
                missing videoId:
                  summary: Missing videoId
                  value:
                    success: false
                    error: "VALIDATION_ERROR"
                    message: "Missing required field: 'videoId'."
                    timestamp: 1770099403116
                missing vssId:
                  summary: Missing vssId
                  value:
                    success: false
                    error: "VALIDATION_ERROR"
                    message: "Missing required field: 'vssId'."
                    timestamp: 1770099403116
        "429":
          description: "Exceeded quota or rate limit."
          content:
            application/json:
              schema:
                type: object
                title: QuotaErrorResponse
                description: "Quota error response format."
                properties:
                  success:
                    type: boolean
                    enum:
                      - 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."
  #Instagram
  # Instagram custom filter search
  /instagram/search:
    post:
      tags:
        - Instagram
      summary: Search Creators
      description: "Search for Instagram creators using advanced filters such as `displayName`, follower count, content performance, and more. Supports fuzzy search, pagination, and multiple filter combinations. At least one filter is required. By default the `creatorList` is sorted by `displayName`. Custom sorting can be applied using the `sortBy` parameter. <br /><br />Optionally pass `fields` to enrich each search result with data from other endpoints. Enrichment is billed per result returned, using each endpoint's own pricing rules. Fractional calls must be enabled on your API key. For details, see [Fractional Calls](/api-v3/fractional-calls)."
      operationId: searchInstagram
      requestBody:
        content:
          application/json:
            schema:
              type: object
              description: "Instagram search request parameters."
              properties:
                filters:
                  type: array
                  description:
                    "Filter objects that include `filterName`, `op`, and `value`. For all accepted `filterName` values and their data types, see [Configuring Custom Search Filters and Examples](https://docs.creatordb.app/api-v3/configuring_advanced_search_filters#configuring-custom-instagram-filter-search-criteria)."
                  minItems: 1
                  items:
                    type: object
                    properties:
                      filterName:
                        type: string
                        description: "The field to apply the filter on."
                      op:
                        type: string
                        enum:
                          - in
                          - ">"
                          - "="
                          - "<"
                        description: "The comparison operator. Accepted values include `in`, `>`, `=`, `<`. <br /> -String fields accept: `=`, `in`. <br /> -Number fields accept: `>`, `=`, `<`. <br /> -Boolean fields accept: `=`"
                      value:
                        description: "Type depends on the `filterName`. <br /> - String fields accept `string` or `string[]`. <br /> - Number fields accept `number`. <br /> -Boolean fields accept `boolean`. <br /> -Operator \"in\" accepts `string[]`, operator \"=\" accepts string for string fields."
                        anyOf:
                          - type: string
                          - type: number
                          - type: array
                            maxItems: 100
                            items:
                              type: string
                          - type: boolean
                      isFuzzySearch:
                        type: boolean
                        description: "When `true`, performs a fuzzy match for `string` type `filterName`."
                        default: false
                    required:
                      - filterName
                      - op
                      - value
                desc:
                  type: boolean
                  description: "Sort order for results. `true` for descending, `false` for ascending order."
                sortBy:
                  type: string
                  description: "Field to sort creators by. For example, `totalFollowers` sorts by follower count."
                pageSize:
                  type: integer
                  description: "Number of results per page. Maximum: 100."
                  minimum: 1
                  maximum: 100
                offset:
                  type: integer
                  description: "Number of records to skip before returning results."
                  minimum: 0
                fields:
                  type: object
                  description: "Enrich each search result with data from other endpoints on the same platform (e.g. `profile`, `contact`). Enrichment is billed per result returned, using each endpoint's pricing rules. Each key is a bare endpoint name, and each key's value follows that endpoint's fractional shape. For details, see [Field and Item Costs](/api-v3/field-and-item-costs#instagram/search)."
                  properties:
                    profile:
                      type: array
                      items:
                        type: string
                      description: "Profile fields to add to each result."
                    performance:
                      type: array
                      items:
                        type: string
                      description: "Performance blocks to add to each result."
                    audience:
                      type: array
                      items:
                        type: string
                      description: "Audience fields to add to each result."
                    contact:
                      type: array
                      items:
                        type: string
                      description: "Contact fields to add to each result."
                    content-detail:
                      type: object
                      description: "Per-item counts, e.g. { \"recentImages\": 5, \"recentReels\": 3 }. `0`, `null`, or omission returns zero items for that field. Valid field names vary by platform. For details, see [Fractional Calls](/api-v3/fractional-calls)."
                    performance-history:
                      type: object
                      required: [pastDayRange]
                      properties:
                        pastDayRange:
                          type: integer
                          minimum: 1
                          maximum: 400
                          description: "Number of past days of daily snapshots, from 1 to 400, as a JSON number (for example `90`, not `\"90\"`)."
                      description: "Date range bucket, e.g. { \"pastDayRange\": 90 }. For pricing, see [Performance history pricing](/api-v3/api-credit-usage#performance-history-pricing)."
                    sponsorship:
                      type: object
                      description: "Per-brand counts, e.g. `{ \"sponsorList\": 5 }`. `0`, `null`, or omission returns zero brands. Available for YouTube and Instagram search only. For details, see [Fractional Calls](/api-v3/fractional-calls)."
                  additionalProperties: false
                  examples:
                    - profile:
                        - country
                      content-detail:
                          recentImages: 5
                          recentReels: 3
                      performance-history:
                          pastDayRange: 90
                      sponsorship:
                          sponsorList: 5
              required:
                - filters
                - pageSize
                - offset
              examples:
                - filters:
                    - filterName: displayName
                      op: "="
                      value: beast
                      isFuzzySearch: true
                  desc: true
                  sortBy: displayName
                  pageSize: 10
                  offset: 0
      x-codeSamples:
        - lang: bash
          label: cURL
          source: |
            curl -X POST "https://apiv3.creatordb.app/instagram/search" \
              -H "Content-Type: application/json" \
              -H "api-key: <YOUR_API_KEY_HERE>" \
              -d '{
                "filters": [
                  {"filterName": "country", "op": "=", "value": "USA"},
                  {"filterName": "mainLanguage", "op": "=", "value": "eng"},
                  {"filterName": "hasSponsors", "op": "=", "value": true},
                  {"filterName": "totalFollowers", "op": ">", "value": 50000},
                  {"filterName": "totalFollowers", "op": "<", "value": 500000},
                  {"filterName": "avgReelsViews", "op": ">", "value": 20000},
                  {"filterName": "avgImagesLikes", "op": ">", "value": 1000},
                  {"filterName": "totalContents", "op": ">", "value": 50}
                ],
                "sortBy": "avgReelsEngagementRate",
                "desc": true,
                "pageSize": 50,
                "offset": 0
              }'
      responses:
        "200":
          description: "Instagram search results returned successfully."
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    description: "Search results containing Instagram creators and pagination information."
                    properties:
                      creatorList:
                        type: array
                        description: "Creator objects matching the search query."
                        items:
                          type: object
                          description: "Creator details in search results."
                          properties:
                            displayName:
                              type: string
                              description: "The Instagram account name."
                              examples:
                                - Instagram
                            uniqueId:
                              type: string
                              description: "The Instagram handle."
                              examples:
                                - instagram
                            avatarUrl:
                              type: string
                              description: "The profile picture URL."
                              examples:
                                - "https://instagram.ftpe8-4.fna.fbcdn.net/..."
                            totalFollowers:
                              type: integer
                              description: "Total number of followers."
                              minimum: 0
                              examples:
                                - 613344
                            profile:
                              $ref: "#/components/schemas/InstagramProfileData"
                              description: "Profile data for this creator. Present only when requested via `fields.profile`."
                            performance:
                              $ref: "#/components/schemas/InstagramPerformanceData"
                              description: "Performance data for this creator. Present only when requested via `fields.performance`."
                            audience:
                              $ref: "#/components/schemas/InstagramAudienceData"
                              description: "Audience demographics for this creator. Present only when requested via `fields.audience`."
                            contact:
                              $ref: "#/components/schemas/InstagramContactData"
                              description: "Contact information for this creator. Present only when requested via `fields.contact`."
                            content-detail:
                              $ref: "#/components/schemas/InstagramContentDetailData"
                              description: "Recent content published by this creator. Present only when requested via `fields.content-detail`."
                            sponsorship:
                              $ref: "#/components/schemas/InstagramSponsorshipData"
                              description: "Sponsorship data for this creator. Present only when requested via `fields.sponsorship`."
                            performance-history:
                              $ref: "#/components/schemas/InstagramPerformanceHistoryData"
                              description: "Daily performance snapshots for this creator. Present only when requested via `fields.performance-history`."
                          required:
                            - displayName
                            - uniqueId
                            - avatarUrl
                            - totalFollowers
                      totalResults:
                        type: integer
                        description: "Number of results for this search query."
                        minimum: 0
                        examples:
                          - 1
                      hasNextPage:
                        type: boolean
                        description: "`true` if there is a next page of results."
                        examples:
                          - true
                      nextOffset:
                        type: integer
                        description: "The offset value for retrieving the next page of results."
                        minimum: 0
                        examples:
                          - 100
                    required:
                      - creatorList
                      - totalResults
                      - hasNextPage
                      - nextOffset
                  creditsUsed:
                    type: number
                    description: "Number of API credits consumed by this request."
                    examples:
                      - 1
                  creditsAvailable:
                    type: number
                    description: "Number of API credits remaining. Equals planCreditsAvailable plus purchasedCreditsAvailable."
                    examples:
                      - -1
                  planCreditsAvailable:
                    type: number
                    description: "Remaining plan credits after this request, in credits."
                    examples:
                      - 900
                  purchasedCreditsAvailable:
                    type: number
                    description: "Remaining purchased-bucket credits after this request, in display units."
                    examples:
                      - 75
                  keyCreditsAvailable:
                    type: number
                    description: "Remaining credits this API key can spend after this request, before reaching its spend limit. Present only when the key has a spend limit."
                    examples:
                      - 4975
                  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
                  enrichment:
                    type: object
                    description: "Enrichment status for this request. Present only when `fields` was supplied."
                    properties:
                      applied:
                        type: boolean
                        description: "Whether each result was enriched with the requested `fields`. `false` when enrichment was skipped because the remaining credits could not cover it, in which case only the standard search fields are returned."
                        examples:
                          - true
                      message:
                        type: string
                        description: "Note explaining the enrichment outcome. Present when enrichment was skipped."
                    required:
                      - applied
                required:
                  - data
                  - traceId
                  - timestamp
                  - errorCode
                  - errorDescription
                  - success
                  - creditsUsed
                  - creditsAvailable
                  - planCreditsAvailable
                  - purchasedCreditsAvailable
              examples:
                default:
                  value:
                    data:
                      creatorList:
                        - displayName: "Big Kana \U0001F98D | B. Jenkins"
                          uniqueId: ceo.nocap
                          avatarUrl: "https://instagram.ftpe8-3.fna.fbcdn.net/v/t51.2885-19/337746176_606805874637299_3223478874000522029_n.jpg?efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=instagram.ftpe8-3.fna.fbcdn.net&_nc_cat=111&_nc_oc=Q6cZ2QHmH_4pzuj5dVzej9_fTh3MGW4Q2kVsANXqJGUfeAjY5MjS_I_VwJfMd1bNRB1mxX4b2s9TvqtdAoqTci7whElk&_nc_ohc=g4OQCRIDH6sQ7kNvwG5TE8S&_nc_gid=3EUn-WAXbtoF-FcbafmmZQ&edm=ALGbJPMBAAAA&ccb=7-5&oh=00_Afmz4A2njFAOwYXtPuXfd4pBgi14sdkpg-PZrLmRmTVj1Q&oe=695208DE&_nc_sid=7d3ac5"
                          totalFollowers: 98600
                        - displayName: "\U0001D412.\U0001D401.\U0001D405 T͟͞H͟͞E͟͞  \U0001D406\U0001D411\U0001D404\U0001D400\U0001D413"
                          uniqueId: el___grande___
                          avatarUrl: "https://instagram.ftpe8-1.fna.fbcdn.net/v/t51.2885-19/50907024_241749340050197_5880292939598397440_n.jpg?stp=dst-jpg_s240x240_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4zODcuYzIifQ&_nc_ht=instagram.ftpe8-1.fna.fbcdn.net&_nc_cat=105&_nc_oc=Q6cZ2QHy3nIjou6YQcUcXVGRKXs5-QybiYxqhRD6IqM0FPeGqP8Li-6uENSoHHRkUgvrK8E&_nc_ohc=q0uEiYZ4FkMQ7kNvwEZ9DND&_nc_gid=jl1mlUdmfpG-mAZpC9zZmA&edm=APs17CUBAAAA&ccb=7-5&oh=00_AfnXSWTlmBMkccnLDiRgZieQNK9P7uczwh60eR0Vamc1OA&oe=694C10C7&_nc_sid=10d13b"
                          totalFollowers: 367039
                        - displayName: JULIA LANG
                          uniqueId: julialang
                          avatarUrl: "https://instagram.ftpe8-2.fna.fbcdn.net/v/t51.2885-19/483165544_953011350277477_837865670376759424_n.jpg?stp=dst-jpg_s240x240_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=instagram.ftpe8-2.fna.fbcdn.net&_nc_cat=101&_nc_oc=Q6cZ2QESysShlh8zx-UVKZ76CTV8ZBWl9eLUkDqONOIlHUR7hr3l7nt8xdqzjNZkDWQ_Lh4&_nc_ohc=WVXl0LSxzdIQ7kNvwHF4q2b&_nc_gid=ip-v-su6d8Hne8ArLtCQww&edm=APs17CUBAAAA&ccb=7-5&oh=00_AfoImrNYfYGjSFJQuBvIyp2XyNOCL4ts9NTvMeGcHo0aQw&oe=6964FCD2&_nc_sid=10d13b"
                          totalFollowers: 339415
                        - displayName: Christian Watson
                          uniqueId: christiann.w1
                          avatarUrl: "https://instagram.ftpe7-3.fna.fbcdn.net/v/t51.2885-19/589490231_18544943971046055_7635208790732130795_n.jpg?stp=dst-jpg_s240x240_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=instagram.ftpe7-3.fna.fbcdn.net&_nc_cat=103&_nc_oc=Q6cZ2QH8448YVlBw0OdXhX77ZwrtuiS4mZjqmI1XA-Fs9UF11tysYRmlE6qBOZ270c83TF4&_nc_ohc=CxAn3dYWtQAQ7kNvwEZjQSi&_nc_gid=N0pnsC48ZhMbBvM-JA-t0A&edm=APs17CUBAAAA&ccb=7-5&oh=00_Aflrc22rbqIopQpHQGzzDATZew1PRhEhNSPvasYh98bSpQ&oe=694C43AA&_nc_sid=10d13b"
                          totalFollowers: 212784
                        - displayName: The Rae Family
                          uniqueId: theraefamily
                          avatarUrl: "https://instagram.ftpe8-1.fna.fbcdn.net/v/t51.2885-19/246243558_419164873026308_8889716148548535991_n.jpg?stp=dst-jpg_s240x240_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=instagram.ftpe8-1.fna.fbcdn.net&_nc_cat=108&_nc_oc=Q6cZ2QHdlD4yeqUpDpvFCc09y2J-SkSFsjPkNfJ9MJybC5PBxDGuuurZRfTto5TY6PRx2eI&_nc_ohc=5Tm0YvGoQtYQ7kNvwFdHLum&_nc_gid=wsxrhzjflov5QogAscuNPA&edm=APs17CUBAAAA&ccb=7-5&oh=00_AfmII8pMbsDsnpmErxwEzB4b0NPhQMeuGZbPZCuMFse3tA&oe=694CACA8&_nc_sid=10d13b"
                          totalFollowers: 206788
                        - displayName: Luke Hughes
                          uniqueId: lhughes_06
                          avatarUrl: "https://instagram.ftpe7-2.fna.fbcdn.net/v/t51.2885-19/245556478_828811234479587_9052356194627222928_n.jpg?stp=dst-jpg_s240x240_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby43OTMuYzIifQ&_nc_ht=instagram.ftpe7-2.fna.fbcdn.net&_nc_cat=111&_nc_oc=Q6cZ2QG8kL9wai6ShLWSyzQpGh6yIhuJkc6babmRYu0L5zYpt3FldpX8stbVuSW7Ixh3UTM&_nc_ohc=V5KPRW01GIgQ7kNvwHFLyb_&_nc_gid=x3JS69M7Mn2t2RSoiRbJ1g&edm=APs17CUBAAAA&ccb=7-5&oh=00_AfldxojqutryrGB790Vdv2TK9-cFH1tzLdTlRjbD7dHRjQ&oe=694B8339&_nc_sid=10d13b"
                          totalFollowers: 215230
                        - displayName: Stephan Crisis ⚔️
                          uniqueId: crisiskhan
                          avatarUrl: "https://instagram.ftpe8-2.fna.fbcdn.net/v/t51.2885-19/503922652_18511094623061667_3995685263185387607_n.jpg?stp=dst-jpg_s240x240_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=instagram.ftpe8-2.fna.fbcdn.net&_nc_cat=103&_nc_oc=Q6cZ2QEDk1WUB9jThfYvO_YuH8l1pZ2twVwJdd75o5QEnBr3_3oUbBWMnS4S1I7au-6sERM&_nc_ohc=5SzlAw4_GnkQ7kNvwFsoRMP&_nc_gid=0FTMQLgYybGgFVjjVt8Dkw&edm=APs17CUBAAAA&ccb=7-5&oh=00_AfnIuUQOAbYK4st5P0I3Fwb-YqUfm4YEYdDGo4EN77_07A&oe=6953BF91&_nc_sid=10d13b"
                          totalFollowers: 77805
                        - displayName: Aimee Cotton Tolleson
                          uniqueId: cotytolly
                          avatarUrl: "https://instagram.ftpe7-3.fna.fbcdn.net/v/t51.2885-19/476466698_2094344647654766_2933391962824742610_n.jpg?efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=instagram.ftpe7-3.fna.fbcdn.net&_nc_cat=102&_nc_oc=Q6cZ2QH2TLXqygEIS68PHMG79dQrtWJh1Qq5B7YYM6gwdXWQl9lfxA_SH_wqhOYomRbVP8farPUpnzJWGtCtOrDSjjIV&_nc_ohc=Qg0Gacj-e1QQ7kNvwHY0sxQ&_nc_gid=y4ecVh4Ww488s9LLE-VTJg&edm=ALGbJPMBAAAA&ccb=7-5&oh=00_Afl9GRIdJ7vRceKmu_HpRTK5P2jGRWmHZeWBBV0PkOw2tw&oe=6953D41F&_nc_sid=7d3ac5"
                          totalFollowers: 78050
                        - displayName: Jah
                          uniqueId: jahzarre
                          avatarUrl: "https://scontent-tpe1-1.cdninstagram.com/v/t51.2885-19/337319615_1637509416720342_5304348895024561675_n.jpg?efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=scontent-tpe1-1.cdninstagram.com&_nc_cat=106&_nc_oc=Q6cZ2QES0AMVABjRumhKmDdfrAC82MKjKcmFxDibEr6sPYUFUKgSVPwmU7Gp9nJGQJ662SITY1YlP3uMQbn9A_NnzhmY&_nc_ohc=3_EZh4_BemIQ7kNvwHZtJZK&_nc_gid=Oj1JzC-lYSgNxO5a_puWzg&edm=ALGbJPMBAAAA&ccb=7-5&oh=00_AfrNPX9ruKsI-b3AKuWN3POB0zV5mPO2WestQVUAKeByhQ&oe=69628071&_nc_sid=7d3ac5"
                          totalFollowers: 325761
                        - displayName: Derrick Rose Jr. (PJ Rose)
                          uniqueId: impjrose
                          avatarUrl: "https://scontent-tpe1-1.cdninstagram.com/v/t51.2885-19/425354879_358635473648549_2984707689449595678_n.jpg?stp=dst-jpg_s240x240_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby45NjcuYzIifQ&_nc_ht=scontent-tpe1-1.cdninstagram.com&_nc_cat=105&_nc_oc=Q6cZ2QGPNSCXmRdFshWMPBJ0NGKXcX2vh0MR_trwJeuUiPkbf3ngo3UdFcUAqtPSNZQQg3M&_nc_ohc=6jEmTwF2N2kQ7kNvwGpykJZ&_nc_gid=CryRpI0pu-uE7NfvnliEbw&edm=APs17CUBAAAA&ccb=7-5&oh=00_Afm4NDLOe8sNgTXuvKtIFvj_yVxLCC94c-akxDjkV7ZIvw&oe=694C53BF&_nc_sid=10d13b"
                          totalFollowers: 177503
                        - displayName: Scott Cawthon
                          uniqueId: scottcawthon87
                          avatarUrl: "https://scontent-tpe1-1.cdninstagram.com/v/t51.2885-19/455284541_1030179601599216_6457993594799410549_n.jpg?stp=dst-jpg_s240x240_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4zODguYzIifQ&_nc_ht=scontent-tpe1-1.cdninstagram.com&_nc_cat=100&_nc_oc=Q6cZ2QHDRn5bABMJyvKXqst0wzUCkiQElveXckzjFRSBlZoOgIif3J5p_4jkJY9AqblZ138&_nc_ohc=jnYOuW8Q-n0Q7kNvwEQrPNR&_nc_gid=lF8nM8gi9OnRyxXu9jdfbA&edm=APs17CUBAAAA&ccb=7-5&oh=00_AflBl_8TeLgN4YMT0C3XFNxXTExuSpBZ5a2Z6wGJ9SxhAQ&oe=694B606B&_nc_sid=10d13b"
                          totalFollowers: 338769
                        - displayName: brndn24k
                          uniqueId: brndn24k
                          avatarUrl: "https://scontent-tpe1-1.cdninstagram.com/v/t51.2885-19/116692430_742054119916128_1560056404777535638_n.jpg?stp=dst-jpg_s240x240_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=scontent-tpe1-1.cdninstagram.com&_nc_cat=100&_nc_oc=Q6cZ2QHqQ0dYw0n-CYbOkCE522haD0SnKD1P3GTfTvwjKo8e9iSGVKQ8qcx8uECVx8CvTkE&_nc_ohc=E2i_ccdy_dIQ7kNvwFfSYbi&_nc_gid=6OZK4t7jmx5qjNhqj0sUGA&edm=APs17CUBAAAA&ccb=7-5&oh=00_AfnqPeh2RsS8JlItdVzmvrEJ5yySiRHTb9dHtXu2Jg0TrQ&oe=694C54C2&_nc_sid=10d13b"
                          totalFollowers: 329946
                        - displayName: Minkah Fitzpatrick Jr.
                          uniqueId: fittypat21
                          avatarUrl: "https://scontent-tpe1-1.cdninstagram.com/v/t51.2885-19/524927859_18513491206044094_8639816373718821943_n.jpg?stp=dst-jpg_s240x240_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby41ODguYzIifQ&_nc_ht=scontent-tpe1-1.cdninstagram.com&_nc_cat=110&_nc_oc=Q6cZ2QFk862jpbvRJbWPtZpijO4DwluMLIsc-dCKUzP41orW2piSyhOfJS-Uug69ocg5kuU&_nc_ohc=UQ2afmhZMB4Q7kNvwFvWVPc&_nc_gid=6_jNE7tKt4I-Ce0LlNKN3A&edm=APs17CUBAAAA&ccb=7-5&oh=00_AflzhcmpvjRXo7julaDiNsIDvoOZgziqLYXwERgGPubEdw&oe=694BF1CF&_nc_sid=10d13b"
                          totalFollowers: 474551
                        - displayName: Ian Greene
                          uniqueId: ian.greene
                          avatarUrl: "https://instagram.ftpe7-1.fna.fbcdn.net/v/t51.2885-19/431218803_916506626804976_1484630105434058709_n.jpg?stp=dst-jpg_s240x240_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=instagram.ftpe7-1.fna.fbcdn.net&_nc_cat=100&_nc_oc=Q6cZ2QFkoLADUHBFDT6FYO75coKhli-74TP8M03Uaq3_RHUfW0wpADKfmCWeP7QsJS9gAEw&_nc_ohc=CWb6U3sCExsQ7kNvwG_inOM&_nc_gid=HECwQsFJi7y4X-JdsLlPrQ&edm=APs17CUBAAAA&ccb=7-5&oh=00_Afkanec4w6e8JDNh_uvlyzonNpl7tEMqWtyC8mq1AYnITQ&oe=694C8F12&_nc_sid=10d13b"
                          totalFollowers: 145595
                        - displayName: carlyaquilino
                          uniqueId: carlyaquilino
                          avatarUrl: "https://instagram.ftpe8-2.fna.fbcdn.net/v/t51.2885-19/248557951_204822755100051_8572917585916734320_n.jpg?stp=dst-jpg_s240x240_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=instagram.ftpe8-2.fna.fbcdn.net&_nc_cat=103&_nc_oc=Q6cZ2QH7inLq7DjdKehVNa4nFFgGgfBgdUd9AO1NOiVu3MmthSZBLd7e1vPK5v8nMW8N8Fc&_nc_ohc=ysfi-qklSoMQ7kNvwEWIJFi&_nc_gid=UwvSNhhZHacIqZ02p0E12Q&edm=APs17CUBAAAA&ccb=7-5&oh=00_Afnzd1AxZxcSSPsjkQwQPCQYrEvmFpa4KI1E5gvLC4JNaQ&oe=694BCEAA&_nc_sid=10d13b"
                          totalFollowers: 432295
                        - displayName: Eddy Piñeiro
                          uniqueId: eddypineiro1
                          avatarUrl: "https://instagram.ftpe8-2.fna.fbcdn.net/v/t51.2885-19/542851144_18523402129013221_8756951106650324563_n.jpg?stp=dst-jpg_s240x240_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=instagram.ftpe8-2.fna.fbcdn.net&_nc_cat=101&_nc_oc=Q6cZ2QGZ5zyR8YCskuIe31VfmWvSjALMbRUJGzCJycoGpCo6P97DK2AlNMU51r98IflBBCQ&_nc_ohc=MQVUPrj1mskQ7kNvwGsfcVV&_nc_gid=V3D1ta5qjLIIWyGCQCxVrg&edm=APs17CUBAAAA&ccb=7-5&oh=00_Afq0A2Onj0M7KLBsAH_ciav2B46ghkiXlDrgWW_6lKZIww&oe=696444B1&_nc_sid=10d13b"
                          totalFollowers: 129246
                        - displayName: Jk Dobbins
                          uniqueId: jk.dobbins2
                          avatarUrl: "https://instagram.ftpe7-3.fna.fbcdn.net/v/t51.2885-19/345476610_976301303741043_5582859921748019435_n.jpg?stp=dst-jpg_s240x240_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDY1LmMyIn0&_nc_ht=instagram.ftpe7-3.fna.fbcdn.net&_nc_cat=103&_nc_oc=Q6cZ2QGfFbW8LZmbgS1n_Zxpa3KvwZxLqH6Elv7hFQUwo1Z9INKYcqPPztDGcUE0oQdhGp0&_nc_ohc=I8wLjvnZtBMQ7kNvwFPFus0&_nc_gid=snyZWo3_4kOIOZ4AmcP7pQ&edm=APs17CUBAAAA&ccb=7-5&oh=00_AfmIMo5UsExDh4cvbi_v2SwhDEc0DXPPFRSIZ_JjWdbhzg&oe=694BC2B8&_nc_sid=10d13b"
                          totalFollowers: 259465
                        - displayName: Khalil Mack
                          uniqueId: fiftydeuce
                          avatarUrl: "https://instagram.ftpe8-4.fna.fbcdn.net/v/t51.2885-19/279916459_1035176104076090_3086457190303627491_n.jpg?stp=dst-jpg_s240x240_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=instagram.ftpe8-4.fna.fbcdn.net&_nc_cat=102&_nc_oc=Q6cZ2QEPkSC0lw2zd0IExVUlHDjESW0AQOLAPImc7tPmS8bwtiMriVFgmwoHA9bEHZ-Ji5U&_nc_ohc=CiKmn70FOh4Q7kNvwHvzpHO&_nc_gid=7zLiM1JN2t-HvKfGm4g3lw&edm=APs17CUBAAAA&ccb=7-5&oh=00_Afm6tzuNc2PHYpTfw7Y9M3a8f-uypRoGnHmZEtuLso_spA&oe=694BD781&_nc_sid=10d13b"
                          totalFollowers: 477263
                        - displayName: Ayman Jomaa
                          uniqueId: aymanjomaa
                          avatarUrl: "https://instagram.ftpe7-1.fna.fbcdn.net/v/t51.2885-19/118715286_631565011068226_3278297634491951145_n.jpg?stp=dst-jpg_s240x240_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=instagram.ftpe7-1.fna.fbcdn.net&_nc_cat=110&_nc_oc=Q6cZ2QEh978Tjk6QPUoPpSsTWnPS1g6O1jP38ZRYKZt8a5CFJwx9xQRmEoD-aBmJqJPagt0&_nc_ohc=7BY9G553GhcQ7kNvwGsvFyT&_nc_gid=fUP20Y9GEmV3Dwql8kdnQA&edm=APs17CUBAAAA&ccb=7-5&oh=00_AfkwawYyX3Zw_fxHkCssxXJOhkfis_4t9Xq8fJUBFENGqA&oe=694CA85E&_nc_sid=10d13b"
                          totalFollowers: 200633
                        - displayName: Gabriel Landeskog
                          uniqueId: landeskog.92
                          avatarUrl: "https://instagram.ftpe8-1.fna.fbcdn.net/v/t51.2885-19/292698352_390948949767375_498949864200808832_n.jpg?stp=dst-jpg_s240x240_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby44OTYuYzIifQ&_nc_ht=instagram.ftpe8-1.fna.fbcdn.net&_nc_cat=103&_nc_oc=Q6cZ2QFEbr-H3jo4zo7ZRgVQrqsHrkOL3CG1rojHB669fbqXm-x99TTcwthlG6XW-n4l1r0&_nc_ohc=Pg5e4tXJc50Q7kNvwEbbm86&_nc_gid=YlSnEQdCUR93d7SRv_Ms-w&edm=APs17CUBAAAA&ccb=7-5&oh=00_AfksKc7_TajSM-YewKg-52ReCdJ-slQICCS1R_beqY3EqA&oe=694C5254&_nc_sid=10d13b"
                          totalFollowers: 140768
                        - displayName: Charlie McAvoy
                          uniqueId: cmcavoy25
                          avatarUrl: "https://instagram.ftpe7-4.fna.fbcdn.net/v/t51.2885-19/70788212_395379251148151_3824571332301946880_n.jpg?stp=dst-jpg_s240x240_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby40MzQuYzIifQ&_nc_ht=instagram.ftpe7-4.fna.fbcdn.net&_nc_cat=107&_nc_oc=Q6cZ2QHZWenoL6LO3bLa2gCW_8K_sd0eGoxt8uwWl3Csp_5jvh1KQoAPL-SwfJXryT7NW8g&_nc_ohc=X2cooBAKuEwQ7kNvwH9Bfyd&_nc_gid=fT3j4ijMloeoY7YGCtMMGg&edm=APs17CUBAAAA&ccb=7-5&oh=00_AfmJAkRULPF4T0l7iW63PlISpZJBzkK1MG0GagLJwN4uAA&oe=6957FD11&_nc_sid=10d13b"
                          totalFollowers: 203417
                        - displayName: Dave Crosby
                          uniqueId: davecrosby
                          avatarUrl: "https://instagram.ftpe7-2.fna.fbcdn.net/v/t51.2885-19/145464020_748268626070812_3951215151737124031_n.jpg?stp=dst-jpg_s240x240_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=instagram.ftpe7-2.fna.fbcdn.net&_nc_cat=104&_nc_oc=Q6cZ2QGSs5u_lX6PBDjsawlVkW9uxlAfICTtH-t0BX27XYkiJa1EJDMF3wIou9MKwf2DxTU&_nc_ohc=FSwaVBYI4kYQ7kNvwGWLuLQ&_nc_gid=5iYOO_1LDWhP40TpE0q61w&edm=APs17CUBAAAA&ccb=7-5&oh=00_Afr2-j0f7zr6AQZqkaNPNKHo2ZIZ_SGwhlmgV-PAl0IbWg&oe=695F5347&_nc_sid=10d13b"
                          totalFollowers: 188464
                        - displayName: Cordarrelle Patterson
                          uniqueId: ceeflashpee
                          avatarUrl: "https://instagram.ftpe8-2.fna.fbcdn.net/v/t51.2885-19/434886329_1270734607234680_7538445043132188543_n.jpg?stp=dst-jpg_s240x240_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby44MDIuYzIifQ&_nc_ht=instagram.ftpe8-2.fna.fbcdn.net&_nc_cat=100&_nc_oc=Q6cZ2QFe8lHWLtDTT6ejHZHnDWhr0sD5z-ho5k52AhhQTo-jHQ49fiWYZfbHRkV3SjC-u8Y&_nc_ohc=_zm6Rfwzy18Q7kNvwHxOK4D&_nc_gid=Tgv9R1TSj12Mxb-zyRsStA&edm=APs17CUBAAAA&ccb=7-5&oh=00_Afmla5lD2OUn0l3V6SzpCfO9HUOu-MPUji0mJHGpgIVDUw&oe=694B6855&_nc_sid=10d13b"
                          totalFollowers: 243744
                        - displayName: Kyle McCord
                          uniqueId: kylemccord
                          avatarUrl: "https://instagram.ftpe7-1.fna.fbcdn.net/v/t51.2885-19/434730669_1678511242891632_1497433174163668983_n.jpg?stp=dst-jpg_s240x240_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby45MjAuYzIifQ&_nc_ht=instagram.ftpe7-1.fna.fbcdn.net&_nc_cat=100&_nc_oc=Q6cZ2QG6QYU2yd6WrAStgxTRmsVin0gzgnSu6299RKWODWIsHlWx5YTk_cLt8KM3BnEB8TQ&_nc_ohc=p-TGJcpLXlsQ7kNvwFnlgq4&_nc_gid=BdxmyUU93ZEZ58DCYGF85Q&edm=APs17CUBAAAA&ccb=7-5&oh=00_AfnM-ci3tz8OMQ-Cc3x_NObSzJ5C6Vlanl_3qr_HxdXo8A&oe=6955121D&_nc_sid=10d13b"
                          totalFollowers: 86680
                        - displayName: Alyssa Naeher
                          uniqueId: alyssanaeher
                          avatarUrl: "https://instagram.ftpe7-2.fna.fbcdn.net/v/t51.2885-19/65606633_472080893579949_1596144713461661696_n.jpg?stp=dst-jpg_s240x240_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby43NDYuYzIifQ&_nc_ht=instagram.ftpe7-2.fna.fbcdn.net&_nc_cat=109&_nc_oc=Q6cZ2QEIgpd1o3aV-YrwFaxOnxRuPovkk3INueoRqAWFs12CulhwT9JyNd59Pagb7HzoTP4&_nc_ohc=AsKzuppolIAQ7kNvwEFHV6o&_nc_gid=1edrCo7mhy81BffVqHjJ8w&edm=APs17CUBAAAA&ccb=7-5&oh=00_Afo25K8yNcJGzGNUFMNGUFVYfRielfxZfDuMB9lBka8Q8A&oe=6966152A&_nc_sid=10d13b"
                          totalFollowers: 237434
                        - displayName: Gary Trent J.R
                          uniqueId: gtrentjr
                          avatarUrl: "https://instagram.ftpe7-1.fna.fbcdn.net/v/t51.2885-19/569761579_18532117627034398_2092621231171445035_n.jpg?stp=dst-jpg_s240x240_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby44NTQuYzIifQ&_nc_ht=instagram.ftpe7-1.fna.fbcdn.net&_nc_cat=110&_nc_oc=Q6cZ2QGthDbVWSpg25U6GAO8_VOlaYIahs-NNJGuv3eU5vHxrYOo7sovmoBaGeqcn85LWoQ&_nc_ohc=HlQMKEELB6EQ7kNvwHuAOxF&_nc_gid=Tw6NyfbOk8ZW11kZnF1NkA&edm=APs17CUBAAAA&ccb=7-5&oh=00_Afkanpi7i2S6ucfEc_LuShItfxn_-zqcnd9Rxg-fxMtjgQ&oe=694BD72C&_nc_sid=10d13b"
                          totalFollowers: 238931
                        - displayName: Erin Zariah Sanders
                          uniqueId: erinsanders
                          avatarUrl: "https://scontent-tpe1-1.cdninstagram.com/v/t51.2885-19/272252704_351084536561826_5592051303825297134_n.jpg?stp=dst-jpg_s240x240_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby44MTAuYzIifQ&_nc_ht=scontent-tpe1-1.cdninstagram.com&_nc_cat=106&_nc_oc=Q6cZ2QHczixYBpOW-zn_bBQnBAZ1Pe67561TzYCh7dnl0-N5Z60dCeDH0avFukpHpJHx67g&_nc_ohc=tPjJVRnqdHsQ7kNvwE-MKCS&_nc_gid=MRZppg8aDNe_pFv3XWEG6g&edm=APs17CUBAAAA&ccb=7-5&oh=00_AfkgbhdB29x-adc6RJlehlKQBMI4-D9xEgOxZ-aFFT--EQ&oe=694B2307&_nc_sid=10d13b"
                          totalFollowers: 457050
                        - displayName: Jamie Thompson
                          uniqueId: jamie_the_hubby
                          avatarUrl: "https://instagram.ftpe7-4.fna.fbcdn.net/v/t51.2885-19/409205662_690244596419035_8833897042509287679_n.jpg?stp=dst-jpg_s320x320_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby45NTkuYzIifQ&_nc_ht=instagram.ftpe7-4.fna.fbcdn.net&_nc_cat=107&_nc_oc=Q6cZ2QF_rRR7gx8BbGn5UluFjPP3WbFNkoa_rbkrzB6xkVKefvruUpEDo4Hi_x7Wr-9kEBA&_nc_ohc=l8yu3sb7jSMQ7kNvwH5Qdzo&_nc_gid=v5o7h9j1wVfy5ehv5smkxw&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_AflU9BiqXEGpYGgnVzxcCLFlMo1A5d4RMEsPdeIbcA7KnQ&oe=69484105&_nc_sid=8b3546"
                          totalFollowers: 139223
                        - displayName: Desmond Ridder
                          uniqueId: desmondridder
                          avatarUrl: "https://instagram.ftpe8-1.fna.fbcdn.net/v/t51.2885-19/548873689_18530076358049385_5163630305806564908_n.jpg?stp=dst-jpg_s240x240_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=instagram.ftpe8-1.fna.fbcdn.net&_nc_cat=109&_nc_oc=Q6cZ2QFcPs1asuCvZ1paalwl1ltalubAUkULNxpriJNCBYlvrDevEUpt0k69dMferQqARAM&_nc_ohc=RxSa1_VVkRUQ7kNvwGx73kN&_nc_gid=qbB39IxGOzDZOyT9CPDFWw&edm=APs17CUBAAAA&ccb=7-5&oh=00_AfmIiKqAP7KMjjO7vKGxxH7OWKkBcoP_inZEQFKq_aY3Xg&oe=695388FC&_nc_sid=10d13b"
                          totalFollowers: 82280
                        - displayName: ""
                          uniqueId: hunter.dickinson1
                          avatarUrl: "https://instagram.ftpe7-2.fna.fbcdn.net/v/t51.2885-19/306936755_644895676960569_1765270294974955198_n.jpg?stp=dst-jpg_s240x240_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMxIn0&_nc_ht=instagram.ftpe7-2.fna.fbcdn.net&_nc_cat=109&_nc_oc=Q6cZ2QHvYVIZ6gkFiw3QyQ8BVr2y2zkvk0e3vfs6rk2vI5IOGR2GlZpNlAeGtQCOQ7Rgl10&_nc_ohc=RYg430ROVYkQ7kNvwEa-xnJ&_nc_gid=Jhn9PQpZCVxW9qWQ4X08cw&edm=APs17CUBAAAA&ccb=7-5&oh=00_Afozy2C2uw3mJERYctUZU-GC81AEsDXmzjLTYb1hPxI9NQ&oe=696479F6&_nc_sid=10d13b"
                          totalFollowers: 67372
                        - displayName: Parker Ferris
                          uniqueId: parkerferris
                          avatarUrl: "https://instagram.ftpe7-3.fna.fbcdn.net/v/t51.2885-19/292490167_580820106947270_915606211603101165_n.jpg?stp=dst-jpg_s240x240_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=instagram.ftpe7-3.fna.fbcdn.net&_nc_cat=102&_nc_oc=Q6cZ2QFqPPFalgJ-ncuqB-_-ah0VwtM1htoLnzxHesp-8NopOd6YhAF459VwMBVAFIhW3Mg&_nc_ohc=TAPs4Tc9l-QQ7kNvwHGP7XX&_nc_gid=ajowb4q-MtB7eu-02g-cmQ&edm=APs17CUBAAAA&ccb=7-5&oh=00_AflYgss56A0dUL1e6H1k80oQah9ooIDaO5qPZ-_38MNI2g&oe=694BA6E8&_nc_sid=10d13b"
                          totalFollowers: 265937
                        - displayName: Scotty Miller
                          uniqueId: millertime___10
                          avatarUrl: "https://instagram.ftpe7-3.fna.fbcdn.net/v/t51.2885-19/459622939_2890327654477190_150579501633606114_n.jpg?stp=dst-jpg_s240x240_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=instagram.ftpe7-3.fna.fbcdn.net&_nc_cat=102&_nc_oc=Q6cZ2QEGzLaoo7RVifVKMcn8KRoSyabHSUxSr1QsUAPtWBnWXZ1om0RxCmRs_veAakMqf4U&_nc_ohc=lD9E4XUvFsAQ7kNvwHmN9Xz&_nc_gid=99CL77xBwjg-2OtE5oD2lA&edm=APs17CUBAAAA&ccb=7-5&oh=00_AflcHN9jyazEGNMHjUBoUzqAl0a9F8rQM3Dl2JeLMJDsfg&oe=694005C4&_nc_sid=10d13b"
                          totalFollowers: 99961
                        - displayName: Austin Bonsell
                          uniqueId: austinbonsell
                          avatarUrl: "https://scontent-tpe1-1.cdninstagram.com/v/t51.2885-19/503799274_18511577758014404_9218704193548113823_n.jpg?stp=dst-jpg_s240x240_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=scontent-tpe1-1.cdninstagram.com&_nc_cat=108&_nc_oc=Q6cZ2QHvGwS1Oq-CKuWBzLTfjYuuIBRiHNL554ANAoqimgpjA9NtLGQJWeHH4auqRnTtnk4&_nc_ohc=tB9zGuPqcHsQ7kNvwGyqNeS&_nc_gid=6dbW7dzJpEnOPnloknlMog&edm=APs17CUBAAAA&ccb=7-5&oh=00_AfoMcEIX_xjMFaAOB0lcCMO_qDaEzLQgp1Wt6AfoqaDXeQ&oe=6965490D&_nc_sid=10d13b"
                          totalFollowers: 155920
                        - displayName: Ben Jolliffe
                          uniqueId: bengunsuk
                          avatarUrl: "https://instagram.ftpe8-2.fna.fbcdn.net/v/t51.2885-19/210580691_142915981256844_4182730516684368862_n.jpg?stp=dst-jpg_s240x240_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=instagram.ftpe8-2.fna.fbcdn.net&_nc_cat=100&_nc_oc=Q6cZ2QFkMS0ceMfhbuWwH6VI2j4FCnTE_JPwil1_hlAlUZSw-OhKr2lPaiyoJvLm8rV8il8&_nc_ohc=Yl36nyNtPiEQ7kNvwFS25B5&_nc_gid=O9ESnnMiC07p0X9PS9DtNg&edm=APs17CUBAAAA&ccb=7-5&oh=00_AfnM6y3gYhdjWZt47lbALHWXjkaRcBbNtGJ0zMaBXkwsVA&oe=6952B8F7&_nc_sid=10d13b"
                          totalFollowers: 69359
                        - displayName: George Foreman
                          uniqueId: biggeorgeforeman
                          avatarUrl: "https://instagram.ftpe8-3.fna.fbcdn.net/v/t51.2885-19/26867264_828209900686326_4217467939743334400_n.jpg?stp=dst-jpg_s240x240_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby41MTIuYzIifQ&_nc_ht=instagram.ftpe8-3.fna.fbcdn.net&_nc_cat=106&_nc_oc=Q6cZ2QFLSiFjChEGZpCoZPLHhyMnf2EYBlh2Pq_k-8juUIvQCeKQzLzSl15q5P0p0zcbyrQ&_nc_ohc=SGgW7ZB2qVEQ7kNvwFWUdSr&_nc_gid=LHimXgWxClpueOyuz39trg&edm=APs17CUBAAAA&ccb=7-5&oh=00_Aflznl1Hj3JQUrYFoLhxYWQQDoczpJtvzCOBHO0GZUCIcw&oe=694C5B5F&_nc_sid=10d13b"
                          totalFollowers: 229994
                        - displayName: Katie Hamilton
                          uniqueId: katiehamilton32
                          avatarUrl: "https://instagram.ftpe8-4.fna.fbcdn.net/v/t51.2885-19/70890551_2479403752347934_113484722566332416_n.jpg?stp=dst-jpg_s240x240_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDA4LmMyIn0&_nc_ht=instagram.ftpe8-4.fna.fbcdn.net&_nc_cat=110&_nc_oc=Q6cZ2QEDwepVcujeRgIA4-QRS3083uTldHRG-UvXCj1XPcRjgEFHrb4a-RNVP1CMfIvuWmI&_nc_ohc=Og8GP3VMJpkQ7kNvwERKxmG&_nc_gid=hvM_V4sw90Hwgk6fCMVbPA&edm=APs17CUBAAAA&ccb=7-5&oh=00_AfnVPOToIgTvl1aYUW21jDzgWpxr2A79w1ifEdMTRmHMPA&oe=694BAA3A&_nc_sid=10d13b"
                          totalFollowers: 157264
                        - displayName: Katherine Webb-McCarron
                          uniqueId: _katherinewebb
                          avatarUrl: "https://instagram.ftpe7-3.fna.fbcdn.net/v/t51.2885-19/329270774_561636259252790_6350564849822256249_n.jpg?efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=instagram.ftpe7-3.fna.fbcdn.net&_nc_cat=102&_nc_oc=Q6cZ2QE8S7VbzrwoSKKFBv5nI35wBDHduu6gFbGMEkHOLmi63OO3z14Vel9dYVtofzqB8Y4&_nc_ohc=-vh-tJtHyh8Q7kNvwEtOqsY&_nc_gid=43J6rn3U29G4f3EVvIFNjw&edm=ALGbJPMBAAAA&ccb=7-5&oh=00_Afqnb4BDtJ2yQwy-7w7lFvaPcFeLpPDHk2MlMcyzH8l4kQ&oe=6964CF89&_nc_sid=7d3ac5"
                          totalFollowers: 270413
                        - displayName: JON ALMEDA
                          uniqueId: almedapottery
                          avatarUrl: "https://scontent-lax3-1.cdninstagram.com/v/t51.2885-19/20635343_118539178829980_8360183859190431744_a.jpg?efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=scontent-lax3-1.cdninstagram.com&_nc_cat=104&_nc_oc=Q6cZ2QGJwWqXdiXoBuHkHVXuGi8I21QbIY31U1Ugan_DeebVDwNnrJwpI8GHvZfW24pgBis&_nc_ohc=fYCzazVwbc4Q7kNvwF_PMZi&_nc_gid=q1jCB2CzY20zH6knVkO7pg&edm=ALGbJPMBAAAA&ccb=7-5&oh=00_Afm8739XM3gsvaB_Kci46CFEIhjbjfgzm9Uh3_hZQd9YjA&oe=694B2F4D&_nc_sid=7d3ac5"
                          totalFollowers: 231050
                        - displayName: "\U0001F9FFlil mochi ball\U0001F361\U0001F1EF\U0001F1F5"
                          uniqueId: money.moch
                          avatarUrl: "https://scontent-tpe1-1.cdninstagram.com/v/t51.2885-19/272912539_2996285020633418_3270138997931867982_n.jpg?stp=dst-jpg_s240x240_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=scontent-tpe1-1.cdninstagram.com&_nc_cat=102&_nc_oc=Q6cZ2QGDxVLbYVtWSugAYCR9KNdWlcluLZ0CBPN2J_vRNCHg_AiIs7oOGW7XxgcKp1HdwcM&_nc_ohc=X1YuAKd_yhwQ7kNvwFtgkGz&_nc_gid=7d_mznIM8tOXlUZlHcVfvQ&edm=APs17CUBAAAA&ccb=7-5&oh=00_Afk_nWtwZ3SWas_edf-N33fUoUQLAfmSG2WTxQ-AEBIpwg&oe=694C6BDC&_nc_sid=10d13b"
                          totalFollowers: 247267
                        - displayName: Caroline Arapoglou
                          uniqueId: carolinearapoglou
                          avatarUrl: "https://instagram.ftpe8-1.fna.fbcdn.net/v/t51.2885-19/401809746_1036787014192413_9148539584608230371_n.jpg?stp=dst-jpg_s240x240_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=instagram.ftpe8-1.fna.fbcdn.net&_nc_cat=109&_nc_oc=Q6cZ2QHXI7sTrpfyhMC8HXd5PlBvNqnPB91crVz6VHC2Q94Vfx4a8ZLzra-kCczWEljyduQ&_nc_ohc=jiSjooGWVQQQ7kNvwFGWC77&_nc_gid=HXtcPVJK_2ecQmmmI79Gkg&edm=APs17CUBAAAA&ccb=7-5&oh=00_Afo-kh_sekXrDCpfvo93zD4fJ_a7M6wr22R2Sd7oSi9PPg&oe=695E0612&_nc_sid=10d13b"
                          totalFollowers: 220338
                        - displayName: Ayesha Malik
                          uniqueId: spisha
                          avatarUrl: "https://scontent-tpe1-1.cdninstagram.com/v/t51.2885-19/286788625_1173762473465529_6220007826896735679_n.jpg?stp=dst-jpg_s240x240_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=scontent-tpe1-1.cdninstagram.com&_nc_cat=109&_nc_oc=Q6cZ2QFSyLg4J_Z8iEuMW8eGvQc_WERb6zBrnzMfFPERBBVzPR3tP-f5_DRF7w1QiypBbTM&_nc_ohc=ApKd_AaLXrgQ7kNvwG7xLY0&_nc_gid=LmFR3bxW335MEg9nca4mBw&edm=APs17CUBAAAA&ccb=7-5&oh=00_Afm6mt5UNx_hYxoFA1j9-SQq-8wTlVc6435sm9EtGP45qw&oe=694B2CDA&_nc_sid=10d13b"
                          totalFollowers: 121837
                        - displayName: r o s i e  c l a y t o n
                          uniqueId: rclayton
                          avatarUrl: "https://instagram.ftpe7-1.fna.fbcdn.net/v/t51.2885-19/24845506_1379627342165574_2259153523545473024_n.jpg?stp=dst-jpg_s240x240_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=instagram.ftpe7-1.fna.fbcdn.net&_nc_cat=106&_nc_oc=Q6cZ2QHSiUYiHRuwI_I0PutPIh1uE-YMOs9VRxH5iy2CAcJrUOi8dS4ltBLotgvALDgpYJo&_nc_ohc=CcRvl2FmgYEQ7kNvwEFCMul&_nc_gid=aVGgs3sPEi0vTt1kG7aYJw&edm=APs17CUBAAAA&ccb=7-5&oh=00_Afn3bS23j2IOAUxmRj48VCoIsmqkpq7foteMYKqrp-pcbA&oe=694B9361&_nc_sid=10d13b"
                          totalFollowers: 122200
                        - displayName: "Glee, The Golden Retriever"
                          uniqueId: goldens_glee
                          avatarUrl: "https://scontent-tpe1-1.cdninstagram.com/v/t51.2885-19/17494308_1382738915095344_8602364437808021504_a.jpg?stp=dst-jpg_s240x240_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=scontent-tpe1-1.cdninstagram.com&_nc_cat=100&_nc_oc=Q6cZ2QFv5EqWYJMSjW0JsmS7m1IQ7QNqtfn4ctzpick1vbElGxVha4pOZWSKrgMUom15BkA&_nc_ohc=ndHfeXIE5EYQ7kNvwFf_o-d&_nc_gid=GkbZ6xNho7taKeIRKdfKPg&edm=APs17CUBAAAA&ccb=7-5&oh=00_Afk7zvEwveOTJYcnMHvggngvWNvStw5vQGD917e0qWX1Qw&oe=694CA543&_nc_sid=10d13b"
                          totalFollowers: 262487
                        - displayName: Brandon Bryant
                          uniqueId: wallstreetpaper
                          avatarUrl: "https://scontent-tpe1-1.cdninstagram.com/v/t51.2885-19/14709641_1095099220608559_7159744915184812032_a.jpg?stp=dst-jpg_s240x240_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=scontent-tpe1-1.cdninstagram.com&_nc_cat=107&_nc_oc=Q6cZ2QH9O_qixkuMLR8DdwohMlsCynnarz1YoGPM2nYwc5yUFSTRSu2FIzvHAm6K6WYbVds&_nc_ohc=hyLWjnmywP4Q7kNvwEH46lw&_nc_gid=ti_jnrZD9CAX4SCpuRvvDw&edm=APs17CUBAAAA&ccb=7-5&oh=00_AflE7SYO5B_iGueEqdAAsoMI-D--maXjl6xWf8svwHkzeQ&oe=694C75BE&_nc_sid=10d13b"
                          totalFollowers: 180547
                        - displayName: Sonik Soundz ™
                          uniqueId: soniksoundz
                          avatarUrl: "https://instagram.ftpe8-4.fna.fbcdn.net/v/t51.2885-19/281631077_734053770954460_1844263308552883191_n.jpg?stp=dst-jpg_s240x240_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=instagram.ftpe8-4.fna.fbcdn.net&_nc_cat=104&_nc_oc=Q6cZ2QGnwQFRgmSmknXSR7nPYuwvzWGNwiYTG1Ho-INnnJvipSTLnddeczOKerEk_GGuNkc&_nc_ohc=IpQpeNzOSwsQ7kNvwHRddi9&_nc_gid=btA0Ujr2L6G39GHwE6X8pw&edm=APs17CUBAAAA&ccb=7-5&oh=00_AfnUKEjV_wqQczJ_XcvUtBJlCWe_rGFGAkCyJVvNClWchw&oe=694C08DB&_nc_sid=10d13b"
                          totalFollowers: 204925
                        - displayName: N'Keal Harry
                          uniqueId: nkealharry
                          avatarUrl: "https://instagram.ftpe8-2.fna.fbcdn.net/v/t51.2885-19/447564464_1227145485328275_7903953311877904839_n.jpg?stp=dst-jpg_s240x240_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4zMzMuYzIifQ&_nc_ht=instagram.ftpe8-2.fna.fbcdn.net&_nc_cat=103&_nc_oc=Q6cZ2QEHeRlzN9mvJzLnW8R88ex0mPuXBnOARvfZlwNdt0gXtrJrOsb3nRKobUzP4X2auNg&_nc_ohc=U2wmZ5oX_IUQ7kNvwEv2hB4&_nc_gid=nV0_OnXWox7pTSzOQ-kWNw&edm=APs17CUBAAAA&ccb=7-5&oh=00_Afl4mX2gkDNImn-CDT2OdQCptDbDI7zECGR0-cKgSjlssQ&oe=694BAE19&_nc_sid=10d13b"
                          totalFollowers: 185621
                        - displayName: J U S T I N B O B B Y
                          uniqueId: justinbobbybrescia
                          avatarUrl: "https://scontent-tpe1-1.cdninstagram.com/v/t51.2885-19/255837810_395946418837630_9052559311099136586_n.jpg?stp=dst-jpg_s240x240_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby41NjUuYzIifQ&_nc_ht=scontent-tpe1-1.cdninstagram.com&_nc_cat=110&_nc_oc=Q6cZ2QFMSHxqaCLbftkjnMlYzdx-VFXtGlqfCtjcE-b5tUk1E32sClFj5TPHxwCUsxHc3fw&_nc_ohc=bM2ayqSYyc8Q7kNvwG7AU3g&_nc_gid=EyHIxqogM5JwbipAPfbKTA&edm=APs17CUBAAAA&ccb=7-5&oh=00_AfnKE5Fr_II77AG9FVOA4XTr2Hm78dt60TegvOrDl4-5Ww&oe=694B257E&_nc_sid=10d13b"
                          totalFollowers: 177549
                        - displayName: Kyla Ross Rittman
                          uniqueId: kyla_ross96
                          avatarUrl: "https://instagram.ftpe8-4.fna.fbcdn.net/v/t51.2885-19/277621805_154954536913730_8142521335054032499_n.jpg?stp=dst-jpg_s240x240_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=instagram.ftpe8-4.fna.fbcdn.net&_nc_cat=102&_nc_oc=Q6cZ2QHLpOKih65pgGYD10G2SkWeeg5kyFdcyBCXTQwVJivwcheIWrAbOff06WCktVikzMk&_nc_ohc=aWb8J-RBxtcQ7kNvwFjPP4e&_nc_gid=_n96JroPhyJQkS38Yqu1ww&edm=APs17CUBAAAA&ccb=7-5&oh=00_Afof5l6OnCrV2ssY7wwmBTWnwClO_6LqNlEz86SxpE3xGg&oe=695F85D7&_nc_sid=10d13b"
                          totalFollowers: 373861
                        - displayName: Umair Siddiqui
                          uniqueId: officialumairs
                          avatarUrl: "https://scontent-lax3-1.cdninstagram.com/v/t51.2885-19/515894639_18520329091059518_6965012349593744087_n.jpg?stp=dst-jpg_s240x240_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=scontent-lax3-1.cdninstagram.com&_nc_cat=102&_nc_oc=Q6cZ2QHIgJbLTJjtwe7dfOEPRL4dMIMbJ8YDYOoQRW2Jv4xbYVvu7pzTepCXuTxbi9bgQmA&_nc_ohc=IJwwB6IvBMwQ7kNvwG15yUl&_nc_gid=XfCazsXCo2WBhphkOicp2Q&edm=APs17CUBAAAA&ccb=7-5&oh=00_AfkA4CmtiW8yclFICebFbTyDwyLKMSV6I4P_Gxedh-6FfA&oe=694C90B8&_nc_sid=10d13b"
                          totalFollowers: 134712
                        - displayName: Victoria Siemer
                          uniqueId: witchoria
                          avatarUrl: "https://scontent-tpe1-1.cdninstagram.com/v/t51.2885-19/88270063_506168086946262_7957531967975587840_n.jpg?efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=scontent-tpe1-1.cdninstagram.com&_nc_cat=106&_nc_oc=Q6cZ2QHgDqMFmDwpCnxg8osNE29jQpJgPEd3_IM0jKwF7eUTeMavKhINdvuIbgAB6RluutJXAMy_Dw-okG8ZcsAfigD6&_nc_ohc=O0PheucbjkwQ7kNvwGv6Juq&_nc_gid=LBTRRGCJHNoRcPZtO4HliA&edm=ALGbJPMBAAAA&ccb=7-5&oh=00_AflEdcBTkznD94wx57aJJKwJmZ6pHpaawKFSPtlWum_sMg&oe=694B55C6&_nc_sid=7d3ac5"
                          totalFollowers: 179967
                      hasNextPage: true
                      nextOffset: 50
                    creditsUsed: 1
                    creditsAvailable: 975
                    planCreditsAvailable: 900
                    purchasedCreditsAvailable: 75
                    traceId: 3be1d050c9300ccb2143d7a2b8e9f586
                    timestamp: 1767931152278
                    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 filters:
                  summary: Missing filters field
                  value:
                    success: false
                    error: "VALIDATION_ERROR"
                    message: "At least 1 filter object is required."
                    timestamp: 1770099403116
                invalid filterName:
                  summary: Invalid filterName
                  value:
                    success: false
                    error: "VALIDATION_ERROR"
                    message: "Invalid 'filterName' for Instagram. For accepted values, see: https://docs.creatordb.app/api-v3/configuring_advanced_search_filters#configuring-custom-instagram-filter-search-criteria."
                    timestamp: 1770099403116
                invalid pageSize:
                  summary: pageSize exceeds upper limit
                  value:
                    success: false
                    error: "VALIDATION_ERROR"
                    message: "Exceeded max pageSize of 100. Must be between 1 and 100."
                    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)"
  /instagram/content-search:
    post:
      summary: "Search Content"
      description: "Search Instagram reels and image posts across every creator in the CreatorDB database, using content-level and creator-level filters. Returns individual content items, each with a short summary of its creator. Without `timeRange` or a `publishTime` filter, the search covers the last 30 days. <br /><br />Each call costs 1–92 credits, set by the time window, a `description` filter, a 100K+ `followers` floor, and the content type. A search with no matches is still charged. For filters, pricing, and examples, see [Using Content Search](/api-v3/content-search)."
      operationId: "searchInstagramContent"
      tags:
        - "Instagram"
      requestBody:
        content:
          application/json:
            schema:
              type: "object"
              properties:
                filters:
                  type: "array"
                  items:
                    type: "object"
                    properties:
                      filterName:
                        type: "string"
                        description: "The field to apply the filter on."
                      op:
                        type: "string"
                        enum:
                          - "in"
                          - ">"
                          - "="
                          - "<"
                        description: "The comparison operator. Available values include `in`, `>`, `=`, `<`. String fields support: =, in. Number fields support: >, =, <. Boolean fields support: ="
                      value:
                        anyOf:
                          - type: "string"
                          - type: "number"
                          - type: "array"
                            items:
                              type: "string"
                            minItems: 1
                            maxItems: 100
                          - type: "boolean"
                        description: "Type depends on the `filterName`. - String fields accept `string` or `string[]`. - Number fields accept `number`. - Boolean fields accept `boolean`. - Operator `in` accepts `string[]`, operator `=` accepts string for `string` fields."
                      isFuzzySearch:
                        type: "boolean"
                        default: false
                        description: "When `true`, matches the value anywhere in the text. Only accepted on `description`, `hashtag`, `creatorDisplayName`, `creatorBio`. With `in`, matches content that contains any of the values (at most 10)."
                    required:
                      - "filterName"
                      - "op"
                      - "value"
                  minItems: 1
                  maxItems: 10
                  description: "Filter objects that include `filterName`, `op`, and `value`. For all accepted `filterName` values, see [Using Content Search](/api-v3/content-search#content-search-by-platform). Use `uniqueId` to search one creator's content."
                desc:
                  type: "boolean"
                  description: "Sort order for results. `true` for descending, `false` for ascending order. Default is `true`."
                sortBy:
                  type: "string"
                  enum:
                    - "likes"
                    - "comments"
                    - "engagement"
                    - "publishTime"
                    - "performanceLikes"
                    - "performanceEngagement"
                    - "followers"
                  default: "publishTime"
                  description: "The field to sort results by. Default is `publishTime`."
                pageSize:
                  type: "integer"
                  minimum: 1
                  maximum: 100
                  description: "Number of results per page. Maximum: 100."
                offset:
                  type: "integer"
                  minimum: 0
                  description: "Number of records to skip before returning results."
                timeRange:
                  type: "object"
                  properties:
                    from:
                      type: "integer"
                      minimum: 1000000000000
                      maximum: 253402300799999
                      description: "Start of the range, Unix milliseconds, **inclusive**."
                      example: 1767225600000
                    to:
                      type: "integer"
                      minimum: 1000000000000
                      maximum: 253402300799999
                      description: "End of the range, Unix milliseconds, **exclusive**. Defaults to the time of the request."
                      example: 1775001600000
                  required:
                    - "from"
                  description: "The publish-date range to search, as absolute times. Only content published inside the range is returned. Without `timeRange` or any `publishTime` filter, the search covers the last 30 days."
              required:
                - "filters"
                - "pageSize"
                - "offset"
              description: "Instagram content search request parameters. Search for Instagram content (image posts, reels) across all creators in the CreatorDB database using content-level and creator-level filters."
              example:
                filters:
                  - filterName: "hashtag"
                    op: "="
                    value: "#skincare"
                  - filterName: "postType"
                    op: "="
                    value: "reel"
                  - filterName: "likes"
                    op: ">"
                    value: 5000
                  - filterName: "publishTime"
                    op: "<"
                    value: 7
                sortBy: "likes"
                desc: true
                pageSize: 20
                offset: 0
      responses:
        "200":
          description: "Content search results."
          content:
            application/json:
              schema:
                type: "object"
                properties:
                  data:
                    type: "object"
                    properties:
                      contentList:
                        type: "array"
                        items:
                          type: "object"
                          properties:
                            contentId:
                              type: "string"
                              description: "The unique content ID. - Image post URL: `https://www.instagram.com/p/{contentId}` Reel URL: `https://www.instagram.com/reel/{contentId}`"
                              example: "DMCkc5CyZdf"
                            contentType:
                              type:
                                - "string"
                                - "null"
                              enum:
                                - "reel"
                                - "slideshow"
                                - "video"
                                - null
                              description: "Content type: `reel`, `slideshow`, or `video`. May be `null` for legacy posts that predate `postType` classification."
                              example: "reel"
                            description:
                              type: "string"
                              description: "The content caption."
                              example: "突然覺得這輩子一定要好好賺錢\n以後都搭商務艙😭😭😭"
                            thumbnail:
                              type: "string"
                              description: "Thumbnail or cover image URL of the content."
                              example: "https://www.instagram.com/p/DMCkc5CyZdf/media/?size=l"
                            url:
                              type: "string"
                              description: "Direct URL of the content."
                              example: "https://www.instagram.com/reel/DMCkc5CyZdf"
                            publishTime:
                              type: "integer"
                              minimum: 0
                              description: "Publish time, represented as a Unix timestamp in milliseconds."
                              example: 1752392905000
                            lengthSec:
                              type:
                                - "integer"
                                - "null"
                              minimum: 0
                              description: "Duration in seconds, on video content only. Not returned for slideshows. `null` when the duration is unknown."
                              example: 28
                            isSponsored:
                              type: "boolean"
                              description: "`true` if sponsored."
                              example: true
                            partneredBrands:
                              type: "array"
                              items:
                                type: "string"
                              description: "Brand IDs (returned as domains) associated with the sponsored content. Empty if the content is not sponsored."
                              example:
                                - "acer.com"
                            likes:
                              type: "integer"
                              minimum: 0
                              description: "Number of likes."
                              example: 15840
                            comments:
                              type: "integer"
                              minimum: 0
                              description: "Number of comments."
                              example: 121
                            engagementRate:
                              type: "number"
                              description: "Engagement rate, rounded to 4 decimal places. Image posts: *(likes + comments) / followers.* Reels: *(likes + comments) / plays*, or followers when plays aren't available."
                              example: 0.1201
                            hashtags:
                              type: "array"
                              items:
                                type: "string"
                              description: "Keywords in the content caption."
                              example:
                                - "#skincare"
                                - "#routine"
                            creator:
                              type: "object"
                              properties:
                                uniqueId:
                                  type: "string"
                                  description: "Account handle."
                                  example: "goodalicia"
                                displayName:
                                  type: "string"
                                  description: "Account display name."
                                  example: "愛莉莎莎 Alisasa 🐨"
                                avatarUrl:
                                  type: "string"
                                  description: "Account profile picture URL."
                                  example: "https://instagram.ftpe8-4.fna.fbcdn.net/..."
                                totalFollowers:
                                  type: "integer"
                                  minimum: 0
                                  description: "Total number of followers."
                                  example: 613344
                              required:
                                - "uniqueId"
                                - "displayName"
                                - "avatarUrl"
                                - "totalFollowers"
                              description: "Creator information for the content."
                          required:
                            - "contentId"
                            - "contentType"
                            - "description"
                            - "thumbnail"
                            - "url"
                            - "publishTime"
                            - "isSponsored"
                            - "partneredBrands"
                            - "likes"
                            - "comments"
                            - "engagementRate"
                            - "hashtags"
                            - "creator"
                          description: "A content item matching the search query"
                        description: "Content items matching the search filters."
                      totalResults:
                        type: "integer"
                        minimum: 0
                        description: "Approximate total number of content items matching the search filters. It can include a few items that no longer load."
                        example: 850
                      hasNextPage:
                        type: "boolean"
                        description: "`true` if there is a next page of results."
                        example: true
                      nextOffset:
                        type: "integer"
                        minimum: 0
                        description: "The offset value for retrieving the next page of results."
                        example: 20
                      timeRange:
                        type: "object"
                        properties:
                          from:
                            type:
                              - "integer"
                              - "null"
                            description: "Start, Unix milliseconds, inclusive. `null` only when the caller asked for a window with no start."
                            example: 1790812800000
                          to:
                            type: "integer"
                            description: "End, Unix milliseconds, exclusive."
                            example: 1792713600000
                          isDefault:
                            type: "boolean"
                            description: "`true` when the request set neither `timeRange` nor a `publishTime` filter, so the 30-day default was searched."
                            example: false
                        required:
                          - "from"
                          - "to"
                          - "isDefault"
                        description: "The publish-date window that was searched, on every response: `timeRange` narrowed by any `publishTime` filter, the `publishTime` filters alone, or the 30-day default when the request set neither. `to` is filled in with the request time when open."
                    required:
                      - "contentList"
                      - "totalResults"
                      - "hasNextPage"
                      - "nextOffset"
                      - "timeRange"
                    description: "Content search results with pagination details."
                  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: "Number of API credits remaining. Equals planCreditsAvailable plus purchasedCreditsAvailable."
                    example: 975
                  creditsUsed:
                    type: "number"
                    description: "Number of API credits consumed by this request, from the content search price grid. For details, see [Using Content Search](/api-v3/content-search#credit-cost)."
                    example: 25
                  planCreditsAvailable:
                    type: "number"
                    description: "Remaining plan credits after this request, in credits."
                    example: 900
                  purchasedCreditsAvailable:
                    type: "number"
                    description: "Remaining purchased-bucket credits after this request, in display units."
                    example: 75
                  keyCreditsAvailable:
                    type: "number"
                    description: "Remaining credits this API key can spend after this request, before reaching its spend limit. Present only when the key has a spend limit."
                    example: 4975
                  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"
                  - "planCreditsAvailable"
                  - "purchasedCreditsAvailable"
                  - "errorCode"
                  - "errorDescription"
                  - "success"
                description: "Instagram content search response."
        "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:
                fuzzy on a non-text field:
                  summary: "isFuzzySearch on a filter that is not free text"
                  value:
                    success: false
                    error: "ValidationError"
                    message: "Request validation failed"
                    errorCode: "VALIDATION_ERROR"
                    timestamp: 1793603319958
                    details:
                      - field: "filters.0.isFuzzySearch"
                        message: "isFuzzySearch is not supported for field 'country'. Allowed fields: description, hashtag, creatorDisplayName, creatorBio"
                missing offset:
                  summary: "offset is required"
                  value:
                    success: false
                    error: "ValidationError"
                    message: "Request validation failed"
                    errorCode: "VALIDATION_ERROR"
                    timestamp: 1793603319958
                    details:
                      - field: "offset"
                        message: "Invalid input: expected number, received undefined"
                window does not overlap:
                  summary: "timeRange and publishTime do not overlap"
                  value:
                    success: false
                    error: "ValidationError"
                    message: "Request validation failed"
                    errorCode: "VALIDATION_ERROR"
                    timestamp: 1793603319958
                    details:
                      - field: "timeRange"
                        message: "timeRange does not overlap the publishTime filter"
        "429":
          description: "Exceeded quota or rate limit."
          content:
            application/json:
              schema:
                type: "object"
                title: "QuotaErrorResponse"
                description: "Quota error response format."
                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)"
  # Instagram creator profile
  /instagram/submitCreators:
    post:
      tags:
        - Instagram
      summary: Submit Creators
      description: "Submit new Instagram creators to the CreatorDB database for indexing. Creators are identified by handle. Accepted creators enter a processing queue and become available through the other Instagram endpoints after their first scrape. Submissions are free of charge. You can submit up to 10,000 identifiers per API key per UTC day. This limit is shared across the YouTube, Instagram, and TikTok submit endpoints. For details, see [API Credit Usage](/api-v3/api-credit-usage). Send bare identifiers, not profile URLs. A URL doesn't cause the request to fail. Instead, the request succeeds and the response marks that entry with status `rejected`, so check the status of every entry."
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - uniqueIds
              properties:
                uniqueIds:
                  type: array
                  description: "Instagram handles to submit for indexing. Handles are case-insensitive, and a leading `@` is stripped. Leading and trailing whitespace is trimmed. Each handle is up to 30 characters and can contain letters, digits, periods (`.`), and underscores (`_`). Numeric account IDs are not accepted. Accepts 1 to 100 handles."
                  items:
                    type: string
                  minItems: 1
                  maxItems: 100
                  examples:
                    - ["cristiano", "khaby.lame"]
      x-codeSamples:
        - lang: bash
          label: cURL
          source: |
            curl -X POST "https://apiv3.creatordb.app/instagram/submitCreators" \
              -H "Content-Type: application/json" \
              -H "api-key: <YOUR_API_KEY_HERE>" \
              -d '{ "uniqueIds": ["cristiano", "khaby.lame"] }'
      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 Instagram handle, in the same submission order."
                        items:
                          type: object
                          properties:
                            uniqueId:
                              type: string
                              description: "The submitted Instagram handle."
                            status:
                              type: string
                              description: "This entry's indexing status. Entries aren't charged, regardless of their status.<br/> - `accepted`: entered the processing queue.<br/> - `done`: already indexed in the database.<br/> - `rejected`: not a valid handle, such as a profile URL.<br/> For details, see [API Credit Usage](/api-v3/api-credit-usage)."
                              enum:
                                - accepted
                                - done
                                - rejected
                            existingUniqueId:
                              type:
                                - string
                                - "null"
                              description: "Returns the existing CreatorDB identifier when the indexing status is `done`. Otherwise, `null`."
                          required:
                            - uniqueId
                            - status
                            - existingUniqueId
                    required:
                      - results
                  creditsUsed:
                    type: number
                    examples:
                      - 0
                  creditsAvailable:
                    description: "Number of API credits remaining. Equals planCreditsAvailable plus purchasedCreditsAvailable."
                    type: number
                  planCreditsAvailable:
                    type: number
                    description: "Remaining plan credits after this request, in credits."
                    examples:
                      - 900
                  purchasedCreditsAvailable:
                    type: number
                    description: "Remaining purchased-bucket credits after this request, in display units."
                    examples:
                      - 75
                  keyCreditsAvailable:
                    type: number
                    description: "Remaining credits this API key can spend after this request, before reaching its spend limit. Present only when the key has a spend limit."
                    examples:
                      - 4975
                  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
                  - creditsAvailable
                  - creditsUsed
                  - planCreditsAvailable
                  - purchasedCreditsAvailable
                  - errorCode
                  - errorDescription
                  - success
  /instagram/profile:
    post:
      tags:
        - Instagram
      summary: Get Profile Information
      description: "Retrieve basic profile information of a specified Instagram creator, including metadata such as follower 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`). For per-field pricing, see [Field and Item Costs](/api-v3/field-and-item-costs#instagram/profile). For how fractional calls work, see [Fractional Calls](/api-v3/fractional-calls)."
      operationId: getInstagramProfile
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - uniqueId
              properties:
                uniqueId:
                  type: string
                  description: "Instagram account ID. Accepts `instagram` or `@instagram` format (@ is stripped automatically)."
                  pattern: "^@?[a-zA-Z0-9._]{1,30}$"
                  minLength: 1
                  maxLength: 31
                  examples:
                    - instagram
                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. For details, see [Field and Item Costs](/api-v3/field-and-item-costs#instagram/profile)."
                  items:
                    type: string
                    enum:
                      - uniqueId
                      - displayName
                      - category
                      - avatarUrl
                      - bio
                      - isBusinessAccount
                      - isPrivateAccount
                      - isVerified
                      - hasSponsors
                      - country
                      - mainLanguage
                      - secondLanguage
                      - languages
                      - totalContents
                      - totalFollowers
                      - totalFollowing
                      - subscriberGrowth
                      - hashtags
                      - topics
                      - niches
                      - otherLinks
                      - lastPublishTime
                      - relatedCreators
                      - lastDbUpdateTime
                  examples:
                    - ["displayName", "country", "totalFollowers"]
      x-codeSamples:
        - lang: bash
          label: cURL
          source: |
            curl -X POST "https://apiv3.creatordb.app/instagram/profile" \
              -H "Content-Type: application/json" \
              -H "api-key: <YOUR_API_KEY_HERE>" \
              -d '{ "uniqueId": "cristiano", "fields": ["displayName", "country"] }'
      responses:
        "200":
          description: "Instagram creator profile information returned successfully."
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: "#/components/schemas/InstagramProfileData"
                    required:
                      - uniqueId
                      - displayName
                      - category
                      - avatarUrl
                      - bio
                      - isBusinessAccount
                      - isPrivateAccount
                      - isVerified
                      - hasSponsors
                      - country
                      - mainLanguage
                      - languages
                      - secondLanguage
                      - totalContents
                      - totalFollowers
                      - totalFollowing
                      - subscriberGrowth
                      - hashtags
                      - topics
                      - niches
                      - otherLinks
                      - lastPublishTime
                      - relatedCreators
                      - lastDbUpdateTime
                  creditsUsed:
                    type: number
                    description: "Number of API credits consumed by this request."
                    examples:
                      - 1
                  creditsAvailable:
                    type: number
                    description: "Number of API credits remaining. Equals planCreditsAvailable plus purchasedCreditsAvailable."
                    examples:
                      - -1
                  planCreditsAvailable:
                    type: number
                    description: "Remaining plan credits after this request, in credits."
                    examples:
                      - 900
                  purchasedCreditsAvailable:
                    type: number
                    description: "Remaining purchased-bucket credits after this request, in display units."
                    examples:
                      - 75
                  keyCreditsAvailable:
                    type: number
                    description: "Remaining credits this API key can spend after this request, before reaching its spend limit. Present only when the key has a spend limit."
                    examples:
                      - 4975
                  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
                  - planCreditsAvailable
                  - purchasedCreditsAvailable
              examples:
                default:
                  value:
                    data:
                      uniqueId: cristiano
                      displayName: Cristiano Ronaldo
                      category: Sportsperson
                      avatarUrl: >-
                        https://instagram.ftpe7-4.fna.fbcdn.net/v/t51.2885-19/472007201_1142000150877579_994350541752907763_n.jpg?efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=instagram.ftpe7-4.fna.fbcdn.net&_nc_cat=1&_nc_oc=Q6cZ2QHtqBG6PlzU9JR2BMFQSEMyTG3ySNQrxXzNbDtoV4jaiwe2ReIgdF8V5E0z2ehh8paPfEaFwBlyq2lB943nq7JF&_nc_ohc=OZ2xUG_Zs_MQ7kNvwFipRgY&_nc_gid=KqYk4e7CABSJyh4CSq_QKg&edm=ALGbJPMBAAAA&ccb=7-5&oh=00_Afq_AmZzttY3DR719tqBCbu2zD5NFHQFvobxIE_8cLmUdg&oe=696401DE&_nc_sid=7d3ac5
                      bio: SIUUUbscribe to my Youtube Channel!
                      isBusinessAccount: false
                      isVerified: true
                      hasSponsors: false
                      country: SAU
                      mainLanguage: eng
                      totalContents: 3995
                      totalFollowers: 670646453
                      totalFollowing: 625
                      hashtags:
                        - name: "#cr7fragances"
                          contentCount: 2
                        - name: "#cr7energy"
                          contentCount: 2
                        - name: "#cr7underwear"
                          contentCount: 1
                        - name: "#foreverforward"
                          contentCount: 1
                        - name: "#sponsored"
                          contentCount: 1
                        - name: "#7heselection"
                          contentCount: 1
                      topics:
                        - id_football_Sports
                        - id_athletessportspeople_Sports
                        - id_celebrity_Entertainment
                        - id_celebritylifestyle_Entertainment
                        - id_motivational_NonprofitsActivism
                        - id_sporttraining_Sports
                        - id_workoutexercise_Sports
                      niches:
                        - id_fitness_All
                        - id_lifestyle_All
                        - id_health_All
                        - id_wellness_All
                        - id_nutrition_All
                        - id_cr7_All
                        - id_cristianoronaldo_All
                        - id_longevity_All
                        - id_ramadankareem_All
                        - id_liveyourbestlife_All
                      otherLinks:
                        - title: Perplexity
                          url: "http://perplexity.ai/ronaldo"
                        - title: WHOOP
                          url: "http://join.whoop.com/cr7"
                        - title: AVA
                          url: "https://avacr7.com/en/"
                        - title: UR Cristiano
                          url: "https://youtube.com/@cristiano"
                      lastPublishTime: 1767707453000
                      relatedCreators:
                        - erakulis
                        - cr7lifemuseum
                        - heidiklum
                        - rauwalejandro
                        - liltunechi
                        - theweeknd
                        - erakulis.pro
                        - bellhatria
                      lastDbUpdateTime: 1767783708328
                    creditsUsed: 1
                    creditsAvailable: 975
                    planCreditsAvailable: 900
                    purchasedCreditsAvailable: 75
                    traceId: 4e143c01006170d2ff95f86e5aaeb400
                    timestamp: 1767928263490
                    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 uniqueId:
                  summary: Missing uniqueId
                  value:
                    success: false
                    error: "VALIDATION_ERROR"
                    message: "Missing required field: 'uniqueId'."
                    timestamp: 1770099403116
                invalid uniqueId:
                  summary: Invalid uniqueId format
                  value:
                    success: false
                    error: "VALIDATION_ERROR"
                    message: "Invalid 'uniqueId' format. Instagram unique IDs must be between 1 and 31 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)"
  # Instagram contact info
  /instagram/contact:
    post:
      tags:
        - Instagram
      summary: Get Contact
      description: "Retrieve the contact information of the specified Instagram creator.<br /><br /> Optionally pass `fields` in the request body to return a creator's contact information. The single available field, `emails`, is billed at the full-bundle price. The contact endpoint currently exposes only this one billable field, so fractional calls do not offer any savings yet. Fractional calls must be enabled on your API key. Otherwise, a request that includes `fields` returns a `400` error (`FractionalCallsNotEnabled`). For per-field costs, see [Field and Item Costs](/api-v3/field-and-item-costs#instagram/contact). For how fractional calls work, see [Fractional Calls](/api-v3/fractional-calls)."
      operationId: getInstagramContact
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - uniqueId
              properties:
                uniqueId:
                  type: string
                  description: "Instagram account ID. Accepts `instagram` or `@instagram` format (@ is stripped automatically)."
                  pattern: "^@?[a-zA-Z0-9._]{1,30}$"
                  minLength: 1
                  maxLength: 31
                  examples:
                    - instagram
                fields:
                  type: array
                  description: "Subset of contact fields to return. Omit or pass an empty array to return the full response at the full-bundle price. For per-field costs, see [Field and Item Costs](/api-v3/field-and-item-costs#instagram/contact)."
                  items:
                    type: string
                    enum:
                      - emails
      x-codeSamples:
        - lang: bash
          label: cURL
          source: |
            curl -X POST "https://apiv3.creatordb.app/instagram/contact" \
              -H "Content-Type: application/json" \
              -H "api-key: <YOUR_API_KEY_HERE>" \
              -d '{ "uniqueId": "iamcardib" }'
      responses:
        "200":
          description: "Instagram contact information returned successfully."
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: "#/components/schemas/InstagramContactData"
                    required:
                      - emails
                  creditsUsed:
                    type: number
                    description: "Number of API credits consumed by this request."
                    examples:
                      - 1
                  creditsAvailable:
                    type: number
                    description: "Number of API credits remaining. Equals planCreditsAvailable plus purchasedCreditsAvailable."
                    examples:
                      - -1
                  planCreditsAvailable:
                    type: number
                    description: "Remaining plan credits after this request, in credits."
                    examples:
                      - 900
                  purchasedCreditsAvailable:
                    type: number
                    description: "Remaining purchased-bucket credits after this request, in display units."
                    examples:
                      - 75
                  keyCreditsAvailable:
                    type: number
                    description: "Remaining credits this API key can spend after this request, before reaching its spend limit. Present only when the key has a spend limit."
                    examples:
                      - 4975
                  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
                  - planCreditsAvailable
                  - purchasedCreditsAvailable
              examples:
                default:
                  value:
                    data:
                      emails:
                        - dwikiryslamyo@gmail.com
                    creditsUsed: 1
                    creditsAvailable: 975
                    planCreditsAvailable: 900
                    purchasedCreditsAvailable: 75
                    traceId: 17ab5d1484d5385d464a6c951dcfe98c
                    timestamp: 1767933868517
                    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 uniqueId:
                  summary: Missing uniqueId
                  value:
                    success: false
                    error: "VALIDATION_ERROR"
                    message: "Missing required field: 'uniqueId'."
                    timestamp: 1770099403116
                invalid uniqueId:
                  summary: Invalid uniqueId format
                  value:
                    success: false
                    error: "VALIDATION_ERROR"
                    message: "Invalid 'uniqueId' format. Instagram unique IDs must be between 1 and 31 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)"
  # Instagram performance
  /instagram/performance:
    post:
      tags:
        - Instagram
      summary: Get Performance Information
      description: "Retrieve advanced performance information of a specified Instagram creator, including post activity, follower growth, engagement metrics, and content performance.<br /><br />Optionally pass `fields` in the request body to return only a subset of performance blocks. Requesting a subset bills fractionally, capped at the full-bundle price. Fractional calls must be enabled on your API key. Otherwise, a request that includes `fields` returns a `400` error (`FractionalCallsNotEnabled`). For per-field costs, see [Field and Item Costs](/api-v3/field-and-item-costs#instagram/performance). For how fractional costs work, see [Fractional Costs](/api-v3/fractional-calls)."
      operationId: getInstagramPerformance
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - uniqueId
              properties:
                uniqueId:
                  type: string
                  description: "Instagram account ID. Accepts `instagram` or `@instagram` format (@ is stripped automatically)."
                  pattern: "^@?[a-zA-Z0-9._]{1,30}$"
                  minLength: 1
                  maxLength: 31
                  examples:
                    - instagram
                fields:
                  type: array
                  description: "Subset of performance blocks to return. Omit or pass an empty array to return the full response at the full-bundle price. For per-field costs, see [Field and Item Costs](/api-v3/field-and-item-costs#instagram/performance)."
                  items:
                    type: string
                    enum:
                      - contentCountByDays
                      - ranking
                      - recentImagesGrowth
                      - recentReelsGrowth
                      - imagesPerformanceRecent
                      - reelsPerformanceRecent
      x-codeSamples:
        - lang: bash
          label: cURL
          source: |
            curl -X POST "https://apiv3.creatordb.app/instagram/performance" \
              -H "Content-Type: application/json" \
              -H "api-key: <YOUR_API_KEY_HERE>" \
              -d '{ "uniqueId": "cristiano" }'
      responses:
        "200":
          description: "Instagram performance data returned successfully."
          content:
            application/json:
              schema:
                type: object
                description: "Performance data of the specified Instagram creator returned successfully."
                properties:
                  data:
                    $ref: "#/components/schemas/InstagramPerformanceData"
                    required:
                      - contentCountByDays
                      - ranking
                      - imagesPerformanceRecent
                      - reelsPerformanceRecent
                      - recentImagesGrowth
                      - recentReelsGrowth
                  creditsUsed:
                    type: number
                    description: "Number of API credits consumed by this request."
                    examples:
                      - 1
                  creditsAvailable:
                    type: number
                    description: "Number of API credits remaining. Equals planCreditsAvailable plus purchasedCreditsAvailable."
                    examples:
                      - -1
                  planCreditsAvailable:
                    type: number
                    description: "Remaining plan credits after this request, in credits."
                    examples:
                      - 900
                  purchasedCreditsAvailable:
                    type: number
                    description: "Remaining purchased-bucket credits after this request, in display units."
                    examples:
                      - 75
                  keyCreditsAvailable:
                    type: number
                    description: "Remaining credits this API key can spend after this request, before reaching its spend limit. Present only when the key has a spend limit."
                    examples:
                      - 4975
                  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
                  - planCreditsAvailable
                  - purchasedCreditsAvailable
              examples:
                default:
                  value:
                    data:
                      contentCountByDays:
                        7d: 2
                        30d: 17
                        90d: 50
                      ranking:
                        totalFollowers:
                          global: 1
                          country: 1
                          language: 1
                        avgEngagementRate:
                          global: 0.3151
                          country: 0.2419
                          language: 0.2027
                      imagesPerformanceRecent:
                        likes:
                          all: 129460053
                          avg: 6813687
                          median: 4971626
                          min: 967242
                          max: 28938447
                        comments:
                          all: 1454317
                          avg: 76543
                          median: 44385
                          min: 9838
                          max: 402754
                        engagement:
                          avgEngagementRate: 0.0103
                          likesPerFollower: 0.0102
                          commentsPerFollower: 0.0001
                          engagementConsistency:
                            cv: 0.9764
                            medianVsMean: 0.7283
                            topBottomRatio: 11.6484
                            consistencyScore: 37
                            consistencyLevel: low
                      reelsPerformanceRecent:
                        likes:
                          all: 53411784
                          avg: 4450982
                          median: 1885484
                          min: 735003
                          max: 18386191
                        comments:
                          all: 1200876
                          avg: 100073
                          median: 31761
                          min: 9965
                          max: 631039
                        views:
                          all: 1075622364
                          avg: 89635197
                          median: 49017380
                          min: 34884947
                          max: 250628732
                        engagement:
                          avgEngagementRate: 0.0401
                          likesPerFollower: 0.0066
                          commentsPerFollower: 0.0001
                          viewsPerFollower: 0.1336
                          engagementConsistency:
                            cv: 0.4417
                            medianVsMean: 0.9014
                            topBottomRatio: 3.0797
                            consistencyScore: 56
                            consistencyLevel: moderate
                    creditsUsed: 1
                    creditsAvailable: 975
                    planCreditsAvailable: 900
                    purchasedCreditsAvailable: 75
                    traceId: 4dc65ca4b026cc141bbd44adda8f0c55
                    timestamp: 1767933681199
                    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 uniqueId:
                  summary: Missing uniqueId
                  value:
                    success: false
                    error: "VALIDATION_ERROR"
                    message: "Missing required field: 'uniqueId'."
                    timestamp: 1770099403116
                invalid uniqueId:
                  summary: Invalid uniqueId format
                  value:
                    success: false
                    error: "VALIDATION_ERROR"
                    message: "Invalid 'uniqueId' format. Instagram unique ID must be between 1 and 31 characters."
                    timestamp: 1770099403116
        "429":
          description: "Exceeded quota or rate limit."
          content:
            application/json:
              schema:
                type: object
                title: QuotaErrorResponse
                description: "Quota error response format."
                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)"
  # Instagram performance history
  /instagram/performance-history:
    get:
      tags:
        - Instagram
      summary: Get Performance History
      description: "Retrieve daily performance snapshots for a specified Instagram creator within a specific period, including upload activity, follower growth, engagement metrics, and post or reel performance. Dates are returned as Unix timestamps in milliseconds."
      operationId: getInstagramPerformanceHistory
      parameters:
        - name: uniqueId
          in: query
          description: "Instagram account ID. Accepts `instagram` or `@instagram` format (@ is stripped automatically)."
          required: true
          schema:
            type: string
            pattern: "^@?[a-zA-Z0-9._]{1,30}$"
            minLength: 1
            maxLength: 31
            examples:
              - instagram
          examples:
            default:
              value: instagram
        - name: pastDayRange
          in: query
          description: "Returns one data point per day over the requested range. For example, `30` returns the past 30 days of daily snapshots. Valid range: `1`-`400`."
          required: true
          schema:
            type: string
            pattern: '^[1-9]\d*$'
            examples:
              - "30"
      x-codeSamples:
        - lang: bash
          label: cURL
          source: |
            curl -X GET "https://apiv3.creatordb.app/instagram/performance-history?uniqueId=cristiano&pastDayRange=30" \
              -H "Content-Type: application/json" \
              -H "api-key: <YOUR_API_KEY_HERE>"
      responses:
        "200":
          description: "Instagram performance historical data returned successfully."
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: "#/components/schemas/InstagramPerformanceHistoryData"
                  creditsUsed:
                    type: number
                    description: "Number of API credits consumed by this request."
                    examples:
                      - 1
                  creditsAvailable:
                    type: number
                    description: "Number of API credits remaining. Equals planCreditsAvailable plus purchasedCreditsAvailable."
                    examples:
                      - -1
                  planCreditsAvailable:
                    type: number
                    description: "Remaining plan credits after this request, in credits."
                    examples:
                      - 900
                  purchasedCreditsAvailable:
                    type: number
                    description: "Remaining purchased-bucket credits after this request, in display units."
                    examples:
                      - 75
                  keyCreditsAvailable:
                    type: number
                    description: "Remaining credits this API key can spend after this request, before reaching its spend limit. Present only when the key has a spend limit."
                    examples:
                      - 4975
                  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
                  - planCreditsAvailable
                  - purchasedCreditsAvailable
              examples:
                default:
                  value:
                    data:
                      histories:
                        - timestamp: 1767934923420
                          totalFollowers: 670701146
                          totalFollowing: 625
                          totalContents: 3996
                          imagesPerformanceRecent:
                            likes:
                              all: 129460053
                              avg: 6813687
                              median: 4971626
                              min: 967242
                              max: 28938447
                            comments:
                              all: 1454317
                              avg: 76543
                              median: 44385
                              min: 9838
                              max: 402754
                            engagement:
                              avgEngagementRate: 0.0103
                              likesPerFollower: 0.0102
                              commentsPerFollower: 0.0001
                              engagementConsistency:
                                cv: 0.9764
                                medianVsMean: 0.7283
                                topBottomRatio: 11.6484
                                consistencyScore: 37
                                consistencyLevel: low
                          reelsPerformanceRecent:
                            likes:
                              all: 53411784
                              avg: 4450982
                              median: 1885484
                              min: 735003
                              max: 18386191
                            comments:
                              all: 1200876
                              avg: 100073
                              median: 31761
                              min: 9965
                              max: 631039
                            views:
                              all: 1075622364
                              avg: 89635197
                              median: 49017380
                              min: 34884947
                              max: 250628732
                            engagement:
                              avgEngagementRate: 0.0401
                              likesPerFollower: 0.0066
                              commentsPerFollower: 0.0001
                              viewsPerFollower: 0.1336
                              engagementConsistency:
                                cv: 0.4417
                                medianVsMean: 0.9014
                                topBottomRatio: 3.0797
                                consistencyScore: 56
                                consistencyLevel: moderate
                        - timestamp: 1767762123420
                          totalFollowers: 670646453
                          totalFollowing: 625
                          totalContents: 3995
                          imagesPerformanceRecent:
                            likes:
                              all: 132415140
                              avg: 6620757
                              median: 4925652
                              min: 962496
                              max: 28938630
                            comments:
                              all: 1474100
                              avg: 73705
                              median: 40749
                              min: 9810
                              max: 402810
                            engagement:
                              avgEngagementRate: 0.01
                              likesPerFollower: 0.0099
                              commentsPerFollower: 0.0001
                              engagementConsistency:
                                cv: 0.9832
                                medianVsMean: 0.7414
                                topBottomRatio: 11.6358
                                consistencyScore: 36
                                consistencyLevel: low
                          reelsPerformanceRecent:
                            likes:
                              all: 53196840
                              avg: 4433070
                              median: 1883337
                              min: 730553
                              max: 18364260
                            comments:
                              all: 1198032
                              avg: 99836
                              median: 31721
                              min: 9902
                              max: 630613
                            views:
                              all: 1071241248
                              avg: 89270104
                              median: 48941749
                              min: 34797482
                              max: 250347282
                            engagement:
                              avgEngagementRate: 0.0401
                              likesPerFollower: 0.0066
                              commentsPerFollower: 0.0001
                              viewsPerFollower: 0.1331
                              engagementConsistency:
                                cv: 0.4435
                                medianVsMean: 0.9003
                                topBottomRatio: 3.0964
                                consistencyScore: 56
                                consistencyLevel: moderate
                        - timestamp: 1767589323420
                          totalFollowers: 670597778
                          totalFollowing: 623
                          totalContents: 3994
                          imagesPerformanceRecent:
                            likes:
                              all: 131768280
                              avg: 6588414
                              median: 4921587
                              min: 956629
                              max: 28937300
                            comments:
                              all: 1467760
                              avg: 73388
                              median: 40549
                              min: 9786
                              max: 402852
                            engagement:
                              avgEngagementRate: 0.0099
                              likesPerFollower: 0.0098
                              commentsPerFollower: 0.0001
                              engagementConsistency:
                                cv: 0.9878
                                medianVsMean: 0.7444
                                topBottomRatio: 11.6479
                                consistencyScore: 36
                                consistencyLevel: low
                          reelsPerformanceRecent:
                            likes:
                              all: 52942068
                              avg: 4411839
                              median: 1880724
                              min: 725025
                              max: 18339536
                            comments:
                              all: 1194936
                              avg: 99578
                              median: 31710
                              min: 9798
                              max: 630010
                            views:
                              all: 1067087196
                              avg: 88923933
                              median: 48862281
                              min: 34706357
                              max: 250055783
                            engagement:
                              avgEngagementRate: 0.04
                              likesPerFollower: 0.0066
                              commentsPerFollower: 0.0001
                              viewsPerFollower: 0.1326
                              engagementConsistency:
                                cv: 0.4446
                                medianVsMean: 0.9003
                                topBottomRatio: 3.1075
                                consistencyScore: 56
                                consistencyLevel: moderate
                        - timestamp: 1767502923420
                          totalFollowers: 670481059
                          totalFollowing: 623
                          totalContents: 3994
                          imagesPerformanceRecent:
                            likes:
                              all: 129735900
                              avg: 6486795
                              median: 4759869
                              min: 952213
                              max: 28935561
                            comments:
                              all: 1440060
                              avg: 72003
                              median: 36859
                              min: 9740
                              max: 402870
                            engagement:
                              avgEngagementRate: 0.0098
                              likesPerFollower: 0.0097
                              commentsPerFollower: 0.0001
                              engagementConsistency:
                                cv: 1.0055
                                medianVsMean: 0.7307
                                topBottomRatio: 11.6489
                                consistencyScore: 36
                                consistencyLevel: low
                          reelsPerformanceRecent:
                            likes:
                              all: 52622760
                              avg: 4385230
                              median: 1878046
                              min: 720368
                              max: 18302670
                            comments:
                              all: 1191012
                              avg: 99251
                              median: 31654
                              min: 9612
                              max: 629453
                            views:
                              all: 1061905140
                              avg: 88492095
                              median: 48778214
                              min: 34603902
                              max: 249646001
                            engagement:
                              avgEngagementRate: 0.04
                              likesPerFollower: 0.0065
                              commentsPerFollower: 0.0001
                              viewsPerFollower: 0.132
                              engagementConsistency:
                                cv: 0.4452
                                medianVsMean: 0.9002
                                topBottomRatio: 3.1146
                                consistencyScore: 56
                                consistencyLevel: moderate
                        - timestamp: 1767330123420
                          totalFollowers: 670424895
                          totalFollowing: 623
                          totalContents: 3994
                          imagesPerformanceRecent:
                            likes:
                              all: 125632294
                              avg: 6612226
                              median: 4767082
                              min: 947369
                              max: 28935723
                            comments:
                              all: 1407444
                              avg: 74076
                              median: 37262
                              min: 9710
                              max: 402844
                            engagement:
                              avgEngagementRate: 0.01
                              likesPerFollower: 0.0099
                              commentsPerFollower: 0.0001
                              engagementConsistency:
                                cv: 1.0075
                                medianVsMean: 0.7206
                                topBottomRatio: 11.6901
                                consistencyScore: 36
                                consistencyLevel: low
                          reelsPerformanceRecent:
                            likes:
                              all: 52282284
                              avg: 4356857
                              median: 1875600
                              min: 715285
                              max: 18263833
                            comments:
                              all: 1187280
                              avg: 98940
                              median: 31602
                              min: 9553
                              max: 628816
                            views:
                              all: 1056432804
                              avg: 88036067
                              median: 48687463
                              min: 34492908
                              max: 249204401
                            engagement:
                              avgEngagementRate: 0.04
                              likesPerFollower: 0.0065
                              commentsPerFollower: 0.0001
                              viewsPerFollower: 0.1313
                              engagementConsistency:
                                cv: 0.4456
                                medianVsMean: 0.9005
                                topBottomRatio: 3.1209
                                consistencyScore: 55
                                consistencyLevel: moderate
                        - timestamp: 1767157323420
                          totalFollowers: 670189480
                          totalFollowing: 623
                          totalContents: 3993
                          imagesPerformanceRecent:
                            likes:
                              all: 119280942
                              avg: 6626719
                              median: 4752101
                              min: 935533
                              max: 28934893
                            comments:
                              all: 1343376
                              avg: 74632
                              median: 36863
                              min: 9619
                              max: 402837
                            engagement:
                              avgEngagementRate: 0.01
                              likesPerFollower: 0.0099
                              commentsPerFollower: 0.0001
                              engagementConsistency:
                                cv: 1.0286
                                medianVsMean: 0.714
                                topBottomRatio: 11.6896
                                consistencyScore: 36
                                consistencyLevel: low
                          reelsPerformanceRecent:
                            likes:
                              all: 47129665
                              avg: 4284515
                              median: 1676707
                              min: 704575
                              max: 18218909
                            comments:
                              all: 1132065
                              avg: 102915
                              median: 18919
                              min: 9471
                              max: 628030
                            views:
                              all: 970460920
                              avg: 88223720
                              median: 46089249
                              min: 34281432
                              max: 248650530
                            engagement:
                              avgEngagementRate: 0.038
                              likesPerFollower: 0.0064
                              commentsPerFollower: 0.0002
                              viewsPerFollower: 0.1316
                              engagementConsistency:
                                cv: 0.4562
                                medianVsMean: 0.9324
                                topBottomRatio: 2.9163
                                consistencyScore: 55
                                consistencyLevel: moderate
                        - timestamp: 1766984523420
                          totalFollowers: 670029165
                          totalFollowing: 623
                          totalContents: 3991
                          imagesPerformanceRecent:
                            likes:
                              all: 118917144
                              avg: 6606508
                              median: 4743719
                              min: 917102
                              max: 28932135
                            comments:
                              all: 1347858
                              avg: 74881
                              median: 39263
                              min: 9530
                              max: 403551
                            engagement:
                              avgEngagementRate: 0.01
                              likesPerFollower: 0.0099
                              commentsPerFollower: 0.0001
                              engagementConsistency:
                                cv: 1.0255
                                medianVsMean: 0.7149
                                topBottomRatio: 11.836
                                consistencyScore: 36
                                consistencyLevel: low
                          reelsPerformanceRecent:
                            likes:
                              all: 41178588
                              avg: 3743508
                              median: 1670761
                              min: 686785
                              max: 18153481
                            comments:
                              all: 1076878
                              avg: 97898
                              median: 18679
                              min: 9302
                              max: 626669
                            views:
                              all: 883750835
                              avg: 80340985
                              median: 46003268
                              min: 33974860
                              max: 247930800
                            engagement:
                              avgEngagementRate: 0.0362
                              likesPerFollower: 0.0056
                              commentsPerFollower: 0.0001
                              viewsPerFollower: 0.1199
                              engagementConsistency:
                                cv: 0.4451
                                medianVsMean: 0.9933
                                topBottomRatio: 2.6984
                                consistencyScore: 54
                                consistencyLevel: moderate
                        - timestamp: 1766638923420
                          totalFollowers: 669681145
                          totalFollowing: 623
                          totalContents: 3987
                          imagesPerformanceRecent:
                            likes:
                              all: 126650220
                              avg: 6332511
                              median: 4726118
                              min: 865580
                              max: 28914769
                            comments:
                              all: 1436000
                              avg: 71800
                              median: 39306
                              min: 9222
                              max: 403375
                            engagement:
                              avgEngagementRate: 0.0096
                              likesPerFollower: 0.0095
                              commentsPerFollower: 0.0001
                              engagementConsistency:
                                cv: 1.0085
                                medianVsMean: 0.743
                                topBottomRatio: 12.5075
                                consistencyScore: 36
                                consistencyLevel: low
                          reelsPerformanceRecent:
                            likes:
                              all: 41685516
                              avg: 3473793
                              median: 1544745
                              min: 648914
                              max: 18012449
                            comments:
                              all: 1083984
                              avg: 90332
                              median: 16925
                              min: 8763
                              max: 622993
                            views:
                              all: 911473272
                              avg: 75956106
                              median: 45154857
                              min: 33205644
                              max: 246259392
                            engagement:
                              avgEngagementRate: 0.0351
                              likesPerFollower: 0.0052
                              commentsPerFollower: 0.0001
                              viewsPerFollower: 0.1134
                              engagementConsistency:
                                cv: 0.4504
                                medianVsMean: 0.9829
                                topBottomRatio: 2.7633
                                consistencyScore: 54
                                consistencyLevel: moderate
                        - timestamp: 1766466123420
                          totalFollowers: 669523275
                          totalFollowing: 623
                          totalContents: 3987
                          imagesPerformanceRecent:
                            likes:
                              all: 105739020
                              avg: 5874390
                              median: 4717582
                              min: 840632
                              max: 28905751
                            comments:
                              all: 1090548
                              avg: 60586
                              median: 38589
                              min: 9047
                              max: 403385
                            engagement:
                              avgEngagementRate: 0.0089
                              likesPerFollower: 0.0088
                              commentsPerFollower: 0.0001
                              engagementConsistency:
                                cv: 1.0341
                                medianVsMean: 0.8003
                                topBottomRatio: 10.1108
                                consistencyScore: 34
                                consistencyLevel: low
                          reelsPerformanceRecent:
                            likes:
                              all: 41517552
                              avg: 3459796
                              median: 1540905
                              min: 637472
                              max: 17937850
                            comments:
                              all: 1081824
                              avg: 90152
                              median: 16832
                              min: 8416
                              max: 621742
                            views:
                              all: 907247544
                              avg: 75603962
                              median: 45093106
                              min: 32941934
                              max: 245404499
                            engagement:
                              avgEngagementRate: 0.0351
                              likesPerFollower: 0.0052
                              commentsPerFollower: 0.0001
                              viewsPerFollower: 0.1129
                              engagementConsistency:
                                cv: 0.4516
                                medianVsMean: 0.9823
                                topBottomRatio: 2.7794
                                consistencyScore: 54
                                consistencyLevel: moderate
                        - timestamp: 1766379723420
                          totalFollowers: 669404801
                          totalFollowing: 623
                          totalContents: 3986
                          imagesPerformanceRecent:
                            likes:
                              all: 99297595
                              avg: 5841035
                              median: 4613392
                              min: 820734
                              max: 28897754
                            comments:
                              all: 1042406
                              avg: 61318
                              median: 37217
                              min: 8836
                              max: 403319
                            engagement:
                              avgEngagementRate: 0.0088
                              likesPerFollower: 0.0087
                              commentsPerFollower: 0.0001
                              engagementConsistency:
                                cv: 1.0719
                                medianVsMean: 0.7877
                                topBottomRatio: 10.1687
                                consistencyScore: 33
                                consistencyLevel: low
                          reelsPerformanceRecent:
                            likes:
                              all: 41391504
                              avg: 3449292
                              median: 1537825
                              min: 625656
                              max: 17887234
                            comments:
                              all: 1080768
                              avg: 90064
                              median: 16743
                              min: 8265
                              max: 621208
                            views:
                              all: 904338336
                              avg: 75361528
                              median: 45045084
                              min: 32637457
                              max: 244844289
                            engagement:
                              avgEngagementRate: 0.0351
                              likesPerFollower: 0.0052
                              commentsPerFollower: 0.0001
                              viewsPerFollower: 0.1126
                              engagementConsistency:
                                cv: 0.4531
                                medianVsMean: 0.9823
                                topBottomRatio: 2.7971
                                consistencyScore: 54
                                consistencyLevel: moderate
                        - timestamp: 1766293323420
                          totalFollowers: 669232649
                          totalFollowing: 623
                          totalContents: 3986
                          imagesPerformanceRecent:
                            likes:
                              all: 93604016
                              avg: 5850251
                              median: 4519730
                              min: 789512
                              max: 28883343
                            comments:
                              all: 1004544
                              avg: 62784
                              median: 38504
                              min: 8679
                              max: 403179
                            engagement:
                              avgEngagementRate: 0.0088
                              likesPerFollower: 0.0087
                              commentsPerFollower: 0.0001
                              engagementConsistency:
                                cv: 1.1048
                                medianVsMean: 0.7706
                                topBottomRatio: 10.2599
                                consistencyScore: 33
                                consistencyLevel: low
                          reelsPerformanceRecent:
                            likes:
                              all: 41205276
                              avg: 3433773
                              median: 1533669
                              min: 604825
                              max: 17815656
                            comments:
                              all: 1079196
                              avg: 89933
                              median: 16665
                              min: 8076
                              max: 620152
                            views:
                              all: 900091920
                              avg: 75007660
                              median: 44974414
                              min: 31998758
                              max: 244041686
                            engagement:
                              avgEngagementRate: 0.035
                              likesPerFollower: 0.0051
                              commentsPerFollower: 0.0001
                              viewsPerFollower: 0.1121
                              engagementConsistency:
                                cv: 0.4556
                                medianVsMean: 0.9829
                                topBottomRatio: 2.8264
                                consistencyScore: 54
                                consistencyLevel: moderate
                        - timestamp: 1766206923420
                          totalFollowers: 669232649
                          totalFollowing: 623
                          totalContents: 3986
                          imagesPerformanceRecent:
                            likes:
                              all: 97416647
                              avg: 5730391
                              median: 4416254
                              min: 735186
                              max: 28849862
                            comments:
                              all: 1053337
                              avg: 61961
                              median: 39799
                              min: 8419
                              max: 402918
                            engagement:
                              avgEngagementRate: 0.0087
                              likesPerFollower: 0.0086
                              commentsPerFollower: 0.0001
                              engagementConsistency:
                                cv: 1.0936
                                medianVsMean: 0.7688
                                topBottomRatio: 10.4202
                                consistencyScore: 33
                                consistencyLevel: low
                          reelsPerformanceRecent:
                            likes:
                              all: 41125992
                              avg: 3427166
                              median: 1531659
                              min: 594221
                              max: 17792818
                            comments:
                              all: 1078692
                              avg: 89891
                              median: 16636
                              min: 8018
                              max: 619844
                            views:
                              all: 898372392
                              avg: 74864366
                              median: 44944272
                              min: 31740378
                              max: 243777711
                            engagement:
                              avgEngagementRate: 0.035
                              likesPerFollower: 0.0051
                              commentsPerFollower: 0.0001
                              viewsPerFollower: 0.1119
                              engagementConsistency:
                                cv: 0.4573
                                medianVsMean: 0.9834
                                topBottomRatio: 2.845
                                consistencyScore: 54
                                consistencyLevel: moderate
                        - timestamp: 1766120523420
                          totalFollowers: 669122041
                          totalFollowing: 623
                          totalContents: 3985
                          imagesPerformanceRecent:
                            likes:
                              all: 97416647
                              avg: 5730391
                              median: 4416254
                              min: 735186
                              max: 28849862
                            comments:
                              all: 1053337
                              avg: 61961
                              median: 39799
                              min: 8419
                              max: 402918
                            engagement:
                              avgEngagementRate: 0.0087
                              likesPerFollower: 0.0086
                              commentsPerFollower: 0.0001
                              engagementConsistency:
                                cv: 1.0936
                                medianVsMean: 0.7688
                                topBottomRatio: 10.4202
                                consistencyScore: 33
                                consistencyLevel: low
                          reelsPerformanceRecent:
                            likes:
                              all: 40877892
                              avg: 3406491
                              median: 1526515
                              min: 569654
                              max: 17688411
                            comments:
                              all: 1076280
                              avg: 89690
                              median: 16503
                              min: 7664
                              max: 618581
                            views:
                              all: 891978744
                              avg: 74331562
                              median: 44823800
                              min: 30811533
                              max: 242568633
                            engagement:
                              avgEngagementRate: 0.0349
                              likesPerFollower: 0.0051
                              commentsPerFollower: 0.0001
                              viewsPerFollower: 0.1111
                              engagementConsistency:
                                cv: 0.4593
                                medianVsMean: 0.9837
                                topBottomRatio: 2.8743
                                consistencyScore: 54
                                consistencyLevel: moderate
                        - timestamp: 1765947723420
                          totalFollowers: 669003324
                          totalFollowing: 623
                          totalContents: 3982
                          imagesPerformanceRecent:
                            likes:
                              all: 99487422
                              avg: 5527079
                              median: 4336795
                              min: 623264
                              max: 28751993
                            comments:
                              all: 1038366
                              avg: 57687
                              median: 36512
                              min: 7596
                              max: 402190
                            engagement:
                              avgEngagementRate: 0.0083
                              likesPerFollower: 0.0083
                              commentsPerFollower: 0.0001
                              engagementConsistency:
                                cv: 1.1025
                                medianVsMean: 0.7844
                                topBottomRatio: 10.7558
                                consistencyScore: 33
                                consistencyLevel: low
                          reelsPerformanceRecent:
                            likes:
                              all: 40271892
                              avg: 3355991
                              median: 1513436
                              min: 499394
                              max: 17463593
                            comments:
                              all: 1069992
                              avg: 89166
                              median: 16287
                              min: 6360
                              max: 615413
                            views:
                              all: 881244468
                              avg: 73437039
                              median: 44622694
                              min: 29071235
                              max: 240216682
                            engagement:
                              avgEngagementRate: 0.0345
                              likesPerFollower: 0.005
                              commentsPerFollower: 0.0001
                              viewsPerFollower: 0.1098
                              engagementConsistency:
                                cv: 0.4723
                                medianVsMean: 0.9905
                                topBottomRatio: 3.0294
                                consistencyScore: 53
                                consistencyLevel: moderate
                        - timestamp: 1765688523420
                          totalFollowers: 668945907
                          totalFollowing: 623
                          totalContents: 3982
                          imagesPerformanceRecent:
                            likes:
                              all: 98466584
                              avg: 5792152
                              median: 4367781
                              min: 974758
                              max: 28649924
                            comments:
                              all: 1028517
                              avg: 60501
                              median: 36952
                              min: 12155
                              max: 401632
                            engagement:
                              avgEngagementRate: 0.0087
                              likesPerFollower: 0.0087
                              commentsPerFollower: 0.0001
                              engagementConsistency:
                                cv: 1.0589
                                medianVsMean: 0.7529
                                topBottomRatio: 6.8049
                                consistencyScore: 35
                                consistencyLevel: low
                          reelsPerformanceRecent:
                            likes:
                              all: 39439125
                              avg: 3585375
                              median: 1630460
                              min: 467927
                              max: 17295265
                            comments:
                              all: 1060246
                              avg: 96386
                              median: 16885
                              min: 13180
                              max: 613313
                            views:
                              all: 839149091
                              avg: 76286281
                              median: 45353877
                              min: 27962153
                              max: 238459306
                            engagement:
                              avgEngagementRate: 0.0363
                              likesPerFollower: 0.0054
                              commentsPerFollower: 0.0001
                              viewsPerFollower: 0.114
                              engagementConsistency:
                                cv: 0.4368
                                medianVsMean: 1.0003
                                topBottomRatio: 2.5694
                                consistencyScore: 54
                                consistencyLevel: moderate
                        - timestamp: 1765515723420
                          totalFollowers: 668933651
                          totalFollowing: 623
                          totalContents: 3980
                          imagesPerformanceRecent:
                            likes:
                              all: 115448864
                              avg: 6076256
                              median: 4351354
                              min: 962732
                              max: 28538136
                            comments:
                              all: 1250485
                              avg: 65815
                              median: 39753
                              min: 12066
                              max: 400571
                            engagement:
                              avgEngagementRate: 0.0092
                              likesPerFollower: 0.0091
                              commentsPerFollower: 0.0001
                              engagementConsistency:
                                cv: 0.9627
                                medianVsMean: 0.7144
                                topBottomRatio: 7.3385
                                consistencyScore: 37
                                consistencyLevel: low
                          reelsPerformanceRecent:
                            likes:
                              all: 39011764
                              avg: 3546524
                              median: 1624284
                              min: 415644
                              max: 17055780
                            comments:
                              all: 1054801
                              avg: 95891
                              median: 16460
                              min: 12454
                              max: 610265
                            views:
                              all: 832031255
                              avg: 75639205
                              median: 45239070
                              min: 26499315
                              max: 235903716
                            engagement:
                              avgEngagementRate: 0.0361
                              likesPerFollower: 0.0053
                              commentsPerFollower: 0.0001
                              viewsPerFollower: 0.1131
                              engagementConsistency:
                                cv: 0.4418
                                medianVsMean: 1.0041
                                topBottomRatio: 2.6122
                                consistencyScore: 54
                                consistencyLevel: moderate
                    creditsUsed: 1
                    creditsAvailable: 975
                    planCreditsAvailable: 900
                    purchasedCreditsAvailable: 75
                    traceId: ea11c06423616d5fe906cc77c5a9697f
                    timestamp: 1767934923526
                    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 uniqueId:
                  summary: Missing uniqueId
                  value:
                    success: false
                    error: "VALIDATION_ERROR"
                    message: "Missing required field: 'uniqueId'."
                    timestamp: 1770099403116
                invalid pastDayRange:
                  summary: pastDayRange out of bounds
                  value:
                    success: false
                    error: "VALIDATION_ERROR"
                    message: "Request validation failed"
                    details:
                      - field: "pastDayRange"
                        message: "pastDayRange must be between 1 and 400 days"
                    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)"
  # Instagram audience demographics
  /instagram/audience:
    post:
      tags:
        - Instagram
      summary: Get Audience Demographics
      description: "Retrieve audience demographic insights for a specified Instagram creator, including country distribution, gender breakdown, and age composition. This endpoint provides detailed audience analytics to help understand creator reach, evaluate audience alignment, and support data‑driven influencer selection and campaign targeting.<br /><br />Optionally pass `fields` in the request body to return only a subset of demographic fields. You are billed for the fields you request, capped at the full-bundle price. Fractional calls must be enabled on your API key. Otherwise, a request that includes `fields` returns a `400` error (`FractionalCallsNotEnabled`). For per-field costs, see [Field and Item Costs](/api-v3/field-and-item-costs#instagram/audience). For how fractional calls work, see [Fractional Calls](/api-v3/fractional-calls)."
      operationId: getInstagramAudience
      requestBody:  
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - uniqueId
              properties:
                uniqueId:
                  type: string
                  description: "Instagram account ID. Accepts `instagram` or `@instagram` format (@ is stripped automatically)."
                  pattern: "^@?[a-zA-Z0-9._]{1,30}$"
                  minLength: 1
                  maxLength: 31
                  examples:
                    - instagram
                fields:
                  type: array
                  description: "Subset of demographic fields to return. Omit or pass an empty array to return the full response at the full-bundle price. For per-field costs, see [Field and Item Costs](/api-v3/field-and-item-costs#instagram/audience)."
                  items:  
                    type: string
                    enum:
                      - audienceLocations
                      - audienceGender
                      - audienceAvgAge
                      - audienceAgeBreakdown
      x-codeSamples:
        - lang: bash
          label: cURL
          source: |
            curl -X POST "https://apiv3.creatordb.app/instagram/audience" \
              -H "Content-Type: application/json" \
              -H "api-key: <YOUR_API_KEY_HERE>" \
              -d '{ "uniqueId": "cristiano" }'
      responses:
        "200":
          description: "Instagram audience demographic data returned successfully."
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: "#/components/schemas/InstagramAudienceData"
                    required:
                      - audienceLocations
                      - audienceGender
                      - audienceAvgAge
                      - audienceAgeBreakdown
                  creditsUsed:
                    type: number
                    description: "Number of API credits consumed by this request."
                    examples:
                      - 1
                  creditsAvailable:
                    type: number
                    description: "Number of API credits remaining. Equals planCreditsAvailable plus purchasedCreditsAvailable."
                    examples:
                      - -1
                  planCreditsAvailable:
                    type: number
                    description: "Remaining plan credits after this request, in credits."
                    examples:
                      - 900
                  purchasedCreditsAvailable:
                    type: number
                    description: "Remaining purchased-bucket credits after this request, in display units."
                    examples:
                      - 75
                  keyCreditsAvailable:
                    type: number
                    description: "Remaining credits this API key can spend after this request, before reaching its spend limit. Present only when the key has a spend limit."
                    examples:
                      - 4975
                  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
                  - planCreditsAvailable
                  - purchasedCreditsAvailable
              examples:
                default:
                  value:
                    data:
                      audienceLocations:
                        - country: USA
                          share: 0.7377
                        - country: GBR
                          share: 0.0493
                        - country: CAN
                          share: 0.0409
                      audienceGender:
                        maleRatio: 0.7752
                        femaleRatio: 0.2248
                      audienceAvgAge: 29
                      audienceAgeBreakdown:
                        - ageRange: 13-17
                          share: 0.1059
                        - ageRange: 18-24
                          share: 0.3429
                        - ageRange: 25-34
                          share: 0.313
                        - ageRange: 35-44
                          share: 0.1506
                        - ageRange: 45-54
                          share: 0.0572
                        - ageRange: 55-64
                          share: 0.0183
                        - ageRange: 65+
                          share: 0.0121
                    creditsUsed: 1
                    creditsAvailable: 975
                    planCreditsAvailable: 900
                    purchasedCreditsAvailable: 75
                    traceId: 85dab7361bacc5adc50b6d9e991d528a
                    timestamp: 1768486538433
                    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 uniqueId:
                  summary: Missing uniqueId
                  value:
                    success: false
                    error: "VALIDATION_ERROR"
                    message: "Missing required field: 'uniqueId'."
                    timestamp: 1770099403116
                invalid uniqueId:
                  summary: Invalid uniqueId format
                  value:
                    success: false
                    error: "VALIDATION_ERROR"
                    message: "Invalid 'uniqueId' format. Instagram unique ID must be between 1 and 31 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)"
  # Instagram content info
  /instagram/content-detail:
    post:
      tags:
        - Instagram
      summary: Get Content Details
      description: "Retrieve the most recent Instagram image posts and reels of a specific creator, including publish time, post description, and engagement metrics. This endpoint enables users to fetch the latest content details for visual and textual analysis or further content-based operations.<br /><br />Optionally pass `fields` in the request body to limit how many items each content-detail array returns. Each item returned is billed individually, capped at the full-bundle price. Fractional calls must be enabled on your API key. Otherwise, a request that includes `fields` returns a `400` error (`FractionalCallsNotEnabled`). For per-item costs, see [Field and Item Costs](/api-v3/field-and-item-costs#instagram/content-detail). For how fractional calls work, see [Fractional Calls](/api-v3/fractional-calls)."
      operationId: getInstagramContentDetail
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - uniqueId
              properties:
                uniqueId:
                  type: string
                  description: "Instagram account ID. Accepts `instagram` or `@instagram` format (@ is stripped automatically)."
                  pattern: "^@?[a-zA-Z0-9._]{1,30}$"
                  minLength: 1
                  maxLength: 31
                  examples:
                    - instagram
                fields:
                  type: object
                  description: "Map each content array to the number of items to return. Omit or pass an empty object to return all items at the full-bundle price. For per-item costs, see [Field and Item Costs](/api-v3/field-and-item-costs#instagram/content-detail)."
                  properties:
                    recentImages:
                      anyOf:
                        - type: integer
                          minimum: 0
                        - type: "null"
                      description: "Number of recent image posts to return. Pass `null` to skip this field and be charged 0 for it."
                      examples:
                        - 5
                    recentReels:
                      anyOf:
                        - type: integer
                          minimum: 0
                        - type: "null"
                      description: "Number of recent reels to return. Pass `null` to skip this field and be charged 0 for it."
                      examples:
                        - 5
                  additionalProperties: false
      x-codeSamples:
        - lang: bash
          label: cURL
          source: |
            curl -X POST "https://apiv3.creatordb.app/instagram/content-detail" \
              -H "Content-Type: application/json" \
              -H "api-key: <YOUR_API_KEY_HERE>" \
              -d '{ "uniqueId": "cristiano", "fields": { "recentReels": 5 } }'
      responses:
        "200":
          description: "Instagram content details returned successfully."
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: "#/components/schemas/InstagramContentDetailData"
                    required:
                      - recentImages
                      - recentReels
                  creditsUsed:
                    type: number
                    description: "Number of API credits consumed by this request."
                    examples:
                      - 1
                  creditsAvailable:
                    type: number
                    description: "Number of API credits remaining. Equals planCreditsAvailable plus purchasedCreditsAvailable."
                    examples:
                      - -1
                  planCreditsAvailable:
                    type: number
                    description: "Remaining plan credits after this request, in credits."
                    examples:
                      - 900
                  purchasedCreditsAvailable:
                    type: number
                    description: "Remaining purchased-bucket credits after this request, in display units."
                    examples:
                      - 75
                  keyCreditsAvailable:
                    type: number
                    description: "Remaining credits this API key can spend after this request, before reaching its spend limit. Present only when the key has a spend limit."
                    examples:
                      - 4975
                  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
                  - planCreditsAvailable
                  - purchasedCreditsAvailable
              examples:
                default:
                  value:
                    data:
                      recentImages:
                        - publishTime: 1767901822000
                          contentId: DTQxXIujVbM
                          isSponsored: false
                          description: "This fight isn’t over. We keep working and we will rise together!"
                          coverImageUrl: "https://www.instagram.com/p/DTQxXIujVbM/media/?size=l"
                          carouselImageUrls:
                            - "https://www.instagram.com/p/DTQxXIujVbM/media/?size=l"
                          igGeoTaggedLocation: null
                          likes: 801639
                          comments: 9269
                          engagementRate: 0.0012
                          hashtags: []
                          taggedCreators: []
                        - publishTime: 1767707453000
                          contentId: DTK-ojYCMS4
                          isSponsored: false
                          description: "Focused and ready \U0001F9BE"
                          coverImageUrl: "https://www.instagram.com/p/DTK-ojYCMS4/media/?size=l"
                          carouselImageUrls:
                            - >-
                              https://scontent.cdninstagram.com/v/t51.82787-15/610529583_18671576230056421_2230082919574148745_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=1&ig_cache_key=MzgwNDEyODI4NTYxMzg4OTE5NA%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6InhwaWRzLjE0NDB4MTgwMS5zZHIuQzMifQ%3D%3D&_nc_ohc=bXT31AbALb8Q7kNvwFGvBZB&_nc_oc=AdmDyEKAXNBiocIcvqOpM5UK3Q8gLqpOgywNptFgA-9do76FFQXuQGQfWglPRBqZaqoy7gDwSz-FBR4CmwxhqkQ_&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=f-KrGwIjrGunj1yq0L-4fw&oh=00_AfpMoD070bxVGn4GmBBesDs3_L55Q1KjSkXA7WCvSBinwA&oe=696640B0
                            - >-
                              https://scontent.cdninstagram.com/v/t51.82787-15/610797258_18671576218056421_6585837875154387424_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=1&ig_cache_key=MzgwNDEyODI4NTYyMjI4MjIwNw%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6InhwaWRzLjE0NDB4MTc5OS5zZHIuQzMifQ%3D%3D&_nc_ohc=ka7gvRAy2SMQ7kNvwF8FtzO&_nc_oc=AdmHfOMYZd_gJy7Y6ALsi64a5KXh7Er9XKDhXt2C_YN1b_o18fWUDcvXhbBNBn9YbZ2mR87GqAOL5We9pqHbD0Wn&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=f-KrGwIjrGunj1yq0L-4fw&oh=00_AfoGGLXuW20-bjfQa-q188vDuu1lyGrmwSQRrpHYeyJADA&oe=6966539A
                            - >-
                              https://scontent.cdninstagram.com/v/t51.82787-15/584388634_18671576239056421_6689684699476595415_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=1&ig_cache_key=MzgwNDEyODI4NTYyMjMxMzgyMg%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6InhwaWRzLjE0NDB4MTc5OS5zZHIuQzMifQ%3D%3D&_nc_ohc=YVrhdmUvQj0Q7kNvwHLRN4G&_nc_oc=AdmQmH1gsBFNq2kf_l6Mxw7L5WokbWsjGsDkqI8mJHZWEb0OCJINNhT7Hp81g3fewTLsZ9cxfm5kAu_lVGorQV0j&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=f-KrGwIjrGunj1yq0L-4fw&oh=00_AfoKlHcBPXbYUAiO3s9UCGAR9yZB66gZKWzPfz4Nm_j4PA&oe=69662F9F
                            - >-
                              https://scontent.cdninstagram.com/v/t51.82787-15/611269111_18671576254056421_870264414783850716_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=108&ig_cache_key=MzgwNDEyODI4NTY2NDI0MTUyNw%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6InhwaWRzLjE0NDB4MTgwMC5zZHIuQzMifQ%3D%3D&_nc_ohc=aatzjWd3ldEQ7kNvwFG-pfY&_nc_oc=AdmdcvYbzXYaNzf6QDlDXeW9SIzm0W13rV-la564xXHremMlQoaH-osN2zetrg7_Cd8AmuJoWpdyzyFc9YYAcIdD&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=f-KrGwIjrGunj1yq0L-4fw&oh=00_Afrdncwt0jVeTl0NQJMmYtBTOz392KsPYX_eE_0bMq676A&oe=69663F5E
                          igGeoTaggedLocation: null
                          likes: 3343821
                          comments: 31076
                          engagementRate: 0.005
                          hashtags: []
                          taggedCreators: []
                        - publishTime: 1767181485000
                          contentId: DS7TbdiCPa7
                          isSponsored: false
                          description: >-
                            Muitos parabéns, Mãe! Obrigado por tudo o que és e por estares sempre ao
                            meu lado. Amo-te muito ❤️
                          coverImageUrl: "https://www.instagram.com/p/DS7TbdiCPa7/media/?size=l"
                          carouselImageUrls:
                            - "https://www.instagram.com/p/DS7TbdiCPa7/media/?size=l"
                          igGeoTaggedLocation: null
                          likes: 6314962
                          comments: 62032
                          engagementRate: 0.0095
                          hashtags: []
                          taggedCreators: []
                        - publishTime: 1767127032000
                          contentId: DS5rkX1AGh-
                          isSponsored: false
                          description: "We are on the right path and we know what we need to do in 2026! \U0001F7E1\U0001F535"
                          coverImageUrl: "https://www.instagram.com/p/DS5rkX1AGh-/media/?size=l"
                          carouselImageUrls:
                            - >-
                              https://scontent.cdninstagram.com/v/t51.82787-15/606454711_18670020949056421_1538560158839278427_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=1&ig_cache_key=Mzc5OTI1OTM2NjkzMTA4OTE2NQ%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6InhwaWRzLjE0NDB4MTgwMS5zZHIuQzMifQ%3D%3D&_nc_ohc=Dtl75yjPieIQ7kNvwGOs0QY&_nc_oc=AdmtwwlacD29dyTPXgllahyjkoLwhWrqrdpVNiHxfBnKms6KTj2wfLCRYsuI6_MGoE_Py4q7qma_Qt3SFcwDXvaP&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=f-KrGwIjrGunj1yq0L-4fw&oh=00_AfoXbIgDXCU03G8qwMudfjr-cF7qOX3UFzpEBJ-p_rIrGg&oe=69665D89
                            - >-
                              https://scontent.cdninstagram.com/v/t51.82787-15/608829644_18670020958056421_377102132518794221_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=1&ig_cache_key=Mzc5OTI1OTM2NjkyMjY4MjQyNg%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6InhwaWRzLjE0NDB4MTgwMC5zZHIuQzMifQ%3D%3D&_nc_ohc=wcch-jSnd_0Q7kNvwFt7X0a&_nc_oc=AdlZIpzcVGQ-_5cpqosJJYAAaA2g8jNlVBMDmaAGKwY0AYVnBaS2L_5nO_iCaTTrGjialyRsgieTogsSWribT9qe&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=f-KrGwIjrGunj1yq0L-4fw&oh=00_Afrz1OE-ATR5qwptovM7W2KkqeS6OD6ulWat9OuM53lAnA&oe=69665519
                            - >-
                              https://scontent.cdninstagram.com/v/t51.82787-15/606960636_18670020967056421_7430034199159642171_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=1&ig_cache_key=Mzc5OTI1OTM2NzA2NTMyMDg5MA%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6InhwaWRzLjE0NDB4MTgwMC5zZHIuQzMifQ%3D%3D&_nc_ohc=0N3GZqEKOvYQ7kNvwFCSGcs&_nc_oc=AdnHyyq1YNq_ot43KISLKtAivLRg19QIRGJXTBhUXg5kChTpbGi9wcuaSG92opDQBx5VfoCsfC95BQraa0hH-yLF&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=f-KrGwIjrGunj1yq0L-4fw&oh=00_AfoGgaQHjvZCBqIhYtpnqgihGIISS7rhQFDNLcq7B55IRg&oe=69665269
                            - >-
                              https://scontent.cdninstagram.com/v/t51.82787-15/606680773_18670020976056421_5839538643603915006_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=110&ig_cache_key=Mzc5OTI1OTM2NjkzMTA3MDA3MQ%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6InhwaWRzLjE0NDB4MTgwMC5zZHIuQzMifQ%3D%3D&_nc_ohc=4uM6SY8RT7kQ7kNvwG9KWTP&_nc_oc=Adl3AS-eKUpKtrkqfToZ_ZZezs8Bzju7lsncfl7vxvk6XXRu_N73TslB72G-Er1qv70awFjQZuwxbFfbh5fhQcUF&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=f-KrGwIjrGunj1yq0L-4fw&oh=00_AfqLU2ZplONZn0FxBv5eeU2Iv9kZMfonC7f3AprpuZ9aSA&oe=69663BBD
                          igGeoTaggedLocation: null
                          likes: 3812987
                          comments: 32043
                          engagementRate: 0.0057
                          hashtags: []
                          taggedCreators:
                            - alnassr
                        - publishTime: 1766947188000
                          contentId: DS0UiwLDbYf
                          isSponsored: false
                          description: >-
                            A special moment to end the year on. I carry on with the same passion,
                            commitment and hunger as always to reach my goals. 


                            Thank you to eve
                          coverImageUrl: "https://www.instagram.com/p/DS0UiwLDbYf/media/?size=l"
                          carouselImageUrls:
                            - >-
                              https://scontent.cdninstagram.com/v/t39.30808-6/608152706_1518694569617078_1624584836312244450_n.jpg?stp=c0.89.724.724a_dst-jpg_e35_s724x724_tt6&_nc_cat=1&ig_cache_key=Mzc5Nzc1MDcyMzY0ODUwNjYxOA%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6InhwaWRzLjcyNHg5MDMuc2RyLkMzIn0%3D&_nc_ohc=uMjTG7rKu1YQ7kNvwH1H-US&_nc_oc=Adl83Pmm-38nQXa-xNl-NgPhzt-E_aDAbuVYIX131zMSXdu0YJU3m0HbR-nMLTHtqd8StbQla1N04Za_S3fjr4r9&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=f-KrGwIjrGunj1yq0L-4fw&oh=00_AfpRTZpAPUGN2k8V3O6ykaCV1VV2TlxomN245cS0zRecLQ&oe=69663662
                            - >-
                              https://scontent.cdninstagram.com/v/t39.30808-6/608954194_1518693992950469_7930921214109586041_n.jpg?stp=c0.1.1093.1364a_dst-jpg_e35_tt6&_nc_cat=1&ig_cache_key=Mzc5Nzc1MDcyMzk3NTY3NDcyOQ%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6InhwaWRzLjEwOTN4MTM2Ni5zZHIuQzMifQ%3D%3D&_nc_ohc=TCPY-esI6SYQ7kNvwHLyGi2&_nc_oc=Adm70KoeIJbc5fxWKw5WvUyT4SQ9JEOYFgI25s8MOTURFqr5l3FCArWs6NcuRy8upzRpgaMOsmukur9x9g4vA2YB&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=f-KrGwIjrGunj1yq0L-4fw&oh=00_AfqZQYNlZSOcNmjlvz8Qyqi2C_pvcHsWLZLKez_3PYFiUQ&oe=69663E2C
                            - >-
                              https://scontent.cdninstagram.com/v/t39.30808-6/606138905_1518693106283891_523667207531762695_n.jpg?stp=c0.1.1367.1706a_dst-jpg_e35_tt6&_nc_cat=1&ig_cache_key=Mzc5Nzc1MDcyMjk0Mzg5OTcyOQ%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6InhwaWRzLjEzNjd4MTcwOC5zZHIuQzMifQ%3D%3D&_nc_ohc=QgAEPLL9Z0cQ7kNvwHWWL81&_nc_oc=AdkCqREOSvRY942xOG64wdYV7F2DfCRb9hvziKgdHfKKJMpX3El7jfEmDTr-5yGoh2zZMgdmjgnUdoxHAD4QsPcY&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=f-KrGwIjrGunj1yq0L-4fw&oh=00_AfrXZegK-ifVuf-daSrLjmZikfBPyJxJsogb3VDiJFxAVQ&oe=69664725
                            - >-
                              https://scontent.cdninstagram.com/v/t39.30808-6/607137267_1518693096283892_2108178947372664993_n.jpg?stp=c0.1.1367.1706a_dst-jpg_e35_tt6&_nc_cat=1&ig_cache_key=Mzc5Nzc1MDcyMTkyMDQ0NDIwMA%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6InhwaWRzLjEzNjd4MTcwOC5zZHIuQzMifQ%3D%3D&_nc_ohc=WwSZZQ4ZyzMQ7kNvwFWA9-6&_nc_oc=AdnhxSZOTZrPO0G8CMKVHmTQ7QYoGw1c1g0xKVZ49RVdYpuXpOBMU3NvDmYzIZhbJJPKHXZXoiFxJUtw--502Kl5&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=f-KrGwIjrGunj1yq0L-4fw&oh=00_AfohsJTlsFzjLY0nqcRjlmofOYsPyMRZ5m6gtjCytNoPfw&oe=69665D3E
                          igGeoTaggedLocation: null
                          likes: 8304184
                          comments: 80377
                          engagementRate: 0.0125
                          hashtags: []
                          taggedCreators:
                            - georginagio
                        - publishTime: 1766855530000
                          contentId: DSxlt9RCKos
                          isSponsored: false
                          description: "Hard work is the way to success!"
                          coverImageUrl: "https://www.instagram.com/p/DSxlt9RCKos/media/?size=l"
                          carouselImageUrls:
                            - >-
                              https://scontent.cdninstagram.com/v/t51.82787-15/607057722_18669317761056421_6598513550874183260_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=1&ig_cache_key=Mzc5Njk4MTgzMzU3ODA3Nzg4NQ%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6InhwaWRzLjE0NDB4MTgwMC5zZHIuQzMifQ%3D%3D&_nc_ohc=v6AU7zJOPhAQ7kNvwFF0HWS&_nc_oc=AdmtTmyBG1eJlcgKKGeaLsLU-4FK9J988GQTEByiriaX3Eqh6tcn244SC1HfoEjZIJOgkJbRwuFMKmF1RAMWjVsb&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=f-KrGwIjrGunj1yq0L-4fw&oh=00_AfodQA09nyff6RfjVwJAzVUnKVFslPo3Oef9QI9er9PM6g&oe=6966485F
                            - >-
                              https://scontent.cdninstagram.com/v/t51.82787-15/608401710_18669317770056421_578978225259329278_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=1&ig_cache_key=Mzc5Njk4MTgzMzI2NzY4MjcxOA%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6InhwaWRzLjE0NDB4MTgwMC5zZHIuQzMifQ%3D%3D&_nc_ohc=8l_x-zmObE8Q7kNvwEtZ_a-&_nc_oc=Admv0G8nZlv2jtmom9xvg2uJkgafGAQiAFHn6G0h822r4ggU3eB5Z7KvoJ0sN9f9UoQNTGIjn1o4TlLm95LGWK1G&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=f-KrGwIjrGunj1yq0L-4fw&oh=00_Afp78jUJHm2JKkpjTeasBZHAUbK3qwMsEtOP88_QAEIF0w&oe=69665EDE
                            - >-
                              https://scontent.cdninstagram.com/v/t51.82787-15/607547502_18669317779056421_7588697297551117939_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=1&ig_cache_key=Mzc5Njk4MTgzMzI3NjA4MDI0MQ%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6InhwaWRzLjE0NDB4MTc5OS5zZHIuQzMifQ%3D%3D&_nc_ohc=BU45ZGsFjYkQ7kNvwGY88et&_nc_oc=AdmZtrt_sryxE5Rph59tevgndTNi4exHevz0b7oMl3eBwUThX03yXKaa2I--CzkVR5QlczextsU8g5jpTQwFUKyz&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=f-KrGwIjrGunj1yq0L-4fw&oh=00_AfqOunq7YLn8gUrQnFncrSt0mAyr6Frd6OP0or5MggFKwQ&oe=69664137
                            - >-
                              https://scontent.cdninstagram.com/v/t51.82787-15/586711759_18669317788056421_4288043490124622115_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=109&ig_cache_key=Mzc5Njk4MTgzMzU5NDg1OTIxOQ%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6InhwaWRzLjE0NDB4MTgwMC5zZHIuQzMifQ%3D%3D&_nc_ohc=fVpfV3Pv9WAQ7kNvwHEdxZO&_nc_oc=AdnSJ4IphoLbtrpMbSXs1IBpqF2O6V8d0sbA5t9WSrhPpW-BS7YIw6vfcyvPtpIrlCxTrZusSHpJ38a7r6ak_Zvf&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=f-KrGwIjrGunj1yq0L-4fw&oh=00_AfpB43iWva4bGiledVQkF19nCLRQ2GhanQIfFC55BjFOrA&oe=6966536C
                          igGeoTaggedLocation: null
                          likes: 5160491
                          comments: 53485
                          engagementRate: 0.0078
                          hashtags: []
                          taggedCreators:
                            - alnassr
                        - publishTime: 1766773115000
                          contentId: DSvIhjcAHW5
                          isSponsored: false
                          description: "Ready for more ⚽️\U0001F601"
                          coverImageUrl: "https://www.instagram.com/p/DSvIhjcAHW5/media/?size=l"
                          carouselImageUrls:
                            - >-
                              https://scontent.cdninstagram.com/v/t51.82787-15/600864819_18669122848056421_5591289704985259956_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=1&ig_cache_key=Mzc5NjI5MDQ5Mjg4MzI5MTU4Mw%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6InhwaWRzLjE0NDB4MTgwMC5zZHIuQzMifQ%3D%3D&_nc_ohc=vTMXuZDsIDsQ7kNvwGWVhQp&_nc_oc=AdkMExWDSJwCFwIWsfpi8eRWq3zUrbvRaOOGilIsUJ3mydEgwSpczTrGnbx2WlieYm2uUm31JyulD9aak8r-bd3B&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=f-KrGwIjrGunj1yq0L-4fw&oh=00_AfpyVy3TkvGIcH6ovOsTjW2yILWFHJe_AAN7ibFuBB92Hg&oe=69666291
                            - >-
                              https://scontent.cdninstagram.com/v/t51.82787-15/587798348_18669122860056421_7023170305536021744_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=1&ig_cache_key=Mzc5NjI5MDQ5Mjg5MTY4MzIzMQ%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6InhwaWRzLjE0NDB4MTgwMC5zZHIuQzMifQ%3D%3D&_nc_ohc=K9qKXe_pEWoQ7kNvwEpGIyK&_nc_oc=AdlT02w3dmgpYj1crk843v6kAAF_oKPS3PXeIe9f9eFY_38Bp-YrnW8el7SB1D90oxj1xOeFy6sHcvHIKTB8F4TA&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=f-KrGwIjrGunj1yq0L-4fw&oh=00_Afp_WoKTAtfV-OhSKbInJG5z3EpqLJPObK5AjaFLqfAxWg&oe=69662F33
                            - >-
                              https://scontent.cdninstagram.com/v/t51.82787-15/605625511_18669122872056421_5192366656564559339_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=106&ig_cache_key=Mzc5NjI5MDQ5Mjg4MzMwMzcyOQ%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6InhwaWRzLjE0NDB4MTgwMC5zZHIuQzMifQ%3D%3D&_nc_ohc=Q56pCUIsmjwQ7kNvwHMOQks&_nc_oc=Adm4B2TxY7zEh7I8tFbSGQ8LPGOXKEY-Mo_Xd4NZXTl9jg514HlzWF0hGql3MjiTIE_Qbq-z2OkCl4DXtMZz1N6Y&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=f-KrGwIjrGunj1yq0L-4fw&oh=00_AfrS4dxLJKmKznkf1aURVzOggf1z0yfaBygZb8NTNhTv_g&oe=69662C95
                            - >-
                              https://scontent.cdninstagram.com/v/t51.82787-15/607428378_18669122887056421_966989934421467884_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=111&ig_cache_key=Mzc5NjI5MDQ5Mjk1MDQxNTkwMA%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6InhwaWRzLjE0NDB4MTgwMC5zZHIuQzMifQ%3D%3D&_nc_ohc=vOx-OsWq9TEQ7kNvwGa9SmN&_nc_oc=AdlXhmFVF8K6dgztb6mSJDBBHFvtyxKqt6_iGu7btlsjROQH878eGG1wzoguW2Ecfr0PUDbd34GBTNoFsczHtqjN&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=f-KrGwIjrGunj1yq0L-4fw&oh=00_Afqk200Oh63Ps1Adp0aLDI_OS5PUCnDLOrm30f9dQqvegA&oe=6966441E
                          igGeoTaggedLocation: null
                          likes: 3812563
                          comments: 32243
                          engagementRate: 0.0057
                          hashtags: []
                          taggedCreators: []
                        - publishTime: 1766426707000
                          contentId: DSkzzZ0FdS_
                          isSponsored: false
                          description: |-
                            Fuel your confidence. CR7 Energy - feel the drive in every moment.⚡️

                            #CR7Fragances #CR7Energy
                          coverImageUrl: "https://www.instagram.com/p/DSkzzZ0FdS_/media/?size=l"
                          carouselImageUrls:
                            - >-
                              https://scontent.cdninstagram.com/v/t39.30808-6/605137028_1514456496707552_2530710364046474663_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=1&ig_cache_key=Mzc5MzM4NDYwNzgwMzg3ODMwNw%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6InhwaWRzLjEwODB4MTM1MC5zZHIuQzMifQ%3D%3D&_nc_ohc=b6RYiYxqguQQ7kNvwE0gV50&_nc_oc=Admzfzdh381IE_VMPUh4-TSiLlZQCHPqyaP8tT3hh6zGNye3AjjoSE9MMhWXSRtIHosUDxTECpqqz9hHsb-b3QhG&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=f-KrGwIjrGunj1yq0L-4fw&oh=00_AfrFWahpzyAsmv5c4cjE6ed-49MMMhjW_82AkLG59BkBSA&oe=69665806
                            - >-
                              https://scontent.cdninstagram.com/v/t39.30808-6/605188719_1514456493374219_2239047837622990473_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=101&ig_cache_key=Mzc5MzM4NDYwNzUzNTQyMTk5Mg%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6InhwaWRzLjEwODB4MTM1MC5zZHIuQzMifQ%3D%3D&_nc_ohc=8ElYT13sdEUQ7kNvwHXwyop&_nc_oc=Adk5d3RhmblAd2z4LyY4Q_R0JSIAniwxvcRTzFpN1DhOvQoMxCgjDFUH3PdULxImT6dX6VTdJRnrZiCssLLp9ece&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=f-KrGwIjrGunj1yq0L-4fw&oh=00_AfpnBVk6H3S73NVKMnjUOR3EywrmU74KcZ6DXJlu1prJrw&oe=69665417
                          igGeoTaggedLocation: null
                          likes: 4074509
                          comments: 36196
                          engagementRate: 0.0061
                          hashtags:
                            - "#cr7fragances"
                            - "#cr7energy"
                          taggedCreators: []
                        - publishTime: 1766251951000
                          contentId: DSfme6niITX
                          isSponsored: false
                          description: >-
                            This Christmas, pick a challenge and push yourself further. Break your
                            limits with @avacr7.
                          coverImageUrl: "https://www.instagram.com/p/DSfme6niITX/media/?size=l"
                          carouselImageUrls:
                            - >-
                              https://scontent.cdninstagram.com/v/t51.82787-15/603911995_18667755976056421_8987570569048868068_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=1&ig_cache_key=Mzc5MTkxODY1MTYzNzU0ODgzMw%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6InhwaWRzLjEwODB4MTM1MC5zZHIuQzMifQ%3D%3D&_nc_ohc=66JP5caiUJEQ7kNvwHUkgT5&_nc_oc=AdkXLc14bYhUiUJl5JDuWGbwG7xubNGRoz94h_wpnWD_K3kZAu7Uw0I45jcav6iZdfcPdP03srXPGmTqr7_-qiSI&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=f-KrGwIjrGunj1yq0L-4fw&oh=00_Afr70aG79uywbWu0t2o_h1vsOJQTZh8LhrmLPr9QAmhDkg&oe=69663D4B
                            - >-
                              https://scontent.cdninstagram.com/v/t51.82787-15/603086192_18667755985056421_3486008902128237110_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=110&ig_cache_key=Mzc5MTkxODY1MTYzNzU0NTcwNw%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6InhwaWRzLjEwODB4MTM1MC5zZHIuQzMifQ%3D%3D&_nc_ohc=mHlSH_gnLUYQ7kNvwGcxfjF&_nc_oc=AdkLbm_NqeqDW-eCS5s3NyKA1OKVpgbHQqTZSJD_JN4C2RoEZ4ZHZPbH6eHk0QySuX40zmKHzMl6x_DEWcAIo4Hq&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=f-KrGwIjrGunj1yq0L-4fw&oh=00_AfpNLrLFAoCBDL4-bcfzRIH3lut-M-Y4UsSadu6bwgDGKw&oe=696642E6
                          igGeoTaggedLocation: null
                          likes: 2861470
                          comments: 21035
                          engagementRate: 0.0043
                          hashtags: []
                          taggedCreators:
                            - avacr7
                        - publishTime: 1766137225000
                          contentId: DScLqP2CPbG
                          isSponsored: false
                          description: "After sauna \U0001F9D8‍♂️\U0001F605"
                          coverImageUrl: "https://www.instagram.com/p/DScLqP2CPbG/media/?size=l"
                          carouselImageUrls:
                            - "https://www.instagram.com/p/DScLqP2CPbG/media/?size=l"
                          igGeoTaggedLocation: null
                          likes: 19446033
                          comments: 347507
                          engagementRate: 0.0295
                          hashtags: []
                          taggedCreators: []
                        - publishTime: 1766080920000
                          contentId: DSagRLYiK2w
                          isSponsored: false
                          description: "Then and now, the skill never fades. \U0001F609\n10 years of #CR7Underwear."
                          coverImageUrl: "https://www.instagram.com/p/DSagRLYiK2w/media/?size=l"
                          carouselImageUrls:
                            - >-
                              https://scontent.cdninstagram.com/v/t51.82787-15/589946635_18667300435056421_6985282292540599096_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=1&ig_cache_key=Mzc5MDQ4Mzk0MDg5Nzc2ODQyOQ%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6InhwaWRzLjEwODB4MTM1MC5zZHIuQzMifQ%3D%3D&_nc_ohc=B5y8APjTRbYQ7kNvwG13Xw1&_nc_oc=Adla0vTpoRDCgMzJ1rhYMrqvYzfSpcxpGZCDMO7BeJ2Bhiu6Q1U-1ucpDVv0j1VX2bsE7F43ui28KePdXW6ICAsO&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=f-KrGwIjrGunj1yq0L-4fw&oh=00_AfrYm8p5Ozv1xs5GzREAvrnN4pXYsx3_6ESYUnj6IBhUrA&oe=69666223
                            - >-
                              https://scontent.cdninstagram.com/v/t51.82787-15/586654598_18667300438056421_3484330116263856152_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=111&ig_cache_key=Mzc5MDQ4Mzk0MDg4OTM1OTY5MA%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6InhwaWRzLjEwODB4MTM1MC5zZHIuQzMifQ%3D%3D&_nc_ohc=t4VXIMZN_OcQ7kNvwELL4b1&_nc_oc=AdlAnkfaMhcSty_dpcAN9X8Jbm00BBSeHyLwBf6kHohNE6Ai07-tPZoeAReyjqJYNUDIEDy4Mr99PcsO12swRqZC&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=f-KrGwIjrGunj1yq0L-4fw&oh=00_AfpCxMOSwPA6JeFMQUgZz4Tx8NTF1xQ5TcTjhybXJWjB1w&oe=69663A46
                          igGeoTaggedLocation: null
                          likes: 6891774
                          comments: 50815
                          engagementRate: 0.0104
                          hashtags:
                            - "#cr7underwear"
                          taggedCreators: []
                        - publishTime: 1765991201000
                          contentId: DSX1JG-CHvf
                          isSponsored: false
                          description: "One step at a time \U0001F44D\U0001F3FC"
                          coverImageUrl: "https://www.instagram.com/p/DSX1JG-CHvf/media/?size=l"
                          carouselImageUrls:
                            - >-
                              https://scontent.cdninstagram.com/v/t51.82787-15/588091181_18667080790056421_4359101660269363876_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=1&ig_cache_key=Mzc4OTczMTMyMjI4NjA0OTQzMw%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6InhwaWRzLjE0NDB4MTgwMC5zZHIuQzMifQ%3D%3D&_nc_ohc=0v1eesYx1JQQ7kNvwGDxVCU&_nc_oc=AdkBsvDQ4fxQpU1rAV3YKf3yKfI75UJqBv1qsFyVXrr1OnPSIoslgItW4czQCHtuFK1MQq4RqzDbvx9shTC6BBRc&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=f-KrGwIjrGunj1yq0L-4fw&oh=00_AfqpF-8N0zFZgc3P_oIiSHTDfCTbl1cZia1sAC6WSmQixQ&oe=69664284
                            - >-
                              https://scontent.cdninstagram.com/v/t51.82787-15/588164443_18667080799056421_7681766630214167413_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=109&ig_cache_key=Mzc4OTczMTMyMjI2OTMyMTQ2Mw%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6InhwaWRzLjE0NDB4MTc5OS5zZHIuQzMifQ%3D%3D&_nc_ohc=FrNExcaywgsQ7kNvwH0KdQE&_nc_oc=AdlAWLG3wZvWwpuiKAhK1H7_zYJB9Oc0X1YNx50KcqisFzcGQMtJwOrvz8LihKBFIfjSC2hkKzE9fvjMArEv4cww&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=f-KrGwIjrGunj1yq0L-4fw&oh=00_AfrkayauehRY0shCihYZLWBEP1XFabndxWpE54LK33KaWw&oe=69662C9F
                            - >-
                              https://scontent.cdninstagram.com/v/t51.82787-15/589025712_18667080808056421_4115222855818571159_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=110&ig_cache_key=Mzc4OTczMTMyMjMxMTIxNjU0Mg%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6InhwaWRzLjE0NDB4MTgwMC5zZHIuQzMifQ%3D%3D&_nc_ohc=va8dnN4fVH8Q7kNvwHU8HCS&_nc_oc=AdlcHdoHNO6dE0ssZDMq4LmfYSgCbL9-Gk_GBkhPcpg4vUEKMtgsPT4I7LRmakcpAViGH4P8WWxePkn5qlK8x0DO&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=f-KrGwIjrGunj1yq0L-4fw&oh=00_Afo_-vN3HSWqrLgnBlGuWyGdmwabq5l2BP282_O0KeWnew&oe=6966442A
                          igGeoTaggedLocation: null
                          likes: 6629750
                          comments: 44385
                          engagementRate: 0.01
                          hashtags: []
                          taggedCreators:
                            - alnassr
                        - publishTime: 1765707689000
                          contentId: DSPYYsjCK5h
                          isSponsored: false
                          description: "✌\U0001F3FD"
                          coverImageUrl: "https://www.instagram.com/p/DSPYYsjCK5h/media/?size=l"
                          carouselImageUrls:
                            - "https://www.instagram.com/p/DSPYYsjCK5h/media/?size=l"
                          igGeoTaggedLocation: null
                          likes: 6391082
                          comments: 76150
                          engagementRate: 0.0096
                          hashtags: []
                          taggedCreators: []
                        - publishTime: 1765564421000
                          contentId: DSLHHeBFO-c
                          isSponsored: false
                          description: "Wherever you play, these bands keep you ready for every moment. Are you home or away? \U0001F440\U0001F447"
                          coverImageUrl: "https://www.instagram.com/p/DSLHHeBFO-c/media/?size=l"
                          carouselImageUrls:
                            - >-
                              https://scontent.cdninstagram.com/v/t51.82787-15/589392008_18552024283016159_1425048830652491957_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=1&ig_cache_key=Mzc4NjE1MTE0MTM2NjI2MTIyNQ%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6InhwaWRzLjE0NDB4MTgwMC5zZHIuQzMifQ%3D%3D&_nc_ohc=ymsQIDEMEKUQ7kNvwEPMKZd&_nc_oc=Adn7AqpKLibFOyg7usig68n73Un-q6Y2-SfNIRbvp1Bal8bHhPyZswMPEF4P3EXUQdSvp2f0zLtHdmprCYoBZ8Kt&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=f-KrGwIjrGunj1yq0L-4fw&oh=00_AfoCbFLo-WuGBfMRpxtGhmbxgIq6bNLCKj5S5J1g6aYI2w&oe=696637B6
                            - >-
                              https://scontent.cdninstagram.com/v/t51.82787-15/598601123_18552024274016159_6513637656102772075_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=111&ig_cache_key=Mzc4NjE1MTE0MTY2ODI4ODY1NA%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6InhwaWRzLjE0NDB4MTgwMC5zZHIuQzMifQ%3D%3D&_nc_ohc=zK1nGZpBoRwQ7kNvwHDQs2p&_nc_oc=AdmmHuQaKXaLTZUmQBFKXckAnx5Gm-eFv3wK5Zzov99bPvKIWVvL1mVVgXwR8tTyNPQj3XpT2ttYenfbBPeoxYri&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=f-KrGwIjrGunj1yq0L-4fw&oh=00_Afrk1SlVVG0v50-RqM7T0sKHG80TgEwHL3bn9LYEeP8hkA&oe=696638EF
                          igGeoTaggedLocation: null
                          likes: 967242
                          comments: 9838
                          engagementRate: 0.0015
                          hashtags: []
                          taggedCreators:
                            - cristiano
                        - publishTime: 1765023832000
                          contentId: DR7ACEHiP-w
                          isSponsored: false
                          description: "\U0001F9BE"
                          coverImageUrl: "https://www.instagram.com/p/DR7ACEHiP-w/media/?size=l"
                          carouselImageUrls:
                            - >-
                              https://scontent.cdninstagram.com/v/t51.82787-15/587817621_18664871770056421_692766851163219489_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=1&ig_cache_key=Mzc4MTYxNjQzNjY1Mzg4MjAxMQ%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6InhwaWRzLjEzNzV4MTcyMC5zZHIuQzMifQ%3D%3D&_nc_ohc=EJD-yz9uy84Q7kNvwGt-1C0&_nc_oc=AdkfMrvq31bwdVFuw0UIfDRjoFKA-iEyCAiOquXAaoCX61XTLWlRfE_3rfhcML9QHOFjIm5rpzrk2iJpUfL2kBbZ&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=f-KrGwIjrGunj1yq0L-4fw&oh=00_Afqu70Os6GgkePqzAU21K3T4qxF5zzB3eQZx_hRJLVxD8g&oe=6966627C
                            - >-
                              https://scontent.cdninstagram.com/v/t51.82787-15/590679760_18664871785056421_3165036813401116146_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=109&ig_cache_key=Mzc4MTYxNjQzNjM0MzUwOTQ3Mw%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6InhwaWRzLjE0NDB4MTgwMC5zZHIuQzMifQ%3D%3D&_nc_ohc=0zkHaW7dWJYQ7kNvwHtdEfW&_nc_oc=AdmevfvbqjhlbdgsfGZ9fSG7WspWsdkEqa-HeqpB1pZwXv6aqAPpBqCDH-0XUQVNre-X96fCoVOjKyAuwBfLpOfL&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=f-KrGwIjrGunj1yq0L-4fw&oh=00_Afo3wfiJwFbrj2VXETWEP9GSyWlWKNMDYMe_2mXYLBml0A&oe=69665AEF
                            - >-
                              https://scontent.cdninstagram.com/v/t51.82787-15/589646088_18664871800056421_3640156764905315815_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=106&ig_cache_key=Mzc4MTYxNjQzNjM0MzUwMjkzNg%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6InhwaWRzLjE0NDB4MTgwMC5zZHIuQzMifQ%3D%3D&_nc_ohc=klatoMGH4AAQ7kNvwFyNsPi&_nc_oc=AdmRwWNvOX6nN1YsL7Ul4qFCEENFpTs0Z6XXu-uzPHSaZ71POdZINxuOWfYmNIWyw7Ll0gRF8UFgvVG4iKiKvYEO&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=f-KrGwIjrGunj1yq0L-4fw&oh=00_Afq2DrK43h9i6XTakdX6mo_xaXiEnhkllUb1JroXZkW1pQ&oe=69663A18
                            - >-
                              https://scontent.cdninstagram.com/v/t51.82787-15/589159539_18664871803056421_3778960796661435567_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=101&ig_cache_key=Mzc4MTYxNjQzNjMzNTA5ODQxNQ%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6InhwaWRzLjE0NDB4MTgwMC5zZHIuQzMifQ%3D%3D&_nc_ohc=fyrcTQV2OuYQ7kNvwEpnksx&_nc_oc=AdlHGhc3-5N-ou1hl_pSvkaiwgmfrBsReV0K7jprLnaWRwIhQTSdgTJw8SXMLnX1ROYQsAcW2U1Df241gvtxGl8x&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=f-KrGwIjrGunj1yq0L-4fw&oh=00_AfqIP7mSbqDBGUBOCXKwaEClO_UpNshZN98jWc9nNJfwaw&oe=696660B6
                          igGeoTaggedLocation: null
                          likes: 4971626
                          comments: 46220
                          engagementRate: 0.0075
                          hashtags: []
                          taggedCreators: []
                        - publishTime: 1764320670000
                          contentId: DRmC24WiKDg
                          isSponsored: false
                          description: "I’m always pushing to feel my best. @whoop helps me do that. \U0001F4AA\U0001F3FC\n\nMake this the season you invest in better health with the best WHOOP offe"
                          coverImageUrl: "https://www.instagram.com/p/DRmC24WiKDg/media/?size=l"
                          carouselImageUrls:
                            - >-
                              https://scontent.cdninstagram.com/v/t51.82787-15/587814439_18663342988056421_7554778705471755120_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=102&ig_cache_key=Mzc3NTcxNzg5MzAxMTQ1Mjc0Mg%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6InhwaWRzLjE0NDB4MTgwMC5zZHIuQzMifQ%3D%3D&_nc_ohc=WkClqYQ6dxoQ7kNvwF-eCgB&_nc_oc=AdlK33fe1u55LgLUJrwzAYn5RdENQ8O3Fi_s3yTdW3sECSvJcqlzk3l3k8rWUN3v4VxEemPpoTU2E7Daf3mxVs2H&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=f-KrGwIjrGunj1yq0L-4fw&oh=00_AfomJdU3WdJwSHd2lCfJL_r34ZEdyQJd7iFRLX8LQkIk8Q&oe=69665831
                            - >-
                              https://scontent.cdninstagram.com/v/t51.82787-15/587814761_18663342997056421_389571138540889032_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=103&ig_cache_key=Mzc3NTcxNzg5Mjk5NDY0NjA4OA%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6InhwaWRzLjE0NDB4MTgwMC5zZHIuQzMifQ%3D%3D&_nc_ohc=zF1GWN66sIYQ7kNvwGfy1Us&_nc_oc=Adnd-zk1Zqi6--6gMPKixnV726kFMhG8fDl5G6I9Nsac9WgXM59tq48GPW4XeWPZy_1Qw-jzClGuLL_RSquC5G2j&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=f-KrGwIjrGunj1yq0L-4fw&oh=00_AfqWKCFP35MgqdVubJnWTBO_KQMm_Be_nF3IQJ7PBz3D4w&oe=69662F62
                          igGeoTaggedLocation: null
                          likes: 4886717
                          comments: 28796
                          engagementRate: 0.0073
                          hashtags: []
                          taggedCreators: []
                        - publishTime: 1764236713000
                          contentId: DRjiuM0iLFj
                          isSponsored: false
                          description: "Recovery is key to my success \U0001F511 \n\nDon’t miss your chance to recover with top technology. @avacr7 is now on Black Friday with up to 50% off "
                          coverImageUrl: "https://www.instagram.com/p/DRjiuM0iLFj/media/?size=l"
                          carouselImageUrls:
                            - >-
                              https://scontent.cdninstagram.com/v/t51.82787-15/587486867_18663181369056421_8763523447249105261_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=1&ig_cache_key=Mzc3NTAxMzYwNjA0NDI2OTcyNQ%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6InhwaWRzLjEwMDF4MTMzNC5zZHIuQzMifQ%3D%3D&_nc_ohc=u9uZ6mUH4sAQ7kNvwHTfOx6&_nc_oc=AdmzqmsfesS05OrOZXA8BsGYtLGR7p9499kdhuPg7IDP7YL2c1eLQOPTjDrhfWAgE4o6vqsLh5Pvp5ZEVm9gbYgp&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=f-KrGwIjrGunj1yq0L-4fw&oh=00_AfoxLCk0cZ-H03qrjepFHrJKHWfNG_j2hTv51vyTzyz80w&oe=69666239
                            - >-
                              https://scontent.cdninstagram.com/v/t51.82787-15/587081287_18663181378056421_8138630744248108341_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=105&ig_cache_key=Mzc3NTAxMzYwNjA0NDI0NDcwMg%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6InhwaWRzLjEwMDF4MTMzNC5zZHIuQzMifQ%3D%3D&_nc_ohc=rTejRFpLRpwQ7kNvwH6Jppa&_nc_oc=AdmYfcdAyvWLWQEMHF263ubY6W6xkIOnQCjCQjUhF1tyHGUUV1imbr8f3ZzaaucU82XrHZTkucj6_XBVFavfuAT7&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=f-KrGwIjrGunj1yq0L-4fw&oh=00_Afq9XITiH79ZZZ7yEIbr_2cqCZTl41s5OrJOnA9fT5y-iw&oe=69665340
                            - >-
                              https://scontent.cdninstagram.com/v/t51.82787-15/586858360_18663181387056421_2277258638846743658_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=106&ig_cache_key=Mzc3NTAxMzYwNjA3Nzc3ODg5Ng%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6InhwaWRzLjEwODB4MTQzMi5zZHIuQzMifQ%3D%3D&_nc_ohc=Ek7Cf8v0xLwQ7kNvwEjSkYI&_nc_oc=AdlK7OTRtHouzz_J8AliyMcMHjG2s-TPqLNwdVqdl_qF6SrIcCRGvqOpsj3Ilg0f3N-1mFQowxK8nB7sVJPSYBlW&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=f-KrGwIjrGunj1yq0L-4fw&oh=00_AfpGy8Sr2Tupj4X5INHUVi1waZPTaRyTGsezPGi7Xo432g&oe=69665836
                          igGeoTaggedLocation: null
                          likes: 3105340
                          comments: 17994
                          engagementRate: 0.0047
                          hashtags: []
                          taggedCreators:
                            - avacr7
                        - publishTime: 1764001808000
                          contentId: DRciq2cFK0i
                          isSponsored: false
                          description: >-
                            Low inflammation. Efficient oxygen delivery. Metabolic precision.
                            Cristiano Ronaldo’s biomarkers reveal what separates him from the rest,
                            an
                          coverImageUrl: "https://www.instagram.com/p/DRciq2cFK0i/media/?size=l"
                          carouselImageUrls:
                            - >-
                              https://scontent.cdninstagram.com/v/t51.82787-15/587574206_18548904580016159_7995134758621938211_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=101&ig_cache_key=Mzc3MzA0Mjk4ODUyOTM2NTEyNQ%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6InhwaWRzLjE0NDB4MTgwMC5zZHIuQzMifQ%3D%3D&_nc_ohc=MkUDtqqIcUYQ7kNvwHK12a4&_nc_oc=AdkpjkbnbnQwjFZXIKFZK4ZiLsCNLM8YHt1rrRY_zdcYgk1nqj8S1fbc0XrO9hSBlE2qpLpRC8lxwMbpqcISo9ka&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=f-KrGwIjrGunj1yq0L-4fw&oh=00_AfrYhIOXG1V_FV-PB2mgZqX77-iGHXPzCBXvqhs6NhCT8w&oe=6966526B
                          igGeoTaggedLocation: null
                          likes: 1066033
                          comments: 12358
                          engagementRate: 0.0016
                          hashtags: []
                          taggedCreators:
                            - cristiano
                        - publishTime: 1763754074000
                          contentId: DRVKKTygA2P
                          isSponsored: false
                          description: "Back \U0001F7E1\U0001F535"
                          coverImageUrl: "https://www.instagram.com/p/DRVKKTygA2P/media/?size=l"
                          carouselImageUrls:
                            - >-
                              https://scontent.cdninstagram.com/v/t51.82787-15/583880410_18662228161056421_5863765173882101851_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=101&ig_cache_key=Mzc3MDk2NDkzOTc5NjE1NzgxMQ%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6InhwaWRzLjE0NDB4MTgwMC5zZHIuQzMifQ%3D%3D&_nc_ohc=07xmEt_mzDEQ7kNvwF01BIC&_nc_oc=AdmEWUkbv-ECHdL_zzhnvhl3xBy-_I3y4Y0VECk4zsl0BTmnQKF5uxjjpS1G0OgLxNOmKRZ34_A-5IQ5oS3IqfOe&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=f-KrGwIjrGunj1yq0L-4fw&oh=00_AfpV-IqMHQ2fbL-oV6QHWiAuIa378nqbkbpRqWWu5EXljg&oe=6966562E
                          igGeoTaggedLocation: null
                          likes: 4481740
                          comments: 37262
                          engagementRate: 0.0067
                          hashtags: []
                          taggedCreators:
                            - alnassr
                        - publishTime: 1763574191000
                          contentId: DRPzD6oCLFZ
                          isSponsored: false
                          description: >-
                            Thank you Mr. President for your invitation and for the warm welcome you
                            and the First Lady gave me and my future wife, @georginagio. Each o
                          coverImageUrl: "https://www.instagram.com/p/DRPzD6oCLFZ/media/?size=l"
                          carouselImageUrls:
                            - >-
                              https://scontent.cdninstagram.com/v/t51.82787-15/583720094_18661902718056421_4523358027666752920_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=110&ig_cache_key=Mzc2OTQ1NTk2MzAyNDE5NTI3NA%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6InhwaWRzLjE0NDB4MTQzOS5zZHIuQzMifQ%3D%3D&_nc_ohc=6eM1S4fNSkoQ7kNvwGwrYR8&_nc_oc=Adk08_RC2SFbV1IYOm8bvzKNAykUDn0gDfSj4KplaSo2NUJGyV0kAfqYttaksMd-qNiJ1_4arvRA8tQB92OfF0dz&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=f-KrGwIjrGunj1yq0L-4fw&oh=00_Afo3qp7wDuLG--753LMnw84TI4_wuc2aIAwptW6HeUdDxA&oe=6966618C
                          igGeoTaggedLocation: null
                          likes: 28938447
                          comments: 402754
                          engagementRate: 0.0437
                          hashtags: []
                          taggedCreators:
                            - georginagio
                            - whitehouse
                            - potus
                        - publishTime: 1763310079000
                          contentId: DRH7TpTiAxK
                          isSponsored: false
                          description: "ESTAMOS NO MUNDIAL! VAMOS COM TUDO, PORTUGAL! \U0001F1F5\U0001F1F9"
                          coverImageUrl: "https://www.instagram.com/p/DRH7TpTiAxK/media/?size=l"
                          carouselImageUrls:
                            - >-
                              https://scontent.cdninstagram.com/v/t51.82787-15/581522266_18661431511056421_4007962002968142506_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=109&ig_cache_key=Mzc2NzI0MDQyNjgwMjEzOTE1Nw%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6InhwaWRzLjE0NDB4MTgwMC5zZHIuQzMifQ%3D%3D&_nc_ohc=QBtU-KnhdTAQ7kNvwFI6DWr&_nc_oc=Adli4QKFihvaSyGhZVePgOjsL4KWezvdMkw79TK2D6MMr8UkXRnCvOIr2cdKjd1HSEDawe87qsCTAdyzbZ93kqVM&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=f-KrGwIjrGunj1yq0L-4fw&oh=00_AfqZWrIG4AMUOKbPjWcSz_4l7QLn5LvVMCJaBa7Iz4stig&oe=69663EB8
                          igGeoTaggedLocation: null
                          likes: 7343117
                          comments: 62834
                          engagementRate: 0.011
                          hashtags: []
                          taggedCreators:
                            - portugal
                      recentReels:
                        - publishTime: 1767025828000
                          contentId: DS2pxhLCJTK
                          isSponsored: false
                          description: >-
                            Game-changers stop time. They are timeless.


                            Congratulations @djokernole for having in your hands a so deserved
                            first-ever Globe Soccer Awar
                          coverImageUrl: "https://www.instagram.com/p/DS2pxhLCJTK/media/?size=l"
                          igGeoTaggedLocation: null
                          likes: 5450766
                          comments: 59896
                          views: 89064050
                          engagementRate: 0.0619
                          hashtags: []
                          taggedCreators: []
                        - publishTime: 1766660544000
                          contentId: DSrxW2EiDsk
                          isSponsored: false
                          description: "Esperança que se renova, amor que abraça, família que apoia e luz que guia. Feliz Natal \U0001F384 ❤️ ✨"
                          coverImageUrl: "https://www.instagram.com/p/DSrxW2EiDsk/media/?size=l"
                          igGeoTaggedLocation: null
                          likes: 8284332
                          comments: 80841
                          views: 146151449
                          engagementRate: 0.0572
                          hashtags: []
                          taggedCreators:
                            - georginagio
                        - publishTime: 1765547815000
                          contentId: DSKnNQqiA8H
                          isSponsored: false
                          description: >-
                            Madrid. December 13. 

                            WOW goes LIVE on UR at 1PM EST. 


                            A new way to experience action sports - immersive, bold, built for the
                            next generati
                          coverImageUrl: "https://www.instagram.com/p/DSKnNQqiA8H/media/?size=l"
                          igGeoTaggedLocation: null
                          likes: 885363
                          comments: 9965
                          views: 46829179
                          engagementRate: 0.0191
                          hashtags: []
                          taggedCreators:
                            - iliatopuria
                            - wowfc
                        - publishTime: 1765206210000
                          contentId: DSAb2ptCBGL
                          isSponsored: false
                          description: "The year ends. The game evolves. And we evolve with it. We move #ForeverForward \U0001F525⏩"
                          coverImageUrl: "https://www.instagram.com/p/DSAb2ptCBGL/media/?size=l"
                          igGeoTaggedLocation: null
                          likes: 735003
                          comments: 15481
                          views: 34884947
                          engagementRate: 0.0215
                          hashtags:
                            - "#foreverforward"
                          taggedCreators:
                            - binance
                        - publishTime: 1764867627000
                          contentId: DR2Vz63CPVY
                          isSponsored: false
                          description: >-
                            Winners never stop learning. Never stop asking. I use @perplexity to get
                            ahead. 


                            Perplexity.ai/ronaldo is just the beginning.
                          coverImageUrl: "https://www.instagram.com/p/DR2Vz63CPVY/media/?size=l"
                          igGeoTaggedLocation: null
                          likes: 1091795
                          comments: 44255
                          views: 41677181
                          engagementRate: 0.0273
                          hashtags: []
                          taggedCreators:
                            - perplexity
                        - publishTime: 1764360143000
                          contentId: DRnOEjME21V
                          isSponsored: false
                          description: >-
                            Ronaldo vs My Goalie Robot. Thanks to @tmobile for helping me get my
                            latest invention ready to take on @cristiano at his own game! #sponsore
                          coverImageUrl: "https://www.instagram.com/p/DRnOEjME21V/media/?size=l"
                          igGeoTaggedLocation: null
                          likes: 2647032
                          comments: 19267
                          views: 75390877
                          engagementRate: 0.0354
                          hashtags:
                            - "#sponsored"
                          taggedCreators:
                            - cristiano
                        - publishTime: 1763928052000
                          contentId: DRaV7mnAGq7
                          isSponsored: false
                          description: "Best caption wins! \U0001F914"
                          coverImageUrl: "https://www.instagram.com/p/DRaV7mnAGq7/media/?size=l"
                          igGeoTaggedLocation: null
                          likes: 18386191
                          comments: 631039
                          views: 250628732
                          engagementRate: 0.0759
                          hashtags: []
                          taggedCreators:
                            - alnassr
                        - publishTime: 1763561096000
                          contentId: DRPZ1xokeMN
                          isSponsored: false
                          description: "Two GOATS. \n\nCR7 x 45/47 \U0001F525"
                          coverImageUrl: "https://www.instagram.com/p/DRPZ1xokeMN/media/?size=l"
                          igGeoTaggedLocation: null
                          likes: 9892568
                          comments: 197288
                          views: 212761237
                          engagementRate: 0.0474
                          hashtags: []
                          taggedCreators:
                            - cristiano
                            - potus
                        - publishTime: 1762538418000
                          contentId: DQw7ZjRCHnV
                          isSponsored: false
                          description: |-
                            Unleash your inner champion.
                            The new CR7 Energy captures an unstoppable spirit in every spray.
                            Are you ready to feel the Energy?

                            #CR7Fragan
                          coverImageUrl: "https://www.instagram.com/p/DQw7ZjRCHnV/media/?size=l"
                          igGeoTaggedLocation: null
                          likes: 1474720
                          comments: 16213
                          views: 45182985
                          engagementRate: 0.033
                          hashtags:
                            - "#cr7fragances"
                            - "#cr7energy"
                          taggedCreators:
                            - cristiano
                        - publishTime: 1762178954000
                          contentId: DQmNZpDiABE
                          isSponsored: false
                          description: |-
                            No filters. No scripts. Just us. 

                            Coming soon with my friend @piersmorgan
                          coverImageUrl: "https://www.instagram.com/p/DQmNZpDiABE/media/?size=l"
                          igGeoTaggedLocation: null
                          likes: 2079807
                          comments: 98226
                          views: 51205580
                          engagementRate: 0.0425
                          hashtags: []
                          taggedCreators: []
                        - publishTime: 1761483603000
                          contentId: DQRfhEjDL23
                          isSponsored: false
                          description: "950 goals ⚽\U0001F525 The legacy continues.\n\nJoin #7heSelection with Binance\nNFT holder or not - you can be part of it \U0001F447\n\nHolders: Fill up the surv"
                          coverImageUrl: "https://www.instagram.com/p/DQRfhEjDL23/media/?size=l"
                          igGeoTaggedLocation: null
                          likes: 793049
                          comments: 13466
                          views: 35559234
                          engagementRate: 0.0227
                          hashtags:
                            - "#7heselection"
                          taggedCreators:
                            - cristiano
                        - publishTime: 1761319015000
                          contentId: DQMlmx3jOOV
                          isSponsored: false
                          description: "Cristiano Ronaldo’s most powerful tool? Strategic sleep. Lock in your bedtime, dial in your mornings, and feel the difference \U0001F4AA"
                          coverImageUrl: "https://www.instagram.com/p/DQMlmx3jOOV/media/?size=l"
                          igGeoTaggedLocation: null
                          likes: 1691160
                          comments: 14940
                          views: 46286914
                          engagementRate: 0.0369
                          hashtags: []
                          taggedCreators:
                            - cristiano
                    creditsUsed: 1
                    creditsAvailable: 975
                    planCreditsAvailable: 900
                    purchasedCreditsAvailable: 75
                    traceId: a67a02e9802d17100ab06375bb2cb37c
                    timestamp: 1767935498559
                    errorCode: ""
                    errorDescription: ""
                    success: true
        "400":
          description: "Validation error."
          content:
            application/json:
              schema:
                type: object
                title: ValidationErrorResponse
                description: "Parameter validation error response format."
                properties:
                  success:
                    const: false
                  error:
                    type: string
                  message:
                    type: string
                  timestamp:
                    type: integer
                required:
                  - success
                  - error
                  - message
                  - timestamp
              examples:
                missing uniqueId:
                  summary: Missing uniqueId
                  value:
                    success: false
                    error: "VALIDATION_ERROR"
                    message: "Missing required field: 'uniqueId'."
                    timestamp: 1770099403116
                invalid uniqueId:
                  summary: Invalid uniqueId format
                  value:
                    success: false
                    error: "VALIDATION_ERROR"
                    message: "Invalid 'uniqueId' format. Instagram unique ID must be between 1 and 31 characters."
                    timestamp: 1770099403116
        "429":
          description: "Exceeded quota or rate limit."
          content:
            application/json:
              schema:
                type: object
                title: QuotaErrorResponse
                description: "Quota error response format."
                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)"
  # Instagram sponsorship info
  /instagram/sponsorship:
    post:
      tags:
        - Instagram
      summary: Get Sponsorship Information
      description: "Retrieve sponsorship data for a specified Instagram creator, including current and past brand partnerships with performance metrics.<br /><br />Optionally pass `fields` in the request body to limit how many sponsoring brands are returned. You are billed per brand returned, capped at the full-bundle price. Fractional calls must be enabled on your API key. Otherwise, a request that includes `fields` returns a `400` error (`FractionalCallsNotEnabled`). For per-brand costs, see [Field and Item Costs](/api-v3/field-and-item-costs#instagram/sponsorship). For how fractional calls work, see [Fractional Calls](/api-v3/fractional-calls)."
      operationId: getInstagramSponsorship
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - uniqueId
              properties:
                uniqueId:
                  type: string
                  description: "Instagram account ID. Accepts `instagram` or `@instagram` format (@ is stripped automatically)."
                  pattern: "^@?[a-zA-Z0-9._]{1,30}$"
                  minLength: 1
                  maxLength: 31
                  examples:
                    - instagram
                fields:
                  type: object
                  description: "Map `sponsorList` to the number of sponsoring brands to return. Omit or pass an empty object to return all brands at the full-bundle price. For per-brand costs, see [Field and Item Costs](/api-v3/field-and-item-costs#instagram/sponsorship)."
                  properties:
                    sponsorList:
                      anyOf:
                        - type: integer
                          minimum: 0
                        - type: "null"
                      description: "Number of sponsoring brands to return. Pass `null` to skip this field and be charged 0 for it."
                      examples:
                        - 5
                  additionalProperties: false
      x-codeSamples:
        - lang: bash
          label: cURL
          source: |
            curl -X POST "https://apiv3.creatordb.app/instagram/sponsorship" \
              -H "Content-Type: application/json" \
              -H "api-key: <YOUR_API_KEY_HERE>" \
              -d '{ "uniqueId": "davidbeckham", "fields": { "sponsorList": 5 } }'
      responses:
        "200":
          description: "Instagram sponsorship data returned successfully."
          content:
            application/json:
              schema:
                type: object
                description: "Instagram sponsorship API response with sponsor-grouped content and performance metrics."
                properties:
                  data:
                    $ref: "#/components/schemas/InstagramSponsorshipData"
                    required:
                      - sponsorList
                  creditsUsed:
                    type: number
                    description: "Number of API credits consumed by this request."
                    examples:
                      - 1
                  creditsAvailable:
                    type: number
                    description: "Number of API credits remaining. Equals planCreditsAvailable plus purchasedCreditsAvailable."
                    examples:
                      - -1
                  planCreditsAvailable:
                    type: number
                    description: "Remaining plan credits after this request, in credits."
                    examples:
                      - 900
                  purchasedCreditsAvailable:
                    type: number
                    description: "Remaining purchased-bucket credits after this request, in display units."
                    examples:
                      - 75
                  keyCreditsAvailable:
                    type: number
                    description: "Remaining credits this API key can spend after this request, before reaching its spend limit. Present only when the key has a spend limit."
                    examples:
                      - 4975
                  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
                  - planCreditsAvailable
                  - purchasedCreditsAvailable
              examples:
                default:
                  value:
                    data:
                      sponsorList:
                        - brandName: ""
                          brandId: ""
                          brandIgIds:
                            - boss
                          sponsoredImages:
                            - publishTime: 1765812372000
                              contentId: DSSgDX6CPDJ
                              isSponsored: true
                              description: "Staying cosy in BECKHAM x BOSS ❤️\U0001F49A @BOSS"
                              coverImageUrl: "https://www.instagram.com/p/DSSgDX6CPDJ/media/?size=l"
                              carouselImageUrls:
                                - >-
                                  https://scontent-tpe1-1.cdninstagram.com/v/t51.82787-15/586674147_18571109599024953_5473428891274672431_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=100&ig_cache_key=Mzc4ODIzMTE4ODA4Nzg5MjMzMQ%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6InhwaWRzLjE0NDB4MTkyMC5zZHIuQzMifQ%3D%3D&_nc_ohc=mzrcZSW-0j8Q7kNvwErpPDc&_nc_oc=Admw5RjgGJ4UDaAVuMtABnS5QHxILSOiJVDXCjP69dP_g3--MHS7-6olEt3RMaoat6y9Fasxfhd9N22jT5rEkm72&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent-tpe1-1.cdninstagram.com&_nc_gid=8hzpDTpSBTQafx-uH7J2qw&oh=00_Afp8OEFBBTKj7OwDiEIhAOU2BGSX_shgyaxagkFMtAXCFw&oe=69644E35
                                - >-
                                  https://scontent-tpe1-1.cdninstagram.com/v/t51.82787-15/587771643_18571109611024953_6383645157204960335_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=105&ig_cache_key=Mzc4ODIzMTE4ODEwNDYxMjI1NA%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6InhwaWRzLjE0NDB4MTkyMC5zZHIuQzMifQ%3D%3D&_nc_ohc=g3STp4MqVg4Q7kNvwE-Irnu&_nc_oc=AdlVkw4ZzZXvdbkNryQmCTn9I-8jWPbkfJk5y8xuIMoHlosMgQ4HDsGx_NHRBDck8GNpu4okjdsidTJJjVM2ISde&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent-tpe1-1.cdninstagram.com&_nc_gid=8hzpDTpSBTQafx-uH7J2qw&oh=00_AfpxWLVJ4zZOBntDbPVF1oX1psoW_RH3sq6glkzuQ93PgA&oe=69643FF8
                              igGeoTaggedLocation: null
                              likes: 210144
                              comments: 1383
                              engagementRate: 0.0024
                              hashtags: []
                              taggedCreators: []
                            - publishTime: 1763980750000
                              contentId: DRb6grcCDRG
                              isSponsored: true
                              description: "Ready for Winter in BECKHAM x BOSS… So pleased with the jacket and love the boots \U0001F90E❄️ @BOSS"
                              coverImageUrl: "https://www.instagram.com/p/DRb6grcCDRG/media/?size=l"
                              carouselImageUrls:
                                - >-
                                  https://scontent-tpe1-1.cdninstagram.com/v/t51.82787-15/586676758_18567404911024953_9015316138915494417_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=102&ig_cache_key=Mzc3Mjg2NjQzMzU5NjgzMTkxNQ%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6InhwaWRzLjE0NDB4MTkyMC5zZHIuQzMifQ%3D%3D&_nc_ohc=mULWBt9Jw94Q7kNvwF8mG4u&_nc_oc=AdnxesyvD-lQSXUgYaltcoWnZ3MVku-N7wx7aSvKjA1fqWXhZ7skbYaY_2ypFVGV63PDLobkwoQGGRJTzieseggu&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent-tpe1-1.cdninstagram.com&_nc_gid=8hzpDTpSBTQafx-uH7J2qw&oh=00_AfqhBHX4ryPsQeC0bO8okN8-ALU1q2m5PmogOt8l6CIy6g&oe=69643A29
                                - >-
                                  https://scontent-tpe1-1.cdninstagram.com/v/t51.82787-15/587286274_18567404926024953_3025260660210148405_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=100&ig_cache_key=Mzc3Mjg2NjQzMzkzMjM1MDMxNQ%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6InhwaWRzLjE0NDB4MTkyMC5zZHIuQzMifQ%3D%3D&_nc_ohc=wwq5b2U4G5sQ7kNvwFQUwj_&_nc_oc=AdmUCP-6GvSUNgFXt-YMhG52UdMwBe2_B-_EZOOlT7bBeCXAGJgvNPxHRJi9D3cpEnJzHvh5ZyA5v9CS1GiBHf1O&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent-tpe1-1.cdninstagram.com&_nc_gid=8hzpDTpSBTQafx-uH7J2qw&oh=00_AfpvCpIoJ2OGsJc7EsimTQFGAGPk4JpSK9CjOiC88CZHCA&oe=69644AB6
                              igGeoTaggedLocation: null
                              likes: 231362
                              comments: 1052
                              engagementRate: 0.0026
                              hashtags: []
                              taggedCreators: []
                            - publishTime: 1763468199000
                              contentId: DRMo5etCC1N
                              isSponsored: true
                              description: "Cosy winter weekends mean only one thing… a good old English pub \U0001F606\U0001F1EC\U0001F1E7 Keeping warm in BECKHAM x BOSS \U0001F5A4 @BOSS"
                              coverImageUrl: "https://www.instagram.com/p/DRMo5etCC1N/media/?size=l"
                              carouselImageUrls:
                                - >-
                                  https://scontent-tpe1-1.cdninstagram.com/v/t51.82787-15/581983107_18566455720024953_8078967835574116917_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=109&ig_cache_key=Mzc2ODU2Njg0NjkwNDEzODY5NQ%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6InhwaWRzLjE0NDB4MTkyMC5zZHIuQzMifQ%3D%3D&_nc_ohc=UauW65J5qOkQ7kNvwFCJXWN&_nc_oc=Admm-nC4UXPJHt-XOtFtoM_TqyQtVWrJoVqP6NoHNoXKecUImo_catgUUjz6nF6oyY0Hp9NCqGSNzOH0w4TZKTlh&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent-tpe1-1.cdninstagram.com&_nc_gid=8hzpDTpSBTQafx-uH7J2qw&oh=00_AfpgM1gKxNjfPdjOfEG_JERCeD87itV9vKrsp1rga_W1mQ&oe=69642E2C
                                - >-
                                  https://scontent-tpe1-1.cdninstagram.com/v/t51.82787-15/582445515_18566455729024953_5970343486893917241_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=103&ig_cache_key=Mzc2ODU2Njg0NzQ2NjE2MzM5NA%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6InhwaWRzLjE0NDB4MTkyMC5zZHIuQzMifQ%3D%3D&_nc_ohc=1oUJfWW7MKoQ7kNvwFA4V1W&_nc_oc=AdneWtg32H2xY9o3Hq-33XF6QOjkXjrSvFEDjne9hiGkCPnPctytDrDK9Uv9U5KI10BRtlnY7PWZjyHVpaCqA6NB&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent-tpe1-1.cdninstagram.com&_nc_gid=8hzpDTpSBTQafx-uH7J2qw&oh=00_AfqZtCxlMYjFI79VZgvXxpS5FlapVdbUyzIePYGKYIRRjA&oe=69642F01
                              igGeoTaggedLocation: null
                              likes: 301438
                              comments: 1566
                              engagementRate: 0.0034
                              hashtags: []
                              taggedCreators: []
                            - publishTime: 1762960780000
                              contentId: DQ9hEpSiAL9
                              isSponsored: true
                              description: "Always been a fan of a great suit… \U0001FA76 So I loved wearing my own BECKHAM x BOSS double-breasted suit for Victoria’s New York event last month"
                              coverImageUrl: "https://www.instagram.com/p/DQ9hEpSiAL9/media/?size=l"
                              carouselImageUrls:
                                - >-
                                  https://scontent-tpe1-1.cdninstagram.com/v/t51.82787-15/580804240_18564692371024953_9126554253645642828_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=107&ig_cache_key=Mzc2NDMxMDMwMTEyNzIxNzczNg%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6InhwaWRzLjEzNjZ4MTgyMS5zZHIuQzMifQ%3D%3D&_nc_ohc=e9O-BtT8ccEQ7kNvwGCUXfp&_nc_oc=Adny8EDV9P2nUKBCMNML-af74jsMvlRnhVBPXdN5i139Cf7YT4APKKOcAH94GMaUNWqQMTSJDG4fXRXCu_MVIOPe&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent-tpe1-1.cdninstagram.com&_nc_gid=8hzpDTpSBTQafx-uH7J2qw&oh=00_AfpskPOceY_iLiUYIbbRQMBs8EE2jzT0sytm_lGvjIL7bA&oe=6964527E
                                - >-
                                  https://scontent-tpe1-1.cdninstagram.com/v/t51.82787-15/580568224_18564692380024953_8788936439823845681_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=106&ig_cache_key=Mzc2NDMxMDMwMTE3NzU2MzcwOA%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6InhwaWRzLjEzNjZ4MTgyMS5zZHIuQzMifQ%3D%3D&_nc_ohc=vbEnHqqqgmoQ7kNvwHtKpVJ&_nc_oc=AdmWLNUavg8NDmWTx3MJZlBT-OpmYZspT0LOkoC6FVu3C-6k47FzkStiUh9SSBGrRZg9yhA9G7tF--1o16sE1q6P&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent-tpe1-1.cdninstagram.com&_nc_gid=8hzpDTpSBTQafx-uH7J2qw&oh=00_AfoR5m0gnf3fAFf4vLURMcKQbk0vQZEj8sKtQLxHENQJvA&oe=69644C4E
                                - >-
                                  https://scontent-tpe1-1.cdninstagram.com/v/t51.82787-15/581110979_18564692389024953_3599087279433599267_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=100&ig_cache_key=Mzc2NDMxMDMwMTM3MDQ5NTczMg%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6InhwaWRzLjE0NDB4MTkyMC5zZHIuQzMifQ%3D%3D&_nc_ohc=T5hZSj7Um3wQ7kNvwEtG0b-&_nc_oc=AdlBKjdymcawp6Rft34sZPOZEN2yo-h-QPrIerBDiztqizNsxyrXKEAq4v1OFM_dzyVYjNiMnsHaMx7rfoxBPg_h&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent-tpe1-1.cdninstagram.com&_nc_gid=8hzpDTpSBTQafx-uH7J2qw&oh=00_Afo8NhdgmOUZnPLtdB5Kkfs4Qyui6RtYNjeTawAy6GtykQ&oe=69644627
                              igGeoTaggedLocation: null
                              likes: 294775
                              comments: 1664
                              engagementRate: 0.0033
                              hashtags: []
                              taggedCreators:
                                - boss
                          sponsoredReels:
                            - publishTime: 1761578139000
                              contentId: DQUT0hHCLBI
                              isSponsored: true
                              description: "My favourite looks from my BECKHAM x BOSS collection \U0001F64C\U0001F3FC All available now at @BOSS \U0001F90E"
                              coverImageUrl: "https://www.instagram.com/p/DQUT0hHCLBI/media/?size=l"
                              igGeoTaggedLocation: null
                              likes: 268715
                              comments: 2696
                              views: 5734200
                              engagementRate: 0.0473
                              hashtags: []
                              taggedCreators: []
                          sponsoredImagesPerformance:
                            likes:
                              all: 1037719
                              avg: 259430
                              median: 263069
                              min: 210144
                              max: 301438
                            comments:
                              all: 5665
                              avg: 1416
                              median: 1475
                              min: 1052
                              max: 1664
                            engagement:
                              avgEngagementRate: 0.0029
                              likesPerFollower: 0.0029
                              commentsPerFollower: 0
                              engagementConsistency:
                                cv: 0.152
                                medianVsMean: 1.0137
                                topBottomRatio: 0
                                consistencyScore: null
                                consistencyLevel: null
                          sponsoredReelsPerformance:
                            likes:
                              all: 268715
                              avg: 268715
                              median: 268715
                              min: 268715
                              max: 268715
                            comments:
                              all: 2696
                              avg: 2696
                              median: 2696
                              min: 2696
                              max: 2696
                            views:
                              all: 5734200
                              avg: 5734200
                              median: 5734200
                              min: 5734200
                              max: 5734200
                            engagement:
                              avgEngagementRate: 0.0031
                              likesPerFollower: 0.003
                              commentsPerFollower: 0
                              viewsPerFollower: 0.0647
                              engagementConsistency:
                                cv: 0
                                medianVsMean: 1
                                topBottomRatio: 0
                                consistencyScore: null
                                consistencyLevel: null
                        - brandName: ""
                          brandId: ""
                          brandIgIds:
                            - adidasfootball
                          sponsoredImages:
                            - publishTime: 1764763413000
                              contentId: DRzPUpkiFwG
                              isSponsored: true
                              description: "Two eras collide… ❤️\U0001FA76 @adidasfootball @judebellingham @trent"
                              coverImageUrl: "https://www.instagram.com/p/DRzPUpkiFwG/media/?size=l"
                              carouselImageUrls:
                                - >-
                                  https://scontent-tpe1-1.cdninstagram.com/v/t51.82787-15/587814381_18568838989024953_8953623466680258797_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=105&ig_cache_key=Mzc3OTQzMTg4NzYzOTQ1Nzg0OQ%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6InhwaWRzLjE0NDB4MTgwMC5zZHIuQzMifQ%3D%3D&_nc_ohc=NFaPRShNPFwQ7kNvwEdbFfO&_nc_oc=Adn2GCS18XHb1Y621p0B0kBaY3S8uFc8_6smURYleFG0vQ02avXoM82MEpZ-xFSj2hpWQUWg5ruDDvqOk4K6Rt75&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent-tpe1-1.cdninstagram.com&_nc_gid=8hzpDTpSBTQafx-uH7J2qw&oh=00_AfrrHZ1xOnAKuMUwfnEXY7mCbyn80XW_bQfWf3detFsqlQ&oe=69642D33
                                - >-
                                  https://scontent-tpe1-1.cdninstagram.com/v/t51.82787-15/587293554_18568838998024953_144098021852943215_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=109&ig_cache_key=Mzc3OTQzMTg4NzMyOTA0Mjk5OQ%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6InhwaWRzLjE0NDB4MTgwMC5zZHIuQzMifQ%3D%3D&_nc_ohc=EH37WIcNI4cQ7kNvwEzwVOO&_nc_oc=AdkNUOOH4MVql8WiMQ2_bREG0pRus-6AGPba4t29CRVQhTc7EwFX9DngI6n_jbiYF4_mZ6Fj06Nf81Oin5rDms9X&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent-tpe1-1.cdninstagram.com&_nc_gid=8hzpDTpSBTQafx-uH7J2qw&oh=00_AfoUr3cdoJgn3PyI8TG5s-0XztrM-5ChuPMOCGyriLZ3rw&oe=69643526
                                - >-
                                  https://scontent-tpe1-1.cdninstagram.com/v/t51.82787-15/587292247_18568839007024953_3770485541519683286_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=101&ig_cache_key=Mzc3OTQzMTg4NzMyMDY1NzEzMQ%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6InhwaWRzLjE0NDB4MTgwMC5zZHIuQzMifQ%3D%3D&_nc_ohc=lJno8zaIV0AQ7kNvwFjArDz&_nc_oc=Adn08KA-3HPNFrda7WqYYdT0I-kIF6B6a3goVH-W1XgKud7Zp9Ka6m-XWM1xLNC01tuTnifO6lJORmTcQCDVkajg&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent-tpe1-1.cdninstagram.com&_nc_gid=8hzpDTpSBTQafx-uH7J2qw&oh=00_AfpymudtM2FOZCk-DrvDbF7TFsP0lKFf3LbSCcW9zPftSQ&oe=69644511
                              igGeoTaggedLocation: null
                              likes: 431701
                              comments: 1014
                              engagementRate: 0.0049
                              hashtags: []
                              taggedCreators:
                                - trent
                                - judebellingham
                                - adidasfootball
                          sponsoredReels: []
                          sponsoredImagesPerformance:
                            likes:
                              all: 431701
                              avg: 431701
                              median: 431701
                              min: 431701
                              max: 431701
                            comments:
                              all: 1014
                              avg: 1014
                              median: 1014
                              min: 1014
                              max: 1014
                            engagement:
                              avgEngagementRate: 0.0049
                              likesPerFollower: 0.0049
                              commentsPerFollower: 0
                              engagementConsistency:
                                cv: 0
                                medianVsMean: 1
                                topBottomRatio: 0
                                consistencyScore: null
                                consistencyLevel: null
                          sponsoredReelsPerformance:
                            likes:
                              all: 0
                              avg: 0
                              median: 0
                              min: 0
                              max: 0
                            comments:
                              all: 0
                              avg: 0
                              median: 0
                              min: 0
                              max: 0
                            views:
                              all: 0
                              avg: 0
                              median: 0
                              min: 0
                              max: 0
                            engagement:
                              avgEngagementRate: 0
                              likesPerFollower: 0
                              commentsPerFollower: 0
                              viewsPerFollower: 0
                              engagementConsistency:
                                cv: 0
                                medianVsMean: 0
                                topBottomRatio: 0
                                consistencyScore: null
                                consistencyLevel: null
                        - brandName: ""
                          brandId: ""
                          brandIgIds:
                            - tudorwatch
                          sponsoredImages:
                            - publishTime: 1764335161000
                              contentId: DRmefuQiIoz
                              isSponsored: true
                              description: >-
                                I had a great evening celebrating @tudorwatch in Mumbai last night…
                                an incredible setting and amazing people ❤️
                              coverImageUrl: "https://www.instagram.com/p/DRmefuQiIoz/media/?size=l"
                              carouselImageUrls:
                                - >-
                                  https://scontent-tpe1-1.cdninstagram.com/v/t51.82787-15/589251883_18568034845024953_3341252956188149986_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=108&ig_cache_key=Mzc3NTgzOTQ0Njk5NDc4NzkwMA%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6InhwaWRzLjE0NDB4MTgwMC5zZHIuQzMifQ%3D%3D&_nc_ohc=0P5LOk46LxUQ7kNvwGos-ml&_nc_oc=AdkU7UBBuGg7D5i7rkz1iqRlOcKN-SkaSOPJs1jyeiJKYC4pzGQI7uFC1rZqUaaXx_-jbOSH5njpucSMMWnEM0Kb&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent-tpe1-1.cdninstagram.com&_nc_gid=8hzpDTpSBTQafx-uH7J2qw&oh=00_AfpqDTv9ahJsIOd4FGjWGzqanhZNTK1tTghbM5uAGlx3iw&oe=69643711
                                - >-
                                  https://scontent-tpe1-1.cdninstagram.com/v/t51.82787-15/587266526_18568034857024953_947552541831842935_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=109&ig_cache_key=Mzc3NTgzOTQ0Njk5NDgyMjI4MQ%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6InhwaWRzLjE0NDB4MTgwMC5zZHIuQzMifQ%3D%3D&_nc_ohc=ZMchtshDrPsQ7kNvwF3QlJ_&_nc_oc=AdkxvuUM4Uzc5SALPTohtzwuT6Eja1mVj2xBssoW7HGDWbag9w5tHIDhUHpaC9VsHwh7P23-FEbxmVKtDBnDfaEp&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent-tpe1-1.cdninstagram.com&_nc_gid=8hzpDTpSBTQafx-uH7J2qw&oh=00_AfpOoVNrVhohX9QZJ91-8_bwSoFQYS5QAxNq4C9x6Egl5A&oe=6964459C
                              igGeoTaggedLocation:
                                lat: 19.0627
                                lng: 72.8764
                              likes: 269043
                              comments: 1164
                              engagementRate: 0.0031
                              hashtags: []
                              taggedCreators: []
                          sponsoredReels: []
                          sponsoredImagesPerformance:
                            likes:
                              all: 269043
                              avg: 269043
                              median: 269043
                              min: 269043
                              max: 269043
                            comments:
                              all: 1164
                              avg: 1164
                              median: 1164
                              min: 1164
                              max: 1164
                            engagement:
                              avgEngagementRate: 0.0031
                              likesPerFollower: 0.003
                              commentsPerFollower: 0
                              engagementConsistency:
                                cv: 0
                                medianVsMean: 1
                                topBottomRatio: 0
                                consistencyScore: null
                                consistencyLevel: null
                          sponsoredReelsPerformance:
                            likes:
                              all: 0
                              avg: 0
                              median: 0
                              min: 0
                              max: 0
                            comments:
                              all: 0
                              avg: 0
                              median: 0
                              min: 0
                              max: 0
                            views:
                              all: 0
                              avg: 0
                              median: 0
                              min: 0
                              max: 0
                            engagement:
                              avgEngagementRate: 0
                              likesPerFollower: 0
                              commentsPerFollower: 0
                              viewsPerFollower: 0
                              engagementConsistency:
                                cv: 0
                                medianVsMean: 0
                                topBottomRatio: 0
                                consistencyScore: null
                                consistencyLevel: null
                        - brandName: ""
                          brandId: ""
                          brandIgIds:
                            - lays_football
                          sponsoredImages: []
                          sponsoredReels:
                            - publishTime: 1764846772000
                              contentId: DR1uIdFCMGI
                              isSponsored: true
                              description: "The group chat you didn’t know you needed… \U0001F606 @leomessi @thierryhenry @alexiaputellas #SteveCarell @lays_football @FIFAWorldCup"
                              coverImageUrl: "https://www.instagram.com/p/DR1uIdFCMGI/media/?size=l"
                              igGeoTaggedLocation: null
                              likes: 81334
                              comments: 909
                              views: 3501074
                              engagementRate: 0.0235
                              hashtags:
                                - "#stevecarell"
                              taggedCreators: []
                          sponsoredImagesPerformance:
                            likes:
                              all: 0
                              avg: 0
                              median: 0
                              min: 0
                              max: 0
                            comments:
                              all: 0
                              avg: 0
                              median: 0
                              min: 0
                              max: 0
                            engagement:
                              avgEngagementRate: 0
                              likesPerFollower: 0
                              commentsPerFollower: 0
                              engagementConsistency:
                                cv: 0
                                medianVsMean: 0
                                topBottomRatio: 0
                                consistencyScore: null
                                consistencyLevel: null
                          sponsoredReelsPerformance:
                            likes:
                              all: 81334
                              avg: 81334
                              median: 81334
                              min: 81334
                              max: 81334
                            comments:
                              all: 909
                              avg: 909
                              median: 909
                              min: 909
                              max: 909
                            views:
                              all: 3501074
                              avg: 3501074
                              median: 3501074
                              min: 3501074
                              max: 3501074
                            engagement:
                              avgEngagementRate: 0.0009
                              likesPerFollower: 0.0009
                              commentsPerFollower: 0
                              viewsPerFollower: 0.0395
                              engagementConsistency:
                                cv: 0
                                medianVsMean: 1
                                topBottomRatio: 0
                                consistencyScore: null
                                consistencyLevel: null
                    creditsUsed: 1
                    creditsAvailable: 975
                    planCreditsAvailable: 900
                    purchasedCreditsAvailable: 75
                    traceId: b3d9d55bd222f728b6fe053e3047d16f
                    timestamp: 1767935788415
                    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 uniqueId:
                  summary: Missing uniqueId
                  value:
                    success: false
                    error: "VALIDATION_ERROR"
                    message: "Missing required field: 'uniqueId'."
                    timestamp: 1770099403116
                invalid uniqueId:
                  summary: Invalid uniqueId format
                  value:
                    success: false
                    error: "VALIDATION_ERROR"
                    message: "Invalid 'uniqueId' format. Instagram unique ID must be between 1 and 31 characters."
                    timestamp: 1770099403116
        "429":
          description: "Exceeded quota or rate limit."
          content:
            application/json:
              schema:
                type: object
                title: QuotaErrorResponse
                description: "Quota error response format."
                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)"
  # Instagram topics
  /instagram/topics:
    get:
      tags:
        - Instagram
      summary: List Topics
      description: "Retrieve all available Instagram topics with their categories and creator count. Topics are used for categorizing Instagram creators based on their content themes. Topics are broader than niches. Every Instagram topic ID ends in `_instagram`."
      operationId: getInstagramTopics
      x-codeSamples:
        - lang: bash
          label: cURL
          source: |
            curl -X GET "https://apiv3.creatordb.app/instagram/topics" \
              -H "api-key: <YOUR_API_KEY_HERE>"
      responses:
        "200":
          description: "Instagram topics data returned successfully."
          content:
            application/json:
              schema:
                type: object
                description: "Instagram Topics API response with all available topics."
                properties:
                  data:
                    type: array
                    description: "Instagram topics."
                    items:
                      type: object
                      description: "Instagram topic item with metadata."
                      properties:
                        id:
                          type: string
                          description: "The unique identifier of the topic."
                          examples:
                            - id_lifestyle_HowtoStyle_instagram
                        name:
                          type: string
                          description: "The topic name."
                          examples:
                            - Lifestyle
                        category:
                          type: string
                          description: "Category classifications."
                          examples:
                            - "Howto & Style"
                        channelCount:
                          type: integer
                          description: "Number of creators associated with this Instagram topic."
                          minimum: 0
                          examples:
                            - 204145
                      required:
                        - id
                        - name
                        - category
                        - channelCount
                  creditsUsed:
                    type: number
                    description: "Number of API credits consumed by this request."
                    examples:
                      - 1
                  creditsAvailable:
                    type: number
                    description: "Number of API credits remaining. Equals planCreditsAvailable plus purchasedCreditsAvailable."
                    examples:
                      - -1
                  planCreditsAvailable:
                    type: number
                    description: "Remaining plan credits after this request, in credits."
                    examples:
                      - 900
                  purchasedCreditsAvailable:
                    type: number
                    description: "Remaining purchased-bucket credits after this request, in display units."
                    examples:
                      - 75
                  keyCreditsAvailable:
                    type: number
                    description: "Remaining credits this API key can spend after this request, before reaching its spend limit. Present only when the key has a spend limit."
                    examples:
                      - 4975
                  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
                  - planCreditsAvailable
                  - purchasedCreditsAvailable
              examples:
                default:
                  value:
                    data:
                      - id: id_lifestyle_HowtoStyle_instagram
                        name: Lifestyle
                        category: "Howto & Style"
                        channelCount: 204145
                      - id: id_beauty_HowtoStyle_instagram
                        name: Beauty
                        category: "Howto & Style"
                        channelCount: 188822
                      - id: id_fashion_HowtoStyle_instagram
                        name: Fashion
                        category: "Howto & Style"
                        channelCount: 186065
                      - id: id_makeup_HowtoStyle_instagram
                        name: Makeup
                        category: "Howto & Style"
                        channelCount: 92344
                      - id: id_hair_HowtoStyle_instagram
                        name: Hair
                        category: "Howto & Style"
                        channelCount: 90529
                      - id: id_cooking_HowtoStyle_instagram
                        name: Cooking
                        category: "Howto & Style"
                        channelCount: 87309
                      - id: id_photography_HowtoStyle_instagram
                        name: Photography
                        category: "Howto & Style"
                        channelCount: 74320
                      - id: id_skincare_HowtoStyle_instagram
                        name: Skincare
                        category: "Howto & Style"
                        channelCount: 73341
                    creditsUsed: 1
                    creditsAvailable: 975
                    planCreditsAvailable: 900
                    purchasedCreditsAvailable: 75
                    traceId: 0f58e95d22ea888a76166ecf6bb251ef
                    timestamp: 1772075633067
                    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:
                unexpected parameter:
                  summary: Unexpected query parameter
                  value:
                    success: false
                    error: "VALIDATION_ERROR"
                    message: "Unrecognized query parameter."
                    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)"
  # Instagram niches
  /instagram/niches:
    get:
      tags:
        - Instagram
      summary: List Niches
      description: "Retrieve all available Instagram niche categories and their creator counts. Niches categorize creators by content themes."
      operationId: getInstagramNiches
      x-codeSamples:
        - lang: bash
          label: cURL
          source: |
            curl -X GET "https://apiv3.creatordb.app/instagram/niches"\
              -H "api-key: <YOUR_API_KEY_HERE>"
      responses:
        "200":
          description: "Instagram niches data returned successfully."
          content:
            application/json:
              schema:
                type: object
                description: "Instagram Niches API response with all available niches."
                properties:
                  data:
                    type: array
                    description: "Instagram niches."
                    items:
                      type: object
                      description: "Niche with metadata."
                      properties:
                        id:
                          type: string
                          description: "The unique identifier."
                          examples:
                            - id_viral_All
                        name:
                          type: string
                          description: "The niche name."
                          examples:
                            - viral
                        category:
                          type: string
                          description: "Category classifications."
                          examples:
                            - All
                        channelCount:
                          type: integer
                          description: "Number of creators associated with this niche."
                          minimum: 0
                          examples:
                            - 5678
                      required:
                        - id
                        - name
                        - category
                        - channelCount
                  creditsUsed:
                    type: number
                    description: "Number of API credits consumed by this request."
                    examples:
                      - 1
                  creditsAvailable:
                    type: number
                    description: "Number of API credits remaining. Equals planCreditsAvailable plus purchasedCreditsAvailable."
                    examples:
                      - -1
                  planCreditsAvailable:
                    type: number
                    description: "Remaining plan credits after this request, in credits."
                    examples:
                      - 900
                  purchasedCreditsAvailable:
                    type: number
                    description: "Remaining purchased-bucket credits after this request, in display units."
                    examples:
                      - 75
                  keyCreditsAvailable:
                    type: number
                    description: "Remaining credits this API key can spend after this request, before reaching its spend limit. Present only when the key has a spend limit."
                    examples:
                      - 4975
                  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
                  - planCreditsAvailable
                  - purchasedCreditsAvailable
              examples:
                default:
                  value:
                    data:
                      - id: id_love_All
                        name: love
                        category: All
                        channelCount: 467198
                      - id: id_viral_All
                        name: viral
                        category: All
                        channelCount: 364528
                      - id: id_fyp_All
                        name: fyp
                        category: All
                        channelCount: 338353
                      - id: id_instagram_All
                        name: instagram
                        category: All
                        channelCount: 320296
                      - id: id_christmas_All
                        name: christmas
                        category: All
                        channelCount: 317930
                      - id: id_instagood_All
                        name: instagood
                        category: All
                        channelCount: 292027
                      - id: id_explore_All
                        name: explore
                        category: All
                        channelCount: 277757
                      - id: id_travel_All
                        name: travel
                        category: All
                        channelCount: 267931
                      - id: id_music_All
                        name: music
                        category: All
                        channelCount: 253719
                      - id: id_family_All
                        name: family
                        category: All
                        channelCount: 253392
                      - id: id_fashion_All
                        name: fashion
                        category: All
                        channelCount: 250567
                    creditsUsed: 1
                    creditsAvailable: 975
                    planCreditsAvailable: 900
                    purchasedCreditsAvailable: 75
                    traceId: fd1210c8a36844a7fcee90d4e13ace34
                    timestamp: 1772092953767
                    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:
                unexpected parameter:
                  summary: Unexpected query parameter
                  value:
                    success: false
                    error: "VALIDATION_ERROR"
                    message: "Unrecognized query parameter."
                    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)"
  #TikTok

  # TikTok custom filter search
  /tiktok/search:
    post:
      tags:
        - TikTok
      summary: Search Creators
      description:  "Search for TikTok creators using advanced filters such as `displayName`, follower count, content performance, and more. Supports fuzzy search, pagination, and multiple filter combinations. At least one filter is required. The `creatorList` is, by default, sorted by `displayName`. Custom sorting can be applied using the `sortBy` parameter. <br /><br />Optionally pass `fields` to enrich each search result with data from other endpoints. Enrichment is billed per result returned, using each endpoint's own pricing rules. Fractional calls must be enabled on your API key. For details, see [Fractional Calls](/api-v3/fractional-calls)."
      operationId: searchTiktok
      requestBody:
        content:
          application/json:
            schema:
              type: object
              description: "TikTok search request parameters."
              properties:
                filters:
                  type: array
                  description: "Filter objects that include `filterName`, `op`, and `value`. For all accepted `filterName` values and their data types, see [Configuring Custom Search Filters and Examples](https://docs.creatordb.app/api-v3/configuring_advanced_search_filters#configuring-custom-tiktok-filter-search-criteria)."
                  minItems: 1
                  items:
                    type: object
                    properties:
                      filterName:
                        type: string
                        description: "The field to apply the filter on."
                      op:
                        type: string
                        enum:
                          - in
                          - ">"
                          - "="
                          - "<"
                        description: "The comparison operator. Accepted values include `in`, `>`, `=`, `<`. <br /> -String fields accept: `=`, `in`. <br /> -Number fields accept: `>`, `=`, `<`. <br /> -Boolean fields accept: `=`"
                      value:
                        description: "Type depends on the `filterName`. <br /> - String fields accept `string` or `string[]`. <br /> - Number fields accept `number`. <br /> -Boolean fields accept `boolean`. <br /> - Operator `in` accepts `string[]`, operator `=` accepts string for string fields."
                        anyOf:
                          - type: string
                          - type: number
                          - type: array
                            maxItems: 100
                            items:
                              type: string
                          - type: boolean
                      isFuzzySearch:
                        type: boolean
                        description: "When `true`, performs a fuzzy match for `string` type `filterName`."
                    required:
                      - filterName
                      - op
                      - value
                desc:
                  type: boolean
                  description: "Sort order for results. `true` for descending, `false` for ascending order."
                sortBy:  
                  type: string
                  description: "Field to sort creators by. For example, `totalFollowers` sorts by follower count."
                pageSize:
                  type: integer
                  description: "Number of results per page. Maximum: 100."
                  minimum: 1
                  maximum: 100
                offset:
                  type: integer
                  description: "Number of records to skip before returning results."
                  minimum: 0
                fields:
                  type: object
                  description: "Enrich each search result with data from other endpoints on the same platform (e.g. `profile`, `contact`). Enrichment is billed per result returned, using each endpoint's pricing rules. Each key is a bare endpoint name, and each key's value follows that endpoint's fractional shape. For details, see [Field and Item Costs](/api-v3/field-and-item-costs#tiktok/search)."
                  properties:
                    profile:
                      type: array
                      items:
                        type: string
                      description: "Profile fields to add to each search result."
                    performance:
                      type: array
                      items:
                        type: string
                      description: "Performance blocks to add to each search result."
                    audience:
                      type: array
                      items:
                        type: string
                      description: "Audience fields to add to each search result."
                    contact:
                      type: array
                      items:
                        type: string
                      description: "Contact fields to add to each search result."
                    content-detail:
                      type: object
                      description: "Per-item counts, e.g. { \"recentVideos\": 5 }. `0`, `null`, or omission returns zero items for that field. Valid field names vary by platform. For details, see [Fractional Calls](/api-v3/fractional-calls)."
                    performance-history:
                      type: object
                      required: [pastDayRange]
                      properties:
                        pastDayRange:
                          type: integer
                          minimum: 1
                          maximum: 400
                          description: "Number of past days of daily snapshots, from 1 to 400, as a JSON number (for example `90`, not `\"90\"`)."
                      description: "Date range bucket, e.g. { \"pastDayRange\": 90 }. For pricing, see [Performance history pricing](/api-v3/api-credit-usage#performance-history-pricing)."
                  additionalProperties: false
                  examples:
                    - profile:
                        - country
                      content-detail:
                          recentVideos: 3
                      performance-history:
                          pastDayRange: 90
              required:
                - filters
                - pageSize
                - offset
              examples:
                - filters:
                    - filterName: displayName
                      op: "="
                      value: beast
                      isFuzzySearch: true
                  desc: true
                  sortBy: displayName
                  pageSize: 10
                  offset: 0
      x-codeSamples:
        - lang: bash
          label: cURL
          source: |
            curl -X POST "https://apiv3.creatordb.app/tiktok/search" \
              -H "Content-Type: application/json" \
              -H "api-key: <YOUR_API_KEY_HERE>" \
              -d '{
                "filters": [
                  {"filterName": "avgVideosEngagementRate", "op": ">", "value": 0.03},
                  {"filterName": "totalContents", "op": ">", "value": 20},
                  {"filterName": "followerGrowthIn30d", "op": ">", "value": 1000},
                  {"filterName": "avgVideosLikes", "op": ">", "value": 500}
                ],
                "sortBy": "avgVideosEngagementRate",
                "desc": true,
                "pageSize": 50,
                "offset": 0
              }'
      responses:
        "200":
          description: "TikTok search results returned successfully."
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    description: "Search results containing TikTok creators and pagination information."
                    properties:
                      creatorList:
                        type: array
                        description: "Creator objects matching the search query."
                        items:
                          type: object
                          description: "Creator details in search results."
                          properties:
                            displayName:
                              type: string
                              description: "The TikTok account name."
                              examples:
                                - TikTok
                            uniqueId:
                              type: string
                              description: "The TikTok handle."
                              examples:
                                - tiktok
                            avatarUrl:
                              type: string
                              description: "The profile picture URL."
                              examples:
                                - "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt..."
                            totalFollowers:
                              type: integer
                              description: "Total number of followers."
                              minimum: 0
                              examples:
                                - 38100
                            profile:
                              $ref: "#/components/schemas/TiktokProfileData"
                              description: "Profile data for this creator. Present only when requested via `fields.profile`."
                            performance:
                              $ref: "#/components/schemas/TiktokPerformanceData"
                              description: "Performance data for this creator. Present only when requested via `fields.performance`."
                            audience:
                              $ref: "#/components/schemas/TiktokAudienceData"
                              description: "Audience demographics for this creator. Present only when requested via `fields.audience`."
                            contact:
                              $ref: "#/components/schemas/TiktokContactData"
                              description: "Contact information for this creator. Present only when requested via `fields.contact`."
                            content-detail:
                              $ref: "#/components/schemas/TiktokContentDetailData"
                              description: "Recent content published by this creator. Present only when requested via `fields.content-detail`."
                            performance-history:
                              $ref: "#/components/schemas/TiktokPerformanceHistoryData"
                              description: "Daily performance snapshots for this creator. Present only when requested via `fields.performance-history`."
                          required:
                            - displayName
                            - uniqueId
                            - avatarUrl
                            - totalFollowers
                      totalResults:
                        type: integer
                        description: "Number of results for this search query."
                        minimum: 0
                        examples:
                          - 1
                      hasNextPage:
                        type: boolean
                        description: "`true` if there is a next page of results."
                        examples:
                          - true
                      nextOffset:
                        type: integer
                        description: "The offset value to use for retrieving results on the next page."
                        minimum: 0
                        examples:
                          - 100
                    required:
                      - creatorList
                      - totalResults
                      - hasNextPage
                      - nextOffset
                  creditsUsed:
                    type: number
                    description: "Number of API credits consumed by this request."
                    examples:
                      - 1
                  creditsAvailable:
                    type: number
                    description: "Number of API credits remaining. Equals planCreditsAvailable plus purchasedCreditsAvailable."
                    examples:
                      - -1
                  planCreditsAvailable:
                    type: number
                    description: "Remaining plan credits after this request, in credits."
                    examples:
                      - 900
                  purchasedCreditsAvailable:
                    type: number
                    description: "Remaining purchased-bucket credits after this request, in display units."
                    examples:
                      - 75
                  keyCreditsAvailable:
                    type: number
                    description: "Remaining credits this API key can spend after this request, before reaching its spend limit. Present only when the key has a spend limit."
                    examples:
                      - 4975
                  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
                  enrichment:
                    type: object
                    description: "Enrichment status for this request. Present only when `fields` was supplied."
                    properties:
                      applied:
                        type: boolean
                        description: "Whether each result was enriched with the requested `fields`. `false` when enrichment was skipped because the remaining credits could not cover it, in which case only the standard search fields are returned."
                        examples:
                          - true
                      message:
                        type: string
                        description: "Note explaining the enrichment outcome. Present when enrichment was skipped."
                    required:
                      - applied
                required:
                  - data
                  - traceId
                  - timestamp
                  - errorCode
                  - errorDescription
                  - success
                  - creditsUsed
                  - creditsAvailable
                  - planCreditsAvailable
                  - purchasedCreditsAvailable
              examples:
                default:
                  value:
                    data:
                      creatorList:
                        - displayName: Ty Myers
                          uniqueId: tymyers
                          avatarUrl: >-
                            https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/95a314aa4befbecaa494aab7e5f6d0cb~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=e4f46e62&x-expires=1768428000&x-signature=Ms7U88fImoMAYs24EQrMEFjXFeY%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=sg1
                          totalFollowers: 779800
                        - displayName: barbie
                          uniqueId: barbiechicc
                          avatarUrl: >-
                            https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/30332117a44f5d110f8275983e3fb0fc~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=bb9952be&x-expires=1753714800&x-signature=zotHqzcGBpvhUi4mN1shxuXzMMU%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my2
                          totalFollowers: 235500
                        - displayName: Rory Bland
                          uniqueId: rorybland
                          avatarUrl: >-
                            https://p16-sign-sg.tiktokcdn.com/tos-alisg-avt-0068/0de0d03ca26837b005fa4232e99d1e0e~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=352087cd&x-expires=1766962800&x-signature=xJmcAIYn2LqU1%2BDGvsbsMuRdHcE%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=maliva
                          totalFollowers: 238700
                        - displayName: "\U0001D53D\U0001D55A\U0001D558\U0001D559\U0001D565\U0001D55A\U0001D55F\U0001D558"
                          uniqueId: fightzoneofficial0
                          avatarUrl: >-
                            https://p16-sign-sg.tiktokcdn.com/tos-alisg-avt-0068/0af25589aced72808751ba4c919db3c6~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=8d117d67&x-expires=1768467600&x-signature=KT2F8H%2FjReky%2BnpWpIvzSVW1OSs%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=maliva
                          totalFollowers: 22000
                        - displayName: Vanessa Mai
                          uniqueId: vanessa.mai
                          avatarUrl: >-
                            https://p19-common-sign-useastred.tiktokcdn-eu.com/tos-useast2a-avt-0068-euttp/712c5cb8b82a369c92cd5348ebacabc8~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=1b65e83f&x-expires=1768417200&x-signature=eXQtvZydJDiuHfYvZToJodLJjus%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=maliva
                          totalFollowers: 1700000
                        - displayName: linatejeirofc
                          uniqueId: linatejeirofc_
                          avatarUrl: >-
                            https://p16-sign-sg.tiktokcdn.com/tos-alisg-avt-0068/8ed9039524261f7d7cc699412c46d81a~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=7311701b&x-expires=1758495600&x-signature=ygXyejZSadm8bCM5wBCjBZNB0MA%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my
                          totalFollowers: 4791
                        - displayName: Tecnologías BG
                          uniqueId: tecnologiasbg
                          avatarUrl: >-
                            https://p16-sign-sg.tiktokcdn.com/tos-alisg-avt-0068/4a40b9a4d114d6e6856f61ead0d9ca83~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=9bf28d33&x-expires=1768230000&x-signature=Q%2FymfDk5JcT7EEjlNifmt5PBxfE%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=maliva
                          totalFollowers: 3296
                        - displayName: BHP
                          uniqueId: bhp
                          avatarUrl: >-
                            https://p16-sign-sg.tiktokcdn.com/tos-alisg-avt-0068/7340142468840554517~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=a8a6e235&x-expires=1768370400&x-signature=v8x9UBvD%2Bih2NC%2BfuCfvw8D%2BqZc%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my
                          totalFollowers: 134500
                      hasNextPage: false
                      nextOffset: 0
                    creditsUsed: 1
                    creditsAvailable: 975
                    planCreditsAvailable: 900
                    purchasedCreditsAvailable: 75
                    traceId: f790925aeaa82fa64b24c1400cbf5e3e
                    timestamp: 1768326490384
                    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 filters:
                  summary: Missing filters field
                  value:
                    success: false
                    error: "VALIDATION_ERROR"
                    message: "At least 1 filter object is required."
                    timestamp: 1770099403116
                invalid filterName:
                  summary: Invalid filterName
                  value:
                    success: false
                    error: "VALIDATION_ERROR"
                    message: "Invalid 'filterName' for TikTok. For accepted values, see: https://docs.creatordb.app/api-v3/configuring_advanced_search_filters#configuring-custom-tiktok-filter-search-criteria."
                    timestamp: 1770099403116
                invalid pageSize:
                  summary: pageSize exceeds upper limit
                  value:
                    success: false
                    error: "VALIDATION_ERROR"
                    message: "Exceeded max pageSize of 100. Must be between 1 and 100."
                    timestamp: 1770099403116
        "429":
          description: "Exceeded quota or rate limit."
          content:
            application/json:
              schema:
                type: object
                title: QuotaErrorResponse
                description: "Quota error response format."
                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)"
  /tiktok/content-search:
    post:
      summary: "Search Content"
      description: "Search TikTok videos across every creator in the CreatorDB database, using content-level and creator-level filters. Returns individual content items, each with a short summary of its creator. Without `timeRange` or a `publishTime` filter, the search covers the last 30 days. <br /><br />Each call costs 1–28 credits, set by the time window, a `description` filter, a 100K+ `followers` floor. A search with no matches is still charged. For filters, pricing, and examples, see [Using Content Search](/api-v3/content-search)."
      operationId: "searchTiktokContent"
      tags:
        - "TikTok"
      requestBody:
        content:
          application/json:
            schema:
              type: "object"
              properties:
                filters:
                  type: "array"
                  items:
                    type: "object"
                    properties:
                      filterName:
                        type: "string"
                        description: "The field to apply the filter on."
                      op:
                        type: "string"
                        enum:
                          - "in"
                          - ">"
                          - "="
                          - "<"
                        description: "The comparison operator. Available values include `in`, `>`, `=`, `<`. String fields support: =, in. Number fields support: >, =, <. Boolean fields support: ="
                      value:
                        anyOf:
                          - type: "string"
                          - type: "number"
                          - type: "array"
                            items:
                              type: "string"
                            minItems: 1
                            maxItems: 100
                          - type: "boolean"
                        description: "Type depends on the `filterName`. - String fields accept `string` or `string[]`. - Number fields accept `number`. - Boolean fields accept `boolean`. - Operator `in` accepts `string[]`, operator `=` accepts string for `string` fields."
                      isFuzzySearch:
                        type: "boolean"
                        default: false
                        description: "When `true`, matches the value anywhere in the text. Only accepted on `description`, `hashtag`, `creatorDisplayName`, `creatorBio`. With `in`, matches content that contains any of the values (at most 10)."
                    required:
                      - "filterName"
                      - "op"
                      - "value"
                  minItems: 1
                  maxItems: 10
                  description: "Filter objects that include `filterName`, `op`, and `value`. For all accepted `filterName` values, see [Using Content Search](/api-v3/content-search#content-search-by-platform). Use `uniqueId` to search one creator's content."
                desc:
                  type: "boolean"
                  description: "Sort order for results. `true` for descending, `false` for ascending order. Default is `true`."
                sortBy:
                  type: "string"
                  enum:
                    - "plays"
                    - "diggs"
                    - "comments"
                    - "shares"
                    - "engagement"
                    - "publishTime"
                    - "lengthSec"
                    - "performanceDiggs"
                    - "performanceEngagement"
                    - "followers"
                  default: "publishTime"
                  description: "The field to sort results by. Default is `publishTime`."
                pageSize:
                  type: "integer"
                  minimum: 1
                  maximum: 100
                  description: "Number of results per page. Maximum: 100."
                offset:
                  type: "integer"
                  minimum: 0
                  description: "Number of records to skip before returning results."
                timeRange:
                  type: "object"
                  properties:
                    from:
                      type: "integer"
                      minimum: 1000000000000
                      maximum: 253402300799999
                      description: "Start of the range, Unix milliseconds, **inclusive**."
                      example: 1767225600000
                    to:
                      type: "integer"
                      minimum: 1000000000000
                      maximum: 253402300799999
                      description: "End of the range, Unix milliseconds, **exclusive**. Defaults to the time of the request."
                      example: 1775001600000
                  required:
                    - "from"
                  description: "The publish-date range to search, as absolute times. Only content published inside the range is returned. Without `timeRange` or any `publishTime` filter, the search covers the last 30 days."
              required:
                - "filters"
                - "pageSize"
                - "offset"
              description: "TikTok content search request parameters. Search for TikTok videos across all creators in the CreatorDB database using content-level and creator-level filters."
              example:
                filters:
                  - filterName: "plays"
                    op: ">"
                    value: 5000000
                  - filterName: "publishTime"
                    op: "<"
                    value: 7
                  - filterName: "engagement"
                    op: ">"
                    value: 0.05
                sortBy: "plays"
                desc: true
                pageSize: 20
                offset: 0
      responses:
        "200":
          description: "Content search results."
          content:
            application/json:
              schema:
                type: "object"
                properties:
                  data:
                    type: "object"
                    properties:
                      contentList:
                        type: "array"
                        items:
                          type: "object"
                          properties:
                            contentId:
                              type: "string"
                              description: "The unique video ID. URL: `https://www.tiktok.com/@{uniqueId}/video/{contentId}`"
                              example: "7318379374288424225"
                            description:
                              type: "string"
                              description: "The video caption."
                              example: "hope everyone is having a nice day! ✨🤍 #xmas #christmas #xmas2023 #tryon #foryoupage #fyp #foryou"
                            thumbnail:
                              type: "string"
                              description: "The Thumbnail or cover image URL."
                              example: "https://p19-common-sign-useastred.tiktokcdn-eu.com/..."
                            url:
                              type: "string"
                              description: "Direct URL of the content."
                              example: "https://www.tiktok.com/@.....aaaaesthetic/video/7318379374288424225"
                            publishTime:
                              type: "integer"
                              minimum: 0
                              description: "Publish time, represented as a Unix timestamp in milliseconds."
                              example: 1703942994000
                            lengthSec:
                              type: "integer"
                              minimum: 0
                              description: "Duration of the video in seconds."
                              example: 11
                            plays:
                              type: "integer"
                              minimum: 0
                              description: "Number of plays."
                              example: 1947
                            likes:
                              type: "integer"
                              minimum: 0
                              description: "Number of likes."
                              example: 239
                            comments:
                              type: "integer"
                              minimum: 0
                              description: "Number of comments."
                              example: 7
                            shares:
                              type: "integer"
                              minimum: 0
                              description: "Number of shares."
                              example: 1
                            engagementRate:
                              type: "number"
                              description: "Engagement rate, rounded to 4 decimal places. *Engagement rate = (likes + comments + shares) / plays.*"
                              example: 0.1269
                            hashtags:
                              type: "array"
                              items:
                                type: "string"
                              description: "Keywords in the video description."
                              example:
                                - "#xmas"
                                - "#foryoupage"
                            audioTitle:
                              type: "string"
                              description: "Title of the audio in the content."
                              example: "original sound - User"
                            audioAuthor:
                              type: "string"
                              description: "Artist of the audio track."
                              example: "User"
                            creator:
                              type: "object"
                              properties:
                                uniqueId:
                                  type: "string"
                                  description: "Account handle."
                                  example: ".....aaaaesthetic"
                                displayName:
                                  type: "string"
                                  description: "Account display name."
                                  example: ".....aaesthetic"
                                avatarUrl:
                                  type: "string"
                                  description: "Account profile picture URL."
                                  example: "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/..."
                                totalFollowers:
                                  type: "integer"
                                  minimum: 0
                                  description: "Total number of followers."
                                  example: 38100
                              required:
                                - "uniqueId"
                                - "displayName"
                                - "avatarUrl"
                                - "totalFollowers"
                              description: "Creator information for the content."
                          required:
                            - "contentId"
                            - "description"
                            - "thumbnail"
                            - "url"
                            - "publishTime"
                            - "lengthSec"
                            - "plays"
                            - "likes"
                            - "comments"
                            - "shares"
                            - "engagementRate"
                            - "hashtags"
                            - "audioTitle"
                            - "audioAuthor"
                            - "creator"
                          description: "A content item matching the search query"
                        description: "Content items matching the search filters."
                      totalResults:
                        type: "integer"
                        minimum: 0
                        description: "Approximate total number of content items matching the search filters. It can include a few items that no longer load."
                        example: 3200
                      hasNextPage:
                        type: "boolean"
                        description: "`true` if there is a next page of results."
                        example: true
                      nextOffset:
                        type: "integer"
                        minimum: 0
                        description: "The offset value for retrieving the next page of results."
                        example: 20
                      timeRange:
                        type: "object"
                        properties:
                          from:
                            type:
                              - "integer"
                              - "null"
                            description: "Start, Unix milliseconds, inclusive. `null` only when the caller asked for a window with no start."
                            example: 1790812800000
                          to:
                            type: "integer"
                            description: "End, Unix milliseconds, exclusive."
                            example: 1792713600000
                          isDefault:
                            type: "boolean"
                            description: "`true` when the request set neither `timeRange` nor a `publishTime` filter, so the 30-day default was searched."
                            example: false
                        required:
                          - "from"
                          - "to"
                          - "isDefault"
                        description: "The publish-date window that was searched, on every response: `timeRange` narrowed by any `publishTime` filter, the `publishTime` filters alone, or the 30-day default when the request set neither. `to` is filled in with the request time when open."
                    required:
                      - "contentList"
                      - "totalResults"
                      - "hasNextPage"
                      - "nextOffset"
                      - "timeRange"
                    description: "Content search results with pagination details."
                  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: "Number of API credits remaining. Equals planCreditsAvailable plus purchasedCreditsAvailable."
                    example: 975
                  creditsUsed:
                    type: "number"
                    description: "Number of API credits consumed by this request, from the content search price grid. For details, see [Using Content Search](/api-v3/content-search#credit-cost)."
                    example: 25
                  planCreditsAvailable:
                    type: "number"
                    description: "Remaining plan credits after this request, in credits."
                    example: 900
                  purchasedCreditsAvailable:
                    type: "number"
                    description: "Remaining purchased-bucket credits after this request, in display units."
                    example: 75
                  keyCreditsAvailable:
                    type: "number"
                    description: "Remaining credits this API key can spend after this request, before reaching its spend limit. Present only when the key has a spend limit."
                    example: 4975
                  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"
                  - "planCreditsAvailable"
                  - "purchasedCreditsAvailable"
                  - "errorCode"
                  - "errorDescription"
                  - "success"
                description: "TikTok content search response."
        "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:
                fuzzy on a non-text field:
                  summary: "isFuzzySearch on a filter that is not free text"
                  value:
                    success: false
                    error: "ValidationError"
                    message: "Request validation failed"
                    errorCode: "VALIDATION_ERROR"
                    timestamp: 1793603319958
                    details:
                      - field: "filters.0.isFuzzySearch"
                        message: "isFuzzySearch is not supported for field 'country'. Allowed fields: description, hashtag, creatorDisplayName, creatorBio"
                missing offset:
                  summary: "offset is required"
                  value:
                    success: false
                    error: "ValidationError"
                    message: "Request validation failed"
                    errorCode: "VALIDATION_ERROR"
                    timestamp: 1793603319958
                    details:
                      - field: "offset"
                        message: "Invalid input: expected number, received undefined"
                window does not overlap:
                  summary: "timeRange and publishTime do not overlap"
                  value:
                    success: false
                    error: "ValidationError"
                    message: "Request validation failed"
                    errorCode: "VALIDATION_ERROR"
                    timestamp: 1793603319958
                    details:
                      - field: "timeRange"
                        message: "timeRange does not overlap the publishTime filter"
        "429":
          description: "Exceeded quota or rate limit."
          content:
            application/json:
              schema:
                type: "object"
                title: "QuotaErrorResponse"
                description: "Quota error response format."
                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)"
  # TikTok creator profile
  /tiktok/submitCreators:
    post:
      tags:
        - TikTok
      summary: Submit Creators
      description: "Submit new TikTok creators to the CreatorDB database for indexing. Creators are identified by handle. Accepted creators enter a processing queue and become available through the other TikTok endpoints after their first scrape. Submissions are free of charge. You can submit up to 10,000 identifiers per API key per UTC day. This limit is shared across the YouTube, Instagram, and TikTok submit endpoints. For details, see [API Credit Usage](/api-v3/api-credit-usage). Send bare identifiers, not profile URLs. A URL doesn't cause the request to fail. Instead, the request succeeds and the response marks that entry with status `rejected`, so check the status of every entry."
      operationId: submitTiktokCreators
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - uniqueIds
              properties:
                uniqueIds:
                  type: array
                  description: "TikTok handles to submit for indexing. Handles are case-insensitive, and a leading `@` is stripped. Leading and trailing whitespace is trimmed. Each handle is 2 to 24 characters and can contain letters, digits, periods (`.`), underscores (`_`), and hyphens (`-`). Numeric account IDs are not accepted. Accepts 1 to 100 handles."
                  items:
                    type: string
                  minItems: 1
                  maxItems: 100
                  examples:
                    - ["charlidamelio", "khaby.lame"]
      x-codeSamples:
        - lang: bash
          label: cURL
          source: |
            curl -X POST "https://apiv3.creatordb.app/tiktok/submitCreators" \
              -H "Content-Type: application/json" \
              -H "api-key: <YOUR_API_KEY_HERE>" \
              -d '{ "uniqueIds": ["charlidamelio", "khaby.lame"] }'
      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 TikTok handle, in the same submission order."
                        items:
                          type: object
                          properties:
                            uniqueId:
                              type: string
                              description: "The submitted TikTok handle."
                            status:
                              type: string
                              description:  "This entry's indexing status. Entries aren't charged, regardless of their status.<br/> - `accepted`: entered the processing queue.<br/> - `done`: already indexed in the database.<br/> - `rejected`: not a valid handle, such as a profile URL.<br/> For details, see [API Credit Usage](/api-v3/api-credit-usage)."
                              enum:
                                - accepted
                                - done
                                - rejected
                            existingUniqueId:
                              type:
                                - string
                                - "null"
                              description: "Returns the existing CreatorDB identifier when the indexing status is `done`. Otherwise, `null`."
                          required:
                            - uniqueId
                            - status
                            - existingUniqueId
                    required:
                      - results
                  creditsUsed:
                    type: number
                    examples:
                      - 0
                  creditsAvailable:
                    description: "Number of API credits remaining. Equals planCreditsAvailable plus purchasedCreditsAvailable."
                    type: number
                  planCreditsAvailable:
                    type: number
                    description: "Remaining plan credits after this request, in credits."
                    examples:
                      - 900
                  purchasedCreditsAvailable:
                    type: number
                    description: "Remaining purchased-bucket credits after this request, in display units."
                    examples:
                      - 75
                  keyCreditsAvailable:
                    type: number
                    description: "Remaining credits this API key can spend after this request, before reaching its spend limit. Present only when the key has a spend limit."
                    examples:
                      - 4975
                  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
                  - creditsAvailable
                  - creditsUsed
                  - planCreditsAvailable
                  - purchasedCreditsAvailable
                  - errorCode
                  - errorDescription
                  - success
  #TikTok niches
  /tiktok/profile:
    post:
      tags:
        - TikTok
      summary: Get Profile Information
      description: "Retrieve profile information of a specified TikTok creator, including metadata, statistics, hashtags, and content analysis.<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`). For per-field pricing, see [Field and Item Costs](/api-v3/field-and-item-costs#tiktok/profile). For how fractional calls work, see [Fractional Calls](/api-v3/fractional-calls)."
      operationId: getTiktokProfile
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - uniqueId
              properties:
                uniqueId:
                  type: string
                  description: "TikTok account ID. Accepts `tiktok` or `@tiktok` (@ is stripped automatically)."
                  pattern: "^@?[a-zA-Z0-9._-]{1,24}$"
                  minLength: 1
                  maxLength: 25
                  examples:
                    - tiktok
                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. For details, see [Field and Item Costs](/api-v3/field-and-item-costs#tiktok/profile)."
                  items:
                    type: string
                    enum:
                      - uniqueId
                      - displayName
                      - category
                      - avatarUrl
                      - bio
                      - isBusinessAccount
                      - isPrivateAccount
                      - isVerified
                      - hasSponsors
                      - country
                      - mainLanguage
                      - languages
                      - secondLanguage
                      - totalContents
                      - totalFollowing
                      - totalFollowers
                      - subscriberGrowth
                      - hashtags
                      - topics
                      - niches
                      - otherLinks
                      - lastPublishTime
                      - lastDbUpdateTime
                  examples:
                    - ["displayName", "country", "totalFollowers"]
      x-codeSamples:
        - lang: bash
          label: cURL
          source: |
            curl -X POST "https://apiv3.creatordb.app/tiktok/profile" \
              -H "Content-Type: application/json" \
              -H "api-key: <YOUR_API_KEY_HERE>" \
              -d '{ "uniqueId": "charlidamelio", "fields": ["displayName", "country"] }'
      responses:
        "200":
          description: "TikTok creator profile information returned successfully."
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: "#/components/schemas/TiktokProfileData"
                    required:
                      - uniqueId
                      - displayName
                      - category
                      - avatarUrl
                      - bio
                      - isBusinessAccount
                      - isPrivateAccount
                      - isVerified
                      - hasSponsors
                      - country
                      - mainLanguage
                      - languages
                      - secondLanguage
                      - totalContents
                      - totalFollowing
                      - totalFollowers
                      - subscriberGrowth
                      - hashtags
                      - topics
                      - niches
                      - otherLinks
                      - lastPublishTime
                      - lastDbUpdateTime
                  creditsUsed:
                    type: number
                    description: "Number of API credits consumed by this request."
                    examples:
                      - 1
                  creditsAvailable:
                    type: number
                    description: "Number of API credits remaining. Equals planCreditsAvailable plus purchasedCreditsAvailable."
                    examples:
                      - -1
                  planCreditsAvailable:
                    type: number
                    description: "Remaining plan credits after this request, in credits."
                    examples:
                      - 900
                  purchasedCreditsAvailable:
                    type: number
                    description: "Remaining purchased-bucket credits after this request, in display units."
                    examples:
                      - 75
                  keyCreditsAvailable:
                    type: number
                    description: "Remaining credits this API key can spend after this request, before reaching its spend limit. Present only when the key has a spend limit."
                    examples:
                      - 4975
                  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
                  - planCreditsAvailable
                  - purchasedCreditsAvailable
              examples:
                default:
                  value:
                    data:
                      uniqueId: charlidamelio
                      displayName: charli d’amelio
                      category: ""
                      avatarUrl: >-
                        https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/7310052907548688430~tplv-tiktokx-cropcenter:720:720.jpeg?dr=14579&refresh_token=d917d4bb&x-expires=1768021200&x-signature=YzmaK9NcAS6NfN%2BNcV1LLX3jJec%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=f20df69d&idc=maliva
                      bio: ":)"
                      isBusinessAccount: false
                      isPrivateAccount: false
                      isVerified: true
                      hasSponsors: false
                      country: USA
                      mainLanguage: eng
                      languages:
                        - eng
                      secondLanguage: null
                      totalContents: 25
                      totalFollowers: 155900000
                      totalFollowing: 1289
                      subscriberGrowth:
                        g7: 0.0012
                        g30: 0.0045
                        g90: 0.0123
                      hashtags:
                        - name: "#pradamode"
                          contentCount: 2
                        - name: "#redbulldanceyourstyle"
                          contentCount: 2
                        - name: "#redbullfam"
                          contentCount: 2
                        - name: "#givesyouwiiings"
                          contentCount: 1
                        - name: "#katespadenypartner"
                          contentCount: 1
                        - name: "#pradass26"
                          contentCount: 1
                        - name: "#eadv2025"
                          contentCount: 1
                        - name: "#ceraveeadv2025"
                          contentCount: 1
                        - name: "#ceravepartner"
                          contentCount: 1
                      topics:
                        - id_couple_PeopleBlogs_tiktok
                        - id_socialmedia_Entertainment_tiktok
                        - id_fashion_HowtoStyle_tiktok
                        - id_lifestyle_HowtoStyle_tiktok
                        - id_celebritylifestyle_Entertainment_tiktok
                        - id_vlog_UniversalTopics_tiktok
                      niches:
                        - dance_All
                        - entertainment_All
                        - lifestyle_All
                      otherLinks:
                        - title: ""
                          url: >-
                            https://www.tiktok.com/link/v2?aid=1988&lang=en&scene=bio_url&target=win.gs/DanceYourStyleLA
                      lastPublishTime: 1763599023000
                      lastDbUpdateTime: 1767830400000
                    creditsUsed: 1
                    creditsAvailable: 975
                    planCreditsAvailable: 900
                    purchasedCreditsAvailable: 75
                    traceId: e2817236a4f325570bfe6ee5fae33f23
                    timestamp: 1767936363120
                    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 uniqueId:
                  summary: Missing uniqueId
                  value:
                    success: false
                    error: "VALIDATION_ERROR"
                    message: "Missing required field: 'uniqueId'."
                    timestamp: 1770099403116
                invalid uniqueId:
                  summary: Invalid uniqueId format
                  value:
                    success: false
                    error: "VALIDATION_ERROR"
                    message: "Invalid 'uniqueId' format. The TikTok unique ID must be between 1 and 101 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)"
  # TikTok contact
  /tiktok/contact:
    post:
      tags:
        - TikTok
      summary: Get Contact
      description: "Retrieve the contact information of the specified TikTok creator.<br /><br />Optionally pass `fields` in the request body to return a creator's contact information. The single available field, `emails`, is billed at the full-bundle price. The contact endpoint currently exposes only this one billable field, so fractional calls do not offer any savings yet. Fractional calls must be enabled on your API key. Otherwise, a request that includes `fields` returns a `400` error (`FractionalCallsNotEnabled`). For per-field costs, see [Field and Item Costs](/api-v3/field-and-item-costs#tiktok/contact). For how fractional calls work, see [Fractional Calls](/api-v3/fractional-calls)."
      operationId: getTiktokContact
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - uniqueId
              properties:
                uniqueId:
                  type: string
                  description: "TikTok account ID. Accepts `tiktok` or `@tiktok` (@ is stripped automatically)."
                  pattern: "^@?[a-zA-Z0-9._-]{1,24}$"
                  minLength: 1
                  maxLength: 25
                  examples:
                    - tiktok
                fields:
                  type: array
                  description: "Subset of contact fields to return. Omit or pass an empty array to return the full response at the full-bundle price. For per-field costs, see [Field and Item Costs](/api-v3/field-and-item-costs#tiktok/contact)."
                  items:
                    type: string
                    enum:
                      - emails
      x-codeSamples:
        - lang: bash
          label: cURL
          source: |
            curl -X POST "https://apiv3.creatordb.app/tiktok/contact" \
              -H "Content-Type: application/json" \
              -H "api-key: <YOUR_API_KEY_HERE>" \
              -d '{ "uniqueId": "kallmekris" }'
      responses:
        "200":
          description: "TikTok creator contact data returned successfully."
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: "#/components/schemas/TiktokContactData"
                    required:
                      - emails
                  creditsUsed:
                    type: number
                    description: "Number of API credits consumed by this request."
                    examples:
                      - 1
                  creditsAvailable:
                    type: number
                    description: "Number of API credits remaining. Equals planCreditsAvailable plus purchasedCreditsAvailable."
                    examples:
                      - -1
                  planCreditsAvailable:
                    type: number
                    description: "Remaining plan credits after this request, in credits."
                    examples:
                      - 900
                  purchasedCreditsAvailable:
                    type: number
                    description: "Remaining purchased-bucket credits after this request, in display units."
                    examples:
                      - 75
                  keyCreditsAvailable:
                    type: number
                    description: "Remaining credits this API key can spend after this request, before reaching its spend limit. Present only when the key has a spend limit."
                    examples:
                      - 4975
                  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
                  - planCreditsAvailable
                  - purchasedCreditsAvailable
              examples:
                default:
                  value:
                    data:
                      emails:
                        - teamkriscollins@gersh.com
                    creditsUsed: 1
                    creditsAvailable: 975
                    planCreditsAvailable: 900
                    purchasedCreditsAvailable: 75
                    traceId: 626ec5ec515aa1037668e84a959eeaaf
                    timestamp: 1767939397696
                    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 uniqueId:
                  summary: Missing uniqueId
                  value:
                    success: false
                    error: "VALIDATION_ERROR"
                    message: "Missing required field: 'uniqueId'."
                    timestamp: 1770099403116
                invalid uniqueId:
                  summary: Invalid uniqueId format
                  value:
                    success: false
                    error: "VALIDATION_ERROR"
                    message: "Invalid 'uniqueId' format. TikTok unique ID must be between 1 to 101 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)"
  # TikTok performance metrics
  /tiktok/performance:
    post:
      tags:
        - TikTok
      summary: Get Performance Information
      description: "Retrieve advanced performance information of a specified TikTok creator, including post activity, follower growth, engagement metrics, and content performance.<br /><br />Optionally pass `fields` in the request body to return only a subset of performance blocks. Requesting a subset bills fractionally, capped at the full-bundle price. Fractional calls must be enabled on your API key. Otherwise, a request that includes `fields` returns a `400` error (`FractionalCallsNotEnabled`). For per-field costs, see [Field and Item Costs](/api-v3/field-and-item-costs#tiktok/performance). For how fractional costs work, see [Fractional Costs](/api-v3/fractional-calls)."
      operationId: getTiktokPerformance
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - uniqueId
              properties:
                uniqueId:
                  type: string
                  description: "TikTok account ID. Accepts `tiktok` or `@tiktok` (@ is stripped automatically)."
                  pattern: "^@?[a-zA-Z0-9._-]{1,24}$"
                  minLength: 1
                  maxLength: 25
                  examples:
                    - tiktok
                fields:
                  type: array
                  description: "Subset of performance blocks to return. Omit or pass an empty array to return the full response at the full-bundle price. For per-field costs, see [Field and Item Costs](/api-v3/field-and-item-costs#tiktok/performance)."
                  items:
                    type: string
                    enum:
                      - contentCountByDays
                      - ranking
                      - recentVideosGrowth
                      - videosPerformanceRecent
      x-codeSamples:
        - lang: bash
          label: cURL
          source: |
            curl -X POST "https://apiv3.creatordb.app/tiktok/performance" \
              -H "Content-Type: application/json" \
              -H "api-key: <YOUR_API_KEY_HERE>" \
              -d '{ "uniqueId": "kallmekris" }'
      responses:
        "200":
          description: "TikTok performance data returned successfully."
          content:
            application/json:
              schema:
                type: object
                description: "Performance data of the specified TikTok creator returned successfully."
                properties:
                  data:
                    $ref: "#/components/schemas/TiktokPerformanceData"
                    required:
                      - contentCountByDays
                      - ranking
                      - videosPerformanceRecent
                      - recentVideosGrowth
                  creditsUsed:
                    type: number
                    description: "Number of API credits consumed by this request."
                    examples:
                      - 1
                  creditsAvailable:
                    type: number
                    description: "Number of API credits remaining. Equals planCreditsAvailable plus purchasedCreditsAvailable."
                    examples:
                      - -1
                  planCreditsAvailable:
                    type: number
                    description: "Remaining plan credits after this request, in credits."
                    examples:
                      - 900
                  purchasedCreditsAvailable:
                    type: number
                    description: "Remaining purchased-bucket credits after this request, in display units."
                    examples:
                      - 75
                  keyCreditsAvailable:
                    type: number
                    description: "Remaining credits this API key can spend after this request, before reaching its spend limit. Present only when the key has a spend limit."
                    examples:
                      - 4975
                  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
                  - planCreditsAvailable
                  - purchasedCreditsAvailable
              examples:
                default:
                  value:
                    data:
                      contentCountByDays:
                        7d: 2
                        30d: 12
                        90d: 38
                      followerGrowthIn30d: 0
                      ranking:
                        totalFollowers:
                          global: 0.0459
                          country: 0.0395
                          language: 0.0375
                        avgViews:
                          global: 0.9183
                          country: 0.9175
                          language: 0.9128
                        avgEngagementRate:
                          global: 0.219
                          country: 0.2332
                          language: 0.2263
                      videosPerformanceRecent:
                        likes:
                          all: 3253500
                          avg: 162675
                          median: 139950
                          min: 0
                          max: 0
                        comments:
                          all: 16780
                          avg: 839
                          median: 0
                          min: 0
                          max: 0
                        views:
                          all: 19514700
                          avg: 975735
                          median: 795300
                          min: 219000
                          max: 2700000
                        shares:
                          all: 150040
                          avg: 7502
                          median: 0
                          min: 0
                          max: 0
                        engagement:
                          avgEngagementRate: 0.1638
                          likesPerFollower: 0.0032
                          commentsPerFollower: 0
                          viewsPerFollower: 0.0193
                          engagementConsistency:
                            cv: 0.183
                            medianVsMean: 0.973
                            topBottomRatio: 0
                            consistencyScore: null
                            consistencyLevel: null
                    creditsUsed: 1
                    creditsAvailable: 975
                    planCreditsAvailable: 900
                    purchasedCreditsAvailable: 75
                    traceId: 497b42dc5ed0208ddc6ab552053e90ec
                    timestamp: 1767938201026
                    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 uniqueId:
                  summary: Missing uniqueId
                  value:
                    success: false
                    error: "VALIDATION_ERROR"
                    message: "Missing required field: 'uniqueId'."
                    timestamp: 1770099403116
                invalid uniqueId:
                  summary: Invalid uniqueId format
                  value:
                    success: false
                    error: "VALIDATION_ERROR"
                    message: "Invalid 'uniqueId' format. TikTok unique ID must be between 1 to 101 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)"
  # TikTok performance history
  /tiktok/performance-history:
    get:
      tags:
        - TikTok
      summary: Get Performance History
      description: "Retrieve daily performance snapshots for a specified TikTok creator within a specific period, including upload activity, follower growth, engagement metrics, and video performance. Dates are returned as Unix timestamps in milliseconds."
      operationId: getTiktokPerformanceHistory
      parameters:
        - name: uniqueId
          in: query
          description: "TikTok account ID. Accepts `tiktok` or `@tiktok` (@ is stripped automatically)."
          required: true
          schema:
            type: string
            pattern: "^@?[a-zA-Z0-9._-]{1,24}$"
            minLength: 1
            maxLength: 25
            examples:
              - tiktok
        - name: pastDayRange
          in: query
          description: "Returns one data point per day over the requested range. For example, `30` returns the past 30 days of daily snapshots. Valid range: `1`-`400`."
          required: true
          schema:
            type: string
            pattern: '^[1-9]\d*$'
            examples:
              - "30"
      x-codeSamples:
        - lang: bash
          label: cURL
          source: |
            curl -X GET "https://apiv3.creatordb.app/tiktok/performance-history?uniqueId=charlidamelio&pastDayRange=30" \
              -H "Content-Type: application/json" \
              -H "api-key: <YOUR_API_KEY_HERE>"
      responses:
        "200":
          description: "TikTok performance historical data returned successfully."
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: "#/components/schemas/TiktokPerformanceHistoryData"
                  creditsUsed:
                    type: number
                    description: "Number of API credits consumed by this request."
                    examples:
                      - 1
                  creditsAvailable:
                    type: number
                    description: "Number of API credits remaining. Equals planCreditsAvailable plus purchasedCreditsAvailable."
                    examples:
                      - -1
                  planCreditsAvailable:
                    type: number
                    description: "Remaining plan credits after this request, in credits."
                    examples:
                      - 900
                  purchasedCreditsAvailable:
                    type: number
                    description: "Remaining purchased-bucket credits after this request, in display units."
                    examples:
                      - 75
                  keyCreditsAvailable:
                    type: number
                    description: "Remaining credits this API key can spend after this request, before reaching its spend limit. Present only when the key has a spend limit."
                    examples:
                      - 4975
                  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
                  - planCreditsAvailable
                  - purchasedCreditsAvailable
              examples:
                default:
                  value:
                    data:
                      histories:
                        - timestamp: 1767852641724
                          totalFollowers: 155900000
                          totalFollowing: 1289
                          totalContents: 2893
                          videosPerformanceRecent:
                            likes:
                              all: 11215700
                              avg: 560785
                              median: 226700
                              min: 0
                              max: 0
                            comments:
                              all: 49820
                              avg: 2491
                              median: 0
                              min: 0
                              max: 0
                            views:
                              all: 202000000
                              avg: 10100000
                              median: 7750000
                              min: 5000000
                              max: 27800000
                            shares:
                              all: 121440
                              avg: 6072
                              median: 0
                              min: 0
                              max: 0
                            engagement:
                              avgEngagementRate: 0.0442
                              likesPerFollower: 0.0036
                              commentsPerFollower: 0
                              viewsPerFollower: 0.0648
                              engagementConsistency:
                                cv: 0.7354
                                medianVsMean: 0.748
                                topBottomRatio: 0
                                consistencyScore: null
                                consistencyLevel: null
                        - timestamp: 1767766241724
                          totalFollowers: 156000000
                          totalFollowing: 1287
                          totalContents: 2892
                          videosPerformanceRecent:
                            likes:
                              all: 11204200
                              avg: 560210
                              median: 226500
                              min: 0
                              max: 0
                            comments:
                              all: 49660
                              avg: 2483
                              median: 0
                              min: 0
                              max: 0
                            views:
                              all: 201200000
                              avg: 10060000
                              median: 7650000
                              min: 5000000
                              max: 27700000
                            shares:
                              all: 121260
                              avg: 6063
                              median: 0
                              min: 0
                              max: 0
                            engagement:
                              avgEngagementRate: 0.0442
                              likesPerFollower: 0.0036
                              commentsPerFollower: 0
                              viewsPerFollower: 0.0645
                              engagementConsistency:
                                cv: 0.7352
                                medianVsMean: 0.7495
                                topBottomRatio: 0
                                consistencyScore: null
                                consistencyLevel: null
                        - timestamp: 1767679841724
                          totalFollowers: 156000000
                          totalFollowing: 1287
                          totalContents: 2892
                          videosPerformanceRecent:
                            likes:
                              all: 11984300
                              avg: 599215
                              median: 235450
                              min: 0
                              max: 0
                            comments:
                              all: 50980
                              avg: 2549
                              median: 0
                              min: 0
                              max: 0
                            views:
                              all: 203500000
                              avg: 10175000
                              median: 7600000
                              min: 4900000
                              max: 27500000
                            shares:
                              all: 105240
                              avg: 5262
                              median: 0
                              min: 0
                              max: 0
                            engagement:
                              avgEngagementRate: 0.0474
                              likesPerFollower: 0.0038
                              commentsPerFollower: 0
                              viewsPerFollower: 0.0652
                              engagementConsistency:
                                cv: 0.6964
                                medianVsMean: 0.7637
                                topBottomRatio: 0
                                consistencyScore: null
                                consistencyLevel: null
                        - timestamp: 1767593441724
                          totalFollowers: 156000000
                          totalFollowing: 1285
                          totalContents: 2892
                          videosPerformanceRecent:
                            likes:
                              all: 11064300
                              avg: 553215
                              median: 225950
                              min: 0
                              max: 0
                            comments:
                              all: 49040
                              avg: 2452
                              median: 0
                              min: 0
                              max: 0
                            views:
                              all: 197500000
                              avg: 9875000
                              median: 7550000
                              min: 4900000
                              max: 27300000
                            shares:
                              all: 120280
                              avg: 6014
                              median: 0
                              min: 0
                              max: 0
                            engagement:
                              avgEngagementRate: 0.0443
                              likesPerFollower: 0.0035
                              commentsPerFollower: 0
                              viewsPerFollower: 0.0633
                              engagementConsistency:
                                cv: 0.7317
                                medianVsMean: 0.752
                                topBottomRatio: 0
                                consistencyScore: null
                                consistencyLevel: null
                        - timestamp: 1767507041724
                          totalFollowers: 155900000
                          totalFollowing: 1290
                          totalContents: 2892
                          videosPerformanceRecent:
                            likes:
                              all: 11040000
                              avg: 552000
                              median: 225250
                              min: 0
                              max: 0
                            comments:
                              all: 48640
                              avg: 2432
                              median: 0
                              min: 0
                              max: 0
                            views:
                              all: 195200000
                              avg: 9760000
                              median: 7500000
                              min: 4800000
                              max: 27100000
                            shares:
                              all: 119460
                              avg: 5973
                              median: 0
                              min: 0
                              max: 0
                            engagement:
                              avgEngagementRate: 0.0445
                              likesPerFollower: 0.0035
                              commentsPerFollower: 0
                              viewsPerFollower: 0.0626
                              engagementConsistency:
                                cv: 0.7338
                                medianVsMean: 0.7553
                                topBottomRatio: 0
                                consistencyScore: null
                                consistencyLevel: null
                        - timestamp: 1767334241724
                          totalFollowers: 156000000
                          totalFollowing: 1290
                          totalContents: 2892
                          videosPerformanceRecent:
                            likes:
                              all: 11014300
                              avg: 550715
                              median: 224100
                              min: 0
                              max: 0
                            comments:
                              all: 48120
                              avg: 2406
                              median: 0
                              min: 0
                              max: 0
                            views:
                              all: 193100000
                              avg: 9655000
                              median: 7450000
                              min: 4800000
                              max: 26900000
                            shares:
                              all: 118800
                              avg: 5940
                              median: 0
                              min: 0
                              max: 0
                            engagement:
                              avgEngagementRate: 0.0447
                              likesPerFollower: 0.0035
                              commentsPerFollower: 0
                              viewsPerFollower: 0.0619
                              engagementConsistency:
                                cv: 0.7335
                                medianVsMean: 0.7513
                                topBottomRatio: 0
                                consistencyScore: null
                                consistencyLevel: null
                        - timestamp: 1767161441724
                          totalFollowers: 156000000
                          totalFollowing: 1290
                          totalContents: 2892
                          videosPerformanceRecent:
                            likes:
                              all: 10885000
                              avg: 544250
                              median: 222650
                              min: 0
                              max: 0
                            comments:
                              all: 47520
                              avg: 2376
                              median: 0
                              min: 0
                              max: 0
                            views:
                              all: 190700000
                              avg: 9535000
                              median: 7400000
                              min: 4700000
                              max: 26700000
                            shares:
                              all: 117860
                              avg: 5893
                              median: 0
                              min: 0
                              max: 0
                            engagement:
                              avgEngagementRate: 0.0448
                              likesPerFollower: 0.0035
                              commentsPerFollower: 0
                              viewsPerFollower: 0.0611
                              engagementConsistency:
                                cv: 0.7311
                                medianVsMean: 0.7571
                                topBottomRatio: 0
                                consistencyScore: null
                                consistencyLevel: null
                        - timestamp: 1767075041724
                          totalFollowers: 156000000
                          totalFollowing: 1290
                          totalContents: 2892
                          videosPerformanceRecent:
                            likes:
                              all: 11769800
                              avg: 588490
                              median: 231050
                              min: 0
                              max: 0
                            comments:
                              all: 48800
                              avg: 2440
                              median: 0
                              min: 0
                              max: 0
                            views:
                              all: 193300000
                              avg: 9665000
                              median: 7350000
                              min: 4700000
                              max: 26500000
                            shares:
                              all: 101960
                              avg: 5098
                              median: 0
                              min: 0
                              max: 0
                            engagement:
                              avgEngagementRate: 0.0482
                              likesPerFollower: 0.0038
                              commentsPerFollower: 0
                              viewsPerFollower: 0.062
                              engagementConsistency:
                                cv: 0.6949
                                medianVsMean: 0.7591
                                topBottomRatio: 0
                                consistencyScore: null
                                consistencyLevel: null
                        - timestamp: 1766988641724
                          totalFollowers: 156000000
                          totalFollowing: 1290
                          totalContents: 2891
                          videosPerformanceRecent:
                            likes:
                              all: 11638900
                              avg: 581945
                              median: 229400
                              min: 0
                              max: 0
                            comments:
                              all: 48240
                              avg: 2412
                              median: 0
                              min: 0
                              max: 0
                            views:
                              all: 190500000
                              avg: 9525000
                              median: 7250000
                              min: 4600000
                              max: 26200000
                            shares:
                              all: 100900
                              avg: 5045
                              median: 0
                              min: 0
                              max: 0
                            engagement:
                              avgEngagementRate: 0.0482
                              likesPerFollower: 0.0037
                              commentsPerFollower: 0
                              viewsPerFollower: 0.0611
                              engagementConsistency:
                                cv: 0.6905
                                medianVsMean: 0.7632
                                topBottomRatio: 0
                                consistencyScore: null
                                consistencyLevel: null
                        - timestamp: 1766729441724
                          totalFollowers: 156000000
                          totalFollowing: 1290
                          totalContents: 2891
                          videosPerformanceRecent:
                            likes:
                              all: 11487300
                              avg: 574365
                              median: 220450
                              min: 0
                              max: 0
                            comments:
                              all: 47220
                              avg: 2361
                              median: 0
                              min: 0
                              max: 0
                            views:
                              all: 185600000
                              avg: 9280000
                              median: 7100000
                              min: 4500000
                              max: 25300000
                            shares:
                              all: 98820
                              avg: 4941
                              median: 0
                              min: 0
                              max: 0
                            engagement:
                              avgEngagementRate: 0.0487
                              likesPerFollower: 0.0037
                              commentsPerFollower: 0
                              viewsPerFollower: 0.0595
                              engagementConsistency:
                                cv: 0.6899
                                medianVsMean: 0.7584
                                topBottomRatio: 0
                                consistencyScore: null
                                consistencyLevel: null
                        - timestamp: 1766383841724
                          totalFollowers: 156000000
                          totalFollowing: 1290
                          totalContents: 2891
                          videosPerformanceRecent:
                            likes:
                              all: 11317300
                              avg: 565865
                              median: 214300
                              min: 0
                              max: 0
                            comments:
                              all: 45960
                              avg: 2298
                              median: 0
                              min: 0
                              max: 0
                            views:
                              all: 179000000
                              avg: 8950000
                              median: 6800000
                              min: 4400000
                              max: 23600000
                            shares:
                              all: 95080
                              avg: 4754
                              median: 0
                              min: 0
                              max: 0
                            engagement:
                              avgEngagementRate: 0.0493
                              likesPerFollower: 0.0036
                              commentsPerFollower: 0
                              viewsPerFollower: 0.0574
                              engagementConsistency:
                                cv: 0.6945
                                medianVsMean: 0.7539
                                topBottomRatio: 0
                                consistencyScore: null
                                consistencyLevel: null
                    creditsUsed: 1
                    creditsAvailable: 975
                    planCreditsAvailable: 900
                    purchasedCreditsAvailable: 75
                    traceId: 20fb4d4399fcf96d227bd016d6171858
                    timestamp: 1767939041800
                    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 uniqueId:
                  summary: Missing uniqueId
                  value:
                    success: false
                    error: "VALIDATION_ERROR"
                    message: "Missing required field: 'uniqueId'."
                    timestamp: 1770099403116
                invalid pastDayRange:
                  summary: pastDayRange out of bounds
                  value:
                    success: false
                    error: "VALIDATION_ERROR"
                    message: "Request validation failed"
                    details:
                      - field: "pastDayRange"
                        message: "pastDayRange must be between 1 and 400 days"
                    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)"
  # TikTok audience demographics
  /tiktok/audience:
    post:
      tags:
        - TikTok
      summary: Get Audience Demographics
      description: "Retrieve audience demographic insights for a specified TikTok creator, including country distribution, gender breakdown, and age composition. This endpoint provides detailed audience analytics to help understand creator reach, evaluate audience alignment, and support data‑driven influencer selection and campaign targeting.<br /><br />Optionally pass `fields` in the request body to return only a subset of demographic fields. You are billed for the fields you request, capped at the full-bundle price. Fractional calls must be enabled on your API key. Otherwise, a request that includes `fields` returns a `400` error (`FractionalCallsNotEnabled`). For per-field costs, see [Field and Item Costs](/api-v3/field-and-item-costs#tiktok/audience). For how fractional calls work, see [Fractional Calls](/api-v3/fractional-calls)."
      operationId: getTiktokAudience
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - uniqueId
              properties:
                uniqueId:
                  type: string
                  description: "TikTok account ID. Accepts `tiktok` or `@tiktok` (@ is stripped automatically)."
                  pattern: "^@?[a-zA-Z0-9._-]{1,24}$"
                  minLength: 1
                  maxLength: 25
                  examples:
                    - tiktok
                fields:
                  type: array
                  description: "Subset of demographic fields to return. Omit or pass an empty array to return the full response at the full-bundle price. For per-field costs, see [Field and Item Costs](/api-v3/field-and-item-costs#tiktok/audience)."
                  items:
                    type: string
                    enum:
                      - audienceLocations
                      - audienceGender
                      - audienceAvgAge
                      - audienceAgeBreakdown
      x-codeSamples:
        - lang: bash
          label: cURL
          source: |
            curl -X POST "https://apiv3.creatordb.app/tiktok/audience" \
              -H "Content-Type: application/json" \
              -H "api-key: <YOUR_API_KEY_HERE>" \
              -d '{ "uniqueId": "davidbeckham" }'
      responses:
        "200":
          description: "TikTok audience demographic data returned successfully."
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: "#/components/schemas/TiktokAudienceData"
                    required:
                      - audienceLocations
                      - audienceGender
                      - audienceAvgAge
                      - audienceAgeBreakdown
                  creditsUsed:
                    type: number
                    description: "Number of API credits consumed by this request."
                    examples:
                      - 1
                  creditsAvailable:
                    type: number
                    description: "Number of API credits remaining. Equals planCreditsAvailable plus purchasedCreditsAvailable."
                    examples:
                      - -1
                  planCreditsAvailable:
                    type: number
                    description: "Remaining plan credits after this request, in credits."
                    examples:
                      - 900
                  purchasedCreditsAvailable:
                    type: number
                    description: "Remaining purchased-bucket credits after this request, in display units."
                    examples:
                      - 75
                  keyCreditsAvailable:
                    type: number
                    description: "Remaining credits this API key can spend after this request, before reaching its spend limit. Present only when the key has a spend limit."
                    examples:
                      - 4975
                  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
                  - planCreditsAvailable
                  - purchasedCreditsAvailable
              examples:
                default:
                  value:
                    data:
                      audienceLocations:
                        - country: USA
                          share: 0.7795
                        - country: GBR
                          share: 0.0716
                        - country: CAN
                          share: 0.0433
                      audienceGender:
                        maleRatio: 0.5833
                        femaleRatio: 0.4167
                      audienceAvgAge: 35
                      audienceAgeBreakdown:
                        - ageRange: 13-17
                          share: 0.0328
                        - ageRange: 18-24
                          share: 0.2022
                        - ageRange: 25-34
                          share: 0.2988
                        - ageRange: 35-44
                          share: 0.2585
                        - ageRange: 45-54
                          share: 0.1274
                        - ageRange: 55-64
                          share: 0.0532
                        - ageRange: 65+
                          share: 0.0271
                    creditsUsed: 1
                    creditsAvailable: 975
                    planCreditsAvailable: 900
                    purchasedCreditsAvailable: 75
                    traceId: fd5e5b27302d80f119671196c628e094
                    timestamp: 1767924063347
                    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 uniqueId:
                  summary: Missing uniqueId
                  value:
                    success: false
                    error: "VALIDATION_ERROR"
                    message: "Missing required field: 'uniqueId'."
                    timestamp: 1770099403116
                invalid uniqueId:
                  summary: Invalid uniqueId format
                  value:
                    success: false
                    error: "VALIDATION_ERROR"
                    message: "Invalid 'uniqueId' format. TikTok unique ID must be between 1 to 101 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)"
  #TikTok content details
  /tiktok/content-detail:
    post:
      tags:
        - TikTok
      summary: Get Content Details
      description: "Retrieve the most recent TikTok videos information of a specified creator, including publish time, video description, and engagement metrics.<br /><br />Optionally pass `fields` in the request body to limit how many items each content-detail array returns. Each item returned is billed individually, capped at the full-bundle price. Fractional calls must be enabled on your API key. Otherwise, a request that includes `fields` returns a `400` error (`FractionalCallsNotEnabled`). For per-item costs, see [Field and Item Costs](/api-v3/field-and-item-costs#tiktok/content-detail). For how fractional calls work, see [Fractional Calls](/api-v3/fractional-calls)."
      operationId: getTiktokContentDetail
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - uniqueId
              properties:
                uniqueId:
                  type: string
                  description: "TikTok account ID. Accepts `tiktok` or `@tiktok` (@ is stripped automatically)."
                  pattern: "^@?[a-zA-Z0-9._-]{1,24}$"
                  minLength: 1
                  maxLength: 25
                  examples:
                    - tiktok
                fields:
                  type: object
                  description: "Map each content array to the number of items to return. Omit or pass an empty object to return all items at the full-bundle price. For per-item costs, see [Field and Item Costs](/api-v3/field-and-item-costs#tiktok/content-detail)."
                  properties:
                    recentVideos:
                      anyOf:
                        - type: integer
                          minimum: 0
                        - type: "null"
                      description: "Number of recent videos to return. Pass `null` to skip this field and be charged 0 for it."
                      examples:
                        - 5
                  additionalProperties: false
      x-codeSamples:
        - lang: bash
          label: cURL
          source: |
            curl -X POST "https://apiv3.creatordb.app/tiktok/content-detail" \
              -H "Content-Type: application/json" \
              -H "api-key: <YOUR_API_KEY_HERE>" \
              -d '{ "uniqueId": "kallmekris", "fields": { "recentVideos": 5 } }'
      responses:
        "200":
          description: "TikTok content details returned successfully."
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: "#/components/schemas/TiktokContentDetailData"
                    required:
                      - recentVideos
                  creditsUsed:
                    type: number
                    description: "Number of API credits consumed by this request."
                    examples:
                      - 1
                  creditsAvailable:
                    type: number
                    description: "Number of API credits remaining. Equals planCreditsAvailable plus purchasedCreditsAvailable."
                    examples:
                      - -1
                  planCreditsAvailable:
                    type: number
                    description: "Remaining plan credits after this request, in credits."
                    examples:
                      - 900
                  purchasedCreditsAvailable:
                    type: number
                    description: "Remaining purchased-bucket credits after this request, in display units."
                    examples:
                      - 75
                  keyCreditsAvailable:
                    type: number
                    description: "Remaining credits this API key can spend after this request, before reaching its spend limit. Present only when the key has a spend limit."
                    examples:
                      - 4975
                  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
                  - planCreditsAvailable
                  - purchasedCreditsAvailable
              examples:
                default:
                  value:
                    data:
                      recentVideos:
                        - publishTime: 1767651698000
                          contentId: "7592006153727380766"
                          description: "What I Imagine pt. \U0001F35F\U0001F45A"
                          coverImageUrl: >-
                            https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/o4nOXHCqlhQOW48cFeLIAkGfRcAGC3fQQHe5UN~tplv-tiktokx-origin.image?dr=14575&x-expires=1768014000&x-signature=HJyXLY1LcfVh0yjzkxdO1%2FnzN7A%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2
                          isAd: false
                          length: 74
                          likes: 111100
                          comments: 777
                          views: 594300
                          shares: 1607
                          engagementRate: 0.191
                          hashtags: []
                        - publishTime: 1767646234000
                          contentId: "7591982673988439327"
                          description: "That went by QUICK\U0001F972"
                          coverImageUrl: >-
                            https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/o0cXAuGDvIS1LJxRCqeCjsRyBgfsJEIfAIITyI~tplv-tiktokx-origin.image?dr=14575&x-expires=1768014000&x-signature=A7o%2FcOJ6GEcUs0F04sV9mPpzHFo%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2
                          isAd: false
                          length: 10
                          likes: 570600
                          comments: 7984
                          views: 5800000
                          shares: 35600
                          engagementRate: 0.1059
                          hashtags: []
                        - publishTime: 1767205808000
                          contentId: "7590091061150731550"
                          description: "\U0001FAE0"
                          coverImageUrl: >-
                            https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oQeR3VEZqtTcUVV7EThwa9AIDfAYFEEdvBIpWI~tplv-tiktokx-origin.image?dr=14575&x-expires=1768014000&x-signature=rhYCgLHWXkj4yeptSRSdno%2BpCts%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2
                          isAd: false
                          length: 43
                          likes: 165000
                          comments: 804
                          views: 1100000
                          shares: 7812
                          engagementRate: 0.1578
                          hashtags: []
                        - publishTime: 1767040557000
                          contentId: "7589381285752163615"
                          description: "It’s a comedy at this point"
                          coverImageUrl: >-
                            https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/o0iXCBqcIAq0HbECxi5i1MHx8IpIA4iR0SAChf~tplv-tiktokx-origin.image?dr=14575&x-expires=1768014000&x-signature=I%2FDa97SoU5L9fydfm0UyEZXFQaU%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2
                          isAd: false
                          length: 54
                          likes: 58000
                          comments: 705
                          views: 472700
                          shares: 2803
                          engagementRate: 0.1301
                          hashtags: []
                        - publishTime: 1766877837000
                          contentId: "7588682450176347422"
                          description: "Merry Christmas and Happy New Year ❤️"
                          coverImageUrl: >-
                            https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/ocfS2ljaIeDokgoE51FKfQbRIS8pQACiNMEq3A~tplv-tiktokx-origin.image?dr=14575&x-expires=1768014000&x-signature=kWjFd5TS2JheGxbIiZxOOMfk048%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2
                          isAd: false
                          length: 177
                          likes: 52800
                          comments: 731
                          views: 336700
                          shares: 168
                          engagementRate: 0.1595
                          hashtags: []
                        - publishTime: 1766703559000
                          contentId: "7587933925494820127"
                          description: "No husbands were harmed ⚠️ "
                          coverImageUrl: >-
                            https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oEHmM8eDIQfqgyBlvHSAWCT3gfj4AHlkkIs2G4~tplv-tiktokx-origin.image?dr=14575&x-expires=1768014000&x-signature=cqoHoRz8wwK9KxKQWr%2BucZtF6qc%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2
                          isAd: false
                          length: 22
                          likes: 132500
                          comments: 902
                          views: 860300
                          shares: 3660
                          engagementRate: 0.1593
                          hashtags: []
                        - publishTime: 1766180572000
                          contentId: "7585687691409313055"
                          description: "This example is NOT even an exaggeration fr"
                          coverImageUrl: >-
                            https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/ogtFI2L4Y7q77wLFIDGAIpiljeSAxChIP4Iee8~tplv-tiktokx-origin.image?dr=14575&x-expires=1768014000&x-signature=pszOQ8kCTwy4sPZ2sKr5taZpyAo%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2
                          isAd: false
                          length: 15
                          likes: 36800
                          comments: 160
                          views: 322700
                          shares: 199
                          engagementRate: 0.1152
                          hashtags: []
                        - publishTime: 1766011340000
                          contentId: "7584960907181165855"
                          description: "This is a Joke btw"
                          coverImageUrl: >-
                            https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/osaDB6U5M0Bwic0IOwDZtR64E4MIAviAhVNQ8~tplv-tiktokx-origin.image?dr=14575&x-expires=1768014000&x-signature=0JInMyUl0ByTPpanvo546iepMaI%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2
                          isAd: false
                          length: 20
                          likes: 186900
                          comments: 1948
                          views: 1400000
                          shares: 13400
                          engagementRate: 0.1445
                          hashtags: []
                        - publishTime: 1765989744000
                          contentId: "7584868136852196638"
                          description: "Guy Mad Dogs Me While He \U0001F4A9 Daily"
                          coverImageUrl: >-
                            https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oEyIVtG6LTddhuFfJj7qACsIWReIQqDeASbJmI~tplv-tiktokx-origin.image?dr=14575&x-expires=1768014000&x-signature=7CHlArs3S1atAsh069Bn2%2FSMpxY%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2
                          isAd: false
                          length: 41
                          likes: 276400
                          comments: 817
                          views: 1500000
                          shares: 11000
                          engagementRate: 0.1921
                          hashtags: []
                        - publishTime: 1765920763000
                          contentId: "7584571831714057502"
                          description: "I know you’ve done this…"
                          coverImageUrl: >-
                            https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oEQGSgJ6ID35ICePB3oIs1MAI6qfDLxQXAeLjn~tplv-tiktokx-origin.image?dr=14575&x-expires=1768014000&x-signature=XrFrKqOdrYYwdluFEmhS9sLLyD4%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2
                          isAd: false
                          length: 31
                          likes: 105300
                          comments: 302
                          views: 635000
                          shares: 3267
                          engagementRate: 0.1714
                          hashtags: []
                        - publishTime: 1765659475000
                          contentId: "7583449579643800863"
                          description: "He loves you @kellyclarkson "
                          coverImageUrl: >-
                            https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oMj01He0psE6vkJ9BuFEAMDTEPARTa0QQhfLVd~tplv-tiktokx-origin.image?dr=14575&x-expires=1768014000&x-signature=T13BdpxX6ivrp85XQ8Q6mDWk6uA%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2
                          isAd: false
                          length: 10
                          likes: 30800
                          comments: 235
                          views: 221900
                          shares: 188
                          engagementRate: 0.1407
                          hashtags: []
                        - publishTime: 1765387838000
                          contentId: "7582282861462506782"
                          description: "Wish I could jump through the phone lol"
                          coverImageUrl: >-
                            https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oIkIFiP6a8JAg9JIm3WVE0ER8BS0T5RvrtAiB~tplv-tiktokx-origin.image?dr=14575&x-expires=1768014000&x-signature=bunPeialx86P2TEgWKVdiGgVkdc%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2
                          isAd: false
                          length: 40
                          likes: 533200
                          comments: 1202
                          views: 2700000
                          shares: 72100
                          engagementRate: 0.2246
                          hashtags: []
                        - publishTime: 1764969961000
                          contentId: "7580488150188018974"
                          description: ""
                          coverImageUrl: >-
                            https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/o8pQfmWegGtIqEZC9mrM8IAjgVAXWKpAeIxSgS~tplv-tiktokx-origin.image?dr=14575&x-expires=1768014000&x-signature=u%2FuEiYRexgfTUWBtEFHVQE91jyE%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2
                          isAd: false
                          length: 24
                          likes: 147400
                          comments: 986
                          views: 955400
                          shares: 1976
                          engagementRate: 0.1574
                          hashtags: []
                        - publishTime: 1764641096000
                          contentId: "7579075705288346911"
                          description: "Literally just one day it happens\U0001F633"
                          coverImageUrl: >-
                            https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/ow4uIsym0VvEGSOi5bUHQ3ASBBIaRiXJvBmAI~tplv-tiktokx-origin.image?dr=14575&x-expires=1768014000&x-signature=Q%2BVYDkQaUHtsZ1p2EW3ClKHCf00%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2
                          isAd: false
                          length: 7
                          likes: 174300
                          comments: 413
                          views: 1000000
                          shares: 8329
                          engagementRate: 0.183
                          hashtags: []
                        - publishTime: 1764195938000
                          contentId: "7577163763112021279"
                          description: "Say no more \U0001F967 "
                          coverImageUrl: >-
                            https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/og0ON71E75RxHQWQbBFpAfJDA8VLbEEmf3JEPh~tplv-tiktokx-origin.image?dr=14575&x-expires=1768014000&x-signature=6GlyzjviOBNHQFQor6wXy0Ckrt4%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2
                          isAd: false
                          length: 10
                          likes: 309300
                          comments: 1521
                          views: 1800000
                          shares: 5246
                          engagementRate: 0.1756
                          hashtags: []
                        - publishTime: 1764180860000
                          contentId: "7577099016840760606"
                          description: "Clocked \U0001F570️ "
                          coverImageUrl: >-
                            https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/o4aMFxDlIEeU9B6E0QpEnD3BJI1UV3YfAAXFAR~tplv-tiktokx-origin.image?dr=14575&x-expires=1768014000&x-signature=LL9TfWyuOW617gtIBhu9CoxwCxA%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2
                          isAd: false
                          length: 26
                          likes: 156000
                          comments: 518
                          views: 730300
                          shares: 6198
                          engagementRate: 0.2228
                          hashtags: []
                        - publishTime: 1764175776000
                          contentId: "7577077211962936607"
                          description: "I’m always listening for it \U0001F633\U0001F442\U0001F3FB"
                          coverImageUrl: >-
                            https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/ok0ygDJeQAVEllJEvEXEpy1YXQxRAOFEpOBq6f~tplv-tiktokx-origin.image?dr=14575&x-expires=1768014000&x-signature=Zjepjp3eiHcpmNrRZyLY1sZVwt8%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2
                          isAd: false
                          length: 9
                          likes: 32500
                          comments: 182
                          views: 221700
                          shares: 497
                          engagementRate: 0.1497
                          hashtags: []
                        - publishTime: 1764028298000
                          contentId: "7576443790114704670"
                          description: "\U0001F373"
                          coverImageUrl: >-
                            https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/owiGR0nACjciCxiIGFIDdyAqd7AfxHwk1gkI4B~tplv-tiktokx-origin.image?dr=14575&x-expires=1768014000&x-signature=umzZi%2FUgKqxWr3tHB9nJcGeza2s%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2
                          isAd: false
                          length: 24
                          likes: 516200
                          comments: 2643
                          views: 2700000
                          shares: 5912
                          engagementRate: 0.1944
                          hashtags: []
                        - publishTime: 1764025951000
                          contentId: "7576433685994507550"
                          description: "Still that little puppy to me\U0001F97A"
                          coverImageUrl: >-
                            https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/o8VDGbPtERfMQMFApMkACzOfWXnRBJEJJQEUsw~tplv-tiktokx-origin.image?dr=14575&x-expires=1768014000&x-signature=65%2Bj5uQyfMy%2BnUH0dnCEoWg9uhg%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2
                          isAd: false
                          length: 9
                          likes: 36000
                          comments: 354
                          views: 219000
                          shares: 114
                          engagementRate: 0.1665
                          hashtags: []
                        - publishTime: 1763657979000
                          contentId: "7574853285790715166"
                          description: "Reactive Gaurd Dog/Most Loving Dog"
                          coverImageUrl: >-
                            https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/o8L7PKaSPA9FIHhJIGYoAjSCq0feQ7GbIe4AQG~tplv-tiktokx-origin.image?dr=14575&x-expires=1768014000&x-signature=pDDzPqWSLfUbvNMPZWB%2BlZzvmbA%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2
                          isAd: false
                          length: 10
                          likes: 100200
                          comments: 427
                          views: 590400
                          shares: 1596
                          engagementRate: 0.1731
                          hashtags: []
                        - publishTime: 1763168675000
                          contentId: "7572751715397602590"
                          description: "Been watching AOT lately"
                          coverImageUrl: >-
                            https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/ooB3bi1CRI0iiiRC4qYPYFnaDUxEAIA3X0IfAi~tplv-tiktokx-origin.image?dr=14575&x-expires=1768014000&x-signature=2AEBNhdExbzTKUMj9sGNiMl82fo%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2
                          isAd: false
                          length: 6
                          likes: 48300
                          comments: 436
                          views: 348600
                          shares: 1241
                          engagementRate: 0.1434
                          hashtags: []
                        - publishTime: 1763167494000
                          contentId: "7572746623525113119"
                          description: ""
                          coverImageUrl: >-
                            https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/ooQiBK0IXvVBVA6zAhqQfvihiCAIABiyXTVVtE~tplv-tiktokx-origin.image?dr=14575&x-expires=1768014000&x-signature=iTWqp3a8bjPUIYAog1Nn%2BzOuXA4%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2
                          isAd: false
                          length: 31
                          likes: 155600
                          comments: 1496
                          views: 1400000
                          shares: 4347
                          engagementRate: 0.1153
                          hashtags: []
                        - publishTime: 1762807222000
                          contentId: "7571199249002663198"
                          description: "What I imagine pt. \U0001F977\U0001F3FB \U0001F3E1 "
                          coverImageUrl: >-
                            https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oojCjWIheTv8RRJyuSfJAJqJeyBIAXsTMJNhQA~tplv-tiktokx-origin.image?dr=14575&x-expires=1768014000&x-signature=bsJaBheTLw4Z%2F%2FNFupX5nTCFMqs%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2
                          isAd: false
                          length: 69
                          likes: 173200
                          comments: 1345
                          views: 847500
                          shares: 3209
                          engagementRate: 0.2097
                          hashtags: []
                        - publishTime: 1762799643000
                          contentId: "7571166724091809055"
                          description: "I want my money back \U0001F43B "
                          coverImageUrl: >-
                            https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/o80IISwCABi6sA85hMtAfiB7ZiqP3IYSIRiBZF~tplv-tiktokx-origin.image?dr=14575&x-expires=1768014000&x-signature=x9HBmwZ4U5fZlVBFj1Yw912LMzs%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2
                          isAd: false
                          length: 5
                          likes: 138800
                          comments: 608
                          views: 742300
                          shares: 6379
                          engagementRate: 0.1964
                          hashtags: []
                        - publishTime: 1762376217000
                          contentId: "7569348133755358494"
                          description: ""
                          coverImageUrl: >-
                            https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/owfQ6ghA7pgwIAEvug1FfEMDBuz2CIRLl0VADE~tplv-tiktokx-origin.image?dr=14575&x-expires=1768014000&x-signature=HVWJ1%2B2qiUITmxIiBzR8lx6lW0E%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2
                          isAd: false
                          length: 25
                          likes: 55700
                          comments: 354
                          views: 325800
                          shares: 600
                          engagementRate: 0.1739
                          hashtags: []
                        - publishTime: 1762374642000
                          contentId: "7569341342095101214"
                          description: "Is this universal?"
                          coverImageUrl: >-
                            https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oQoIKZOfgokIq1FCPXWGeIAjaZALTe2AJYCSgT~tplv-tiktokx-origin.image?dr=14575&x-expires=1768014000&x-signature=46skl1J79dmVzN112ullV7IBvRU%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2
                          isAd: false
                          length: 26
                          likes: 96400
                          comments: 351
                          views: 780300
                          shares: 19800
                          engagementRate: 0.1494
                          hashtags: []
                        - publishTime: 1762284168000
                          contentId: "7568952759513255199"
                          description: "Fr "
                          coverImageUrl: >-
                            https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/owSKlrAFeAIpPKcZFGjSBoCyUIIqLIXekK8IEe~tplv-tiktokx-origin.image?dr=14575&x-expires=1768014000&x-signature=ISs7IOF4BlTM0%2FLwHgU%2BeJhy3Fw%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2
                          isAd: false
                          length: 11
                          likes: 96300
                          comments: 592
                          views: 692100
                          shares: 7951
                          engagementRate: 0.1515
                          hashtags: []
                        - publishTime: 1762204949000
                          contentId: "7568612550296751391"
                          description: "Let me cook\U0001F479 or let me apologize\U0001F64F\U0001F3FB"
                          coverImageUrl: >-
                            https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/o4IA2iiRBcgfQ2hVR0RHALqJdCECIgJABIH4iA~tplv-tiktokx-origin.image?dr=14575&x-expires=1768014000&x-signature=lMrLqAWGT8lpazmQ49qCA1cVmho%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2
                          isAd: false
                          length: 9
                          likes: 36800
                          comments: 363
                          views: 241100
                          shares: 795
                          engagementRate: 0.1574
                          hashtags: []
                        - publishTime: 1761958206000
                          contentId: "7567552814591921439"
                          description: "Who knows???? \U0001F525 "
                          coverImageUrl: >-
                            https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/ocQlFjCSxCFWFWIZYO4MUAJIqeI8APy2OQefQr~tplv-tiktokx-origin.image?dr=14575&x-expires=1768014000&x-signature=5AP6zsFBTd6A1iLn3a%2B04PMJXN4%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2
                          isAd: false
                          length: 10
                          likes: 292300
                          comments: 1048
                          views: 2500000
                          shares: 1468
                          engagementRate: 0.1179
                          hashtags: []
                        - publishTime: 1761846857000
                          contentId: "7567074579148000543"
                          description: "Designated sacrifice \U0001FAE1"
                          coverImageUrl: >-
                            https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oABAeCI0J7GcjfAMy5SwLAHIerqDgSQIT2ILAT~tplv-tiktokx-origin.image?dr=14575&x-expires=1768014000&x-signature=pan6fzKzSEDAwx5uhK%2BAcPv9TvQ%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2
                          isAd: false
                          length: 9
                          likes: 190400
                          comments: 523
                          views: 1300000
                          shares: 11100
                          engagementRate: 0.1554
                          hashtags: []
                        - publishTime: 1761343142000
                          contentId: "7564911153571220767"
                          description: "Barks brought to you by Kevin "
                          coverImageUrl: >-
                            https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/o8AIKqZ7gzRQfC2VnfDfBQlwq99jEWFA6KMI6d~tplv-tiktokx-origin.image?dr=14575&x-expires=1768014000&x-signature=i8zmftPYB%2BC3jKNFJuzE29%2BgNRs%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2
                          isAd: false
                          length: 48
                          likes: 69100
                          comments: 494
                          views: 422300
                          shares: 1271
                          engagementRate: 0.1678
                          hashtags: []
                        - publishTime: 1761010029000
                          contentId: "7563480419786689823"
                          description: "All bets are off when we’re on the water\U0001F972"
                          coverImageUrl: >-
                            https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oQxttArz3UFf7QQjX2W8QFAJDwG9eeQfGdM6Rj~tplv-tiktokx-origin.image?dr=14575&x-expires=1768014000&x-signature=dfNixRS6jFheyUYOWP94gMmj99I%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2
                          isAd: false
                          length: 18
                          likes: 414300
                          comments: 1916
                          views: 3200000
                          shares: 15000
                          engagementRate: 0.1348
                          hashtags: []
                        - publishTime: 1760569128000
                          contentId: "7561586769943072030"
                          description: "Never a dull moment"
                          coverImageUrl: >-
                            https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oIUP5Pqi4ArVaBtkyDBLATgiERxgwIEjABviJ~tplv-tiktokx-origin.image?dr=14575&x-expires=1768014000&x-signature=UCzH5j9sEnPuNgrmNbk3%2BTneq1A%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2
                          isAd: false
                          length: 43
                          likes: 2000000
                          comments: 3370
                          views: 11200000
                          shares: 145300
                          engagementRate: 0.1918
                          hashtags: []
                        - publishTime: 1760393436000
                          contentId: "7560832177194159391"
                          description: "It’s true "
                          coverImageUrl: >-
                            https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/ogALaF9Vd7wbD8XFRfgBXfEjAVEOEPXQnol0QE~tplv-tiktokx-origin.image?dr=14575&x-expires=1768014000&x-signature=gi4KHg1kimclr%2FeHGhYFTAEzTMQ%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2
                          isAd: false
                          length: 8
                          likes: 130700
                          comments: 656
                          views: 1300000
                          shares: 1007
                          engagementRate: 0.1018
                          hashtags: []
                        - publishTime: 1760132268000
                          contentId: "7559710452603784479"
                          description: ""
                          coverImageUrl: >-
                            https://p16-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/ocVR0MG2gICI4OaCeIAAgfFLDvltkMCJVyMjqe~tplv-tiktokx-origin.image?dr=14575&x-expires=1768014000&x-signature=UpCJy11IGaKfrPnYBMAKL5E02fc%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=my2
                          isAd: false
                          length: 30
                          likes: 207100
                          comments: 726
                          views: 1400000
                          shares: 5160
                          engagementRate: 0.1521
                          hashtags: []
                    creditsUsed: 1
                    creditsAvailable: 975
                    planCreditsAvailable: 900
                    purchasedCreditsAvailable: 75
                    traceId: 6b3d3226368e03a0f213f5697bf7312a
                    timestamp: 1767939569931
                    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 uniqueId:
                  summary: Missing uniqueId
                  value:
                    success: false
                    error: "VALIDATION_ERROR"
                    message: "Missing required field: 'uniqueId'."
                    timestamp: 1770099403116
                invalid uniqueId:
                  summary: Invalid uniqueId format
                  value:
                    success: false
                    error: "VALIDATION_ERROR"
                    message: "Invalid 'uniqueId' format. TikTok unique ID must be between 1 to 101 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)"
  # TikTok topics
  /tiktok/topics:
    get:
      tags:
        - TikTok
      summary: List Topics
      description: "Retrieve all available TikTok topics with their categories and creator count. Topics are used for categorizing TikTok creators based on their content themes. Topics are broader than niches. Every TikTok topic ID ends in `_tiktok`."
      operationId: getTiktokTopics
      x-codeSamples:
        - lang: bash
          label: cURL
          source: |
            curl -X GET "https://apiv3.creatordb.app/tiktok/topics" \
              -H "api-key: <YOUR_API_KEY_HERE>"
      responses:
        "200":
          description: "TikTok topics data returned successfully."
          content:
            application/json:
              schema:
                type: object
                description: "TikTok Topics API response with all available topics."
                properties:
                  data:
                    type: array
                    description: "TikTok topics."
                    items:
                      type: object
                      description: "TikTok topic item with metadata."
                      properties:
                        id:
                          type: string
                          description: "The unique identifier of the topic."
                          examples:
                            - id_beauty_HowtoStyle_tiktok
                        name:
                          type: string
                          description: "The topic name."
                          examples:
                            - Beauty
                        category:
                          type: string
                          description: "Category classifications."
                          examples:
                            - "Howto & Style"
                        channelCount:
                          type: integer
                          description: "Number of creators associated with this TikTok topic."
                          minimum: 0
                          examples:
                            - 152162
                      required:
                        - id
                        - name
                        - category
                        - channelCount
                  creditsUsed:
                    type: number
                    description: "Number of API credits consumed by this request."
                    examples:
                      - 1
                  creditsAvailable:
                    type: number
                    description: "Number of API credits remaining. Equals planCreditsAvailable plus purchasedCreditsAvailable."
                    examples:
                      - -1
                  planCreditsAvailable:
                    type: number
                    description: "Remaining plan credits after this request, in credits."
                    examples:
                      - 900
                  purchasedCreditsAvailable:
                    type: number
                    description: "Remaining purchased-bucket credits after this request, in display units."
                    examples:
                      - 75
                  keyCreditsAvailable:
                    type: number
                    description: "Remaining credits this API key can spend after this request, before reaching its spend limit. Present only when the key has a spend limit."
                    examples:
                      - 4975
                  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
                  - planCreditsAvailable
                  - purchasedCreditsAvailable
              examples:
                default:
                  value:
                    data:
                      - id: id_beauty_HowtoStyle_tiktok
                        name: Beauty
                        category: "Howto & Style"
                        channelCount: 152162
                      - id: id_lifestyle_HowtoStyle_tiktok
                        name: Lifestyle
                        category: "Howto & Style"
                        channelCount: 136434
                      - id: id_fashion_HowtoStyle_tiktok
                        name: Fashion
                        category: "Howto & Style"
                        channelCount: 133563
                      - id: id_hair_HowtoStyle_tiktok
                        name: Hair
                        category: "Howto & Style"
                        channelCount: 99363
                      - id: id_makeup_HowtoStyle_tiktok
                        name: Makeup
                        category: "Howto & Style"
                        channelCount: 89148
                      - id: id_skincare_HowtoStyle_tiktok
                        name: Skincare
                        category: "Howto & Style"
                        channelCount: 88355
                      - id: id_shopping_HowtoStyle_tiktok
                        name: Shopping
                        category: "Howto & Style"
                        channelCount: 64785
                      - id: id_cooking_HowtoStyle_tiktok
                        name: Cooking
                        category: "Howto & Style"
                        channelCount: 56013
                    creditsUsed: 1
                    creditsAvailable: 975
                    planCreditsAvailable: 900
                    purchasedCreditsAvailable: 75
                    traceId: 0f58e95d22ea888a76166ecf6bb251ef
                    timestamp: 1772075633067
                    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:
                unexpected parameter:
                  summary: Unexpected query parameter
                  value:
                    success: false
                    error: "VALIDATION_ERROR"
                    message: "Unrecognized query parameter."
                    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)"
  # TikTok submit creators
  /tiktok/niches:
    get:
      tags:
        - TikTok
      summary: List Niches
      description: "Retrieve all available TikTok niche categories and their creator counts. Niches categorize creators by content themes."
      operationId: getTiktokNiches
      x-codeSamples:
        - lang: bash
          label: cURL
          source: |
            curl -X GET "https://apiv3.creatordb.app/tiktok/niches" \
              -H "Content-Type: application/json" \
              -H "api-key: <YOUR_API_KEY_HERE>"
      responses:
        "200":
          description: "TikTok niches data returned successfully."
          content:
            application/json:
              schema:
                type: object
                description: "TikTok Niches API response with all available niches."
                properties:
                  data:
                    type: array
                    description: "TikTok niches."
                    items:
                      type: object
                      description: "Niche with metadata."
                      properties:
                        id:
                          type: string
                          description: "The unique identifier."
                          examples:
                            - niche_Entertainment_Comedy
                        name:
                          type: string
                          description: "The niche name."
                          examples:
                            - Comedy
                        category:
                          type: string
                          description: "Category classifications."
                          examples:
                            - Entertainment
                        channelCount:
                          type: integer
                          description: "Number of creators associated with this niche."
                          minimum: 0
                          examples:
                            - 9012
                      required:
                        - id
                        - name
                        - category
                        - channelCount
                  creditsUsed:
                    type: number
                    description: "Number of API credits consumed by this request."
                    examples:
                      - 1
                  creditsAvailable:
                    type: number
                    description: "Number of API credits remaining. Equals planCreditsAvailable plus purchasedCreditsAvailable."
                    examples:
                      - -1
                  planCreditsAvailable:
                    type: number
                    description: "Remaining plan credits after this request, in credits."
                    examples:
                      - 900
                  purchasedCreditsAvailable:
                    type: number
                    description: "Remaining purchased-bucket credits after this request, in display units."
                    examples:
                      - 75
                  keyCreditsAvailable:
                    type: number
                    description: "Remaining credits this API key can spend after this request, before reaching its spend limit. Present only when the key has a spend limit."
                    examples:
                      - 4975
                  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
                  - planCreditsAvailable
                  - purchasedCreditsAvailable
              examples:
                default:
                  value:
                    data:
                      - id: id_capcut_All
                        name: Capcut
                        category: All
                        channelCount: 252193
                      - id: id_palagi_All
                        name: Palagi
                        category: All
                        channelCount: 78266
                      - id: id_trending_All
                        name: Trending
                        category: All
                        channelCount: 104173
                      - id: id_christmas_All
                        name: Christmas
                        category: All
                        channelCount: 132159
                      - id: id_prepare_All
                        name: Prepare
                        category: All
                        channelCount: 49884
                      - id: id_humor_All
                        name: Humor
                        category: All
                        channelCount: 75487
                      - id: id_trend_All
                        name: Trend
                        category: All
                        channelCount: 107639
                      - id: id_funny_All
                        name: Funny
                        category: All
                        channelCount: 79880
                      - id: id_comedy_All
                        name: Comedy
                        category: All
                        channelCount: 49504
                      - id: id_motivation_All
                        name: Motivation
                        category: All
                        channelCount: 41842
                    traceId: 13b6aee50b7a305432c39a7baf7fe7a2
                    timestamp: 1772096850140
                    creditsAvailable: 975
                    planCreditsAvailable: 900
                    purchasedCreditsAvailable: 75
                    creditsUsed: 1
                    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:
                unexpected parameter:
                  summary: Unexpected query parameter
                  value:
                    success: false
                    error: "VALIDATION_ERROR"
                    message: "Unrecognized query parameter."
                    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)"
# Sponsor search
  /sponsor/search:
    post:
      summary: Search Brands
      description: "Search the CreatorDB sponsor database using filters including brand name, industry, region, and creator associations. Returns a brand list suitable for discovery; use `/sponsor/information` for detailed brand data. Supports fuzzy name search, ISO 3166-1 alpha-3 country codes, and pagination."
      operationId: searchSponsor
      tags:
        - Sponsor
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                filters:
                  type: array
                  items:
                    type: object
                    properties:
                      filterName:
                        type: string
                        description: "The field to apply the filter on"
                      op:
                        type: string
                        enum:
                          - in
                          - ">"
                          - "="
                          - "<"
                        description: "The comparison operator. Accepted values include: `in`, `>`, `=`, `<`. <br /> -String fields accept: `=`, `in`.  <br />
                          Number fields accept: `>`, `=`, `<`.  <br /> Boolean fields accept: `=`"
                      value:
                        anyOf:
                          - type: string
                          - type: number
                          - type: array
                            items:
                              type: string
                            maxItems: 100
                          - type: boolean
                        description: "Type depends on the `filterName`. <br /> - String fields accept `string` or `string[]`. <br /> - Number fields accept `number`. <br /> -Boolean fields accept `boolean`. <br /> - Operator `in` accepts `string[]`, operator `=` accepts string for string fields."
                      isFuzzySearch:
                        type: boolean
                        default: false
                        description: "When `true`, performs a fuzzy match for `string` type `filterName`."
                    required:
                      - filterName
                      - op
                      - value
                  minItems: 0
                  description: "Filter objects that include `filterName`, `op`, and `value`. For all accepted `filterName` values and their data types, see [Configuring Custom Search Filters and Examples](https://docs.creatordb.app/api-v3/configuring_advanced_search_filters#sponsor-search-filters)."
                desc:
                  type: boolean
                  description: "Sort order for results. `true` for descending, `false` for ascending order."
                sortBy:
                  type: string
                  description: "Field to sort brands by. For example, `totalFollowers`, sorts by follower count."
                pageSize:
                  type: integer
                  minimum: 1
                  maximum: 100
                  description: "Number of results per page. Maximum: 100."
                offset:
                  type: integer
                  minimum: 0
                  description: "Number of records to skip before returning results."
              required:
                - filters
                - pageSize
                - offset
              description: "Search for sponsoring brands by attributes, influencer marketing activity, or associated creators."
              example:
                filters:
                  - filterName: industry
                    op: in
                    value:
                      - Computer
                      - ConsumerElectronics
                  - filterName: sponsoringRegion
                    op: "="
                    value: USA
                desc: true
                sortBy: name
                pageSize: 20
                offset: 0
      responses:
        "200":
          description: "Sponsors search results returned successfully."
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      results:
                        type: array
                        items:
                          type: object
                          properties:
                            brandId:
                              type: string
                              description: "Unique brand identifier, typically the brand's primary domain."
                              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
                            country:
                              type: string
                              description: "Headquarters country in ISO 3166-1 alpha-3 format (e.g., `USA`)."
                              example: TWN
                          required:
                            - brandId
                            - name
                            - logo
                            - industries
                            - country
                          description: "Brand information returned in the sponsor search results."
                        description: "Brands matching the search query."
                      totalResults:
                        type: integer
                        minimum: 0
                        description: "Total number of brands matching the filters."
                        example: 342
                      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: 20
                    required:
                      - results
                      - totalResults
                      - offset
                      - pageSize
                    description: "Sponsor search response with matching brands and pagination information."
                  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. Equals planCreditsAvailable plus purchasedCreditsAvailable."
                    example: 975
                  creditsUsed:
                    type: number
                    description: "Number of API credits consumed by this request."
                    example: 25
                  planCreditsAvailable:
                    type: number
                    description: "Remaining plan credits after this request, in credits."
                    examples:
                      - 900
                  purchasedCreditsAvailable:
                    type: number
                    description: "Remaining purchased-bucket credits after this request, in display units."
                    examples:
                      - 75
                  keyCreditsAvailable:
                    type: number
                    description: "Remaining credits this API key can spend after this request, before reaching its spend limit. Present only when the key has a spend limit."
                    examples:
                      - 4975
                  errorCode:
                    type: string
                    description: "Error code returned if the request fails. Empty if the request is successful."
                  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
                  - planCreditsAvailable
                  - purchasedCreditsAvailable
                  - errorCode
                  - errorDescription
                  - success
                description: "Sponsor Search API response. Contains search results in data, along with credit usage, trace info, and error details."
# Sponsor information
  /sponsor/submit:
    post:
      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.\n\nEach API key can make up to 100 submissions per day (resets at 00:00 UTC). The response `status` field returns one of:\n\n* `accepted` — The brand submission was accepted. \n* `done` — The brand is already indexed. The existing record ID is returned in `existingBrandId`.(No costs)\n* `rejected` — The submission was invalid or the brand is blacklisted.(No costs)\n For per submitted brand cost, see [API Credit Usage](/api-v3/api-credit-usage)."
      operationId: submitSponsor
      tags:
        - Sponsor
      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. Equals planCreditsAvailable plus purchasedCreditsAvailable."
                    example: 975
                  creditsUsed:
                    type: number
                    description: "Number of API credits consumed by this request."
                    example: 25
                  planCreditsAvailable:
                    type: number
                    description: "Remaining plan credits after this request, in credits."
                    examples:
                      - 900
                  purchasedCreditsAvailable:
                    type: number
                    description: "Remaining purchased-bucket credits after this request, in display units."
                    examples:
                      - 75
                  keyCreditsAvailable:
                    type: number
                    description: "Remaining credits this API key can spend after this request, before reaching its spend limit. Present only when the key has a spend limit."
                    examples:
                      - 4975
                  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
                  - planCreditsAvailable
                  - purchasedCreditsAvailable
                  - errorCode
                  - errorDescription
                  - success
                description: "Response body for a sponsor submission. Submission details are returned in `data`."                 

  /sponsor/information:
    get:
      summary: Get Brand Information
      description: "Returns identity and metadata for a specific brand — including company details, industries, key people, social links, competitors, and basic activity indicators. Does not include sponsor performance data or sponsored creator lists."
      operationId: getSponsorInformation
      tags:
        - Sponsor
      parameters:
        - schema:
            type: string
            minLength: 1
            pattern: ^[a-zA-Z0-9._-]+$
            description: "Brand's unique identifier, typically the primary domain. Allowed characters: letters (a-z, A-Z), digits (0-9), periods (.), underscores (_), and hyphens (-)."
            example: acer.com
          required: true
          name: brandId
          in: query
      responses:
        "200":
          description: "Detailed brand profile information returned successfully."
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      brandId:
                        type: string
                        description: "Unique brand identifier, typically the brand's primary domain."
                        example: acer.com
                      name:
                        type: string
                        description: "Brand's display name."
                        example: Acer
                      alias:
                        type: array
                        items:
                          type: string
                        description: "Alternative domains and names for this brand."
                        example:
                          - acer.co
                          - store.acer.com
                          - acer.link
                      logo:
                        type: string
                        description: "URL of the brand's logo."
                        example: https://i.imgur.com/bazrFjP.png
                      description:
                        type: string
                        description: "Short description of the brand."
                        example: Acer is a Taiwanese multinational hardware and electronics corporation.
                      companySize:
                        type: string
                        description: "Estimated company size by employee count, as a range (e.g., `501-1,000`)."
                        example: 501-1,000
                      keyPeople:
                        type: array
                        items:
                          type: string
                        description: "Notable people associated with the brand."
                        example:
                          - Carolyn Yeh
                          - George Huang
                          - Stan Shih
                      industries:
                        type: array
                        items:
                          type: string
                        description: "Industries the brand operates in. See [Industry List](https://docs.creatordb.app/api-v2/industry-list) for all possible values."
                        example:
                          - Computer
                          - ConsumerElectronics
                          - Hardware
                      country:
                        type: string
                        description: "Headquarters country in ISO 3166-1 alpha-3 format."
                        example: TWN
                      location:
                        type: string
                        description: "City-level headquarters location."
                        example: Taipei, Taiwan
                      website:
                        type: string
                        description: "Brand's official website URL."
                        example: http://www.acer.com
                      socialMedia:
                        type: array
                        items:
                          type: object
                          properties:
                            platform:
                              type: string
                              description: "Social media platform name. Canonical values: see PRD Reference: socialMedia standardized platforms."
                              example: facebook
                            url:
                              type: string
                              description: "URL to the brand's social media profile"
                              example: https://www.facebook.com/Acer
                          required:
                            - platform
                            - url
                          description: "Brand social link with canonical platform key (restructured from v1_brandReport.socialMedia string array)"
                        description: "Brand's social media presence."
                      competitors:
                        type: array
                        items:
                          type: string
                        description: "Known competitor brands."
                        example:
                          - Apple
                          - HP
                          - ASUS
                      totalSponsoredContent:
                        type: integer
                        minimum: 0
                        description: "Total count of sponsored content pieces detected across the platforms in `activePlatforms`."
                        example: 278
                      activePlatforms:
                        type: array
                        items:
                          type: string
                        description: "Social media platforms where this brand's sponsored content has been detected."
                        example:
                          - youtube
                          - instagram
                    required:
                      - brandId
                      - name
                      - alias
                      - logo
                      - description
                      - companySize
                      - keyPeople
                      - industries
                      - country
                      - location
                      - website
                      - socialMedia
                      - competitors
                      - totalSponsoredContent
                      - activePlatforms
                    description: "Identity and metadata for a specific brand, such as company details, industries, and competitors. Does not include sponsored content performance metrics or sponsored creator relationships."
                  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. Equals planCreditsAvailable plus purchasedCreditsAvailable."
                    example: 975
                  creditsUsed:
                    type: number
                    description: "Number of API credits consumed by this request."
                    example: 25
                  planCreditsAvailable:
                    type: number
                    description: "Remaining plan credits after this request, in credits."
                    examples:
                      - 900
                  purchasedCreditsAvailable:
                    type: number
                    description: "Remaining purchased-bucket credits after this request, in display units."
                    examples:
                      - 75
                  keyCreditsAvailable:
                    type: number
                    description: "Remaining credits this API key can spend after this request, before reaching its spend limit. Present only when the key has a spend limit."
                    examples:
                      - 4975
                  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
                  - planCreditsAvailable
                  - purchasedCreditsAvailable
                  - errorCode
                  - errorDescription
                  - success
                description: "Sponsor Information API response with full brand identity metadata"
# Sponsor list
  /sponsor/list:
    get:
      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
      tags:
        - Sponsor
      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. Equals planCreditsAvailable plus purchasedCreditsAvailable."
                    example: 975
                  creditsUsed:
                    type: number
                    description: "Number of API credits consumed by this request."
                    example: 25
                  planCreditsAvailable:
                    type: number
                    description: "Remaining plan credits after this request, in credits."
                    examples:
                      - 900
                  purchasedCreditsAvailable:
                    type: number
                    description: "Remaining purchased-bucket credits after this request, in display units."
                    examples:
                      - 75
                  keyCreditsAvailable:
                    type: number
                    description: "Remaining credits this API key can spend after this request, before reaching its spend limit. Present only when the key has a spend limit."
                    examples:
                      - 4975
                  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
                  - planCreditsAvailable
                  - purchasedCreditsAvailable
                  - errorCode
                  - errorDescription
                  - success
                description: "Sponsor List API response with paginated brands"
# Sponsor creators
  /sponsor/creators:
    get:
      summary: List Sponsored Creators
      description: "Returns a paginated list of creators sponsored by a brand on a specified platform (YouTube or Instagram)."
      operationId: getSponsorCreators
      tags:
        - Sponsor
      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. On Instagram, this is estimated by CreatorDB's location model."
                              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. Equals planCreditsAvailable plus purchasedCreditsAvailable."
                    example: 975
                  creditsUsed:
                    type: number
                    description: "Number of API credits consumed by this request."
                    example: 25
                  planCreditsAvailable:
                    type: number
                    description: "Remaining plan credits after this request, in credits."
                    examples:
                      - 900
                  purchasedCreditsAvailable:
                    type: number
                    description: "Remaining purchased-bucket credits after this request, in display units."
                    examples:
                      - 75
                  keyCreditsAvailable:
                    type: number
                    description: "Remaining credits this API key can spend after this request, before reaching its spend limit. Present only when the key has a spend limit."
                    examples:
                      - 4975
                  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
                  - planCreditsAvailable
                  - purchasedCreditsAvailable
                  - errorCode
                  - errorDescription
                  - success
                description: "Sponsor Creators API response"
# Sponsor performance
  /sponsor/performance:
    get:
      summary: Get Sponsored Creator Performance
      description: "Returns performance metrics for creators sponsored by a brand on YouTube or Instagram. For each creator, the response includes comparison stats (sponsored vs. overall performance), estimated cost and CPM (YouTube only), and performance details for their individual posts or videos."
      operationId: getSponsorPerformance
      tags:
        - Sponsor
      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`. Only one platform is allowed per
                request."
              example: youtube          
        - name: pageSize
          in: query
          required: false 
          schema:
              type: string
              default: "50"
              description: "Number of unique creators per page. All sponsored content for each creator is included. Default: 50. Maximum: 100"
              example: "50"
        - name: offset
          in: query
          required: false 
          schema:
              type: string
              default: "0"
              description: "Number of creators to skip before returning results. Pagination is creator-level. Default: 0"
              example: "0"      
        - name: sortBy
          in: query
          required: false
          schema:
              type: string
              enum:
                - publishTime
                - views
                - likes
                - engagementRate
              default: publishTime
              description: "Field for sorting creators. Accepted values: `publishTime`, `views`, `likes`, `engagementRate`. Numeric sort fields (`views`, `likes`, `engagementRate`) use per-creator averages across this brand's sponsored content. Default: `publishTime`."
              example: publishTime
        - 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: "Performance of sponsored creators returned successfully. "
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      sponsoredCreators:
                        type: array
                        items:
                          type: object
                          properties:
                            creatorId:
                              type: string
                              description: "Platform-specific creator identifier (`channelId` for YouTube, `uniqueId` for Instagram)."
                              example: UCm-X6o81nRsXQTmqpyArkBQ
                            displayName:
                              type: string
                              description: "Creator's display name."
                              example: Flamingo
                            platform:
                              type: string
                              enum:
                                - youtube
                                - instagram
                              description: "Platform for which this creator's sponsored content performance was queried. Matches the `platform` request parameter."
                              example: youtube
                            creatorTotalStats:
                              type: object
                              properties:
                                avgEngagementRate:
                                  type: number
                                  description: "Average engagement rate across all of this creator's tracked content (sponsored and non-sponsored). Expressed as a decimal (e.g., 0.0452 = 4.52%)."
                                  example: 0.0452
                                avgViews:
                                  type:
                                    - number
                                    - "null"
                                  description: "Average views per content piece across all of this creator's tracked content (sponsored and non-sponsored)."
                                  example: 1600000
                                avgLikes:
                                  type: number
                                  description: "Average likes per content piece across all of this creator's tracked content (sponsored and non-sponsored)."
                                  example: 63700
                                avgComments:
                                  type: number
                                  description: "Average comments per content piece across all of this creator's tracked content (sponsored and non-sponsored)."
                                  example: 5200
                                contentCount:
                                  type: integer
                                  minimum: 0
                                  description: "Number of tracked content pieces used to calculate the averages in this `creatorTotalStats` object."
                                  example: 180
                                latestContentDate:
                                  type: integer
                                  description: "Unix timestamp (in milliseconds) of this creator's most recent content, across all content types (sponsored or non-sponsored)."
                                  example: 1741939200000
                              required:
                                - avgEngagementRate
                                - avgViews
                                - avgLikes
                                - avgComments
                                - contentCount
                                - latestContentDate
                              description: "This creator's overall performance stats across all tracked content (sponsored and non-sponsored). Use as a baseline to compare against `creatorAllSponsoredStats` and `creatorThisBrandSponsoredStats`."
                            creatorAllSponsoredStats:
                              type: object
                              properties:
                                avgEngagementRate:
                                  type: number
                                  description: "Average engagement rate across all of this creator's sponsored content (any brand). Expressed as a decimal (e.g., 0.0412 = 4.12%)."
                                  example: 0.0412
                                avgViews:
                                  type:
                                    - number
                                    - "null"
                                  description: "Average views per piece across all of this creator's sponsored content (any brand). May be null if view data is unavailable."
                                  example: 1950000
                                avgLikes:
                                  type: number
                                  description: "Average likes per piece across all of this creator's sponsored content (any brand)."
                                  example: 66500
                                avgComments:
                                  type: number
                                  description: "Average comments per piece across all of this creator's sponsored content (any brand)."
                                  example: 5350
                                sponsoredCount:
                                  type: integer
                                  minimum: 0
                                  description: "Number of this creator's sponsored content pieces (any brand) used to calculate the averages in this creatorAllSponsoredStats object."
                                  example: 42
                                latestSponsoredContentDate:
                                  type: integer
                                  description: "Unix timestamp (in milliseconds) of this creator's most recent sponsored content (any brand)."
                                  example: 1738569600000
                              required:
                                - avgEngagementRate
                                - avgViews
                                - avgLikes
                                - avgComments
                                - sponsoredCount
                                - latestSponsoredContentDate
                              description: "This creator's overall performance stats across all tracked content (sponsored and non-sponsored)."
                            creatorSpecificSponsoredStats:
                              type: object
                              properties:
                                avgEngagementRate:
                                  type: number
                                  description: "Average engagement rate across this creator's sponsored content for the queried brand. Expressed as a decimal (e.g., 0.0379 = 3.79%)."
                                  example: 0.0379
                                avgViews:
                                  type: number
                                  description: "Average views per piece across this creator's sponsored content for the queried brand."
                                  example: 2200000
                                avgLikes:
                                  type: number
                                  description: "Average likes per piece across this creator's sponsored content for the queried brand."
                                  example: 69800
                                avgComments:
                                  type: number
                                  description: "Average comments per piece across this creator's sponsored content for the queried brand."
                                  example: 5500
                                sponsoredCount:
                                  type: integer
                                  minimum: 0
                                  description: "Number of this creator's sponsored content pieces for the queried brand used to calculate the averages in this `creatorSpecificSponsoredStats` object."
                                  example: 3
                                latestSponsoredContentDate:
                                  type: integer
                                  description: "Unix timestamp (in milliseconds) of this creator's most recent sponsored content for the queried brand."
                                  example: 1733529600000
                              required:
                                - avgEngagementRate
                                - avgViews
                                - avgLikes
                                - avgComments
                                - sponsoredCount
                                - latestSponsoredContentDate
                              description: "This creator's performance stats across their sponsored content for the queried brand. Compare against `creatorTotalStats` (overall baseline) and `creatorAllSponsoredStats` (all-brand sponsored performance) to evaluate brand-specific performance."
                            estimatedCost:
                              type:
                                - number
                                - "null"
                              description: "Sum of estimated prices (in USD) across this creator's sponsored videos for the queried brand. YouTube only — returns `null` for Instagram queries."
                              example: 4500
                            estimatedCreatorCPM:
                              type:
                                - number
                                - "null"
                              description: "Estimated cost per 1,000 views (in USD) for this creator's sponsored content for the queried brand. YouTube only.
                                            Calculated as 1000 × (`estimatedCost` ÷ `total views`), summed across this creator's sponsored videos for the brand.
                                            Returns null when:
                                            - Total views across the included videos are 0
                                            - `estimatedCost` is `null`
                                            - No spend data is available for the platform"
                              example: 9.12
                            content:
                              type: array
                              items:
                                type: object
                                properties:
                                  contentId:
                                    type: string
                                    description: "Platform-specific content identifier (`videoId` for YouTube, `mediaId` for Instagram)."
                                    example: eHnzGYHEdO0
                                  title:
                                    type: string
                                    description: "Content title (for YouTube videos) or caption excerpt (for Instagram posts)."
                                    example: ROBLOX OP ADMIN IN STEAL A BRAINROT
                                  publishTime:
                                    type: number
                                    description: "Publish time, represented as a Unix timestamp in milliseconds."
                                    example: 1754797869000
                                  views7d:
                                    type:
                                      - number
                                      - "null"
                                    description: "Cumulative view count 7 days after publication. Returns `null` if fewer than 7 days have passed since publication."
                                    example: 8200
                                  views30d:
                                    type:
                                      - number
                                      - "null"
                                    description: "Cumulative view count 30 days after publication. Returns `null` if fewer than 30 days have passed since publication."
                                    example: 15000
                                  views90d:
                                    type:
                                      - number
                                      - "null"
                                    description: "Cumulative view count 90 days after publication. Returns `null` if fewer than 90 days have passed since publication."
                                    example: 28500
                                  viewsLifetime:
                                    type: number
                                    description: "Total view count for this content piece since publication."
                                    example: 150000
                                  likes:
                                    type: number
                                    description: "Like count for this content piece. Calculation may vary depending on platform and content age."
                                    example: 10000
                                  comments:
                                    type: number
                                    description: "Comment count for this content piece. Calculation may vary depending on platform and content age."
                                    example: 100
                                  engagementRate:
                                    type: number
                                    description: "Engagement rate of this content piece. Expressed as a decimal and rounded to the 4th decimal place (e.g. 0.1202 = 12.02%)."
                                    example: 0.1202
                                  length:
                                    type:
                                      - number
                                      - "null"
                                    description: "Video length in seconds. Returns `null` for non-video content."
                                    example: 873
                                  hashtags:
                                    type: array
                                    items:
                                      type: string
                                    description: "Hashtags used in this content."
                                    example:
                                      - "#VLOG"
                                  estimatedContentCPM:
                                    type:
                                      - number
                                      - "null"
                                    description:"Estimated cost per 1,000 views (in USD) for this sponsored content piece. YouTube only. Returns null when:
                                                  - The content has 0 views
                                                  - Cost data is unavailable
                                                  - No spend data exists for the platform"
                                    example: 300
                                required:
                                  - contentId
                                  - title
                                  - publishTime
                                  - views7d
                                  - views30d
                                  - views90d
                                  - viewsLifetime
                                  - likes
                                  - comments
                                  - engagementRate
                                  - length
                                  - hashtags
                                  - estimatedContentCPM
                              description: "Performance data for one piece of this creator's sponsored content for the queried brand."
                          required:
                            - creatorId
                            - displayName
                            - platform
                            - creatorTotalStats
                            - creatorAllSponsoredStats
                            - creatorSpecificSponsoredStats
                            - estimatedCost
                            - estimatedCreatorCPM
                            - content
                        description:"Array of creator groups. Each group contains:
                                      - Creator ID and identity information
                                      - Three parallel stats objects for comparison (`creatorTotalStats`, `creatorAllSponsoredStats`, `creatorSpecificSponsoredStats`)
                                      - A content array with the creator's sponsored content pieces for the queried brand
                                      - Filtered by the platform parameter and paginated via `pageSize` and `offset`.
                      totalResults:
                        type: integer
                        minimum: 0
                        description: "Total number of creators that match the queried brand and platform, across all pages."
                        example: 156
                      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:
                      - sponsoredCreators
                      - totalResults
                      - offset
                      - pageSize
                    description: "Sponsored creators with performance data for the queried brand and platform, along 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. Equals planCreditsAvailable plus purchasedCreditsAvailable."
                    example: 975
                  creditsUsed:
                    type: number
                    description: "Number of API credits consumed by this request."
                    example: 25
                  planCreditsAvailable:
                    type: number
                    description: "Remaining plan credits after this request, in credits."
                    examples:
                      - 900
                  purchasedCreditsAvailable:
                    type: number
                    description: "Remaining purchased-bucket credits after this request, in display units."
                    examples:
                      - 75
                  keyCreditsAvailable:
                    type: number
                    description: "Remaining credits this API key can spend after this request, before reaching its spend limit. Present only when the key has a spend limit."
                    examples:
                      - 4975
                  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 successful."
                    example: ""
                  success:
                    type: boolean
                    description: "`true` if the request is successful."
                    example: true
                required:
                  - data
                  - traceId
                  - timestamp
                  - creditsAvailable
                  - creditsUsed
                  - planCreditsAvailable
                  - purchasedCreditsAvailable
                  - errorCode
                  - errorDescription
                  - success
                description: "Sponsor Performance API response. Contains creator performance data in data, along with credit usage, trace info, and error details."
# Sponsor audience
  /sponsor/audience:
      get:
        summary: Get Sponsored Creator Demographics
        description: "Returns audience demographics for a brand's sponsored YouTube and Instagram creators when available. Using optional platform filters returns a single key."
        operationId: getSponsorAudience
        tags:
          - Sponsor
        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: false
            schema:
                type: string
                enum:
                  - youtube
                  - instagram
                description: "Filter audience demographics by social media platform. If empty, returns data for both platforms (either may be absent if unavailable)."
                example: youtube  
        responses:
          "200":
            description: "Audience data of sponsored creators returned successfully."
            content:
              application/json:
                schema:
                  type: object
                  properties:
                    data:
                      type: object
                      properties:
                        youtube:
                          type:
                            - object
                            - "null"
                          properties:
                            audienceLocations:
                              type: array
                              items:
                                type: object
                                properties:
                                  country:
                                    type: string
                                    description: "Country code in ISO 3166-1 alpha-3 format."
                                    example: THA
                                  share:
                                    type: number
                                    description: "Proportion of this brand's sponsored audience on YouTube that is from this country. Expressed as a decimal rounded to 4 decimal places (e.g., 0.1446 = 14.46%)."
                                    example: 0.1446
                                required:
                                  - country
                                  - share
                                description: "A single country and its share of the sponsored audience pool."
                              description: "Top 5 countries for this brand's sponsored audience on YouTube, ranked by share."
                            audienceGender:
                              type: object
                              properties:
                                maleRatio:
                                  type: number
                                  description: "Proportion of this brand's sponsored audience on YouTube that identifies as male. Expressed as a decimal rounded to 4 decimal places (e.g., 0.6705 = 67.05%)."
                                  example: 0.6705
                                femaleRatio:
                                  type: number
                                  description: "Proportion of this brand's sponsored audience on YouTube that identifies as female. Expressed as a decimal rounded to 4 decimal places (e.g., 0.3295 = 32.95%)."
                                  example: 0.3295
                              required:
                                - maleRatio
                                - femaleRatio
                              description: "Gender distribution of this brand's sponsored audience pool on YouTube."
                            audienceAvgAge:
                              type: integer
                              description: "Average age of the sponsored audience on YouTube, rounded to an integer."
                              example: 28
                            audienceAgeBreakdown:
                              type: array
                              items:
                                type: object
                                properties:
                                  ageRange:
                                    type: string
                                    enum:
                                      - 13-17
                                      - 18-24
                                      - 25-34
                                      - 35-44
                                      - 45-54
                                      - 55-64
                                      - 65+
                                    description: "Age range bucket for this breakdown item."
                                    example: 18-24
                                  share:
                                    type: number
                                    description: "Proportion of this brand's sponsored audience in this age group, rounded to 4 decimal places (e.g., 0.2450 = 24.50%)."
                                    example: 0.245
                                required:
                                  - ageRange
                                  - share
                                description: "Age bucket in the sponsored audience pool on YouTube."
                                example: 18-24
                              description: "Distribution of sponsored audience by age range on YouTube."
                          required:
                            - audienceLocations
                            - audienceGender
                            - audienceAvgAge
                            - audienceAgeBreakdown
                          description: "Audience data for this brand's YouTube sponsored creators. Returns `null` when the brand has no sponsored YouTube channels."
                        instagram:
                          type:
                            - object
                            - "null"
                          properties:
                            audienceLocations:
                              type: array
                              items:
                                type: object
                                properties:
                                  country:
                                    type: string
                                    description: "Country code in ISO 3166-1 alpha-3 format."
                                    example: THA
                                  share:
                                    type: number
                                    description: "Proportion of this brand's sponsored audience on Instagram that is from this country. Expressed as a decimal rounded to 4 decimal places (e.g., 0.1446 = 14.46%)."
                                    example: 0.1446
                                required:
                                  - country
                                  - share
                                description: "A single country and its share of the sponsored audience pool."
                              description: "Top 5 countries for this brand's sponsored audience on Instagram, ranked by share."
                            audienceGender:
                              type: object
                              properties:
                                maleRatio:
                                  type: number
                                  description: "Proportion of this brand's sponsored audience on Instagram that identifies as male. Expressed as a decimal rounded to 4 decimal places (e.g., 0.6705 = 67.05%)."
                                  example: 0.6705
                                femaleRatio:
                                  type: number
                                  description: "Proportion of this brand's sponsored audience on Instagram that identifies as female. Expressed as a decimal rounded to 4 decimal places (e.g., 0.3295 = 32.95%)."
                                  example: 0.3295
                              required:
                                - maleRatio
                                - femaleRatio
                              description: "Gender distribution of this brand's sponsored audience pool on Instagram."
                            audienceAvgAge:
                              type: integer
                              description: "Average age of this brand's sponsored audience on Instagram, rounded to integer."
                              example: 28
                            audienceAgeBreakdown:
                              type: array
                              items:
                                type: object
                                properties:
                                  ageRange:
                                    type: string
                                    enum:
                                      - 13-17
                                      - 18-24
                                      - 25-34
                                      - 35-44
                                      - 45-54
                                      - 55-64
                                      - 65+
                                    description: "Age range bucket for this breakdown item."
                                    example: 18-24
                                  share:
                                    type: number
                                    description: "Proportion of audience in this age group, rounded to 4th decimal."
                                    example: 0.245
                                required:
                                  - ageRange
                                  - share
                                description: "Age bucket in the sponsored audience pool on Instagram."
                              description: "Distribution of sponsored audience by age range on Instagram."
                          required:
                            - audienceLocations
                            - audienceGender
                            - audienceAvgAge
                            - audienceAgeBreakdown
                          description: "Audience demographics keyed by platform. When the platform parameter filters the query, only the matching platform's key is returned. Keys for platforms without data are absent from the response."
                    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. Equals planCreditsAvailable plus purchasedCreditsAvailable."
                      example: 975
                    creditsUsed:
                      type: number
                      description: "Number of API credits consumed by this request."
                      example: 25
                    planCreditsAvailable:
                      type: number
                      description: "Remaining plan credits after this request, in credits."
                      examples:
                        - 900
                    purchasedCreditsAvailable:
                      type: number
                      description: "Remaining purchased-bucket credits after this request, in display units."
                      examples:
                        - 75
                    keyCreditsAvailable:
                      type: number
                      description: "Remaining credits this API key can spend after this request, before reaching its spend limit. Present only when the key has a spend limit."
                      examples:
                        - 4975
                    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
                    - planCreditsAvailable
                    - purchasedCreditsAvailable
                    - errorCode
                    - errorDescription
                    - success
                  description: "Sponsor Audience API response. Contains audience demographics in data, along with credit usage, trace info, and error details.\""
# Sponsor summary
  /sponsor/summary:
      get:
        summary: "Get Brand Summary"
        description: "Returns a non-paginated summary object for a brand, combining creator roster rollups and platform-level performance totals for both YouTube and Instagram. Includes YouTube-specific metrics: estimated brand spend, CPM, and CPE."
        operationId: getSponsorSummary
        tags:
          - Sponsor
        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
        responses:
          "200":
            description: "Brand summary data returned successfully."
            content:
              application/json:
                schema:
                  type: object
                  properties:
                    data:
                      type: object
                      properties:
                        summary:
                          type: object
                          properties:
                            totalSponsoredCreators:
                              type: integer
                              description: "Total number of creators this brand sponsors across YouTube and Instagram. Creators active on both platforms are counted twice."
                              example: 49
                            totalSponsoredContent:
                              type: integer
                              description: "Total number of sponsored content pieces this brand sponsors across YouTube and Instagram."
                              example: 278
                            youtube:
                              type: object
                              properties:
                                creators:
                                  type: object
                                  properties:
                                    sponsoredCreators:
                                      type: integer
                                      description: "Total unique creators sponsored by this brand on YouTube."
                                      example: 34
                                    sponsoredContent:
                                      type: integer
                                      description: "Total number of sponsored content pieces from this brand on YouTube."
                                      example: 156
                                    sponsoredContent30d:
                                      type: integer
                                      description: "Sponsored content pieces from this brand published on YouTube in the last 30 days."
                                      example: 35
                                    creatorLocationBreakdown:
                                      type: array
                                      items:
                                        type: object
                                        properties:
                                          key:
                                            type: string
                                            description: "Country code in ISO 3166-1 alpha-3 format."
                                          count:
                                            type: integer
                                            description: "Number of YouTube creators sponsored by this brand in this country."
                                            example: 12
                                          share:
                                            type: number
                                            description: "Proportion of this brand's sponsored YouTube creators that are based in this country. Expressed as a decimal rounded to 4 decimal places (e.g., 0.4 = 40%)."
                                            example: 0.4
                                        required:
                                          - key
                                          - count
                                          - share
                                        description: "A single country with its sponsored YouTube creator count and share."
                                      description: "Top 5 countries of this brand's sponsored YouTube creators, ranked by count. Shares across the top 5 may sum to less than 100%."
                                    creatorLanguageBreakdown:
                                      type: array
                                      items:
                                        type: object
                                        properties:
                                          key:
                                            type: string
                                            description: "Language code in ISO-639 alpha-3 format."
                                            example: eng
                                          count:
                                            type: integer
                                            description: "Number of sponsored YouTube creators, who primarily speak this language."
                                            example: 12
                                          share:
                                            type: number
                                            description: "Proportion of this brand's sponsored YouTube creators, who primarily speak this language. Expressed as a decimal rounded to 4 decimal places (e.g., 0.4 = 40%)."
                                            example: 0.4
                                        required:
                                          - key
                                          - count
                                          - share
                                        description: "A single language with its sponsored YouTube creator count and share."
                                      description: "Top 5 languages of this brand's sponsored YouTube creators, ranked by count. Share across the top 5 may sum to less than 100%."
                                  required:
                                    - sponsoredCreators
                                    - sponsoredContent
                                    - sponsoredContent30d
                                    - creatorLocationBreakdown
                                    - creatorLanguageBreakdown
                                  description: "Summary of this brand's sponsored YouTube creators: total counts, recent sponsored content volume, and breakdowns by creator location and language."
                                performance:
                                  type: object
                                  properties:
                                    estimatedTotalSpend7d:
                                      type:
                                        - number
                                        - "null"
                                      description: "Estimated amount (USD) spent by this brand on sponsored YouTube creators over a rolling 7-day window. Returns null when no sponsored creator has a price estimate available."
                                      example: 28000
                                    estimatedTotalSpend30d:
                                      type:
                                        - number
                                        - "null"
                                      description: "Estimated amount (USD) spent by this brand on sponsored YouTube creators over a rolling 30-day window. Returns null when no sponsored creator has a price estimate available."
                                      example: 100000
                                    estimatedTotalSpend90d:
                                      type:
                                        - number
                                        - "null"
                                      description: "Estimated amount (USD) spent by this brand on sponsored YouTube creators over a rolling 90-day window. Returns null when no sponsored creator has a price estimate available."
                                      example: 220000
                                    estimatedCPM30d:
                                      type:
                                        - number
                                        - "null"
                                      description: "Cost per Mille (CPM, in USD) of the brand over a rolling 30-day window. < /br> CPM = `estimatedTotalSpend30d` /`views30d` x 1000 < /br> Returns `null` when the estimated total spend or the 30-day sponsored video views data is `null` or `0`. This is the brand's aggregate CPM across all sponsored content in the window. For per-video CPM, see the `sponsor/performance` endpoint."
                                      example: 8.51
                                    estimatedCPE30d:
                                      type:
                                        - number
                                        - "null"
                                      description: "Cost per Engagement (CPE, in USD) for this brand over a rolling 30-day window. Engagement is defined as likes plus comments on sponsored content published in the window.< /b> CPE = `estimatedTotalSpend30d` / sum(`likes` + `comments`) < /br> Returns `null` when `estimatedTotalSpend30d` is `null` or the denominator is `0`."
                                      example: 0.31
                                    views:
                                      type: object
                                      properties:
                                        total:
                                          type: number
                                          description: "Total views across all of this brand's sponsored YouTube content (all-time)."
                                          example: 452000000
                                        avg:
                                          type: number
                                          description: "Mean views per piece of this brand's sponsored YouTube content (all-time)."
                                          example: 75374
                                        median:
                                          type: number
                                          description: "Median views per piece of this brand's sponsored YouTube content (all-time)."
                                          example: 62000
                                        min:
                                          type: number
                                          description: "Minimum views on any single piece of this brand's sponsored YouTube content (all-time)."
                                          example: 1200
                                        max:
                                          type: number
                                          description: "Maximum views on any single piece of this brand's sponsored YouTube content (all-time)."
                                          example: 890000
                                        views30d:
                                          type: number
                                          description: "Sum of views on this brand's sponsored YouTube content over a rolling 30-day window. Unavailable on Instagram."
                                          example: 11758366
                                      required:
                                        - total
                                        - avg
                                        - median
                                        - min
                                        - max
                                        - views30d
                                      description: "Summary statistics of views on this brand's sponsored YouTube content."
                                    likes:
                                      type: object
                                      properties:
                                        total:
                                          type: number
                                          description: "Total likes across all of this brand's sponsored YouTube content (all-time)"
                                          example: 452000000
                                        avg:
                                          type: number
                                          description: "Mean likes per piece of this brand's sponsored YouTube content (all-time)."
                                          example: 75374
                                        median:
                                          type: number
                                          description: "Median likes per piece of this brand's sponsored YouTube content (all-time)."
                                          example: 62000
                                        min:
                                          type: number
                                          description: "Minimum likes on any single piece of this brand's sponsored YouTube content (all-time)."
                                          example: 1200
                                        max:
                                          type: number
                                          description: "Maximum likes on any single piece of this brand's sponsored YouTube content (all-time)."
                                          example: 890000
                                      required:
                                        - total
                                        - avg
                                        - median
                                        - min
                                        - max
                                      description: "Summary statistics of likes on this brand's sponsored YouTube content."
                                    comments:
                                      type: object
                                      properties:
                                        total:
                                          type: number
                                          description: "Total comments across all of this brand's sponsored YouTube content (all-time)"
                                          example: 452000000
                                        avg:
                                          type: number
                                          description: "Mean comments per piece of this brand's sponsored YouTube content (all-time)."
                                          example: 75374
                                        median:
                                          type: number
                                          description: "Median comments per piece of this brand's sponsored YouTube content (all-time)."
                                          example: 62000
                                        min:
                                          type: number
                                          description: "Minimum comments on any single piece of this brand's sponsored YouTube content (all-time)."
                                          example: 1200
                                        max:
                                          type: number
                                          description: "Maximum comments on any single piece of this brand's sponsored YouTube content (all-time)."
                                          example: 890000
                                      required:
                                        - total
                                        - avg
                                        - median
                                        - min
                                        - max
                                      description: "Summary statistics of comments on this brand's sponsored YouTube content."
                                    engagement:
                                      type: object
                                      properties:
                                        avgEngagementRate:
                                          type: number
                                          description: "Average engagement rate across all of this brand's sponsored YouTube content. Expressed as a decimal and rounded up to 4 decimal places (e.g., 0.0352=3.52%). Engagement rate is defined as (likes + comments) / views."
                                          example: 0.0352
                                      required:
                                        - avgEngagementRate
                                      description: "Average engagement rate across this brand's sponsored YouTube content."
                                    growth30d:
                                      type: object
                                      properties:
                                        viewsGrowth:
                                          type: number
                                          description: "Views growth ratio for this brand's sponsored YouTube content over a rolling 30-day window. Computed as `delta` / `(current - delta)`, where `delta` is the 30-day change in views and `current - delta` is the views count at the start of the window. Expressed as a decimal rounded to 4 decimal places (e.g., 0.3261 = 32.61%)."
                                          example: 0.3261
                                        likesGrowth:
                                          type: number
                                          description: "Likes growth ratio for this brand's sponsored YouTube content over a rolling 30-day window. Computed as `delta` / `(current - delta)`, where `delta` is the 30-day change in likes and `current - delta` is the likes count at the start of the window. Expressed as a decimal rounded to 4 decimal places (e.g., 0.2119 = 21.19%)."
                                          example: 0.2119
                                        commentsGrowth:
                                          type: number
                                          description: "Comments growth ratio for this brand's sponsored YouTube content over a rolling 30-day window. Computed as `delta` / `(current - delta)`, where `delta` is the 30-day change in comments and `current - delta` is the comments count at the start of the window. Expressed as a decimal rounded to 4 decimal places (e.g., 0.2976 = 29.76%)."
                                          example: 0.2976
                                        engagementGrowth:
                                          type: number
                                          description: "Engagement growth ratio for this brand's sponsored YouTube content over a rolling 30-day window. Computed as `delta` / `(current - delta)`, where `delta` is the 30-day change in engagement and `current - delta` is the engagement count at the start of the window. Expressed as a decimal rounded to 4 decimal places (e.g., -0.0831 = -8.31%)."
                                          example: -0.0831
                                      required:
                                        - viewsGrowth
                                        - likesGrowth
                                        - commentsGrowth
                                        - engagementGrowth
                                      description: "Rolling 30-day growth ratios for this brand's sponsored YouTube content, covering views, likes, comments, and engagement."
                                  required:
                                    - estimatedTotalSpend7d
                                    - estimatedTotalSpend30d
                                    - estimatedTotalSpend90d
                                    - estimatedCPM30d
                                    - estimatedCPE30d
                                    - views
                                    - likes
                                    - comments
                                    - engagement
                                    - growth30d
                                  description: "Aggregate metrics for this brand's sponsored YouTube activity, covering estimated spend, efficiency ratios (CPM, CPE), engagement totals, and rolling growth."
                              required:
                                - creators
                                - performance
                              description: "Creator roster and aggregate performance metrics for this brand's sponsored YouTube activity."
                            instagram:
                              type: object
                              properties:
                                creators:
                                  type: object
                                  properties:
                                    sponsoredCreators:
                                      type: integer
                                      description: "Total unique creators sponsored by this brand on Instagram."
                                      example: 34
                                    sponsoredContent:
                                      type: integer
                                      description: "Total number of sponsored content pieces from this brand on Instagram (all-time)."
                                      example: 156
                                    sponsoredContent30d:
                                      type: integer
                                      description: "Sponsored content pieces from this brand published on Instagram in the last 30 days."
                                      example: 35
                                    creatorLocationBreakdown:
                                      type: array
                                      items:
                                        type: object
                                        properties:
                                          key:
                                            type: string
                                            description: "Country code in ISO 3166-1 alpha-3 format."
                                          count:
                                            type: integer
                                            description: "Number of Instagram creators sponsored by this brand in this country."
                                            example: 12
                                          share:
                                            type: number
                                            description: "Proportion of this brand's sponsored Instagram creators that are based in this country. Expressed as a decimal rounded to 4 decimal places (e.g., 0.4 = 40%)."
                                            example: 0.4
                                        required:
                                          - key
                                          - count
                                          - share
                                        description: "A single country with its sponsored Instagram creator count and share."
                                      description: "Top 5 countries of this brand's sponsored Instagram creators, ranked by count. Shares across the top 5 may sum to less than 100%."
                                    creatorLanguageBreakdown:
                                      type: array
                                      items:
                                        type: object
                                        properties:
                                          key:
                                            type: string
                                            description: "Language code in ISO-639 alpha-3 format."
                                          count:
                                            type: integer
                                            description: "Number of sponsored Instagram creators, who primarily speak this language."
                                            example: 12
                                          share:
                                            type: number
                                            description: "Proportion of this brand's sponsored Instagram creators that primarily speak this language. Expressed as a decimal rounded to 4 decimal places (e.g., 0.4 = 40%)."
                                            example: 0.4
                                        required:
                                          - key
                                          - count
                                          - share
                                        description: "A single language with its sponsored Instagram creator count and share."
                                      description: "Top 5 languages of this brand's sponsored Instagram creators, ranked by count. Share across the top 5 may sum to less than 100%."
                                  required:
                                    - sponsoredCreators
                                    - sponsoredContent
                                    - sponsoredContent30d
                                    - creatorLocationBreakdown
                                    - creatorLanguageBreakdown
                                  description: "Summary of this brand's sponsored Instagram creators: total counts, recent sponsored content volume, and breakdowns by creator location and language."
                                performance:
                                  type: object
                                  properties:
                                    estimatedTotalSpend7d:
                                      type: "null"
                                      description: "Not yet available for Instagram. Always returns `null`. See parent object description."
                                      example: null
                                    estimatedTotalSpend30d:
                                      type: "null"
                                      description: "Not yet available for Instagram. Always returns `null`. See parent object description."
                                      example: null
                                    estimatedTotalSpend90d:
                                      type: "null"
                                      description: "Not yet available for Instagram. Always returns `null`. See parent object description."
                                      example: null
                                    estimatedCPM30d:
                                      type: "null"
                                      description: "Not yet available for Instagram. Always returns `null`. See parent object description."
                                      example: null
                                    estimatedCPE30d:
                                      type: "null"
                                      description: "Not yet available for Instagram. Always returns `null`. See parent object description."
                                      example: null
                                    views:
                                      type: object
                                      properties:
                                        total:
                                          type: number
                                          description: "Total views across all of this brand's sponsored Instagram posts (all-time)."
                                          example: 452000000
                                        avg:
                                          type: number
                                          description: "Mean views per piece of this brand's sponsored Instagram posts (all-time)."
                                          example: 75374
                                        median:
                                          type: number
                                          description: "Median views per piece of this brand's sponsored Instagram posts (all-time)."
                                          example: 62000
                                        min:
                                          type: number
                                          description: "Minimum views per piece of this brand's sponsored Instagram posts (all-time)."
                                          example: 1200
                                        max:
                                          type: number
                                          description: "Maximum views per piece of this brand's sponsored Instagram posts (all-time)."
                                          example: 890000
                                      required:
                                        - total
                                        - avg
                                        - median
                                        - min
                                        - max
                                      description: "Summary statistics of views on this brand's sponsored Instagram posts. Sum of views on this brand's sponsored Instagram posts over a rolling 30-day window is unavailable."
                                    likes:
                                      type: object
                                      properties:
                                        total:
                                          type: number
                                          description: "Total likes across all of this brand's sponsored Instagram posts (all-time)"
                                          example: 452000000
                                        avg:
                                          type: number
                                          description: "Mean likes per piece of this brand's sponsored Instagram posts (all-time)."
                                          example: 75374
                                        median:
                                          type: number
                                          description: "Median likes per piece of this brand's sponsored Instagram posts (all-time)."
                                          example: 62000
                                        min:
                                          type: number
                                          description: "Minimum likes on any single piece of this brand's sponsored Instagram posts (all-time)."
                                          example: 1200
                                        max:
                                          type: number
                                          description: "Maximum likes on any single piece of this brand's sponsored Instagram posts (all-time)."
                                          example: 890000
                                      required:
                                        - total
                                        - avg
                                        - median
                                        - min
                                        - max
                                      description: "Summary statistics of likes on this brand's sponsored Instagram posts."
                                    comments:
                                      type: object
                                      properties:
                                        total:
                                          type: number
                                          description: "Total comments across all of this brand's sponsored Instagram posts (all-time)"
                                          example: 452000000
                                        avg:
                                          type: number
                                          description: "Mean comments per piece of this brand's sponsored Instagram posts (all-time)."
                                          example: 75374
                                        median:
                                          type: number
                                          description: "Median comments per piece of this brand's sponsored Instagram posts (all-time)."
                                          example: 62000
                                        min:
                                          type: number
                                          description: "Minimum comments on any single piece of this brand's sponsored Instagram posts (all-time)."
                                          example: 1200
                                        max:
                                          type: number
                                          description: "Maximum comments on any single piece of this brand's sponsored Instagram posts (all-time)."
                                          example: 890000
                                      required:
                                        - total
                                        - avg
                                        - median
                                        - min
                                        - max
                                      description: "Summary statistics of comments on this brand's sponsored Instagram posts."
                                    engagement:
                                      type: object
                                      properties:
                                        avgEngagementRate:
                                          type: number
                                          description: "Average engagement rate across all of this brand's sponsored Instagram posts. Expressed as a decimal and rounded up to 4 decimal places (e.g., 0.0352=3.52%). Engagement rate is defined as (likes + comments) / views."
                                      required:
                                        - avgEngagementRate
                                      description: "Average engagement rate across this brand's sponsored Instagram posts."
                                    growth30d:
                                      type: object
                                      properties:
                                        viewsGrowth:
                                          type: number
                                          description: "Views growth ratio for this brand's sponsored Instagram posts over a rolling 30-day window. Computed as `delta` / `(current - delta)`, where `delta` is the 30-day change in views and `current - delta` is the views count at the start of the window. Expressed as a decimal rounded to 4 decimal places (e.g., 0.3261 = 32.61%)."
                                          example: 0.3261
                                        likesGrowth:
                                          type: number
                                          description: "Likes growth ratio for this brand's sponsored Instagram posts over a rolling 30-day window. Computed as `delta` / `(current - delta)`, where `delta` is the 30-day change in views and `current - delta` is the views count at the start of the window. Expressed as a decimal rounded to 4 decimal places (e.g., 0.2119 = 21.19%)."
                                          example: 0.2119
                                        commentsGrowth:
                                          type: number
                                          description: "Comments growth ratio for this brand's sponsored Instagram posts over a rolling 30-day window. Computed as `delta` / `(current - delta)`, where `delta` is the 30-day change in views and `current - delta` is the views count at the start of the window. Expressed as a decimal rounded to 4 decimal places (e.g.,0.2976 = 29.76%)."
                                          example: 0.2976
                                        engagementGrowth:
                                          type: number
                                          description: "Engagement growth ratio for this brand's sponsored YouTube content over a rolling 30-day window. Computed as `delta` / `(current - delta)`, where `delta` is the 30-day change in engagement and `current - delta` is the engagement count at the start of the window. Expressed as a decimal rounded to 4 decimal places (e.g., -0.0831 = -8.31%)."
                                          example: -0.0831
                                      required:
                                        - viewsGrowth
                                        - likesGrowth
                                        - commentsGrowth
                                        - engagementGrowth
                                      description: "Rolling 30-day growth ratios for this brand's sponsored Instagram content, covering views, likes, comments, and engagement."
                                  required:
                                    - estimatedTotalSpend7d
                                    - estimatedTotalSpend30d
                                    - estimatedTotalSpend90d
                                    - estimatedCPM30d
                                    - estimatedCPE30d
                                    - views
                                    - likes
                                    - comments
                                    - engagement
                                    - growth30d
                                  description: "Aggregate metrics for this brand's sponsored Instagram activity, covering engagement totals, and rolling growth. Performance metrics for this brand's sponsored Instagram activity. Spend and efficiency fields are currently placeholders (always `null`) and will be populated when Instagram pricing data becomes available."
                              required:
                                - creators
                                - performance
                              description: "Creator roster and aggregate performance metrics for this brand's sponsored Instagram activity."
                          required:
                            - totalSponsoredCreators
                            - totalSponsoredContent
                            - youtube
                            - instagram
                          description: "Summary of this brand's sponsored activity: cross-platform totals and per-platform breakdowns (YouTube, Instagram)."
                      required:
                        - summary
                      description: "Top-level response object containing the brand summary."
                    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. Equals planCreditsAvailable plus purchasedCreditsAvailable."
                      example: 975
                    creditsUsed:
                      type: number
                      description: "Number of API credits consumed by this request."
                      example: 25
                    planCreditsAvailable:
                      type: number
                      description: "Remaining plan credits after this request, in credits."
                      examples:
                        - 900
                    purchasedCreditsAvailable:
                      type: number
                      description: "Remaining purchased-bucket credits after this request, in display units."
                      examples:
                        - 75
                    keyCreditsAvailable:
                      type: number
                      description: "Remaining credits this API key can spend after this request, before reaching its spend limit. Present only when the key has a spend limit."
                      examples:
                        - 4975
                    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
                    - planCreditsAvailable
                    - purchasedCreditsAvailable
                    - errorCode
                    - errorDescription
                    - success
                  description: "Response body for a sponsor summary. Summary details are returned in `data`."
webhooks: {}
tags:
  - 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: Sponsor
    description: "Sponsor analysis endpoints including sponsor search and sponsor reports."
  - name: TikTok
    description: "TikTok creator data endpoints with metrics and advanced search functionality."
  - name: YouTube
    description: "YouTube creator data endpoints including basic metrics, historical data, and detailed analytics."
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      description: "The valid CreatorDB API key for authentication."
      name: api-key
      in: header
  schemas:
    DisplayNameFilter:
      type: object
      title: displayName
      required: [filterName, op, value]
      properties:
        filterName:
          type: string
          description: "The YouTube channel name."
          const: displayName
        op:
          type: string
          enum: [in, "="]
        value:
          oneOf:
            - type: string
            - type: array
              items:
                type: string
        isFuzzySearch:
          type: boolean
          default: false
    YoutubeProfileData:
      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
        isPodcast:
          type:
            - boolean
            - "null"
          description: "Whether the channel is a podcast channel, as labeled by CreatorDB's AI classifier. `null` means the channel hasn't been classified."
          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-v3/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 490 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: "Channels YouTube recommends alongside this creator's videos, returned as channel IDs and ordered by how often YouTube recommends them."
          examples:
            - - UCBR8-60-B28hp2BmDPdntcQ
              - UC4PooiX37Pld1T8J5SYT-SQ
          items:
            type: string
        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
    YoutubePerformanceData:
      type: object
      description: "Performance metrics."
      properties:
        contentCountByDays:
          type: object
          description: "Number of videos published over different time intervals."
          properties:
            7d:
              type: integer
              description: "Number of videos published in the past 7 days."
              minimum: 0
              examples:
                - 1
            30d:
              type: integer
              description: "Number of videos published in the past 30 days."
              minimum: 0
              examples:
                - 2
            90d:
              type: integer
              description: "Number of videos published in the past 90 days."
              minimum: 0
              examples:
                - 2
          required:
            - 7d
            - 30d
            - 90d
        ranking:
          type: object
          description: "Percentile rankings for various performance metrics, benchmarked at the global, country, or language level. A value of `1.0` indicates top 1%, while `0.5` represents the median."
          properties:
            totalSubscribers:
              type: object
              description: "Percentile rank of the total subscriber count."
              properties:
                global:
                  type: number
                  description: "Percentile rank compared to all creators in CreatorDB's database."
                  minimum: 0
                  maximum: 1
                  examples:
                    - 0.9912
                country:
                  type: number
                  description: "Percentile rank among creators from the same country."
                  minimum: 0
                  maximum: 1
                  examples:
                    - 0.9986
                language:
                  type: number
                  description: "Percentile rank among creators using the same primary language."
                  minimum: 0
                  maximum: 1
                  examples:
                    - 0.9764
              required:
                - global
                - country
                - language
            avgEngagementRate:
              type: object
              description: "Percentile rank of the average engagement rate for the last 20 YouTube videos."
              properties:
                global:
                  type: number
                  description: "Percentile rank compared to all creators in CreatorDB's database."
                  minimum: 0
                  maximum: 1
                  examples:
                    - 0.9912
                country:
                  type: number
                  description: "Percentile rank among creators from the same country."
                  minimum: 0
                  maximum: 1
                  examples:
                    - 0.9986
                language:
                  type: number
                  description: "Percentile rank among creators using the same primary language."
                  minimum: 0
                  maximum: 1
                  examples:
                    - 0.9764
              required:
                - global
                - country
                - language
          required:
            - totalSubscribers
            - avgEngagementRate
        videosPerformanceRecent:
          type: object
          description: "Performance metrics of the creator's last 20 YouTube videos."
          properties:
            likes:
              type: object
              properties:
                all:
                  type: integer
                  description: "Total number of likes across the last 20 YouTube videos."
                  minimum: 0
                  examples:
                    - 2944445
                avg:
                  type: integer
                  description: "Average likes per video for the last 20 YouTube videos, rounded to an integer."
                  minimum: 0
                  examples:
                    - 100
                median:
                  type: integer
                  description: "Median number of likes across the last 20 YouTube videos."
                  minimum: 0
                  examples:
                    - 48
                min:
                  type: integer
                  description: "Minimum number of likes across the last 20 YouTube videos."
                  minimum: 0
                  examples:
                    - 20
                max:
                  type: integer
                  description: "Maximum number of likes across the last 20 YouTube videos."
                  minimum: 0
                  examples:
                    - 149
              required:
                - all
                - avg
                - median
                - min
                - max
            comments:
              type: object
              properties:
                all:
                  type: integer
                  description: "Total number of comments across the last 20 YouTube videos."
                  minimum: 0
                  examples:
                    - 2944445
                avg:
                  type: integer
                  description: "Average comments per video for last 20 YouTube videos, rounded to an integer."
                  minimum: 0
                  examples:
                    - 100
                median:
                  type: integer
                  description: "Median number of comments across the last 20 YouTube videos."
                  minimum: 0
                  examples:
                    - 48
                min:
                  type: integer
                  description: "Minimum number of comments across the last 20 YouTube videos."
                  minimum: 0
                  examples:
                    - 20
                max:
                  type: integer
                  description: "Maximum number of comments across the last 20 YouTube videos."
                  minimum: 0
                  examples:
                    - 149
              required:
                - all
                - avg
                - median
                - min
                - max
            views:
              type: object
              properties:
                all:
                  type: integer
                  description: "Total number of views across the last 20 YouTube videos."
                  minimum: 0
                  examples:
                    - 3599
                avg:
                  type: integer
                  description: "Average views per video for the last 20 YouTube videos, rounded to an integer."
                  minimum: 0
                  examples:
                    - 100
                median:
                  type: integer
                  description: "Median number of views across the last 20 YouTube videos."
                  minimum: 0
                  examples:
                    - 48
                min:
                  type: integer
                  description: "Minimum number of views across the last 20 YouTube videos."
                  minimum: 0
                  examples:
                    - 20
                max:
                  type: integer
                  description: "Maximum number of views across the last 20 YouTube videos."
                  minimum: 0
                  examples:
                    - 149
                percentile25:
                  type: integer
                  description: "The 25th percentile (first quartile) of views across the last 20 YouTube videos."
                  minimum: 0
                  examples:
                    - 35
                percentile75:
                  type: integer
                  description: "The 75th percentile (third quartile) of views across the last 20 YouTube videos."
                  minimum: 0
                  examples:
                    - 85
                iqr:
                  type: integer
                  description: "Interquartile range (IQR) of views, calculated from the 25th to the 75th percentile, representing the spread of the middle 50%."
                  minimum: 0
                  examples:
                    - 50
              required:
                - all
                - avg
                - median
                - min
                - max
                - percentile25
                - percentile75
                - iqr
            length:
              type: object
              description: "Video length in seconds."
              properties:
                avg:
                  type: integer
                  description: "Average video length in seconds, rounded to an integer."
                  minimum: 0
                  examples:
                    - 180
              required:
                - avg
            engagement:
              type: object
              description: "Engagement performance metrics including engagement rates, per-subscriber statistics, and consistency analysis."
              properties:
                avgEngagementRate:
                  type: number
                  description: |-
                    Average engagement rate per video, rounded to 4th decimal place. <br />
                    - *Engagement Rate = (Likes + Comments)/ Views*
                  minimum: 0
                  examples:
                    - 0.5201
                likesPerSubscriber:
                  type: number
                  description: "Average likes per subscriber for the last 20 YouTube videos, rounded to 4th decimal place."
                  minimum: 0
                  examples:
                    - 0.1111
                commentsPerSubscriber:
                  type: number
                  description: "Average comments per subscriber for the last 20 YouTube videos, rounded to 4th decimal place."
                  minimum: 0
                  examples:
                    - 0.1111
                viewsPerSubscriber:
                  type: number
                  description: "Average views per subscriber for the last 20 YouTube videos, rounded to 4th decimal place."
                  minimum: 0
                  examples:
                    - 0.1111
                engagementConsistency:
                  type: object
                  description: "Consistency of engagement performance across the last 20 YouTube videos."
                  properties:
                    cv:
                      type: number
                      description: |-
                        *cv &#61; Standard Deviation of Engagement Rate/ Mean Engagement Rate* <br />
                        - The value is rounded to 4th decimal place. <br />
                        - Lower values indicate more consistent performance. <br />
                        - *A value of `0` indicates insufficient data.*
                      minimum: 0
                      examples:
                        - 0.1001
                    medianVsMean:
                      type: number
                      description: |-
                        *medianVsMean &#61; Median Engagement Rate/ Mean Engagement Rate* <br />
                        - The value is rounded to 4th decimal place. <br />
                        - Values closer to `1` indicate more consistent performance. <br />
                        - *A value of `0` indicates insufficient data.*
                      minimum: 0
                      examples:
                        - 0.9001
                    topBottomRatio:
                      type: number
                      description: |-
                        *topBottomRatio &#61; avg(Top 3 Engagement)/ avg(Bottom 3 Engagement)* <br />
                        - The value is rounded to 4th decimal place. <br />
                        - Lower ratios indicate more consistent performance. <br />
                        - *A value of `0` indicates insufficient data.*
                      minimum: 0
                      examples:
                        - 1.2001
                    consistencyScore:
                      type:
                        - integer
                        - "null"
                      description: |-
                        *consistencyScore &#61; 100 - [(cvScore*weight_cv) + (topBottomScore*weight_topBottom) + (medianVsMeanScore*weight_medianVsMean)]* <br />
                        - The score is rounded to an integer. <br />
                        - A higher score indicates more stable and consistent performance. <br />
                        - If any of the three indicators is `0`, the `consistencyScore` will be null.
                      minimum: 0
                      maximum: 100
                      examples:
                        - 63
                    consistencyLevel:
                      type:
                        - string
                        - "null"
                      enum:
                        - high
                        - moderate
                        - low
                        - null
                      description: |-
                        A qualitative label based on the `consistencyScore`: <br />
                        - high: 81 - 100 <br />
                        - moderate: 51 - 80 <br />
                        - low: 0 - 50 <br />
                        - Returns `null` when `consistencyScore` is `null`.
                      examples:
                        - moderate
                  required:
                    - cv
                    - medianVsMean
                    - topBottomRatio
                    - consistencyScore
                    - consistencyLevel
              required:
                - avgEngagementRate
                - likesPerSubscriber
                - commentsPerSubscriber
                - viewsPerSubscriber
                - engagementConsistency
          required:
            - likes
            - comments
            - views
            - length
            - engagement
        shortsPerformanceRecent:
          type: object
          description: "Performance metrics of the creator's last 20 YouTube shorts."
          properties:
            likes:
              type: object
              properties:
                all:
                  type: integer
                  description: "Total number of likes across the last 20 YouTube shorts."
                  minimum: 0
                  examples:
                    - 2459
                avg:
                  type: integer
                  description: "Average likes per short for the last 20 YouTube shorts, rounded to an integer."
                  minimum: 0
                  examples:
                    - 100
                median:
                  type: integer
                  description: "Median number of likes across the last 20 YouTube shorts."
                  minimum: 0
                  examples:
                    - 120
                min:
                  type: integer
                  description: "Minimum number of likes across the last 20 YouTube shorts."
                  minimum: 0
                  examples:
                    - 50
                max:
                  type: integer
                  description: "Maximum number of likes across the last 20 YouTube shorts."
                  minimum: 0
                  examples:
                    - 988
              required:
                - all
                - avg
                - median
                - min
                - max
            comments:
              type: object
              properties:
                all:
                  type: integer
                  description: "Total number of comments across the last 20 YouTube shorts."
                  minimum: 0
                  examples:
                    - 2459
                avg:
                  type: integer
                  description: "Average comments per short, rounded to an integer."
                  minimum: 0
                  examples:
                    - 100
                median:
                  type: integer
                  description: "Median number of comments across the last 20 YouTube shorts."
                  minimum: 0
                  examples:
                    - 120
                min:
                  type: integer
                  description: "Minimum number of comments across the last 20 YouTube shorts."
                  minimum: 0
                  examples:
                    - 50
                max:
                  type: integer
                  description: "Maximum number of comments across the last 20 YouTube shorts."
                  minimum: 0
                  examples:
                    - 988
              required:
                - all
                - avg
                - median
                - min
                - max
            views:
              type: object
              properties:
                all:
                  type: integer
                  description: "Total number of views across the last 20 YouTube shorts."
                  minimum: 0
                  examples:
                    - 2459
                avg:
                  type: integer
                  description: "Average views per short for the last 20 YouTube shorts, rounded to an integer."
                  minimum: 0
                  examples:
                    - 100
                median:
                  type: integer
                  description: "Median number of views across the last 20 YouTube shorts."
                  minimum: 0
                  examples:
                    - 120
                min:
                  type: integer
                  description: "Minimum number of views across the last 20 YouTube shorts."
                  minimum: 0
                  examples:
                    - 50
                max:
                  type: integer
                  description: "Maximum number of views across the last 20 YouTube shorts."
                  minimum: 0
                  examples:
                    - 988
                percentile25:
                  type: integer
                  description: "The 25th percentile (first quartile) of views across the last 20 YouTube shorts."
                  minimum: 0
                  examples:
                    - 80
                percentile75:
                  type: integer
                  description: "The 75th percentile (third quartile) of views across the last 20 YouTube shorts."
                  minimum: 0
                  examples:
                    - 250
                iqr:
                  type: integer
                  description: "Interquartile range (IQR) of views, calculated as the 25th to 75th percentile, representing the spread of the middle 50%."
                  minimum: 0
                  examples:
                    - 170
              required:
                - all
                - avg
                - median
                - min
                - max
                - percentile25
                - percentile75
                - iqr
            length:
              type: object
              description: "Shorts length statistics in seconds."
              properties:
                avg:
                  type: integer
                  description: "The average shorts length in seconds, rounded to an integer."
                  minimum: 0
                  examples:
                    - 180
              required:
                - avg
            engagement:
              type: object
              description: "Engagement performance metrics of shorts including rates, per-subscriber statistics and consistency analysis."
              properties:
                avgEngagementRate:
                  type: number
                  description: |-
                    Average engagement rate per short, rounded to 4th decimal place. <br /> 
                    - *Engagement Rate = (Likes + Comments)/ Views*.
                  minimum: 0
                  examples:
                    - 0.5201
                likesPerSubscriber:
                  type: number
                  description: "Average likes per subscriber for the last 20 YouTube shorts, rounded to 4th decimal place."
                  minimum: 0
                  examples:
                    - 0.1111
                commentsPerSubscriber:
                  type: number
                  description: "Average comments per subscriber for the last 20 YouTube shorts, rounded to 4th decimal place."
                  minimum: 0
                  examples:
                    - 0.1111
                viewsPerSubscriber:
                  type: number
                  description: "Average views per subscriber for the last 20 YouTube shorts, rounded to 4th decimal place."
                  minimum: 0
                  examples:
                    - 0.1111
                engagementConsistency:
                  type: object
                  description: "Consistency of engagement performance across the last 20 YouTube shorts."
                  properties:
                    cv:
                      type: number
                      description: |-
                        *cv &#61; Standard Deviation of Engagement Rate/Mean Engagement Rate* <br />
                        - The value is rounded to 4th decimal place. <br />
                        - Lower values indicate more consistent performance. <br />
                        - *A value of `0` indicates insufficient data.*
                      minimum: 0
                      examples:
                        - 0.1001
                    medianVsMean:
                      type: number
                      description: |-
                        *medianVsMean &#61; Median Engagement Rate/ Mean Engagement Rate* <br />
                        - The value is rounded to 4th decimal place. <br />
                        - Values closer to `1` indicate more consistent performance. <br />
                        - *A value of `0` indicates insufficient data.*
                      minimum: 0
                      examples:
                        - 0.9001
                    topBottomRatio:
                      type: number
                      description: |-
                        *topBottomRatio &#61; avg(Top 3 Engagement)/avg(Bottom 3 Engagement)* <br />
                        - The value is rounded to 4th decimal place. <br />
                        - Lower ratios indicate more consistent performance. <br />
                        - *A value of `0` indicates insufficient data.*
                      minimum: 0
                      examples:
                        - 1.2001
                    consistencyScore:
                      type:
                        - integer
                        - "null"
                      description: |-
                        *consistencyScore &#61; 100 - [(cvScore\*weight_cv) + (topBottomScore\*weight_topBottom) + (medianVsMeanScore\*weight_medianVsMean)]* <br />
                        - The score is rounded to an integer. <br />
                        - A higher score indicates more stable and consistent performance. <br />
                        - If any of the three indicators is `0`, the `consistencyScore` will be `null`.
                      minimum: 0
                      maximum: 100
                      examples:
                        - 63
                    consistencyLevel:
                      type:
                        - string
                        - "null"
                      enum:
                        - high
                        - moderate
                        - low
                        - null
                      description: |-
                        A qualitative label based on the `consistencyScore`: <br />
                        - high: 81 - 100 <br />
                        - moderate: 51 - 80 <br />
                        - low: 0 - 50 <br />
                        - Returns `null` when `consistencyScore` is `null`.
                      examples:
                        - moderate
                  required:
                    - cv
                    - medianVsMean
                    - topBottomRatio
                    - consistencyScore
                    - consistencyLevel
              required:
                - avgEngagementRate
                - likesPerSubscriber
                - commentsPerSubscriber
                - viewsPerSubscriber
                - engagementConsistency
          required:
            - likes
            - comments
            - views
            - length
            - engagement
        videosPerformanceAll:
          type: object
          description: "Creator's video performance metrics for the last 800 YouTube videos."
          properties:
            likes:
              type: object
              description: "Likes statistics for the last 800 YouTube videos."
              properties:
                all:
                  type: integer
                  description: "Total number of likes across the last 800 YouTube videos."
                  minimum: 0
                  examples:
                    - 2944445
                avg:
                  type: integer
                  description: "Average likes per video for the last 800 YouTube videos, rounded to an integer."
                  minimum: 0
                  examples:
                    - 100
                median:
                  type: integer
                  description: "Median number of likes across the last 800 YouTube videos."
                  minimum: 0
                  examples:
                    - 48
                min:
                  type: integer
                  description: "Minimum number of likes across the last 800 YouTube videos."
                  minimum: 0
                  examples:
                    - 20
                max:
                  type: integer
                  description: "Maximum number of likes across the last 800 YouTube videos."
                  minimum: 0
                  examples:
                    - 149
              required:
                - all
                - avg
                - median
                - min
                - max
            comments:
              type: object
              description: "Comments statistics for the last 800 YouTube videos."
              properties:
                all:
                  type: integer
                  description: "Total number of comments across the last 800 YouTube videos."
                  minimum: 0
                  examples:
                    - 2944445
                avg:
                  type: integer
                  description: "Average comments per video for the last 800 YouTube videos, rounded to an integer."
                  minimum: 0
                  examples:
                    - 100
                median:
                  type: integer
                  description: "Median number of comments across the last 800 YouTube videos."
                  minimum: 0
                  examples:
                    - 48
                min:
                  type: integer
                  description: "Minimum number of comments across the last 800 YouTube videos."
                  minimum: 0
                  examples:
                    - 20
                max:
                  type: integer
                  description: "Maximum number of comments across the last 800 YouTube videos."
                  minimum: 0
                  examples:
                    - 149
              required:
                - all
                - avg
                - median
                - min
                - max
            views:
              type: object
              description: "View statistics for the last 800 YouTube videos."
              properties:
                all:
                  type: integer
                  description: "Total number of views across the last 800 YouTube videos."
                  minimum: 0
                  examples:
                    - 3599
                avg:
                  type: integer
                  description: "Average views per video for the last 800 YouTube videos, rounded to an integer."
                  minimum: 0
                  examples:
                    - 100
                median:
                  type: integer
                  description: "Median number of views across the last 800 YouTube videos."
                  minimum: 0
                  examples:
                    - 48
                min:
                  type: integer
                  description: "Minimum number of views across the last 800 YouTube videos."
                  minimum: 0
                  examples:
                    - 20
                max:
                  type: integer
                  description: "Maximum number of views across the last 800 YouTube videos."
                  minimum: 0
                  examples:
                    - 149
                percentile25:
                  type: integer
                  description: "The 25th percentile (first quartile) of views across the last 800 YouTube videos."
                  minimum: 0
                  examples:
                    - 35
                percentile75:
                  type: integer
                  description: "The 75th percentile (third quartile) of views across the last 800 YouTube videos."
                  minimum: 0
                  examples:
                    - 85
                iqr:
                  type: integer
                  description: "Interquartile range (IQR) of views, calculated as 25th to 75th percentile, representing the spread of the middle 50%."
                  minimum: 0
                  examples:
                    - 50
              required:
                - all
                - avg
                - median
                - min
                - max
                - percentile25
                - percentile75
                - iqr
            length:
              type: object
              description: "Video length statistics for the last 800 YouTube videos."
              properties:
                avg:
                  type: integer
                  description: "Average video length in seconds, rounded to an integer."
                  minimum: 0
                  examples:
                    - 180
              required:
                - avg
            engagement:
              type: object
              description: "Engagement metrics for the last 800 YouTube videos."
              properties:
                avgEngagementRate:
                  type: number
                  description: |-
                    Average engagement rate per video, rounded to 4th decimal place. <br /> 
                    - *Engagement Rate = (Likes + Comments)/ Views*
                  minimum: 0
                  examples:
                    - 0.5201
                likesPerSubscriber:
                  type: number
                  description: "Average likes per subscriber for the last 800 YouTube videos, rounded to 4th decimal place."
                  minimum: 0
                  examples:
                    - 0.1111
                commentsPerSubscriber:
                  type: number
                  description: "Average comments per subscriber for the last 800 YouTube videos, rounded to 4th decimal place."
                  minimum: 0
                  examples:
                    - 0.1111
                viewsPerSubscriber:
                  type: number
                  description: "Average views per subscriber for the last 800 YouTube videos, rounded to 4th decimal place."
                  minimum: 0
                  examples:
                    - 0.1111
                engagementConsistency:
                  type: object
                  description: "Consistency of engagement performance across the last 800 YouTube videos."
                  properties:
                    cv:
                      type: number
                      description: |-
                        *cv &#61; Standard Deviation of Engagement Rate/Mean Engagement Rate* <br />
                        - The value is rounded to 4th decimal place. <br />
                        - Lower values indicate more consistent performance. <br />
                        - *A value of `0` indicates insufficient data.*
                      minimum: 0
                      examples:
                        - 0.1001
                    medianVsMean:
                      type: number
                      description: |-
                        *medianVsMean &#61; Median Engagement Rate/ Mean Engagement Rate* <br />
                        - The value is rounded to 4th decimal place. <br />
                        - Values closer to `1` indicate more consistent performance. <br />
                        - *A value of `0` indicates insufficient data.*
                      minimum: 0
                      examples:
                        - 0.9001
                    topBottomRatio:
                      type: number
                      description: |-
                        *topBottomRatio &#61; avg(Top 3 Engagement)/avg(Bottom 3 Engagement)* <br />
                        - The value is rounded to 4th decimal place. <br />
                        - Lower ratios indicate more consistent performance. <br />
                        - *A value of `0` indicates insufficient data.*
                      minimum: 0
                      examples:
                        - 1.2001
                    consistencyScore:
                      type:
                        - integer
                        - "null"
                      description: |-
                        *consistencyScore &#61; 100 - [(cvScore\*weight_cv) + (topBottomScore\*weight_topBottom) + (medianVsMeanScore\*weight_medianVsMean)]* <br />
                        - The score is rounded to an integer. <br />
                        - A higher score indicates more stable and consistent performance. <br />
                        - If any of the three indicators is `0`, the `consistencyScore` will be `null`.
                      minimum: 0
                      maximum: 100
                      examples:
                        - 63
                    consistencyLevel:
                      type:
                        - string
                        - "null"
                      enum:
                        - high
                        - moderate
                        - low
                        - null
                      description: |-
                        A qualitative label based on the `consistencyScore`: <br />
                        - high: 81 - 100 <br />
                        - moderate: 51 - 80 <br />
                        - low: 0 - 50 <br />
                        - Returns `null` when `consistencyScore` is `null`.
                      examples:
                        - moderate
                  required:
                    - cv
                    - medianVsMean
                    - topBottomRatio
                    - consistencyScore
                    - consistencyLevel
              required:
                - avgEngagementRate
                - likesPerSubscriber
                - commentsPerSubscriber
                - viewsPerSubscriber
                - engagementConsistency
          required:
            - likes
            - comments
            - views
            - length
            - engagement
        shortsPerformanceAll:
          type: object
          description: "Performance metrics for the last 800 YouTube shorts."
          properties:
            likes:
              type: object
              description: "Likes statistics for the last 800 YouTube shorts."
              properties:
                all:
                  type: integer
                  description: "Total number of likes across the last 800 YouTube shorts."
                  minimum: 0
                  examples:
                    - 2459
                avg:
                  type: integer
                  description: "Average likes per short, for the last 800 YouTube shorts, rounded to an integer."
                  minimum: 0
                  examples:
                    - 100
                median:
                  type: integer
                  description: "Median number of likes across the last 800 YouTube shorts."
                  minimum: 0
                  examples:
                    - 120
                min:
                  type: integer
                  description: "Minimum number of likes across the last 800 YouTube shorts."
                  minimum: 0
                  examples:
                    - 50
                max:
                  type: integer
                  description: "Maximum number of likes across the last 800 YouTube shorts."
                  minimum: 0
                  examples:
                    - 988
              required:
                - all
                - avg
                - median
                - min
                - max
            comments:
              type: object
              description: "Comments statistics for the last 800 YouTube shorts."
              properties:
                all:
                  type: integer
                  description: "Total number of comments across the last 800 YouTube shorts."
                  minimum: 0
                  examples:
                    - 2459
                avg:
                  type: integer
                  description: "Average comments per short for the last 800 YouTube shorts, rounded to an integer."
                  minimum: 0
                  examples:
                    - 100
                median:
                  type: integer
                  description: "Median number of comments across the last 800 YouTube shorts."
                  minimum: 0
                  examples:
                    - 120
                min:
                  type: integer
                  description: "Minimum number of comments across the last 800 YouTube shorts."
                  minimum: 0
                  examples:
                    - 50
                max:
                  type: integer
                  description: "Maximum number of comments across the last 800 YouTube shorts."
                  minimum: 0
                  examples:
                    - 988
              required:
                - all
                - avg
                - median
                - min
                - max
            views:
              type: object
              description: "Views statistics for the last 800 YouTube shorts."
              properties:
                all:
                  type: integer
                  description: "Total number of views across the last 800 YouTube shorts."
                  minimum: 0
                  examples:
                    - 2459
                avg:
                  type: integer
                  description: "Average views per short for the last 800 YouTube shorts, rounded to an integer."
                  minimum: 0
                  examples:
                    - 100
                median:
                  type: integer
                  description: "Median number of views across the last 800 YouTube shorts."
                  minimum: 0
                  examples:
                    - 120
                min:
                  type: integer
                  description: "Minimum number of views across the last 800 YouTube shorts."
                  minimum: 0
                  examples:
                    - 50
                max:
                  type: integer
                  description: "Maximum number of views across the last 800 YouTube shorts."
                  minimum: 0
                  examples:
                    - 988
                percentile25:
                  type: integer
                  description: "The 25th percentile (first quartile) of views across the last 800 YouTube shorts."
                  minimum: 0
                  examples:
                    - 80
                percentile75:
                  type: integer
                  description: "The 75th percentile (third quartile) of views across the last 800 YouTube shorts."
                  minimum: 0
                  examples:
                    - 250
                iqr:
                  type: integer
                  description: "Interquartile range (IQR) of views calculated as 25th to 75th percentile, representing the spread of the middle 50%."
                  minimum: 0
                  examples:
                    - 170
              required:
                - all
                - avg
                - median
                - min
                - max
                - percentile25
                - percentile75
                - iqr
            length:
              type: object
              description: "Length statistics for the last 800 YouTube shorts."
              properties:
                avg:
                  type: integer
                  description: "Average shorts length in seconds, rounded to an integer."
                  minimum: 0
                  examples:
                    - 180
              required:
                - avg
            engagement:
              type: object
              description: "Engagement metrics for the last 800 YouTube shorts."
              properties:
                avgEngagementRate:
                  type: number
                  description: |-
                    The average engagement rate per YouTube short, rounded to 4th decimal place. <br />
                    - *Engagement Rate = (Likes + Comments)/Views*.
                  minimum: 0
                  examples:
                    - 0.5201
                likesPerSubscriber:
                  type: number
                  description: "Average likes per subscriber for the last 800 YouTube shorts, rounded to 4th decimal place."
                  minimum: 0
                  examples:
                    - 0.1111
                commentsPerSubscriber:
                  type: number
                  description: "Average comments per subscriber for the last 800 YouTube shorts, rounded to 4th decimal place."
                  minimum: 0
                  examples:
                    - 0.1111
                viewsPerSubscriber:
                  type: number
                  description: "Average views per subscriber for the last 800 YouTube shorts, rounded to 4th decimal place."
                  minimum: 0
                  examples:
                    - 0.1111
                engagementConsistency:
                  type: object
                  description: "Consistency of engagement performance across the last 800 YouTube shorts."
                  properties:
                    cv:
                      type: number
                      description: |-
                        *cv &#61; Standard Deviation of Engagement Rate/Mean Engagement Rate* <br />
                        - The value is rounded to 4th decimal place. <br />
                        - Lower values indicate more consistent performance. <br />
                        - *A value of `0` indicates insufficient data.*
                      minimum: 0
                      examples:
                        - 0.1001
                    medianVsMean:
                      type: number
                      description: |-
                        *medianVsMean &#61; Median Engagement Rate/ Mean Engagement Rate* <br />
                        - The value is rounded to 4th decimal place. <br />
                        - Values closer to `1` indicate more consistent performance. <br />
                        - *A value of `0` indicates insufficient data.*
                      minimum: 0
                      examples:
                        - 0.9001
                    topBottomRatio:
                      type: number
                      description: |-
                        *topBottomRatio &#61; avg(Top 3 Engagement)/avg(Bottom 3 Engagement)* <br />
                        - The value is rounded to 4th decimal place. <br />
                        - Lower ratios indicate more consistent performance. <br />
                        - *A value of `0` indicates insufficient data.*
                      minimum: 0
                      examples:
                        - 1.2001
                    consistencyScore:
                      type:
                        - integer
                        - "null"
                      description: |-
                        *consistencyScore &#61; 100 - [(cvScore\*weight_cv) + (topBottomScore\*weight_topBottom) + (medianVsMeanScore\*weight_medianVsMean)]* <br />
                        -  The score is rounded to an integer. <br />
                        -  A higher score indicates more stable and consistent performance. <br />
                        - If any of the three indicators is `0`, the `consistencyScore` will be `null`.
                      minimum: 0
                      maximum: 100
                      examples:
                        - 63
                    consistencyLevel:
                      type:
                        - string
                        - "null"
                      enum:
                        - high
                        - moderate
                        - low
                        - null
                      description: |-
                        A qualitative label based on the `consistencyScore`: <br />
                        - high: 81 - 100 <br />
                        - moderate: 51 - 80 <br />
                        - low: 0 - 50 <br />
                        * Returns `null` when `consistencyScore` is `null`.
                      examples:
                        - moderate
                  required:
                    - cv
                    - medianVsMean
                    - topBottomRatio
                    - consistencyScore
                    - consistencyLevel
              required:
                - avgEngagementRate
                - likesPerSubscriber
                - commentsPerSubscriber
                - viewsPerSubscriber
                - engagementConsistency
          required:
            - likes
            - comments
            - views
            - length
            - engagement
        recentVideosGrowth:
          type: object
          description: "Growth metrics for recent YouTube videos across 7, 30, and 90-day periods."
          properties:
            g7:
              type: object
              description: "Growth metrics over 7 days."
              properties:
                avgViews:
                  type: number
                  description: "Growth rate of average views, rounded to 4th decimal place."
                  examples:
                    - 0.2345
                engagementRate:
                  type: number
                  description: "Growth rate of engagement rate, rounded to 4th decimal place."
                  examples:
                    - 0.0567
              required:
                - avgViews
                - engagementRate
            g30:
              type: object
              description: "Growth metrics over 30 days."
              properties:
                avgViews:
                  type: number
                  description: "The growth rate of average views, rounded to 4th decimal place."
                  examples:
                    - 0.2345
                engagementRate:
                  type: number
                  description: "Growth rate of engagement rate, rounded to 4th decimal place."
                  examples:
                    - 0.0567
              required:
                - avgViews
                - engagementRate
            g90:
              type: object
              description: "Growth metrics over 90 days."
              properties:
                avgViews:
                  type: number
                  description: "Growth rate of average views, rounded to 4th decimal place."
                  examples:
                    - 0.2345
                engagementRate:
                  type: number
                  description: "Growth rate of engagement rate, rounded to 4th decimal place."
                  examples:
                    - 0.0567
              required:
                - avgViews
                - engagementRate
          required:
            - g7
            - g30
            - g90
        recentShortsGrowth:
          type: object
          description: "Growth metrics for recent shorts across 7, 30, and 90-day periods."
          properties:
            g7:
              type: object
              description: "Growth metrics over 7 days."
              properties:
                avgViews:
                  type: number
                  description: "Growth rate of average views, rounded to 4th decimal place."
                  examples:
                    - 0.2345
                engagementRate:
                  type: number
                  description: "Growth rate of engagement rate, rounded to 4th decimal place."
                  examples:
                    - 0.0567
              required:
                - avgViews
                - engagementRate
            g30:
              type: object
              description: "Growth metrics over 30 days."
              properties:
                avgViews:
                  type: number
                  description: "Growth rate of average views, rounded to 4th decimal place."
                  examples:
                    - 0.2345
                engagementRate:
                  type: number
                  description: "Growth rate of engagement rate, rounded to 4th decimal place."
                  examples:
                    - 0.0567
              required:
                - avgViews
                - engagementRate
            g90:
              type: object
              description: "Growth metrics over 90 days."
              properties:
                avgViews:
                  type: number
                  description: "Growth rate of average views, rounded to 4th decimal place."
                  examples:
                    - 0.2345
                engagementRate:
                  type: number
                  description: "Growth rate of engagement rate, rounded to 4th decimal place."
                  examples:
                    - 0.0567
              required:
                - avgViews
                - engagementRate
          required:
            - g7
            - g30
            - g90
        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
    YoutubeAudienceData:
      type: object
      description: "Returned audience demographic data of the YouTube channel."
      properties:
        audienceLocations:
          type:
            - array
            - "null"
          description: "Country locations of the audience, sorted by descending share."
          examples:
            - - country: USA
                share: 0.5511
              - country: GBR
                share: 0.1313
              - country: CAN
                share: 0.0501
          items:
            type: object
            description: "Country distribution of the audience."
            properties:
              country:
                type: string
                description: "The country in **ISO 3166-1 alpha-3** format. For details, see [Country Codes](http://docs.creatordb.app/api-v3/country-code)."
                examples:
                  - USA
              share:
                type: number
                description: "Proportion of audience from that country, rounded to 4th decimal place."
                examples:
                  - 0.5511
            required:
              - country
              - share
        audienceGender:
          type:
            - object
            - "null"
          description: "Gender distribution of the audience."
          properties:
            maleRatio:
              type: number
              description: "Proportion of male audience, rounded to 4th decimal place."
              examples:
                - 0.5233
            femaleRatio:
              type: number
              description: "Proportion of female audience, rounded to 4th decimal place."
              examples:
                - 0.4412
          required:
            - maleRatio
            - femaleRatio
          examples:
            - maleRatio: 0.5233
              femaleRatio: 0.4412
        audienceAvgAge:
          type:
            - integer
            - "null"
          description: "Average age of the audience, rounded to an integer."
          examples:
            - 30
        audienceAgeBreakdown:
          type:
            - array
            - "null"
          description: "Distribution of the audience by age range."
          examples:
            - - ageRange: 13-17
                share: 0.0123
              - ageRange: 18-24
                share: 0.1871
              - ageRange: 25-34
                share: 0.2818
              - ageRange: 35-44
                share: 0.2025
              - ageRange: 45-54
                share: 0.1398
              - ageRange: 55-64
                share: 0.1
              - ageRange: 65+
                share: 0.0765
          items:
            type: object
            description: "Age range distribution of the audience."
            properties:
              ageRange:
                type: string
                enum:
                  - 13-17
                  - 18-24
                  - 25-34
                  - 35-44
                  - 45-54
                  - 55-64
                  - 65+
                description: "Age group. <br /> Accepted values: `13-17`, `18-24`, `25-34`, `35-44`, `45-54`, `55-64`, `65+`"
                examples:
                  - 25-34
              share:
                type: number
                description: "Percentage of audience in a specific age group, rounded to 4th decimal place."
                examples:
                  - 0.0123
            required:
              - ageRange
              - share
    YoutubeContactData:
      type: object
      description: "Contact information."
      properties:
        emails:
          type: array
          description: "Associated email addresses. Empty if unavailable."
          examples:
            - - example@email.com
          items:
            type: string
            format: email
      examples:
        - emails:
            - example@email.com
    YoutubeContentDetailData:
      type: object
      description: "Retrieved YouTube content details of a specified creator."
      properties:
        recentVideos:
          type: array
          description: "Data of recent YouTube videos."
          items:
            type: object
            description: "Recent YouTube video information."
            properties:
              publishTime:
                type: integer
                description: "Publish time, represented as a Unix timestamp in milliseconds."
                examples:
                  - 1755273600000
              contentId:
                type: string
                description: "The unique identifier. Represented as follows: `https://www.youtube.com/watch?v={contentId}`"
                examples:
                  - FbCF_H4ZD64
              title:
                type: string
                description: "The video title."
                examples:
                  - I hosted an ADMIN ABUSE on GROW A GARDEN
              description:
                type: string
                description: "The video description, including emojis, mentions, URLs, and line breaks."
                examples:
                  - Thanks @JandelTheGuy play grow a garden here support a small developer like Jandel. Today I hosted an admin abuse to 20 million people
              length:
                type: integer
                description: "Video length in seconds."
                examples:
                  - 873
              isSponsored:
                type: boolean
                description: "`true` if sponsored."
                examples:
                  - true
              isMemberOnly:
                type: boolean
                description: "`true` if member-only."
                examples:
                  - false
              likes:
                type: integer
                description: "Number of likes."
                examples:
                  - 153000
              comments:
                type: integer
                description: "Number of comments."
                examples:
                  - 15182
              views:
                type: integer
                description: "Number of views."
                examples:
                  - 5009695
              engagementRate:
                type: number
                description: "Engagement rate, rounded to 4th decimal place. <br /> *Engagement Rate &#61; (Likes + Comments) / Views*"
                examples:
                  - 0.0336
              hashtags:
                type: array
                description: "Keywords in the video description."
                examples:
                  - - "#VLOG"
                items:
                  type: string
            required:
              - publishTime
              - contentId
              - title
              - description
              - length
              - isSponsored
              - isMemberOnly
              - likes
              - comments
              - views
              - engagementRate
              - hashtags
        recentShorts:
          type: array
          description: "Data of recent YouTube shorts."
          items:
            type: object
            description: "Recent YouTube short information."
            properties:
              publishTime:
                type: integer
                description: "Publish time, represented as a Unix timestamp in milliseconds."
                examples:
                  - 1754928000000
              contentId:
                type: string
                description: "The unique identifier. Represented as follows: `https://www.youtube.com/shorts/{contentId}`"
                examples:
                  - 6tlVsknqy9M
              title:
                type: string
                description: "The shorts title."
                examples:
                  - "Customized skin care clinics available in Japan #cosmeticmedicine"
              description:
                type: string
                description: "The shorts description, including emojis, mentions, URLs, and line breaks."
                examples:
                  - Recommended for those looking for skin care in Tokyo. Shimokitazawa Cosmetic Dermatology Clinic @oneup_clinic
              length:
                type: integer
                description: "Shorts length in seconds."
                examples:
                  - 60
              likes:
                type: integer
                description: "Number of likes."
                examples:
                  - 10000
              comments:
                type: integer
                description: "Number of comments."
                examples:
                  - 100
              views:
                type: integer
                description: "Number of views."
                examples:
                  - 15000
              engagementRate:
                type: number
                description: "Engagement rate, rounded to 4th decimal place <br /> *Engagement Rate &#61; (Likes + Comments) / Views*"
                examples:
                  - 0.0517
              hashtags:
                type: array
                description: "Keywords in the shorts description."
                examples:
                  - - "#cosmeticmedicine"
                items:
                  type: string
            required:
              - publishTime
              - contentId
              - title
              - description
              - length
              - likes
              - comments
              - views
              - engagementRate
              - hashtags
    YoutubeSponsorshipData:
      type: object
      description: "Retrieve data of recently sponsored YouTube videos for a specified creator."
      properties:
        sponsorList:
          type: array
          description: "List of sponsors and their associated branded content."
          items:
            type: object
            description: "A sponsor's branded videos and aggregated performance metrics."
            properties:
              brandName:
                type: string
                description: "The sponsor name."
                examples:
                  - Acer
              brandId:
                type: string
                description: "The official website URL or unique identifier of the sponsor."
                examples:
                  - acer.com
              brandIgIds:
                type: array
                description: "The Instagram handles of the sponsor."
                examples:
                  - - acer
                items:
                  type: string
              sponsoredVideos:
                type: array
                description: "Recent sponsored YouTube videos data."
                items:
                  type: object
                  description: "A recent sponsored YouTube video."
                  properties:
                    publishTime:
                      type: integer
                      description: "Publish time, represented as a Unix timestamp in milliseconds."
                      examples:
                        - 1754797869000
                    contentId:
                      type: string
                      description: "The unique identifier. Represented as follows: `https://www.youtube.com/watch?v={contentId}`"
                      examples:
                        - eHnzGYHEdO0
                    title:
                      type: string
                      description: "The sponsored video title."
                      examples:
                        - ROBLOX OP ADMIN IN STEAL A BRAINROT
                    description:
                      type: string
                      description: "The sponsored video description, including emojis, mentions, URLs, and line breaks."
                      examples:
                        - Roblox admin in steal a brainrot except way more OP. i gave almost everyone their stuff back its just fun to make these kids laugh in voice chat lol
                    length:
                      type: integer
                      description: "Video length in seconds."
                      examples:
                        - 873
                    isSponsored:
                      type: boolean
                      description: "`true` if sponsored."
                      examples:
                        - true
                    isMemberOnly:
                      type: boolean
                      description: "`true` if member-only."
                      examples:
                        - false
                    likes:
                      type: integer
                      description: "Number of likes."
                      examples:
                        - 10000
                    comments:
                      type: integer
                      description: "Number of comments."
                      examples:
                        - 100
                    views:
                      type: integer
                      description: "Number of views."
                      examples:
                        - 15000
                    engagementRate:
                      type: number
                      description: "Engagement rate, rounded to 4th decimal place. <br /> *Engagement Rate &#61; (Likes + Comments) / Views*"
                      examples:
                        - 0.1202
                    hashtags:
                      type: array
                      description: "Keywords used in the video description."
                      examples:
                        - - "#VLOG"
                      items:
                        type: string
                  required:
                    - publishTime
                    - contentId
                    - title
                    - description
                    - length
                    - isSponsored
                    - isMemberOnly
                    - likes
                    - comments
                    - views
                    - engagementRate
                    - hashtags
              sponsoredVideosPerformance:
                type: object
                description: "Aggregated performance metrics for sponsored YouTube videos broken down by brands."
                properties:
                  likes:
                    type: object
                    description: "Likes statistics for sponsored YouTube videos broken down by brands."
                    properties:
                      all:
                        type: integer
                        description: "Total number of likes across the last 20 sponsored YouTube videos."
                        minimum: 0
                        examples:
                          - 2944445
                      avg:
                        type: integer
                        description: "Average likes per video for the last 20 sponsored YouTube videos, rounded to an integer."
                        minimum: 0
                        examples:
                          - 100
                      median:
                        type: integer
                        description: "Median number of likes across the last 20 sponsored YouTube videos."
                        minimum: 0
                        examples:
                          - 48
                      min:
                        type: integer
                        description: "Minimum number of likes across the last 20 sponsored YouTube videos."
                        minimum: 0
                        examples:
                          - 20
                      max:
                        type: integer
                        description: "Maximum number of likes across the last 20 sponsored YouTube videos."
                        minimum: 0
                        examples:
                          - 149
                    required:
                      - all
                      - avg
                      - median
                      - min
                      - max
                  comments:
                    type: object
                    description: "Comments statistics for sponsored YouTube videos broken down by brands."
                    properties:
                      all:
                        type: integer
                        description: "Total number of comments across the last 20 sponsored YouTube videos."
                        minimum: 0
                        examples:
                          - 2944445
                      avg:
                        type: integer
                        description: "Average comments per video for the last 20 sponsored YouTube videos, rounded to an integer."
                        minimum: 0
                        examples:
                          - 100
                      median:
                        type: integer
                        description: "Median number of comments across the last 20 sponsored YouTube videos."
                        minimum: 0
                        examples:
                          - 48
                      min:
                        type: integer
                        description: "Minimum number of comments across the last 20 sponsored YouTube videos."
                        minimum: 0
                        examples:
                          - 20
                      max:
                        type: integer
                        description: "Maximum number of comments across the last 20 sponsored YouTube videos."
                        minimum: 0
                        examples:
                          - 149
                    required:
                      - all
                      - avg
                      - median
                      - min
                      - max
                  views:
                    type: object
                    description: "View statistics for sponsored YouTube videos broken down by brands."
                    properties:
                      all:
                        type: integer
                        description: "Total number of views across the last 20 sponsored YouTube videos."
                        minimum: 0
                        examples:
                          - 3599
                      avg:
                        type: integer
                        description: "Average views per video for the last 20 sponsored YouTube videos, rounded to an integer."
                        minimum: 0
                        examples:
                          - 100
                      median:
                        type: integer
                        description: "Median number of views across the last 20 sponsored YouTube videos."
                        minimum: 0
                        examples:
                          - 48
                      min:
                        type: integer
                        description: "Minimum number of views across the last 20 sponsored YouTube videos."
                        minimum: 0
                        examples:
                          - 20
                      max:
                        type: integer
                        description: "Maximum number of views across the last 20 sponsored YouTube videos."
                        minimum: 0
                        examples:
                          - 149
                      percentile25:
                        type: integer
                        description: "The 25th percentile (first quartile) of views across the last 20 sponsored YouTube videos."
                        minimum: 0
                        examples:
                          - 35
                      percentile75:
                        type: integer
                        description: "The 75th percentile (third quartile) of views across the last 20 sponsored YouTube videos."
                        minimum: 0
                        examples:
                          - 85
                      iqr:
                        type: integer
                        description: "Interquartile range (IQR) of views, calculated as 25th to 75th percentile, representing the spread of the middle 50%."
                        minimum: 0
                        examples:
                          - 50
                    required:
                      - all
                      - avg
                      - median
                      - min
                      - max
                      - percentile25
                      - percentile75
                      - iqr
                  length:
                    type: object
                    description: "Length statistics for sponsored YouTube videos broken down by brands."
                    properties:
                      avg:
                        type: integer
                        description: "The average sponsored video length in seconds, rounded to an integer."
                        minimum: 0
                        examples:
                          - 180
                    required:
                      - avg
                  engagement:
                    type: object
                    description: "Engagement performance metrics for sponsored YouTube videos broken down by brands."
                    properties:
                      avgEngagementRate:
                        type: number
                        description: "Average engagement rate per sponsored video, rounded to 4th decimal place. <br /> 
                          - *Engagement Rate &#61; (Likes + Comments)/ Views*"
                        minimum: 0
                        examples:
                          - 0.5201
                      likesPerSubscriber:
                        type: number
                        description: "Average number of likes per subscriber for sponsored videos, rounded to 4th decimal place."
                        minimum: 0
                        examples:
                          - 0.1111
                      commentsPerSubscriber:
                        type: number
                        description: "Average number of comments per subscriber for sponsored videos, rounded to 4th decimal place."
                        minimum: 0
                        examples:
                          - 0.1111
                      viewsPerSubscriber:
                        type: number
                        description: "Average number of views per subscriber for sponsored videos, rounded to 4th decimal place."
                        minimum: 0
                        examples:
                          - 0.1111
                      engagementConsistency:
                        type: object
                        description: "Consistency of engagement performance across sponsored videos broken down by brands."
                        properties:
                          cv:
                            type: number
                            description: |-
                              *cv &#61; Standard Deviation of Engagement Rate/ Mean Engagement Rate* <br />
                              - The value is rounded to 4th decimal place. <br />
                              - Lower values indicate more consistent performance. <br />
                              - *A value of `0` indicates insufficient data.*
                            minimum: 0
                            examples:
                              - 0.1001
                          medianVsMean:
                            type: number
                            description: |-
                              *medianVsMean &#61; Median Engagement Rate/ Mean Engagement Rate* <br />
                              - The value is rounded to 4th decimal place. <br />
                              - Values closer to `1` indicate more consistent performance. <br />
                              - *A value of `0` indicates insufficient data.*
                            minimum: 0
                            examples:
                              - 0.9001
                          topBottomRatio:
                            type: number
                            description: |-
                              *topBottomRatio &#61; avg(Top 3 Engagement)/avg(Bottom 3 Engagement)* <br />
                              - The value is rounded to 4th decimal place. <br />
                              - Lower ratios indicate more consistent performance. <br />
                              - *A value of `0` indicates insufficient data.*
                            minimum: 0
                            examples:
                              - 1.2001
                          consistencyScore:
                            type:
                              - integer
                              - "null"
                            description: |-
                              *consistencyScore &#61; 100 - [(cvScore\*weight_cv) + (topBottomScore\*weight_topBottom) + (medianVsMeanScore\*weight_medianVsMean)]* <br />
                              - The score is rounded to an integer. <br />
                              - A higher score indicates more stable and consistent performance. <br />
                              - If any of the three indicators is `0`, the `consistencyScore` will be `null`.
                            minimum: 0
                            maximum: 100
                            examples:
                              - 63
                          consistencyLevel:
                            type:
                              - string
                              - "null"
                            enum:
                              - high
                              - moderate
                              - low
                              - null
                            description: |-
                              A qualitative label based on the `consistencyScore`: <br />
                              - high: 81 - 100 <br />
                              - moderate: 51 - 80 <br />
                              - low: 0 - 50 <br />
                              - Returns `null` when `consistencyScore` is `null`.
                            examples:
                              - moderate
                        required:
                          - cv
                          - medianVsMean
                          - topBottomRatio
                          - consistencyScore
                          - consistencyLevel
                    required:
                      - avgEngagementRate
                      - likesPerSubscriber
                      - commentsPerSubscriber
                      - viewsPerSubscriber
                      - engagementConsistency
                required:
                  - likes
                  - comments
                  - views
                  - length
                  - engagement
            required:
              - brandName
              - brandId
              - brandIgIds
              - sponsoredVideos
              - sponsoredVideosPerformance
    YoutubePerformanceHistoryData:
      type: object
      description: "The YouTube performance historical data."
      properties:
        histories:
          type: array
          description: "Historical performance snapshots, each containing metrics and a corresponding Unix timestamp in milliseconds."
          items:
            type: object
            description: "A single historical performance snapshot containing metrics and a corresponding Unix timestamp in milliseconds."
            properties:
              timestamp:
                type: integer
                description: "The performance snapshot date, represented as a Unix timestamp in milliseconds."
                minimum: 0
                examples:
                  - 1750732453635
              totalSubscribers:
                type: integer
                description: "Total number of subscribers."
                minimum: 0
                examples:
                  - 13900000
              totalContents:
                type: integer
                description: "Total number of videos and shorts."
                minimum: 0
                examples:
                  - 399
              videosPerformanceAll:
                type: object
                description: "Performance metrics for the last 800 YouTube videos."
                properties:
                  likes:
                    type: object
                    description: "Likes statistics for the last 800 YouTube videos."
                    properties:
                      all:
                        type: integer
                        description: "Total number of likes across the last 800 YouTube videos."
                        minimum: 0
                        examples:
                          - 2944445
                      avg:
                        type: integer
                        description: "Average likes per video for up to the last 800 videos, rounded to an integer."
                        minimum: 0
                        examples:
                          - 100
                      median:
                        type: integer
                        description: "Median number of likes across the last 800 videos."
                        minimum: 0
                        examples:
                          - 48
                      min:
                        type: integer
                        description: "Minimum number of likes across the last 800 videos."
                        minimum: 0
                        examples:
                          - 20
                      max:
                        type: integer
                        description: "Maximum number of likes across the last 800 videos."
                        minimum: 0
                        examples:
                          - 149
                    required:
                      - all
                      - avg
                      - median
                      - min
                      - max
                  comments:
                    type: object
                    description: "Comments statistics for the last 800 YouTube videos."
                    properties:
                      all:
                        type: integer
                        description: "Total number of comments across the last 800 videos."
                        minimum: 0
                        examples:
                          - 2944445
                      avg:
                        type: integer
                        description: "Average comments per video for the last 800 videos, rounded to an integer."
                        minimum: 0
                        examples:
                          - 100
                      median:
                        type: integer
                        description: "Median number of comments across the last 800 videos."
                        minimum: 0
                        examples:
                          - 48
                      min:
                        type: integer
                        description: "Minimum number of comments across the last 800 YouTube videos."
                        minimum: 0
                        examples:
                          - 20
                      max:
                        type: integer
                        description: "Maximum number of comments across the last 800 YouTube videos."
                        minimum: 0
                        examples:
                          - 149
                    required:
                      - all
                      - avg
                      - median
                      - min
                      - max
                  views:
                    type: object
                    description: "Views statistics for the last 800 YouTube videos."
                    properties:
                      all:
                        type: integer
                        description: "Total number of views across the last 800 videos."
                        minimum: 0
                        examples:
                          - 3599
                      avg:
                        type: integer
                        description: "Average views per video for the last 800 videos, rounded to an integer."
                        minimum: 0
                        examples:
                          - 100
                      median:
                        type: integer
                        description: "Median number of views across the last 800 videos."
                        minimum: 0
                        examples:
                          - 48
                      min:
                        type: integer
                        description: "Minimum number of views across the last 800 videos."
                        minimum: 0
                        examples:
                          - 20
                      max:
                        type: integer
                        description: "Maximum number of views across the last 800 videos."
                        minimum: 0
                        examples:
                          - 149
                      percentile25:
                        type: integer
                        description: "The 25th percentile (first quartile) of views across the last 800 videos."
                        minimum: 0
                        examples:
                          - 35
                      percentile75:
                        type: integer
                        description: "The 75th percentile (third quartile) of views across the last 800 videos."
                        minimum: 0
                        examples:
                          - 85
                      iqr:
                        type: integer
                        description: "Interquartile range (IQR) of views, calculated as 25th to 75th percentile, representing the spread of the middle 50%."
                        minimum: 0
                        examples:
                          - 50
                    required:
                      - all
                      - avg
                      - median
                      - min
                      - max
                      - percentile25
                      - percentile75
                      - iqr
                  length:
                    type: object
                    description: "Length statistics for the last 800 YouTube videos."
                    properties:
                      avg:
                        type: integer
                        description: "Average video length in seconds, rounded to an integer."
                        minimum: 0
                        examples:
                          - 180
                    required:
                      - avg
                  engagement:
                    type: object
                    description: "Engagement metrics for the last 800 videos."
                    properties:
                      avgEngagementRate:
                        type: number
                        description: |-
                          Average engagement rate per video, rounded to 4th decimal place <br />
                          - *Engagement Rate = (Likes + Comments)/Views*.
                        minimum: 0
                        examples:
                          - 0.5201
                      likesPerSubscriber:
                        type: number
                        description: "Average likes per subscriber for the last 800 videos, rounded to 4th decimal place."
                        minimum: 0
                        examples:
                          - 0.1111
                      commentsPerSubscriber:
                        type: number
                        description: "Average comments per subscriber for the last 800 videos, rounded to 4th decimal place."
                        minimum: 0
                        examples:
                          - 0.1111
                      viewsPerSubscriber:
                        type: number
                        description: "Average views per subscriber for the last 800 videos, rounded to 4th decimal place."
                        minimum: 0
                        examples:
                          - 0.1111
                      engagementConsistency:
                        type: object
                        description: "Consistency of engagement performance across the last 800 videos."
                        properties:
                          cv:
                            type: number
                            description: |-
                              *cv &#61; Standard Deviation of Engagement Rate/Mean Engagement Rate* <br />
                              - The value is rounded to 4th decimal place. <br />
                              - Lower values indicate more consistent performance. <br />
                              - *A value of `0` indicates insufficient data.*
                            minimum: 0
                            examples:
                              - 0.1001
                          medianVsMean:
                            type: number
                            description: |-
                               *medianVsMean &#61;  Median Engagement Rate/Mean Engagement Rate* <br />
                                - The value is rounded to 4th decimal place. <br />
                                - Values closer to `1` indicate more consistent performance. <br />
                                - *A value of `0` indicates insufficient data.*
                            minimum: 0
                            examples:
                              - 0.9001
                          topBottomRatio:
                            type: number
                            description: |-
                              *topBottomRatio &#61; avg(Top 3 Engagement)/avg(Bottom 3 Engagement)* <br />
                              - The value is rounded to 4th decimal place. <br />
                              - Lower ratios indicate more consistent performance. <br />
                              - *A value of `0` indicates insufficient data.*
                            minimum: 0
                            examples:
                              - 1.2001
                          consistencyScore:
                            type:
                              - integer
                              - "null"
                            description: |-
                              *consistencyScore &#61; 100 - [(cvScore\*weight_cv) + (topBottomScore\*weight_topBottom) + (medianVsMeanScore\*weight_medianVsMean)]* <br />
                              - The score is rounded to an integer. <br />
                              - A higher score indicates more stable and consistent performance. <br />
                              - If any of the three indicators is `0`, the `consistencyScore` will be `null`.
                            minimum: 0
                            maximum: 100
                            examples:
                              - 63
                          consistencyLevel:
                            type:
                              - string
                              - "null"
                            enum:
                              - high
                              - moderate
                              - low
                              - null
                            description: |-
                              A qualitative label based on the `consistencyScore`: <br />
                              - high: 81 - 100 <br />
                              - moderate: 51 - 80 <br />
                              - low: 0 - 50 <br />
                              - Returns `null` when `consistencyScore` is `null`.
                            examples:
                              - moderate
                        required:
                          - cv
                          - medianVsMean
                          - topBottomRatio
                          - consistencyScore
                          - consistencyLevel
                    required:
                      - avgEngagementRate
                      - likesPerSubscriber
                      - commentsPerSubscriber
                      - viewsPerSubscriber
                      - engagementConsistency
                required:
                  - likes
                  - comments
                  - views
                  - length
                  - engagement
              shortsPerformanceAll:
                type: object
                description: "Performance metrics for the last 800 YouTube shorts."
                properties:
                  likes:
                    type: object
                    description: "Likes statistics for the last 800 YouTube shorts."
                    properties:
                      all:
                        type: integer
                        description: "Total number of likes across the last 800 shorts."
                        minimum: 0
                        examples:
                          - 2459
                      avg:
                        type: integer
                        description: "Average likes per short for the last 800 shorts, rounded to an integer."
                        minimum: 0
                        examples:
                          - 100
                      median:
                        type: integer
                        description: "The median number of likes across the last 800 shorts."
                        minimum: 0
                        examples:
                          - 120
                      min:
                        type: integer
                        description: "The minimum number of likes across the last 800 shorts."
                        minimum: 0
                        examples:
                          - 50
                      max:
                        type: integer
                        description: "The maximum number of likes across the last 800 shorts."
                        minimum: 0
                        examples:
                          - 988
                    required:
                      - all
                      - avg
                      - median
                      - min
                      - max
                  comments:
                    type: object
                    description: "Comments statistics for the last 800 YouTube shorts."
                    properties:
                      all:
                        type: integer
                        description: "Total number of comments across the last 800 shorts."
                        minimum: 0
                        examples:
                          - 2459
                      avg:
                        type: integer
                        description: "Average comments per short for the last 800 shorts, rounded to an integer."
                        minimum: 0
                        examples:
                          - 100
                      median:
                        type: integer
                        description: "Median number of comments across the last 800 shorts."
                        minimum: 0
                        examples:
                          - 120
                      min:
                        type: integer
                        description: "Minimum number of comments across the last 800 shorts."
                        minimum: 0
                        examples:
                          - 50
                      max:
                        type: integer
                        description: "Maximum number of comments across the last 800 shorts."
                        minimum: 0
                        examples:
                          - 988
                    required:
                      - all
                      - avg
                      - median
                      - min
                      - max
                  views:
                    type: object
                    description: "Views statistics for the last 800 shorts."
                    properties:
                      all:
                        type: integer
                        description: "Total number of views across the last 800 shorts."
                        minimum: 0
                        examples:
                          - 2459
                      avg:
                        type: integer
                        description: "Average views per short for the last 800 shorts, rounded to an integer."
                        minimum: 0
                        examples:
                          - 100
                      median:
                        type: integer
                        description: "Median number of views across the last 800 shorts."
                        minimum: 0
                        examples:
                          - 120
                      min:
                        type: integer
                        description: "Minimum number of views across the last 800 shorts."
                        minimum: 0
                        examples:
                          - 50
                      max:
                        type: integer
                        description: "Maximum number of views across the last 800 shorts."
                        minimum: 0
                        examples:
                          - 988
                      percentile25:
                        type: integer
                        description: "The 25th percentile (first quartile) of views across the last 800 shorts."
                        minimum: 0
                        examples:
                          - 80
                      percentile75:
                        type: integer
                        description: "The 75th percentile (third quartile) of views across the last 800 shorts."
                        minimum: 0
                        examples:
                          - 250
                      iqr:
                        type: integer
                        description: "Interquartile range (IQR) of views, calculated as 25th to 75th percentile, representing the spread of the middle 50%."
                        minimum: 0
                        examples:
                          - 170
                    required:
                      - all
                      - avg
                      - median
                      - min
                      - max
                      - percentile25
                      - percentile75
                      - iqr
                  length:
                    type: object
                    description: "Length statistics for the last 800 YouTube shorts."
                    properties:
                      avg:
                        type: integer
                        description: "Average shorts length in seconds, rounded to an integer."
                        minimum: 0
                        examples:
                          - 180
                    required:
                      - avg
                  engagement:
                    type: object
                    description: "Engagement metrics for the last 800 shorts."
                    properties:
                      avgEngagementRate:
                        type: number
                        description: |-
                          Average engagement rate per short, rounded to 4th decimal place. <br />
                          - *Engagement Rate = (Likes + Comments)/ Views*.
                        minimum: 0
                        examples:
                          - 0.5201
                      likesPerSubscriber:
                        type: number
                        description: "Average likes per subscriber for the last 800 shorts, rounded to 4th decimal place." 
                        minimum: 0
                        examples:
                          - 0.1111
                      commentsPerSubscriber:
                        type: number
                        description: "Average comments per subscriber for the last 800 shorts, rounded to 4th decimal place."
                        minimum: 0
                        examples:
                          - 0.1111
                      viewsPerSubscriber:
                        type: number
                        description: "Average views per subscriber for the last 800 shorts, rounded to 4th decimal place."
                        minimum: 0
                        examples:
                          - 0.1111
                      engagementConsistency:
                        type: object
                        description: "Consistency of engagement performance across the last 800 shorts."
                        properties:
                          cv:
                            type: number
                            description: |-
                              *cv &#61; Standard Deviation of Engagement Rate/ Mean Engagement Rate* <br />
                              - The value is rounded to 4th decimal place. <br />
                              - Lower values indicate more consistent performance. <br />
                              - *A value of `0` indicates insufficient data.*
                            minimum: 0
                            examples:
                              - 0.1001
                          medianVsMean:
                            type: number
                            description: |-
                              *medianVsMean &#61; Median Engagement Rate/ Mean Engagement Rate* <br />
                              - The value is rounded to 4th decimal place. <br />
                              - Values closer to `1` indicate more consistent performance. <br />
                              - *A value of `0` indicates insufficient data.*
                            minimum: 0
                            examples:
                              - 0.9001
                          topBottomRatio:
                            type: number
                            description: |-
                              *topBottomRatio &#61; avg(Top 3 Engagement)/avg(Bottom 3 Engagement)* <br />
                              - The value is rounded to 4th decimal place <br />
                              - Lower ratios indicate more consistent performance <br />
                              - *A value of `0` indicates insufficient data.*
                            minimum: 0
                            examples:
                              - 1.2001
                          consistencyScore:
                            type:
                              - integer
                              - "null"
                            description: |-
                              *consistencyScore &#61; 100 - [(cvScore\*weight_cv) + (topBottomScore\*weight_topBottom) + (medianVsMeanScore\*weight_medianVsMean)]* <br />
                              - The score is rounded to an integer. <br />
                              - A higher score indicates more stable and consistent performance. <br />
                              - If any of the three indicators is `0`, the `consistencyScore` will be `null`.
                            minimum: 0
                            maximum: 100
                            examples:
                              - 63
                          consistencyLevel:
                            type:
                              - string
                              - "null"
                            enum:
                              - high
                              - moderate
                              - low
                              - null
                            description: |-
                              A qualitative label based on the `consistencyScore`: <br />
                              - high: 81 - 100 <br />
                              - moderate: 51 - 80 <br />
                              - low: 0 - 50 <br />
                              - Returns `null` when `consistencyScore` is `null`.
                            examples:
                              - moderate
                        required:
                          - cv
                          - medianVsMean
                          - topBottomRatio
                          - consistencyScore
                          - consistencyLevel
                    required:
                      - avgEngagementRate
                      - likesPerSubscriber
                      - commentsPerSubscriber
                      - viewsPerSubscriber
                      - engagementConsistency
                required:
                  - likes
                  - comments
                  - views
                  - length
                  - engagement
            required:
              - timestamp
              - totalSubscribers
              - totalContents
              - videosPerformanceAll
              - shortsPerformanceAll
      required:
        - histories
    InstagramProfileData:
      type: object
      description: "Profile information of the specified Instagram creator."
      properties:
        uniqueId:
          type: string
          description: "The Instagram handle."
          examples:
            - instagram
        displayName:
          type: string
          description: "The Instagram account name."
          examples:
            - Instagram
        category:
          type: string
          description: "The professional account category."
          examples:
            - Art
        avatarUrl:
          type: string
          description: "The profile picture URL."
          format: uri
          examples:
            - "https://instagram.ftpe8-4.fna.fbcdn.net/v/t51.2885-19/500169417_18514151086053040_2166230648120544979_n.jpg"
        bio:
          type: string
          description: "The profile biography."
          examples:
            - Capture and share the world's moments
        isBusinessAccount:
          type: boolean
          description: "`true` if it is a business account."
          examples:
            - false
        isPrivateAccount:
          type: boolean
          description: "`true` if it is a private account."
          examples:
            - false
        isVerified:
          type: boolean
          description: "`true` if it is verified by Instagram."
          examples:
            - true
        hasSponsors:
          type: boolean
          description: "`true` if there is sponsored content."
          examples:
            - true
        country:
          type: string
          description: "The creator's country, estimated by CreatorDB's location model. In **ISO 3166-1 alpha-3** format. For the country code list, see [here](https://docs.creatordb.app/api-v3/country-code)."
          examples:
            - TWN
        mainLanguage:
          type: string
          description: "The primary language used in posts, represented in **ISO 639-3** format. For the language code list, see [here](https://docs.creatordb.app/api-v3/language-code)."
          examples:
            - zht
        languages:
          type: array
          description: "All languages used in posts, represented in **ISO 639-3** format. For the 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 posts, 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 image posts and reels."
          minimum: 0
          examples:
            - 1609
        totalFollowers:
          type: integer
          description: "Total number of followers."
          minimum: 0
          examples:
            - 613344
        totalFollowing:
          type: integer
          description: "Total number of accounts followed."
          minimum: 0
          examples:
            - 1204
        subscriberGrowth:
          type: object
          description: "Follower growth metrics over 7, 30, and 90-day periods."
          properties:
            g7:
              type: number
              description: "Follower growth over 7 days, rounded to 4th decimal place."
              examples:
                - 0.1234
            g30:
              type: number
              description: "Follower growth over 30 days, rounded to 4th decimal place."
              examples:
                - 0.2345
            g90:
              type: number
              description: "Follower growth over 90 days, rounded to 4th decimal place."
              examples:
                - 0.3456
          required:
            - g7
            - g30
            - g90
        hashtags:
          type: array
          description: "Hashtags in Instagram content and usage statistics."
          items:
            type: object
            description: "Hashtag information and usage statistics."
            properties:
              name:
                type: string
                description: "Keywords used in post captions or descriptions."
                examples:
                  - "#doubleblackcrew"
              contentCount:
                type: integer
                description: "Number of posts using the hashtag."
                minimum: 0
                examples:
                  - 33
            required:
              - name
              - contentCount
        topics:
          type: array
          description: "Content topics assigned by CreatorDB's AI model, which classifies creators into about 490 themes based on their content. Topics are broader than `niches`. Can be an empty array. For all available topics, call `/instagram/topics`. IDs here can come without the `_instagram` ending (for example, `id_beauty_HowtoStyle`); the Instagram `topics` search filter accepts either form."
          examples:
            - - id_beauty_HowtoStyle
          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:
            - - india_All
              - newyear_All
              - thailand_All
          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:
                  - TikTok
              url:
                type: string
                description: "URL of the social media profile page."
                format: uri
                examples:
                  - "https://www.tiktok.com/@tiktok"
            required:
              - title
              - url
        lastPublishTime:
          type: integer
          description: "Time of the last uploaded content, represented as a Unix timestamp in milliseconds."
          examples:
            - 1753179002000
        relatedCreators:
          type: array
          description: "Accounts Instagram lists as related to this creator, returned as handles. CreatorDB returns them unchanged, in the order Instagram provides them."
          examples:
            - - tiktok
              - youtube
              - meta
          items:
            type: string
        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:
            - 1755309755899
    InstagramPerformanceData:
      type: object
      description: "The Instagram performance data."
      properties:
        contentCountByDays:
          type: object
          description: "Published Instagram posts over different time intervals."
          properties:
            7d:
              type: integer
              description: "Number of posts published in the past 7 days."
              minimum: 0
              examples:
                - 4
            30d:
              type: integer
              description: "Number of posts published in the past 30 days."
              minimum: 0
              examples:
                - 13
            90d:
              type: integer
              description: "Number of posts published in the past 90 days."
              minimum: 0
              examples:
                - 45
          required:
            - 7d
            - 30d
            - 90d
        ranking:
          type: object
          description: "Percentile rankings for various performance metrics, benchmarked at the global, country, or language level. A value of `1.0` indicates top 1%, while `0.5` represents the median."
          properties:
            totalFollowers:
              type: object
              description: "Percentile rank of the total follower count."
              properties:
                global:
                  type: number
                  description: "Percentile rank compared to all creators in CreatorDB's database."
                  minimum: 0
                  maximum: 1
                  examples:
                    - 0.9912
                country:
                  type: number
                  description: "Percentile rank among creators from the same country."
                  minimum: 0
                  maximum: 1
                  examples:
                    - 0.9986
                language:
                  type: number
                  description: "Percentile rank among creators using the same primary language."
                  minimum: 0
                  maximum: 1
                  examples:
                    - 0.9764
              required:
                - global
                - country
                - language
            avgEngagementRate:
              type: object
              description: "Percentile rank of the average engagement rate, calculated based on the creator's recent posts."
              properties:
                global:
                  type: number
                  description: "Percentile rank compared to all creators in CreatorDB's database."
                  minimum: 0
                  maximum: 1
                  examples:
                    - 0.9912
                country:
                  type: number
                  description: "Percentile rank among creators from the same country."
                  minimum: 0
                  maximum: 1
                  examples:
                    - 0.9986
                language:
                  type: number
                  description: "Percentile rank among creators using the same primary language."
                  minimum: 0
                  maximum: 1
                  examples:
                    - 0.9764
              required:
                - global
                - country
                - language
          required:
            - totalFollowers
            - avgEngagementRate
        imagesPerformanceRecent:
          type: object
          description: "Performance metrics of the creator's recent Instagram image posts."
          properties:
            likes:
              type: object
              properties:
                all:
                  type: integer
                  description: "Total number of likes."
                  minimum: 0
                  examples:
                    - 2459
                avg:
                  type: number
                  description: "Average number of likes per image post, rounded to an integer."
                  minimum: 0
                  examples:
                    - 100
                median:
                  type: number
                  description: "Median number of likes."
                  minimum: 0
                  examples:
                    - 120
                min:
                  type: number
                  description: "Minimum number of likes."
                  minimum: 0
                  examples:
                    - 50
                max:
                  type: number
                  description: "Maximum number of likes."
                  minimum: 0
                  examples:
                    - 988
              required:
                - all
                - avg
                - median
                - min
                - max
            comments:
              type: object
              properties:
                all:
                  type: integer
                  description: "Total number of comments."
                  minimum: 0
                  examples:
                    - 2459
                avg:
                  type: number
                  description: "Average number of comments per image post, rounded to an integer."
                  minimum: 0
                  examples:
                    - 100
                median:
                  type: number
                  description: "Median number of comments."
                  minimum: 0
                  examples:
                    - 120
                min:
                  type: number
                  description: "Minimum number of comments."
                  minimum: 0
                  examples:
                    - 50
                max:
                  type: number
                  description: "Maximum number of comments."
                  minimum: 0
                  examples:
                    - 988
              required:
                - all
                - avg
                - median
                - min
                - max
            engagement:
              type: object
              description: "Engagement performance metrics including rates, per-follower statistics, and consistency analysis."
              properties:
                avgEngagementRate:
                  type: number
                  description: |-
                    Average engagement rate per image post (excluding older pinned image posts), rounded to 4th decimal place. <br />
                      - *Engagement Rate &#61; (Likes + Comments)/ Followers*
                  minimum: 0
                  examples:
                    - 0.5201
                likesPerFollower:
                  type: number
                  description: "Average number of likes per follower, rounded to 4th decimal place."
                  minimum: 0
                  examples:
                    - 0.1111
                commentsPerFollower:
                  type: number
                  description: "Average number of comments per follower, rounded to 4th decimal place."
                  minimum: 0
                  examples:
                    - 0.1111
                engagementConsistency:
                  type: object
                  description: "Consistency of engagement performance."
                  properties:
                    cv:
                      type: number
                      description: |-
                        *cv &#61; Standard Deviation of Engagement Rate/ Mean Engagement Rate* <br />
                        - The value is rounded to 4th decimal place. <br />
                        - Lower values indicate more consistent performance. <br />
                        - *A value of `0` indicates insufficient data.*
                      minimum: 0
                      examples:
                        - 0.5201
                    medianVsMean:
                      type: number
                      description: |-
                        *medianVsMean &#61; Median Engagement Rate/ Mean Engagement Rate* <br />
                        - The value is rounded to 4th decimal place <br />
                        - Values closer to `1` indicate more consistent performance. <br />
                        - *A value of `0` indicates insufficient data*.
                      minimum: 0
                      examples:
                        - 0.9001
                    topBottomRatio:
                      type: number
                      description: |-
                        *topBottomRatio &#61; avg(Top 3 Engagement)/avg(Bottom 3 Engagement)* <br />
                        - The value is rounded to 4th decimal place. <br />
                        - Lower ratios indicate more consistent performance. <br />
                        - *A value of `0` indicates insufficient data*.
                      minimum: 0
                      examples:
                        - 1.2001
                    consistencyScore:
                      type:
                        - integer
                        - "null"
                      description: |-
                        *consistencyScore &#61; 100 - [(cvScore\*weight_cv) + (topBottomScore\*weight_topBottom) + (medianVsMeanScore\*weight_medianVsMean)]* <br />
                        - The score is rounded to an integer. <br />
                        - A higher score indicates more stable and consistent performance. <br />
                        - Returns `null` when any of the three indicators (`cv`, `medianVsMean`, `topBottomRatio`) is `0`, indicating insufficient data.
                      minimum: 0
                      maximum: 100
                      examples:
                        - 63
                    consistencyLevel:
                      type:
                        - string
                        - "null"
                      enum:
                        - high
                        - moderate
                        - low
                        - null
                      description: |-
                        A qualitative label based on the `consistencyScore`: <br />
                        - high: 81 - 100 <br />
                        - moderate: 51 - 80 <br />
                        - low: 1 - 50 <br />
                        - Returns `null` when `consistencyScore` is `null`, indicating insufficient data.
                      examples:
                        - moderate
                  required:
                    - cv
                    - medianVsMean
                    - topBottomRatio
                    - consistencyScore
                    - consistencyLevel
              required:
                - avgEngagementRate
                - likesPerFollower
                - commentsPerFollower
                - engagementConsistency
          required:
            - likes
            - comments
            - engagement
        reelsPerformanceRecent:
          type: object
          description: "Performance metrics of the creator's recent Instagram reels."
          properties:
            likes:
              type: object
              properties:
                all:
                  type: integer
                  description: "Total number of likes."
                  minimum: 0
                  examples:
                    - 2459
                avg:
                  type: number
                  description: "Average number of likes per reel, rounded to an integer."
                  minimum: 0
                  examples:
                    - 100
                median:
                  type: number
                  description: "Median number of likes."
                  minimum: 0
                  examples:
                    - 120
                min:
                  type: number
                  description: "Minimum number of likes."
                  minimum: 0
                  examples:
                    - 50
                max:
                  type: number
                  description: "Maximum number of likes."
                  minimum: 0
                  examples:
                    - 988
              required:
                - all
                - avg
                - median
                - min
                - max
            comments:
              type: object
              properties:
                all:
                  type: integer
                  description: "Total number of comments."
                  minimum: 0
                  examples:
                    - 2459
                avg:
                  type: number
                  description: "Average number of comments per Instagram reel, rounded to an integer."
                  minimum: 0
                  examples:
                    - 100
                median:
                  type: number
                  description: "Median number of comments."
                  minimum: 0
                  examples:
                    - 120
                min:
                  type: number
                  description: "Minimum number of comments."
                  minimum: 0
                  examples:
                    - 50
                max:
                  type: number
                  description: "Maximum number of comments."
                  minimum: 0
                  examples:
                    - 988
              required:
                - all
                - avg
                - median
                - min
                - max
            views:
              type: object
              properties:
                all:
                  type: integer
                  description: "Total number of views."
                  minimum: 0
                  examples:
                    - 2459
                avg:
                  type: number
                  description: "Average number of views per reel, rounded to an integer."
                  minimum: 0
                  examples:
                    - 100
                median:
                  type: number
                  description: "Median number of views."
                  minimum: 0
                  examples:
                    - 120
                min:
                  type: number
                  description: "Minimum number of views."
                  minimum: 0
                  examples:
                    - 50
                max:
                  type: number
                  description: "Maximum number of views."
                  minimum: 0
                  examples:
                    - 988
              required:
                - all
                - avg
                - median
                - min
                - max
            engagement:
              type: object
              description: "Engagement performance metrics of Instagram reels, including standard engagement metrics and views per follower."
              properties:
                avgEngagementRate:
                  type: number
                  description: |-
                    Average engagement rate per reel (excluding older pinned reels), rounded to 4th decimal place. <br />
                    - *Engagement Rate &#61; (Likes + Comments)/ Views*
                  minimum: 0
                  examples:
                    - 0.5201
                likesPerFollower:
                  type: number
                  description: "Average number of likes per follower, rounded to 4th decimal place."
                  minimum: 0
                  examples:
                    - 0.1111
                commentsPerFollower:
                  type: number
                  description: "Average number of comments per follower, rounded to 4th decimal place."
                  minimum: 0
                  examples:
                    - 0.1111
                viewsPerFollower:
                  type: number
                  description: "Average number of views per follower, rounded to 4th decimal place."
                  minimum: 0
                  examples:
                    - 0.1111
                engagementConsistency:
                  type: object
                  description: "Consistency of engagement performance."
                  properties:
                    cv:
                      type: number
                      description: |-
                        *cv &#61; Standard Deviation of Engagement Rate/ Mean Engagement Rate* <br />
                        - The value is rounded to 4th decimal place. <br />
                        - Lower values indicate more consistent performance. <br />
                        - *A value of `0` indicates insufficient data.*
                      minimum: 0
                      examples:
                        - 0.5201
                    medianVsMean:
                      type: number
                      description: |-
                        *medianVsMean &#61; Median Engagement Rate/ Mean Engagement Rate* <br />
                        - The value is rounded to 4th decimal place. <br />
                        - Values closer to `1` indicate more consistent performance. <br />
                        - *A value of `0` indicates insufficient data.*
                      minimum: 0
                      examples:
                        - 0.9001
                    topBottomRatio:
                      type: number
                      description: |-
                        *topBottomRatio &#61; avg(Top 3 Engagement)/avg(Bottom 3 Engagement)* <br />
                        - The value is rounded to 4th decimal place. <br />
                        - Lower ratios indicate more consistent performance. <br />
                        - *A value of `0` indicates insufficient data.*
                      minimum: 0
                      examples:
                        - 1.2001
                    consistencyScore:
                      type:
                        - integer
                        - "null"
                      description: |-
                        *consistencyScore &#61; 100 - [(cvScore\*weight_cv) + (topBottomScore\*weight_topBottom) + (medianVsMeanScore\*weight_medianVsMean)]* <br />
                        - The score is rounded to an integer. <br />
                        - A higher score indicates more stable and consistent performance. <br />
                        - Returns `null` when any of the three indicators (`cv`, `medianVsMean`, `topBottomRatio`) is `0`, indicating insufficient data.
                      minimum: 0
                      maximum: 100
                      examples:
                        - 63
                    consistencyLevel:
                      type:
                        - string
                        - "null"
                      enum:
                        - high
                        - moderate
                        - low
                        - null
                      description: |-
                        A qualitative label based on the `consistencyScore`: <br />
                        - high: 81 - 100 <br />
                        - moderate: 51 - 80 <br />
                        - low: 1 - 50 <br />
                        - Returns `null` when `consistencyScore` is `null`, indicating insufficient data.
                      examples:
                        - moderate
                  required:
                    - cv
                    - medianVsMean
                    - topBottomRatio
                    - consistencyScore
                    - consistencyLevel
              required:
                - avgEngagementRate
                - likesPerFollower
                - commentsPerFollower
                - viewsPerFollower
                - engagementConsistency
          required:
            - likes
            - comments
            - views
            - engagement
        recentImagesGrowth:
          type: object
          description: "Growth metrics for recent Instagram image posts across 7, 30, and 90-day periods."
          properties:
            g7:
              type: object
              description: "Growth metrics over 7 days."
              properties:
                engagementRate:
                  type: number
                  description: "Growth rate of engagement rate, rounded to 4th decimal place."
                  examples:
                    - 0.0567
              required:
                - engagementRate
            g30:
              type: object
              description: "Growth metrics over 30 days."
              properties:
                engagementRate:
                  type: number
                  description: "Growth rate of engagement rate, rounded to 4th decimal place."
                  examples:
                    - 0.0567
              required:
                - engagementRate
            g90:
              type: object
              description: "Growth metrics over 90 days."
              properties:
                engagementRate:
                  type: number
                  description: "Growth rate of engagement rate, rounded to 4th decimal place."
                  examples:
                    - 0.0567
              required:
                - engagementRate
          required:
            - g7
            - g30
            - g90
        recentReelsGrowth:
          type: object
          description: "Growth metrics for recent Instagram reels across 7, 30, and 90-day periods."
          properties:
            g7:
              type: object
              description: "Growth metrics over 7 days."
              properties:
                avgViews:
                  type: number
                  description: "Growth rate of average views, rounded to 4th decimal place."
                  examples:
                    - 0.2345
                engagementRate:
                  type: number
                  description: "Growth rate of engagement rate, rounded to 4th decimal place."
                  examples:
                    - 0.0567
              required:
                - avgViews
                - engagementRate
            g30:
              type: object
              description: "Growth metrics over 30 days."
              properties:
                avgViews:
                  type: number
                  description: "Growth rate of average views, rounded to 4th decimal place."
                  examples:
                    - 0.2345
                engagementRate:
                  type: number
                  description: "Growth rate of engagement rate, rounded to 4th decimal place."
                  examples:
                    - 0.0567
              required:
                - avgViews
                - engagementRate
            g90:
              type: object
              description: "Growth metrics over 90 days."
              properties:
                avgViews:
                  type: number
                  description: "Growth rate of average views, rounded to 4th decimal place."
                  examples:
                    - 0.2345
                engagementRate:
                  type: number
                  description: "Growth rate of engagement rate, rounded to 4th decimal place."
                  examples:
                    - 0.0567
              required:
                - avgViews
                - engagementRate
          required:
            - g7
            - g30
            - g90
    InstagramAudienceData:
      type: object
      description: "Returned audience demographic data of the specified Instagram account."
      properties:
        audienceLocations:
          type:
            - array
            - "null"
          description: "Country locations of the audience, sorted by descending share."
          examples:
            - - country: TWN
                share: 0.6521
              - country: USA
                share: 0.0813
              - country: HKG
                share: 0.0501
          items:
            type: object
            description: "Country distribution of the audience."
            properties:
              country:
                type: string
                description: "The country in **ISO 3166-1 alpha-3** format. For details, see [Country Codes](http://docs.creatordb.app/api-v3/country-code)."
                examples:
                  - TWN
              share:
                type: number
                description: "Proportion of audience from that country, rounded to 4th decimal place."
                examples:
                  - 0.6521
            required:
              - country
              - share
        audienceGender:
          type:
            - object
            - "null"
          description: "Gender distribution of the audience."
          properties:
            maleRatio:
              type: number
              description: "Proportion of male audience, rounded to 4th decimal place."
              examples:
                - 0.3233
            femaleRatio:
              type: number
              description: "Proportion of female audience, rounded to 4th decimal place."
              examples:
                - 0.6412
          required:
            - maleRatio
            - femaleRatio
          examples:
            - maleRatio: 0.3233
              femaleRatio: 0.6412
        audienceAvgAge:
          type:
            - integer
            - "null"
          description: "Average age of the audience, rounded to an integer."
          examples:
            - 28
        audienceAgeBreakdown:
          type:
            - array
            - "null"
          description: "Distribution of the audience by age range."
          examples:
            - - ageRange: 13-17
                share: 0.0523
              - ageRange: 18-24
                share: 0.2871
              - ageRange: 25-34
                share: 0.3418
              - ageRange: 35-44
                share: 0.1825
              - ageRange: 45-54
                share: 0.0898
              - ageRange: 55-64
                share: 0.0312
              - ageRange: 65+
                share: 0.0153
          items:
            type: object
            description: "Age range distribution of the audience."
            properties:
              ageRange:
                type: string
                enum:
                  - 13-17
                  - 18-24
                  - 25-34
                  - 35-44
                  - 45-54
                  - 55-64
                  - 65+
                description: "Age group. <br /> Accepted values: `13-17`, `18-24`, `25-34`, `35-44`, `45-54`, `55-64`, `65+`"
                examples:
                  - 25-34
              share:
                type: number
                description: "Percentage of audience in a specific age group, rounded to 4th decimal place."
                examples:
                  - 0.0523
            required:
              - ageRange
              - share
    InstagramContactData:
      type: object
      description: "Contact information of the specified Instagram creator."
      properties:
        emails:
          type: array
          description: "Associated email addresses. Empty if unavailable."
          examples:
            - - example@email.com
          items:
            type: string
            format: email
    InstagramContentDetailData:
      type: object
      description: "Retrieved Instagram content details of a specified creator."
      properties:
        recentImages:
          type: array
          description: "Data of Instagram image posts."
          items:
            type: object
            description: "A recent Instagram image post."
            properties:
              publishTime:
                type: integer
                description: "Publish time, represented as a Unix timestamp in milliseconds."
                examples:
                  - 1752392905000
              contentId:
                type: string
                description: "The unique identifier. Represented as follows: `https://www.instagram.com/p/{imageId}`"
                examples:
                  - DMCkc5CyZdf
              isSponsored:
                type: boolean
                description: "`true` if sponsored."
                examples:
                  - true
              description:
                type: string
                description: "The post caption, including emojis and line breaks."
                examples:
                  - "突然覺得這輩子一定要好好賺錢\n以後都搭商務艙\U0001F62D\U0001F62D\U0001F62D"
              coverImageUrl:
                type: string
                description: "The URL of the first image shown in the Instagram image post."
                examples:
                  - "https://www.instagram.com/p/DMCkc5CyZdf/media/?size=l"
              carouselImageUrls:
                type: array
                description: "URLs of images in the Instagram post."
                examples:
                  - - "https://instagram.ftpe7-2.fna.fbcdn.net/v/GfDr0Q&oe=68A5CBD8&_nc_sid=7a9f4b"
                    - "https://instagram.ftpe7-2.fna.fbcdn.net/v/ttjknzBbXhk2y8g9"
                items:
                  type: string
              igGeoTaggedLocation:
                type:
                  - object
                  - "null"
                description: "Tagged location."
                properties:
                  lat:
                    type: number
                    description: "Latitude of the geo-tagged location."
                    examples:
                      - 25.033964
                  lng:
                    type: number
                    description: "Longitude of the geo-tagged location."
                    examples:
                      - 121.564468
                  name:
                    type: string
                    description: "Name of the geo-tagged location."
                    examples:
                      - Taipei 101
                required:
                  - lat
                  - lng
                  - name
              likes:
                type: number
                description: "Number of likes."
                examples:
                  - 15840
              comments:
                type: number
                description: "Number of comments."
                examples:
                  - 121
              engagementRate:
                type: number
                description: "Engagement rate, rounded to 4th decimal place. <br /> - *Engagement Rate &#61; (Likes + Comments) / Followers*"
                examples:
                  - 0.1201
              hashtags:
                type: array
                description: "Keywords used in the post description."
                examples:
                  - - "#激瘦挖腰連身泳衣"
                items:
                  type: string
              taggedCreators:
                type: array
                description: "Tagged creators."
                examples:
                  - - lalalalisa_m
                items:
                  type: string
            required:
              - publishTime
              - contentId
              - isSponsored
              - description
              - coverImageUrl
              - carouselImageUrls
              - igGeoTaggedLocation
              - likes
              - comments
              - engagementRate
              - hashtags
              - taggedCreators
        recentReels:
          type: array
          description: "Data of recent Instagram reels."
          items:
            type: object
            description: "A recent Instagram reel."
            properties:
              publishTime:
                type: integer
                description: "Publish time, represented as a Unix timestamp in milliseconds."
                examples:
                  - 1752902842000
              contentId:
                type: string
                description: "The unique identifier. Represented as: `https://www.instagram.com/reel/{reelId}`"
                examples:
                  - DMRw6T2St3ui
              isSponsored:
                type: boolean
                description: "`true` if sponsored."
                examples:
                  - false
              description:
                type: string
                description: "The reel caption, including emojis and line breaks."
                examples:
                  - "史上最優惠：買一件內衣 就送一件面膜內褲\U0001F389"
              coverImageUrl:
                type: string
                description: "The cover image URL."
                examples:
                  - "https://www.instagram.com/p/DMCkc5CyZdf/media/?size=l"
              igGeoTaggedLocation:
                type:
                  - object
                  - "null"
                description: "Tagged location."
                properties:
                  lat:
                    type: number
                    description: "Latitude of the geo-tagged location."
                    examples:
                      - 25.033964
                  lng:
                    type: number
                    description: "Longitude of the geo-tagged location."
                    examples:
                      - 121.564468
                  name:
                    type: string
                    description: "Name of the geo-tagged location."
                    examples:
                      - Taipei 101
                required:
                  - lat
                  - lng
                  - name
              likes:
                type: number
                description: "Number of likes."
                examples:
                  - 15840
              comments:
                type: number
                description: "Number of comments."
                examples:
                  - 121
              views:
                type: number
                description: "Number of views."
                examples:
                  - 3469
              engagementRate:
                type: number
                description: "Engagement rate, rounded to 4th decimal place. <br /> - *Engagement Rate &#61; (Likes + Comments) / Views*"
                examples:
                  - 0.1201
              hashtags:
                type: array
                description: "Keywords in the reel description."
                examples:
                  - - "#激瘦挖腰連身泳衣"
                items:
                  type: string
              taggedCreators:
                type: array
                description: "Tagged creators."
                examples:
                  - - lalalalisa_m
                items:
                  type: string
              musicInfo:
                type: object
                description: "Information about the music used in the reel. Returns an object of empty strings when no music information is available."
                properties:
                  id:
                    type: string
                    description: "Unique identifier of the music track."
                    examples:
                      - "18155959992226227"
                  title:
                    type: string
                    description: "Title of the music track."
                    examples:
                      - Original Audio
                  displayArtist:
                    type: string
                    description: "Artist name as displayed on Instagram."
                    examples:
                      - author_name
                required:
                  - id
                  - title
                  - displayArtist
            required:
              - publishTime
              - contentId
              - isSponsored
              - description
              - coverImageUrl
              - igGeoTaggedLocation
              - likes
              - comments
              - views
              - engagementRate
              - hashtags
              - taggedCreators
              - musicInfo
    InstagramSponsorshipData:
      type: object
      description: "Retrieve recently sponsored Instagram posts and reels data for a specified creator."
      properties:
        sponsorList:
          type: array
          description: "List of sponsors and their associated branded content."
          items:
            type: object
            description: "A sponsor's branded posts and aggregated performance metrics."
            properties:
              brandName:
                type: string
                description: "The sponsor name."
                examples:
                  - Acer
              brandId:
                type: string
                description: "The official website URL or unique identifier of the sponsor."
                examples:
                  - acer.com
              brandIgIds:
                type: array
                description: "The Instagram handles of the sponsor."
                examples:
                  - - acer
                items:
                  type: string
              sponsoredImages:
                type: array
                description: "Recent sponsored Instagram image post data."
                items:
                  type: object
                  description: "A recent sponsored Instagram image post."
                  properties:
                    publishTime:
                      type: integer
                      description: "Publish time, represented as a Unix timestamp in milliseconds."
                      examples:
                        - 1752392905000
                    contentId:
                      type: string
                      description: "The unique identifier. Represented as follows: `https://www.instagram.com/p/{imageId}`"
                      examples:
                        - DMCkc5CyZdf
                    isSponsored:
                      type: boolean
                      description: "`true` if sponsored."
                      examples:
                        - true
                    description:
                      type: string
                      description: "The post caption, including emojis and line breaks."
                      examples:
                        - "突然覺得這輩子一定要好好賺錢\n以後都搭商務艙\U0001F62D\U0001F62D\U0001F62D"
                    coverImageUrl:
                      type: string
                      description: "The first image URL in an image post."
                      examples:
                        - "https://www.instagram.com/p/DMCkc5CyZdf/media/?size=l"
                    carouselImageUrls:
                      type: array
                      description: "URLs of images in the Instagram post."
                      examples:
                        - - "https://instagram.ftpe7-2.fna.fbcdn.net/v/GfDr0Q&oe=68A5CBD8&_nc_sid=7a9f4b"
                          - "https://instagram.ftpe7-2.fna.fbcdn.net/v/ttjknzBbXhk2y8g9"
                      items:
                        type: string
                    igGeoTaggedLocation:
                      type:
                        - object
                        - "null"
                      description: "Tagged location."
                      properties:
                        lat:
                          type: number
                          description: "Latitude of the geo-tagged location."
                          examples:
                            - 25.033964
                        lng:
                          type: number
                          description: "Longitude of the geo-tagged location."
                          examples:
                            - 121.564468
                        name:
                          type: string
                          description: "Name of the geo-tagged location."
                          examples:
                            - Taipei 101
                      required:
                        - lat
                        - lng
                        - name
                    likes:
                      type: number
                      description: "Number of likes."
                      examples:
                        - 15840
                    comments:
                      type: number
                      description: "Number of comments."
                      examples:
                        - 121
                    engagementRate:
                      type: number
                      description: "Engagement rate, rounded to 4th decimal place. <br /> *Engagement Rate &#61; (Likes + Comments)/ Followers*"
                      examples:
                        - 0.1201
                    hashtags:
                      type: array
                      description: "Keywords used in the post description."
                      examples:
                        - - "#激瘦挖腰連身泳衣"
                      items:
                        type: string
                    taggedCreators:
                      type: array
                      description: "Tagged creators."
                      examples:
                        - - lalalalisa_m
                      items:
                        type: string
                  required:
                    - publishTime
                    - contentId
                    - isSponsored
                    - description
                    - coverImageUrl
                    - carouselImageUrls
                    - igGeoTaggedLocation
                    - likes
                    - comments
                    - engagementRate
                    - hashtags
                    - taggedCreators
              sponsoredReels:
                type: array
                description: "Recently sponsored Instagram reels."
                items:
                  type: object
                  description: "A recent sponsored Instagram reel."
                  properties:
                    publishTime:
                      type: integer
                      description: "Publish time, represented as a Unix timestamp in milliseconds."
                      examples:
                        - 1752902842000
                    contentId:
                      type: string
                      description: "The unique identifier. Represented as follows: `https://www.instagram.com/reel/{reelId}`"
                      examples:
                        - DMRw6T2St3ui
                    isSponsored:
                      type: boolean
                      description: "`true` if sponsored."
                      examples:
                        - false
                    description:
                      type: string
                      description: "The reel caption, including emojis and line breaks."
                      examples:
                        - "史上最優惠：買一件內衣 就送一件面膜內褲\U0001F389"
                    coverImageUrl:
                      type: string
                      description: "The cover image URL."
                      examples:
                        - "https://www.instagram.com/p/DMCkc5CyZdf/media/?size=l"
                    igGeoTaggedLocation:
                      type:
                        - object
                        - "null"
                      description: "Tagged location."
                      properties:
                        lat:
                          type: number
                          description: "Latitude of the geo-tagged location."
                          examples:
                            - 25.033964
                        lng:
                          type: number
                          description: "Longitude of the geo-tagged location."
                          examples:
                            - 121.564468
                        name:
                          type: string
                          description: "Name of the geo-tagged location."
                          examples:
                            - Taipei 101
                      required:
                        - lat
                        - lng
                        - name
                    likes:
                      type: number
                      description: "Number of likes."
                      examples:
                        - 15840
                    comments:
                      type: number
                      description: "Number of comments."
                      examples:
                        - 121
                    views:
                      type: number
                      description: "Number of views."
                      examples:
                        - 3469
                    engagementRate:
                      type: number
                      description: "Engagement rate, rounded to 4th decimal place. <br /> - *Engagement Rate &#61; (Likes + Comments) / Views*"
                      examples:
                        - 0.1201
                    hashtags:
                      type: array
                      description: "Keywords in the reel description."
                      examples:
                        - - "#激瘦挖腰連身泳衣"
                      items:
                        type: string
                    taggedCreators:
                      type: array
                      description: "Tagged creators."
                      examples:
                        - - lalalalisa_m
                      items:
                        type: string
                    musicInfo:
                      type: object
                      description: "Information about the music used in the reel. Returns an object of empty strings when no music information is available."
                      properties:
                        id:
                          type: string
                          description: "Unique identifier of the music track."
                          examples:
                            - "18155959992226227"
                        title:
                          type: string
                          description: "Title of the music track."
                          examples:
                            - Original Audio
                        displayArtist:
                          type: string
                          description: "Artist name as displayed on Instagram."
                          examples:
                            - author_name
                      required:
                        - id
                        - title
                        - displayArtist
                  required:
                    - publishTime
                    - contentId
                    - isSponsored
                    - description
                    - coverImageUrl
                    - igGeoTaggedLocation
                    - likes
                    - comments
                    - views
                    - engagementRate
                    - hashtags
                    - taggedCreators
                    - musicInfo
              sponsoredImagesPerformance:
                type: object
                description: "Performance metrics for sponsored Instagram image posts broken down by brands."
                properties:
                  likes:
                    type: object
                    properties:
                      all:
                        type: integer
                        description: "Total number of likes."
                        minimum: 0
                        examples:
                          - 2459
                      avg:
                        type: number
                        description: "Average number of likes per sponsored image post, rounded to an integer."
                        minimum: 0
                        examples:
                          - 100
                      median:
                        type: number
                        description: "Median number of likes."
                        minimum: 0
                        examples:
                          - 120
                      min:
                        type: number
                        description: "Minimum number of likes."
                        minimum: 0
                        examples:
                          - 50
                      max:
                        type: number
                        description: "Maximum number of likes."
                        minimum: 0
                        examples:
                          - 988
                    required:
                      - all
                      - avg
                      - median
                      - min
                      - max
                  comments:
                    type: object
                    properties:
                      all:
                        type: integer
                        description: "Total number of comments."
                        minimum: 0
                        examples:
                          - 2459
                      avg:
                        type: number
                        description: "Average number of comments per sponsored image post, rounded to an integer."
                        minimum: 0
                        examples:
                          - 100
                      median:
                        type: number
                        description: "Median number of comments."
                        minimum: 0
                        examples:
                          - 120
                      min:
                        type: number
                        description: "Minimum number of comments."
                        minimum: 0
                        examples:
                          - 50
                      max:
                        type: number
                        description: "Maximum number of comments."
                        minimum: 0
                        examples:
                          - 988
                    required:
                      - all
                      - avg
                      - median
                      - min
                      - max
                  engagement:
                    type: object
                    description: "Engagement performance metrics including rates, per-follower statistics and consistency analysis."
                    properties:
                      avgEngagementRate:
                        type: number
                        description: |-
                          Average engagement rate per image post (excluding older pinned image posts), rounded to 4th decimal place <br />
                          - *Engagement Rate &#61; (Likes + Comments) / Followers*
                        minimum: 0
                        examples:
                          - 0.5201
                      likesPerFollower:
                        type: number
                        description: "Average number of likes per follower on image posts, rounded to 4th decimal place."
                        minimum: 0
                        examples:
                          - 0.1111
                      commentsPerFollower:
                        type: number
                        description: "Average number of comments per follower on image posts, rounded to 4th decimal place."
                        minimum: 0
                        examples:
                          - 0.1111
                      engagementConsistency:
                        type: object
                        description: "Consistency of engagement performance of sponsored Instagram image posts broken down by brands."
                        properties:
                          cv:
                            type: number
                            description: |-
                              *cv &#61; Standard Deviation of Engagement Rate/ Mean Engagement Rate* <br />
                              - The value is rounded to 4th decimal place. <br />
                              - Lower values indicate more consistent performance. <br />
                              - *A value of `0` indicates insufficient data.*
                            minimum: 0
                            examples:
                              - 0.5201
                          medianVsMean:
                            type: number
                            description: |-
                              *medianVsMean &#61; Median Engagement Rate/ Mean Engagement Rate* <br />
                              - The value is rounded to 4th decimal place <br />
                              - Values closer to `1` indicate more consistent performance. <br />
                              - *A value of `0` indicates insufficient data.*
                            minimum: 0
                            examples:
                              - 0.9001
                          topBottomRatio:
                            type: number
                            description: |-
                              *topBottomRatio &#61; avg(Top 3 Engagement) / avg(Bottom 3 Engagement)* <br />
                              - The value is rounded to 4th decimal place <br />
                              - Lower ratios indicate more consistent performance <br />
                              - *A value of `0` indicates insufficient data.*
                            minimum: 0
                            examples:
                              - 1.2001
                          consistencyScore:
                            type:
                              - integer
                              - "null"
                            description: |-
                              *consistencyScore &#61; 100 - [(cvScore\*weight_cv) + (topBottomScore\*weight_topBottom) + (medianVsMeanScore\*weight_medianVsMean)]* <br />
                              - The score is rounded to an integer. <br />
                              - A higher score indicates more stable and consistent performance. <br />
                              - Returns `null` when any of the three indicators (`cv`, `medianVsMean`, `topBottomRatio`) is `0`, indicating insufficient data.
                            minimum: 0
                            maximum: 100
                            examples:
                              - 63
                          consistencyLevel:
                            type:
                              - string
                              - "null"
                            enum:
                              - high
                              - moderate
                              - low
                              - null
                            description: |-
                              A qualitative label based on the `consistencyScore`: <br />
                              - high: 81 - 100 <br />
                              - moderate: 51 - 80 <br />
                              - low: 1 - 50 <br />
                              - Returns `null` when `consistencyScore` is `null`, indicating insufficient data.
                            examples:
                              - moderate
                        required:
                          - cv
                          - medianVsMean
                          - topBottomRatio
                          - consistencyScore
                          - consistencyLevel
                    required:
                      - avgEngagementRate
                      - likesPerFollower
                      - commentsPerFollower
                      - engagementConsistency
                required:
                  - likes
                  - comments
                  - engagement
              sponsoredReelsPerformance:
                type: object
                description: "Performance metrics for sponsored Instagram reels broken down by brands."
                properties:
                  likes:
                    type: object
                    properties:
                      all:
                        type: integer
                        description: "Total number of likes."
                        minimum: 0
                        examples:
                          - 2459
                      avg:
                        type: number
                        description: "Average number of likes per reel, rounded to an integer."
                        minimum: 0
                        examples:
                          - 100
                      median:
                        type: number
                        description: "Median number of likes."
                        minimum: 0
                        examples:
                          - 120
                      min:
                        type: number
                        description: "Minimum number of likes."
                        minimum: 0
                        examples:
                          - 50
                      max:
                        type: number
                        description: "Maximum number of likes."
                        minimum: 0
                        examples:
                          - 988
                    required:
                      - all
                      - avg
                      - median
                      - min
                      - max
                  comments:
                    type: object
                    properties:
                      all:
                        type: integer
                        description: "Total number of comments."
                        minimum: 0
                        examples:
                          - 2459
                      avg:
                        type: number
                        description: "Average number of comments per reel, rounded to an integer."
                        minimum: 0
                        examples:
                          - 100
                      median:
                        type: number
                        description: "Median number of comments."
                        minimum: 0
                        examples:
                          - 120
                      min:
                        type: number
                        description: "Minimum number of comments."
                        minimum: 0
                        examples:
                          - 50
                      max:
                        type: number
                        description: "Maximum number of comments."
                        minimum: 0
                        examples:
                          - 988
                    required:
                      - all
                      - avg
                      - median
                      - min
                      - max
                  views:
                    type: object
                    properties:
                      all:
                        type: integer
                        description: "Total number of views."
                        minimum: 0
                        examples:
                          - 2459
                      avg:
                        type: number
                        description: "Average number of views per reel, rounded to an integer."
                        minimum: 0
                        examples:
                          - 100
                      median:
                        type: number
                        description: "Median number of views."
                        minimum: 0
                        examples:
                          - 120
                      min:
                        type: number
                        description: "Minimum number of views."
                        minimum: 0
                        examples:
                          - 50
                      max:
                        type: number
                        description: "Maximum number of views."
                        minimum: 0
                        examples:
                          - 988
                    required:
                      - all
                      - avg
                      - median
                      - min
                      - max
                  engagement:
                    type: object
                    description: "Engagement performance metrics broken down by brand, including standard engagement metrics and views per follower."
                    properties:
                      avgEngagementRate:
                        type: number
                        description: |-
                          Average engagement rate per reel (excluding older pinned reels), rounded to 4th decimal place. <br />
                          *Engagement Rate &#61; (Likes + Comments)/ Followers* <br />
                          - This aggregate is recomputed against follower count, while the per-reel `engagementRate` values in `sponsoredReels` are divided by views. The two are therefore not directly comparable, and this figure is not the mean of those values.
                        minimum: 0
                        examples:
                          - 0.5201
                      likesPerFollower:
                        type: number
                        description: "Average number of likes per follower, rounded to 4th decimal place."
                        minimum: 0
                        examples:
                          - 0.1111
                      commentsPerFollower:
                        type: number
                        description: "Average number of comments per follower, rounded to 4th decimal place."
                        minimum: 0
                        examples:
                          - 0.1111
                      viewsPerFollower:
                        type: number
                        description: "Average number of views per follower, rounded to 4th decimal place."
                        minimum: 0
                        examples:
                          - 0.1111
                      engagementConsistency:
                        type: object
                        description: "Consistency of engagement performance of sponsored Instagram reels broken down by brands."
                        properties:
                          cv:
                            type: number
                            description: |-
                              *cv &#61; Standard Deviation of Engagement Rate/Mean Engagement Rate* <br />
                              - The value is rounded to 4th decimal place. <br />
                              - Lower values indicate more consistent performance. <br />
                              - *A value of `0` indicates insufficient data.*
                            minimum: 0
                            examples:
                              - 0.5201
                          medianVsMean:
                            type: number
                            description: |-
                              *medianVsMean &#61; Median Engagement Rate/ Mean Engagement Rate* <br />
                              - The value is rounded to 4th decimal place <br />
                              - Values closer to `1` indicate more consistent performance. <br />
                              - *A value of `0` indicates insufficient data.*
                            minimum: 0
                            examples:
                              - 0.9001
                          topBottomRatio:
                            type: number
                            description: |-
                              *topBottomRatio &#61; avg(Top 3 Engagement)/avg(Bottom 3 Engagement)* <br />
                              - The value is rounded to 4th decimal place. <br />
                              - Lower ratios indicate more consistent performance. <br />
                              - *A value of `0` indicates insufficient data.*
                            minimum: 0
                            examples:
                              - 1.2001
                          consistencyScore:
                            type:
                              - integer
                              - "null"
                            description: |-
                              *consistencyScore &#61; 100 - [(cvScore*weight_cv) + (topBottomScore*weight_topBottom) + (medianVsMeanScore*weight_medianVsMean)]* <br />
                              - The score is rounded to an integer. <br />
                              - A higher score indicates more stable and consistent performance. <br />
                              - Returns `null` when any of the three indicators (`cv`, `medianVsMean`, `topBottomRatio`) is `0`, indicating insufficient data.
                            minimum: 0
                            maximum: 100
                            examples:
                              - 63
                          consistencyLevel:
                            type:
                              - string
                              - "null"
                            enum:
                              - high
                              - moderate
                              - low
                              - null
                            description: |-
                              A qualitative label based on the `consistencyScore`: <br />
                              - high: 81 - 100 <br />
                              - moderate: 51 - 80 <br />
                              - low: 1 - 50 <br />
                              - Returns `null` when `consistencyScore` is `null`, indicating insufficient data.
                            examples:
                              - moderate
                        required:
                          - cv
                          - medianVsMean
                          - topBottomRatio
                          - consistencyScore
                          - consistencyLevel
                    required:
                      - avgEngagementRate
                      - likesPerFollower
                      - commentsPerFollower
                      - viewsPerFollower
                      - engagementConsistency
                required:
                  - likes
                  - comments
                  - views
                  - engagement
            required:
              - brandName
              - brandId
              - brandIgIds
              - sponsoredImages
              - sponsoredReels
              - sponsoredImagesPerformance
              - sponsoredReelsPerformance
    InstagramPerformanceHistoryData:
      type: object
      description: "The historical performance metrics of the specified Instagram account."
      properties:
        histories:
          type: array
          description: "Historical performance snapshots, each containing metrics and a corresponding Unix timestamp in milliseconds."
          items:
            type: object
            description: "A snapshot of the performance metrics on the specified date."
            properties:
              timestamp:
                type: integer
                description: "The performance snapshot date, represented as a Unix timestamp in milliseconds."
                exclusiveMinimum: 0
                examples:
                  - 1750732453635
              totalFollowers:
                type: integer
                description: "Total number of followers."
                minimum: 0
                examples:
                  - 613344
              totalFollowing:
                type: integer
                description: "Total number of accounts followed."
                minimum: 0
                examples:
                  - 1204
              totalContents:
                type: integer
                description: "Total number of posts."
                minimum: 0
                examples:
                  - 1609
              imagesPerformanceRecent:
                type: object
                description: "Performance metrics of the image posts for the specified time period."
                properties:
                  likes:
                    type: object
                    properties:
                      all:
                        type: integer
                        description: "Total number of likes."
                        minimum: 0
                        examples:
                          - 2459
                      avg:
                        type: number
                        description: "Average number of likes per image post, rounded to an integer."
                        minimum: 0
                        examples:
                          - 100
                      median:
                        type: number
                        description: "Median number of likes."
                        minimum: 0
                        examples:
                          - 120
                      min:
                        type: number
                        description: "Minimum number of likes."
                        minimum: 0
                        examples:
                          - 50
                      max:
                        type: number
                        description: "Maximum number of likes."
                        minimum: 0
                        examples:
                          - 988
                    required:
                      - all
                      - avg
                      - median
                      - min
                      - max
                  comments:
                    type: object
                    properties:
                      all:
                        type: integer
                        description: "Total number of comments."
                        minimum: 0
                        examples:
                          - 2459
                      avg:
                        type: number
                        description: "Average number of comments per image post, rounded to an integer."
                        minimum: 0
                        examples:
                          - 100
                      median:
                        type: number
                        description: "Median number of comments."
                        minimum: 0
                        examples:
                          - 120
                      min:
                        type: number
                        description: "Minimum number of comments."
                        minimum: 0
                        examples:
                          - 50
                      max:
                        type: number
                        description: "Maximum number of comments."
                        minimum: 0
                        examples:
                          - 988
                    required:
                      - all
                      - avg
                      - median
                      - min
                      - max
                  engagement:
                    type: object
                    description: "Engagement performance metrics including rates, per-follower statistics, and consistency analysis."
                    properties:
                      avgEngagementRate:
                        type: number
                        description: |-
                          Average engagement rate per Instagram image post (excluding older pinned image posts), rounded to 4th decimal place. <br />
                            - *Engagement Rate &#61; (Likes + Comments)/ Followers*
                        minimum: 0
                        examples:
                          - 0.5201
                      likesPerFollower:
                        type: number
                        description: "Average number of likes per follower, rounded to 4th decimal place."
                        minimum: 0
                        examples:
                          - 0.1111
                      commentsPerFollower:
                        type: number
                        description: "Average number of comments per follower, rounded to 4th decimal place."
                        minimum: 0
                        examples:
                          - 0.1111
                      engagementConsistency:
                        type: object
                        description: "Consistency of engagement performance."
                        properties:
                          cv:
                            type: number
                            description: |-
                              *cv &#61; Standard Deviation of Engagement Rate/ Mean Engagement Rate* <br />
                              - The value is rounded to 4th decimal place. <br />
                              - Lower values indicate more consistent performance. <br />
                              - *A value of `0` indicates insufficient data.*
                            minimum: 0
                            examples:
                              - 0.5201
                          medianVsMean:
                            type: number
                            description: |-
                              *medianVsMean &#61; Median Engagement Rate/ Mean Engagement Rate* <br />
                              - The value is rounded to 4th decimal place. <br />
                              - Values closer to `1` indicate more consistent performance. <br />
                              - *A value of `0` indicates insufficient data.*
                            minimum: 0
                            examples:
                              - 0.9001
                          topBottomRatio:
                            type: number
                            description: |-
                              *topBottomRatio &#61; avg(Top 3 Engagement)/avg(Bottom 3 Engagement)* <br />
                              - The value is rounded to 4th decimal place. <br />
                              - Lower ratios indicate more consistent performance. <br />
                              - *A value of `0` indicates insufficient data.*
                            minimum: 0
                            examples:
                              - 1.2001
                          consistencyScore:
                            type:
                              - integer
                              - "null"
                            description: |-
                              *consistencyScore &#61; 100 - [(cvScore\*weight_cv) + (topBottomScore\*weight_topBottom) + (medianVsMeanScore\*weight_medianVsMean)]* <br />
                              - The score is rounded to an integer. <br />
                              - A higher score indicates more stable and consistent performance. <br />
                              - Returns `null` when any of the three indicators (`cv`, `medianVsMean`, `topBottomRatio`) is `0`, indicating insufficient data.
                            minimum: 0
                            maximum: 100
                            examples:
                              - 63
                          consistencyLevel:
                            type:
                              - string
                              - "null"
                            enum:
                              - high
                              - moderate
                              - low
                              - null
                            description: |-
                              A qualitative label based on the `consistencyScore`: <br />
                              - high: 81 - 100 <br />
                              - moderate: 51 - 80 <br />
                              - low: 1 - 50 <br />
                              - Returns `null` when `consistencyScore` is `null`, indicating insufficient data.
                            examples:
                              - moderate
                        required:
                          - cv
                          - medianVsMean
                          - topBottomRatio
                          - consistencyScore
                          - consistencyLevel
                    required:
                      - avgEngagementRate
                      - likesPerFollower
                      - commentsPerFollower
                      - engagementConsistency
                required:
                  - likes
                  - comments
                  - engagement
              reelsPerformanceRecent:
                type: object
                description: "The Instagram reels performance metrics for the specified time period."
                properties:
                  likes:
                    type: object
                    properties:
                      all:
                        type: integer
                        description: "Total number of likes."
                        minimum: 0
                        examples:
                          - 2459
                      avg:
                        type: number
                        description: "Average number of likes per Instagram reel, rounded to an integer."
                        minimum: 0
                        examples:
                          - 100
                      median:
                        type: number
                        description: "Median number of likes."
                        minimum: 0
                        examples:
                          - 120
                      min:
                        type: number
                        description: "Minimum number of likes."
                        minimum: 0
                        examples:
                          - 50
                      max:
                        type: number
                        description: "Maximum number of likes."
                        minimum: 0
                        examples:
                          - 988
                    required:
                      - all
                      - avg
                      - median
                      - min
                      - max
                  comments:
                    type: object
                    properties:
                      all:
                        type: integer
                        description: "Total number of comments."
                        minimum: 0
                        examples:
                          - 2459
                      avg:
                        type: number
                        description: "Average number of comments per Instagram reel, rounded to an integer."
                        minimum: 0
                        examples:
                          - 100
                      median:
                        type: number
                        description: "Median number of comments."
                        minimum: 0
                        examples:
                          - 120
                      min:
                        type: number
                        description: "Minimum number of comments."
                        minimum: 0
                        examples:
                          - 50
                      max:
                        type: number
                        description: "Maximum number of comments."
                        minimum: 0
                        examples:
                          - 988
                    required:
                      - all
                      - avg
                      - median
                      - min
                      - max
                  views:
                    type: object
                    properties:
                      all:
                        type: integer
                        description: "Total number of views."
                        minimum: 0
                        examples:
                          - 2459
                      avg:
                        type: number
                        description: "Average number of views per Instagram reel, rounded to an integer."
                        minimum: 0
                        examples:
                          - 100
                      median:
                        type: number
                        description: "Median number of views."
                        minimum: 0
                        examples:
                          - 120
                      min:
                        type: number
                        description: "Minimum number of views."
                        minimum: 0
                        examples:
                          - 50
                      max:
                        type: number
                        description: "Maximum number of views."
                        minimum: 0
                        examples:
                          - 988
                    required:
                      - all
                      - avg
                      - median
                      - min
                      - max
                  engagement:
                    type: object
                    description: "Engagement performance metrics for Instagram reels."
                    properties:
                      avgEngagementRate:
                        type: number
                        description: |-
                          Average engagement rate per Instagram reel (excluding older pinned reels), rounded to 4th decimal place. <br />
                            - *Engagement Rate &#61; (Likes + Comments) / Views*
                        minimum: 0
                        examples:
                          - 0.5201
                      likesPerFollower:
                        type: number
                        description: "Average number of likes per follower, rounded to 4th decimal place."
                        minimum: 0
                        examples:
                          - 0.1111
                      commentsPerFollower:
                        type: number
                        description: "Average number of comments per follower, rounded to 4th decimal place."
                        minimum: 0
                        examples:
                          - 0.1111
                      viewsPerFollower:
                        type: number
                        description: "Average number of views per follower, rounded to 4th decimal place."
                        minimum: 0
                        examples:
                          - 0.1111
                      engagementConsistency:
                        type: object
                        description: "Consistency of engagement performance across Instagram reels."
                        properties:
                          cv:
                            type: number
                            description: |-
                              *cv &#61; Standard Deviation of Engagement Rate/ Mean Engagement Rate* <br />
                              - The value is rounded to 4th decimal place. <br />
                              - Lower values indicate more consistent performance. <br />
                              - *A value of `0` indicates insufficient data.*
                            minimum: 0
                            examples:
                              - 0.5201
                          medianVsMean:
                            type: number
                            description: |-
                              *medianVsMean &#61; Median Engagement Rate/ Mean Engagement Rate* <br />
                              - The value is rounded to 4th decimal place. <br />
                              - Values closer to `1` indicate more consistent performance. <br />
                              - *A value of `0` indicates insufficient data.*
                            minimum: 0
                            examples:
                              - 0.9001
                          topBottomRatio:
                            type: number
                            description: |-
                              *topBottomRatio &#61; avg(Top 3 Engagement)/avg(Bottom 3 Engagement)* <br />
                              - The value is rounded to 4th decimal place. <br />
                              - Lower ratios indicate more consistent performance. <br />
                              - *A value of `0` indicates insufficient data.*
                            minimum: 0
                            examples:
                              - 1.2001
                          consistencyScore:
                            type:
                              - integer
                              - "null"
                            description: |-
                              *consistencyScore &#61; 100 - [(cvScore\*weight_cv) + (topBottomScore\*weight_topBottom) + (medianVsMeanScore\*weight_medianVsMean)]* <br />
                              - The score is rounded to an integer. <br />
                              - A higher score indicates more stable and consistent performance. <br />
                              - Returns `null` when any of the three indicators (`cv`, `medianVsMean`, `topBottomRatio`) is `0`, indicating insufficient data.
                            minimum: 0
                            maximum: 100
                            examples:
                              - 63
                          consistencyLevel:
                            type:
                              - string
                              - "null"
                            enum:
                              - high
                              - moderate
                              - low
                              - null
                            description: |-
                              A qualitative label based on the `consistencyScore`: <br />
                              - high: 81 - 100 <br />
                              - moderate: 51 - 80 <br />
                              - low: 1 - 50 <br />
                              - Returns `null` when `consistencyScore` is `null`, indicating insufficient data.
                            examples:
                              - moderate
                        required:
                          - cv
                          - medianVsMean
                          - topBottomRatio
                          - consistencyScore
                          - consistencyLevel
                    required:
                      - avgEngagementRate
                      - likesPerFollower
                      - commentsPerFollower
                      - viewsPerFollower
                      - engagementConsistency
                required:
                  - likes
                  - comments
                  - views
                  - engagement
            required:
              - timestamp
              - totalFollowers
              - totalFollowing
              - totalContents
              - imagesPerformanceRecent
              - reelsPerformanceRecent
      required:
        - histories
    TiktokProfileData:
      type: object
      description: "Profile information of the specified TikTok creator."
      properties:
        uniqueId:
          type: string
          description: "Account handle."
          examples:
            - tiktok
        displayName:
          type: string
          description: "Account name."
          examples:
            - TikTok
        category:
          type: string
          description: "Professional account category."
          examples:
            - BAKERY
        avatarUrl:
          type: string
          description: "Account profile picture URL."
          examples:
            - "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/"
        bio:
          type: string
          description: "The profile biography."
          examples:
            - "The #1 destination for short-form mobile videos."
        isBusinessAccount:
          type: boolean
          description: "`true` if it is a business account."
          examples:
            - false
        isPrivateAccount:
          type: boolean
          description: "`true` if it is a private account."
          examples:
            - false
        isVerified:
          type: boolean
          description: "`true` if the account is verified."
          examples:
            - true
        hasSponsors:
          type: boolean
          description: "`true` if there is sponsored content."
          examples:
            - true
        country:
          type: string
          description: "The country in **ISO 3166-1 alpha-3** format. For the country code list, see [here](https://docs.creatordb.app/api-v3/country-code)."
          examples:
            - GBR
        mainLanguage:
          type: string
          description: "The primary language used in posts, represented in **ISO 639-3** format. For the language code list, see [here](https://docs.creatordb.app/api-v3/language-code)."
          examples:
            - eng
        languages:
          type: array
          description: "All languages used in posts, represented in **ISO 639-3** format. For the language code list, see [here](https://docs.creatordb.app/api-v3/language-code)."
          examples:
            - - eng
              - zht
          items:
            type: string
        secondLanguage:
          type: string
          description: "The secondary language used in posts, represented in **ISO 639-3** format. For language code list, see [here](https://docs.creatordb.app/api-v3/language-code)."
          examples:
            - zht
        totalContents:
          type: integer
          description: "Total number of videos."
          minimum: 0
          examples:
            - 305
        totalFollowing:
          type: integer
          description: "Total number of accounts followed."
          minimum: 0
          examples:
            - 4757
        totalFollowers:
          type: integer
          description: "Total number of followers."
          minimum: 0
          examples:
            - 38100
        subscriberGrowth:
          type: object
          description: "Follower growth metrics over 7, 30, and 90-day periods."
          properties:
            g7:
              type: number
              description: "Follower growth over 7 days, rounded to 4th decimal place."
              examples:
                - 0.1234
            g30:
              type: number
              description: "Follower growth over 30 days, rounded to 4th decimal place."
              examples:
                - 0.2345
            g90:
              type: number
              description: "Follower growth over 90 days, rounded to 4th decimal place."
              examples:
                - 0.3456
          required:
            - g7
            - g30
            - g90
        hashtags:
          type: array
          description: "Hashtags used in TikTok posts and usage statistics."
          items:
            type: object
            description: "Hashtag information and usage statistics."
            properties:
              name:
                type: string
                description: "Hashtags used in post captions or descriptions."
                examples:
                  - "#foryoupage"
              contentCount:
                type: integer
                description: "Number of contents using the hashtag."
                minimum: 0
                examples:
                  - 250
            required:
              - name
              - contentCount
        topics:
          type: array
          description: "Content topics assigned by CreatorDB's AI model, which classifies creators into about 490 themes based on their content. Topics are broader than `niches`. Can be an empty array. For all available topics, call `/tiktok/topics`."
          examples:
            - - id_beauty_HowtoStyle_tiktok
          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:
            - - india_All
              - newyear_All
              - thailand_All
          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:
                  - string
              url:
                type: string
                description: "The profile or website URL."
                examples:
                  - url string
            required:
              - title
              - url
        lastPublishTime:
          type: integer
          description: "Time the last content was uploaded, represented as a Unix timestamp in milliseconds."
          examples:
            - 1753179002000
        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
    TiktokPerformanceData:
      type: object
      description: "The performance metrics."
      properties:
        contentCountByDays:
          type: object
          description: "Published TikTok content over different time intervals."
          properties:
            7d:
              type: integer
              description: "Number of contents published in the past 7 days."
              minimum: 0
              examples:
                - 4
            30d:
              type: integer
              description: "Number of contents published in the past 30 days."
              minimum: 0
              examples:
                - 13
            90d:
              type: integer
              description: "Number of contents published in the past 90 days."
              minimum: 0
              examples:
                - 45
          required:
            - 7d
            - 30d
            - 90d
        ranking:
          type: object
          description: "Percentile rankings for various performance metrics, benchmarked at the global, country, or language level. A value of `1.0` indicates top 1%, while `0.5` represents the median."
          properties:
            totalFollowers:
              type: object
              description: "Percentile rank of the total follower count."
              properties:
                global:
                  type: number
                  description: "Percentile rank compared to all creators in CreatorDB's database."
                  minimum: 0
                  maximum: 1
                  examples:
                    - 0.9912
                country:
                  type: number
                  description: "Percentile rank among creators from the same country."
                  minimum: 0
                  maximum: 1
                  examples:
                    - 0.9986
                language:
                  type: number
                  description: "Percentile rank among creators using the same primary language."
                  minimum: 0
                  maximum: 1
                  examples:
                    - 0.9764
              required:
                - global
                - country
                - language
            avgViews:
              type: object
              description: "Percentile rank of the average views per video."
              properties:
                global:
                  type: number
                  description: "Percentile rank compared to all creators in CreatorDB's database."
                  minimum: 0
                  maximum: 1
                  examples:
                    - 0.9912
                country:
                  type: number
                  description: "Percentile rank among creators from the same country."
                  minimum: 0
                  maximum: 1
                  examples:
                    - 0.9986
                language:
                  type: number
                  description: "Percentile rank among creators using the same primary language."
                  minimum: 0
                  maximum: 1
                  examples:
                    - 0.9764
              required:
                - global
                - country
                - language
            avgEngagementRate:
              type: object
              description: "Percentile rank of the average engagement rate."
              properties:
                global:
                  type: number
                  description: "Percentile rank compared to all creators in CreatorDB's database."
                  minimum: 0
                  maximum: 1
                  examples:
                    - 0.9912
                country:
                  type: number
                  description: "Percentile rank among creators from the same country."
                  minimum: 0
                  maximum: 1
                  examples:
                    - 0.9986
                language:
                  type: number
                  description: "Percentile rank among creators using the same primary language."
                  minimum: 0
                  maximum: 1
                  examples:
                    - 0.9764
              required:
                - global
                - country
                - language
          required:
            - totalFollowers
            - avgViews
            - avgEngagementRate
        videosPerformanceRecent:
          type: object
          description: "Performance metrics of the creator's recent TikTok videos."
          properties:
            likes:
              type: object
              properties:
                all:
                  type: integer
                  description: "Total number of likes."
                  minimum: 0
                  examples:
                    - 2944445
                avg:
                  type: integer
                  description: "Average likes per video, rounded to an integer."
                  minimum: 0
                  examples:
                    - 100
                median:
                  type: integer
                  description: "Median number of likes."
                  minimum: 0
                  examples:
                    - 48
                min:
                  type: integer
                  description: "Minimum number of likes."
                  minimum: 0
                  examples:
                    - 20
                max:
                  type: integer
                  description: "Maximum number of likes."
                  minimum: 0
                  examples:
                    - 149
              required:
                - all
                - avg
                - median
                - min
                - max
            comments:
              type: object
              properties:
                all:
                  type: integer
                  description: "Total number of comments."
                  minimum: 0
                  examples:
                    - 222344
                avg:
                  type: integer
                  description: "Average comments per video, rounded to an integer."
                  minimum: 0
                  examples:
                    - 100
                median:
                  type: integer
                  description: "Median number of comments."
                  minimum: 0
                  examples:
                    - 48
                min:
                  type: integer
                  description: "Minimum number of comments."
                  minimum: 0
                  examples:
                    - 20
                max:
                  type: integer
                  description: "Maximum number of comments."
                  minimum: 0
                  examples:
                    - 149
              required:
                - all
                - avg
                - median
                - min
                - max
            views:
              type: object
              properties:
                all:
                  type: integer
                  description: "Total number of views."
                  minimum: 0
                  examples:
                    - 3599
                avg:
                  type: integer
                  description: "Average views per video, rounded to an integer."
                  minimum: 0
                  examples:
                    - 100
                median:
                  type: integer
                  description: "Median number of views."
                  minimum: 0
                  examples:
                    - 48
                min:
                  type: integer
                  description: "Minimum number of views."
                  minimum: 0
                  examples:
                    - 20
                max:
                  type: integer
                  description: "Maximum number of views."
                  minimum: 0
                  examples:
                    - 149
              required:
                - all
                - avg
                - median
                - min
                - max
            shares:
              type: object
              properties:
                all:
                  type: integer
                  description: "Total number of shares."
                  minimum: 0
                  examples:
                    - 3599
                avg:
                  type: integer
                  description: "Average shares per video, rounded to an integer."
                  minimum: 0
                  examples:
                    - 100
                median:
                  type: integer
                  description: "Median number of shares."
                  minimum: 0
                  examples:
                    - 48
                min:
                  type: integer
                  description: "Minimum number of shares."
                  minimum: 0
                  examples:
                    - 20
                max:
                  type: integer
                  description: "Maximum number of shares."
                  minimum: 0
                  examples:
                    - 149
              required:
                - all
                - avg
                - median
                - min
                - max
            engagement:
              type: object
              description: "Engagement performance metrics including rates, per-follower statistics and consistency analysis."
              properties:
                avgEngagementRate:
                  type: number
                  description: |-
                    Average engagement rate per video, rounded to 4th decimal place. <br />
                    - *Engagement Rate &#61; (Likes + Comments + Shares)/ Views*
                  minimum: 0
                  examples:
                    - 0.5201
                likesPerFollower:
                  type: number
                  description: "Average likes per follower, rounded to 4th decimal place."
                  minimum: 0
                  examples:
                    - 0.1111
                commentsPerFollower:
                  type: number
                  description: "Average comments per follower, rounded to 4th decimal place."
                  minimum: 0
                  examples:
                    - 0.1111
                viewsPerFollower:
                  type: number
                  description: "Average views per follower, rounded to 4th decimal place."
                  minimum: 0
                  examples:
                    - 0.1111
                engagementConsistency:
                  type: object
                  description: "Consistency of engagement performance."
                  properties:
                    cv:
                      type: number
                      description: |-
                        *cv &#61; Standard Deviation of Engagement Rate/ Mean Engagement Rate* <br />
                        - The value is rounded to 4th decimal place. <br />
                        - Lower values indicate more consistent performance. <br />
                        - *A value of `0` indicates insufficient data.*
                      minimum: 0
                      examples:
                        - 0.1201
                    medianVsMean:
                      type: number
                      description: |-
                        *medianVsMean &#61; Median Engagement Rate/ Mean Engagement Rate* <br />
                        - The value is rounded to 4th decimal place <br />
                        - Values closer to `1` indicate more consistent performance. <br />
                        - *A value of `0` indicates insufficient data.*
                      minimum: 0
                      examples:
                        - 0.9001
                    topBottomRatio:
                      type: number
                      description: |-
                        *topBottomRatio &#61; avg(Top 3 Engagement)/avg(Bottom 3 Engagement)* <br />
                        - The value is rounded to 4th decimal place. <br />
                        - Lower ratios indicate more consistent performance. <br />
                        - *A value of `0` indicates insufficient data.*
                      minimum: 0
                      examples:
                        - 1.2001
                    consistencyScore:
                      type:
                        - integer
                        - "null"
                      description: |-
                        *consistencyScore &#61; 100 - [(cvScore\*weight_cv) + (topBottomScore\*weight_topBottom) + (medianVsMeanScore\*weight_medianVsMean)]* <br />
                        - The score is rounded to an integer. <br />
                        - A higher score indicates more stable and consistent performance. <br />
                        - If any of the three indicators is `0`, the `consistencyScore` will be `null`.
                      minimum: 0
                      maximum: 100
                      examples:
                        - 63
                    consistencyLevel:
                      type:
                        - string
                        - "null"
                      enum:
                        - high
                        - moderate
                        - low
                        - null
                      description: |-
                        A qualitative label based on the `consistencyScore`: <br />
                        - high: 81 - 100 <br />
                        - moderate: 51 - 80 <br />
                        - low: 0 - 50 <br />
                        - Returns `null` when the `consistencyScore` is `null`.
                      examples:
                        - moderate
                  required:
                    - cv
                    - medianVsMean
                    - topBottomRatio
                    - consistencyScore
                    - consistencyLevel
              required:
                - avgEngagementRate
                - likesPerFollower
                - commentsPerFollower
                - viewsPerFollower
                - engagementConsistency
          required:
            - likes
            - comments
            - views
            - shares
            - engagement
        recentVideosGrowth:
          type: object
          description: "Growth metrics for recent videos across 7, 30, and 90-day periods."
          properties:
            g7:
              type: object
              description: "Growth metrics over 7 days."
              properties:
                engagementRate:
                  type: number
                  description: "Growth rate of engagement rate, rounded to 4th decimal place."
                  examples:
                    - 0.0567
              required:
                - engagementRate
            g30:
              type: object
              description: "Growth metrics over 30 days."
              properties:
                engagementRate:
                  type: number
                  description: "Growth rate of engagement rate, rounded to 4th decimal place."
                  examples:
                    - 0.0567
              required:
                - engagementRate
            g90:
              type: object
              description: "Growth metrics over 90 days."
              properties:
                engagementRate:
                  type: number
                  description: "Growth rate of engagement rate, rounded to 4th decimal place."
                  examples:
                    - 0.0567
              required:
                - engagementRate
          required:
            - g7
            - g30
            - g90
    TiktokAudienceData:
      type: object
      description: "Returned audience demographic data of the specified TikTok account."
      properties:
        audienceLocations:
          type:
            - array
            - "null"
          description: "Country location of the audience, sorted by descending share."
          examples:
            - - country: TWN
                share: 0.6521
              - country: USA
                share: 0.0813
              - country: HKG
                share: 0.0501
          items:
            type: object
            description: "Country distribution of the audience."
            properties:
              country:
                type: string
                description: "The country in **ISO 3166-1 alpha-3** format. For details, see [Country Codes](http://docs.creatordb.app/api-v3/country-code)."
                examples:
                  - TWN
              share:
                type: number
                description: "Proportion of audience from that country, rounded to 4th decimal place."
                examples:
                  - 0.6521
            required:
              - country
              - share
        audienceGender:
          type:
            - object
            - "null"
          description: "Gender distribution of the audience."
          properties:
            maleRatio:
              type: number
              description: "Proportion of male audience, rounded to 4th decimal place."
              examples:
                - 0.3233
            femaleRatio:
              type: number
              description: "Proportion of female audience, rounded to 4th decimal place."
              examples:
                - 0.6412
          required:
            - maleRatio
            - femaleRatio
          examples:
            - maleRatio: 0.3233
              femaleRatio: 0.6412
        audienceAvgAge:
          type:
            - integer
            - "null"
          description: "Average age of the audience, rounded to an integer."
          examples:
            - 28
        audienceAgeBreakdown:
          type:
            - array
            - "null"
          description: "Distribution of the audience by age range."
          examples:
            - - ageRange: 13-17
                share: 0.0523
              - ageRange: 18-24
                share: 0.2871
              - ageRange: 25-34
                share: 0.3418
              - ageRange: 35-44
                share: 0.1825
              - ageRange: 45-54
                share: 0.0898
              - ageRange: 55-64
                share: 0.0312
              - ageRange: 65+
                share: 0.0153
          items:
            type: object
            description: "Age range distribution of the audience."
            properties:
              ageRange:
                type: string
                enum:
                  - 13-17
                  - 18-24
                  - 25-34
                  - 35-44
                  - 45-54
                  - 55-64
                  - 65+
                description: "Age group. <br /> Accepted values: `13-17`, `18-24`, `25-34`, `35-44`, `45-54`, `55-64`, `65+`"
                examples:
                  - 25-34
              share:
                type: number
                description: "Percentage of audience in a specific age group, rounded to 4th decimal place."
                examples:
                  - 0.0523
            required:
              - ageRange
              - share
    TiktokContactData:
      type: object
      description: "Contact information of the specified TikTok creator."
      properties:
        emails:
          type: array
          description: "Associated email addresses. Empty if unavailable."
          examples:
            - - example@email.com
          items:
            type: string
            format: email
      examples:
        - emails:
            - example@email.com
    TiktokContentDetailData:
      type: object
      description: "The TikTok content information."
      properties:
        recentVideos:
          type: array
          description: "Data of recent TikTok videos."
          items:
            type: object
            description: "A recent TikTok video."
            properties:
              publishTime:
                type: integer
                description: "Publish time, represented as a Unix timestamp in milliseconds."
                examples:
                  - 1703942994000
              contentId:
                type: string
                description: "The unique identifier. Represented as follows: `https://www.tiktok.com/@{uniqueId}/video/{contentId}`"
                examples:
                  - "7318379374288424225"
              description:
                type: string
                description: "The video caption, including emojis, hashtags, and line breaks."
                examples:
                  - "hope everyone is having a nice day! ✨\U0001F90D #xmas #christmas #xmas2023 #tryon #foryoupage #fyp #foryou"
              coverImageUrl:
                type: string
                description: "URL of the video cover image or thumbnail."
                examples:
                  - "https://p19-common-sign-useastred.tiktokcdn-eu.com/..."
              isAd:
                type: boolean
                description: "`true` if it is an ad."
                examples:
                  - false
              length:
                type: integer
                description: "Video length in seconds."
                minimum: 0
                examples:
                  - 11
              likes:
                type: integer
                description: "Number of likes."
                minimum: 0
                examples:
                  - 239
              comments:
                type: integer
                description: "Number of comments."
                minimum: 0
                examples:
                  - 7
              views:
                type: integer
                description: "Number of views."
                minimum: 0
                examples:
                  - 1947
              shares:
                type: integer
                description: "Number of shares."
                minimum: 0
                examples:
                  - 1
              engagementRate:
                type: number
                description: "Engagement rate of the video, rounded to 4th decimal place. <br />
                  - *Engagement Rate &#61; (Likes + Comments + Shares)/ Views*"
                examples:
                  - 0.1269
              hashtags:
                type: array
                description: "Keywords used in the video caption or description."
                examples:
                  - - "#xmas"
                    - "#tryon"
                items:
                  type: string
              audioId:
                type: string
                description: "Unique identifier of the audio track in the content."
                examples:
                  - "7318379374288424225"
              audioTitle:
                type: string
                description: "Title of the audio track."
                examples:
                  - original sound - User
              audioAuthor:
                type: string
                description: "Artist of the audio track."
                examples:
                  - User
              audioAlbum:
                type: string
                description: "Album name of the audio track."
                examples:
                  - ""
              isDuetEnabled:
                type: boolean
                description: "`true` if duet is enabled."
                examples:
                  - true
            required:
              - publishTime
              - contentId
              - description
              - coverImageUrl
              - isAd
              - length
              - likes
              - comments
              - views
              - shares
              - engagementRate
              - hashtags
              - audioId
              - audioTitle
              - audioAuthor
              - audioAlbum
              - isDuetEnabled
    TiktokPerformanceHistoryData:
      type: object
      description: "The historical performance metrics of the specified TikTok account."
      properties:
        histories:
          type: array
          description: "Historical performance snapshots, each containing metrics, and a corresponding Unix timestamp in milliseconds."
          items:
            type: object
            description: "A snapshot of the performance metrics on the specified date."
            properties:
              timestamp:
                type: integer
                description: "The performance snapshot date, represented as a Unix timestamp in milliseconds."
                exclusiveMinimum: 0
                examples:
                  - 1755273600000
              totalFollowers:
                type: integer
                description: "Total number of followers."
                minimum: 0
                examples:
                  - 38100
              totalFollowing:
                type: integer
                description: "Total number of accounts followed."
                minimum: 0
                examples:
                  - 4757
              totalContents:
                type: integer
                description: "Total number of videos."
                minimum: 0
                examples:
                  - 305
              videosPerformanceRecent:
                type: object
                description: "Performance metrics of the most recent TikTok videos."
                properties:
                  likes:
                    type: object
                    properties:
                      all:
                        type: integer
                        description: "Total number of likes."
                        minimum: 0
                        examples:
                          - 2944445
                      avg:
                        type: integer
                        description: "Average likes per video, rounded to an integer."
                        minimum: 0
                        examples:
                          - 100
                      median:
                        type: integer
                        description: "Median number of likes."
                        minimum: 0
                        examples:
                          - 48
                      min:
                        type: integer
                        description: "Minimum number of likes."
                        minimum: 0
                        examples:
                          - 20
                      max:
                        type: integer
                        description: "Maximum number of likes."
                        minimum: 0
                        examples:
                          - 149
                    required:
                      - all
                      - avg
                      - median
                      - min
                      - max
                  comments:
                    type: object
                    properties:
                      all:
                        type: integer
                        description: "Total number of comments."
                        minimum: 0
                        examples:
                          - 222344
                      avg:
                        type: integer
                        description: "Average comments per video, rounded to an integer."
                        minimum: 0
                        examples:
                          - 100
                      median:
                        type: integer
                        description: "Median number of comments."
                        minimum: 0
                        examples:
                          - 48
                      min:
                        type: integer
                        description: "Minimum number of comments."
                        minimum: 0
                        examples:
                          - 20
                      max:
                        type: integer
                        description: "Maximum number of comments."
                        minimum: 0
                        examples:
                          - 149
                    required:
                      - all
                      - avg
                      - median
                      - min
                      - max
                  views:
                    type: object
                    properties:
                      all:
                        type: integer
                        description: "Total number of views."
                        minimum: 0
                        examples:
                          - 3599
                      avg:
                        type: integer
                        description: "Average views per video, rounded to an integer."
                        minimum: 0
                        examples:
                          - 100
                      median:
                        type: integer
                        description: "Median number of views."
                        minimum: 0
                        examples:
                          - 48
                      min:
                        type: integer
                        description: "Minimum number of views."
                        minimum: 0
                        examples:
                          - 20
                      max:
                        type: integer
                        description: "Maximum number of views."
                        minimum: 0
                        examples:
                          - 149
                    required:
                      - all
                      - avg
                      - median
                      - min
                      - max
                  shares:
                    type: object
                    properties:
                      all:
                        type: integer
                        description: "Total number of shares."
                        minimum: 0
                        examples:
                          - 3599
                      avg:
                        type: integer
                        description: "Average shares per video, rounded to an integer."
                        minimum: 0
                        examples:
                          - 100
                      median:
                        type: integer
                        description: "Median number of shares."
                        minimum: 0
                        examples:
                          - 48
                      min:
                        type: integer
                        description: "Minimum number of shares."
                        minimum: 0
                        examples:
                          - 20
                      max:
                        type: integer
                        description: "Maximum number of shares."
                        minimum: 0
                        examples:
                          - 149
                    required:
                      - all
                      - avg
                      - median
                      - min
                      - max
                  engagement:
                    type: object
                    description: "Engagement performance metrics including rates, per-follower statistics, and consistency analysis."
                    properties:
                      avgEngagementRate:
                        type: number
                        description: |-
                          Average engagement rate per video, rounded to 4th decimal place. <br />
                            - *Engagement Rate &#61; (Likes + Comments + Shares)/ Views*
                        minimum: 0
                        examples:
                          - 0.5201
                      likesPerFollower:
                        type: number
                        description: "Average likes per follower, rounded to 4th decimal place."
                        minimum: 0
                        examples:
                          - 0.1111
                      commentsPerFollower:
                        type: number
                        description: "Average comments per follower, rounded to 4th decimal place."
                        minimum: 0
                        examples:
                          - 0.1111
                      viewsPerFollower:
                        type: number
                        description: "Average views per follower, rounded to 4th decimal place."
                        minimum: 0
                        examples:
                          - 0.1111
                      engagementConsistency:
                        type: object
                        description: "Consistency of engagement performance."
                        properties:
                          cv:
                            type: number
                            description: |-
                              *cv &#61; Standard Deviation of Engagement Rate/ Mean Engagement Rate* <br />
                              - The value is rounded to 4th decimal place. <br />
                              - Lower values indicate more consistent performance. <br />
                              - *A value of `0` indicates insufficient data.*
                            minimum: 0
                            examples:
                              - 0.1201
                          medianVsMean:
                            type: number
                            description: |-
                              *medianVsMean &#61; Median Engagement Rate/ Mean Engagement Rate* <br />
                              - The value is rounded to 4th decimal place. <br />
                              - Values closer to `1` indicate more consistent performance. <br />
                              - *A value of `0` indicates insufficient data.*
                            minimum: 0
                            examples:
                              - 0.9001
                          topBottomRatio:
                            type: number
                            description: |-
                              *topBottomRatio &#61; avg(Top 3 Engagement)/avg(Bottom 3 Engagement)* <br />
                              - The value is rounded to 4th decimal place. <br />
                              - Lower ratios indicate more consistent performance. <br />
                              - *A value of `0` indicates insufficient data.*
                            minimum: 0
                            examples:
                              - 1.2001
                          consistencyScore:
                            type:
                              - integer
                              - "null"
                            description: |-
                              *consistencyScore &#61; 100 - [(cvScore*weight_cv) + (topBottomScore*weight_topBottom) + (medianVsMeanScore*weight_medianVsMean)]* <br />
                              - The score is rounded to an integer. <br />
                              - A higher score indicates more stable and consistent performance. <br />
                              - If any of the three indicators is `0`, the `consistencyScore` will be `null`.
                            minimum: 0
                            maximum: 100
                            examples:
                              - 63
                          consistencyLevel:
                            type:
                              - string
                              - "null"
                            enum:
                              - high
                              - moderate
                              - low
                              - null
                            description: |-
                              A qualitative label based on the `consistencyScore`: <br />
                              - high: 81 - 100 <br />
                              - moderate: 51 - 80 <br />
                              - low: 0 - 50 <br />
                              - Returns `null` when `consistencyScore` is `null`.
                            examples:
                              - moderate
                        required:
                          - cv
                          - medianVsMean
                          - topBottomRatio
                          - consistencyScore
                          - consistencyLevel
                    required:
                      - avgEngagementRate
                      - likesPerFollower
                      - commentsPerFollower
                      - viewsPerFollower
                      - engagementConsistency
                required:
                  - likes
                  - comments
                  - views
                  - shares
                  - engagement
            required:
              - timestamp
              - totalFollowers
              - totalFollowing
              - totalContents
              - videosPerformanceRecent
      required:
        - histories
security:
  - ApiKeyAuth: []

# END