> ## Documentation Index
> Fetch the complete documentation index at: https://docs.creatordb.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Get a Brand's Daily Sponsorship Activity Over Time

> Returns a brand's daily sponsorship activity over the requested `pastDayRange`, as one time series per platform:

- `youtubeActivity` tracks the brand's sponsored YouTube videos and the views they gained.
- `instagramActivity` describes the creators who posted sponsored content for the brand on Instagram.

Neither series includes activity from the brand's own accounts or combines both platforms. For cross-platform totals, use `/sponsor/summary`. Each series is sorted by date in ascending order.

**Billing is based on the number of days returned (`coverage.daysReturned`), not on `pastDayRange`.**

- 1–7 days cost 3 credits.
- 8–30 days cost 3.5 credits.
- 31–90 days cost 4 credits.
- 91–180 days cost 4.5 credits.
- 181–400 days cost 5 credits.
- A brand with no history returns empty arrays and isn't charged.

For details, see [API Credit Usage](/api-v3/api-credit-usage#sponsors).

`daysReturned` is at most `pastDayRange`. The range includes today, and today's snapshot is added once a day, so a call made before it's recorded returns at most `pastDayRange - 1` days. Days without a snapshot lower it further.

A `brandId` that isn't in CreatorDB returns a `404` error. This endpoint has no `fields` parameter and always returns the whole response. Sending `fields`, or any other unknown parameter, returns a `400` error (`VALIDATION_ERROR`) and isn't charged.




## OpenAPI

````yaml /api-v3/api-v3.yaml get /sponsor/history
openapi: 3.1.0
info:
  version: 1.0.0
  title: CreatorDB Headless API V3
  description: '# CreatorDB Headless API V3'
  contact:
    name: CreatorDB
    url: https://www.creatordb.app
    email: support@creatordb.app
  license:
    url: http://www.apache.org/licenses/LICENSE-2.0.html
    name: Apache 2.0
servers:
  - url: https://apiv3.creatordb.app
    description: Production Environment (CreatorDB Headless API V3)
security:
  - ApiKeyAuth: []
tags:
  - name: Creator
    description: >-
      Cross-platform creator endpoints. Each result is one creator, with their
      linked YouTube, Instagram, and TikTok accounts grouped together.
  - 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.
paths:
  /sponsor/history:
    get:
      tags:
        - Sponsor
      summary: Get a Brand's Daily Sponsorship Activity Over Time
      description: >
        Returns a brand's daily sponsorship activity over the requested
        `pastDayRange`, as one time series per platform:


        - `youtubeActivity` tracks the brand's sponsored YouTube videos and the
        views they gained.

        - `instagramActivity` describes the creators who posted sponsored
        content for the brand on Instagram.


        Neither series includes activity from the brand's own accounts or
        combines both platforms. For cross-platform totals, use
        `/sponsor/summary`. Each series is sorted by date in ascending order.


        **Billing is based on the number of days returned
        (`coverage.daysReturned`), not on `pastDayRange`.**


        - 1–7 days cost 3 credits.

        - 8–30 days cost 3.5 credits.

        - 31–90 days cost 4 credits.

        - 91–180 days cost 4.5 credits.

        - 181–400 days cost 5 credits.

        - A brand with no history returns empty arrays and isn't charged.


        For details, see [API Credit Usage](/api-v3/api-credit-usage#sponsors).


        `daysReturned` is at most `pastDayRange`. The range includes today, and
        today's snapshot is added once a day, so a call made before it's
        recorded returns at most `pastDayRange - 1` days. Days without a
        snapshot lower it further.


        A `brandId` that isn't in CreatorDB returns a `404` error. This endpoint
        has no `fields` parameter and always returns the whole response. Sending
        `fields`, or any other unknown parameter, returns a `400` error
        (`VALIDATION_ERROR`) and isn't charged.
      operationId: getSponsorHistory
      parameters:
        - name: brandId
          in: query
          required: true
          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
          schema:
            type: string
            minLength: 1
            pattern: ^[a-zA-Z0-9._-]+$
        - name: pastDayRange
          in: query
          required: true
          description: >-
            Number of days of history to return, counting back from today (UTC),
            today included. A whole number from `1` to `400`, without leading
            zeros. Other values return a `400` error, for example `pastDayRange
            must be between 1 and 400 days`. You're billed on the days actually
            returned, which can be fewer.
          example: '90'
          schema:
            type: string
            pattern: ^(0|[1-9]\d*)$
      responses:
        '200':
          description: Brand historical sponsorship data returned successfully.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      brandId:
                        type: string
                        description: >-
                          The brand ID. A brand ID is the brand's website
                          domain.
                        example: acer.com
                      coverage:
                        type: object
                        properties:
                          from:
                            type:
                              - string
                              - 'null'
                            description: >-
                              First date with data in either `youtubeActivity`
                              or `instagramActivity`, in `YYYY-MM-DD` format.
                              `null` if no days are returned.
                            example: '2026-06-13'
                          to:
                            type:
                              - string
                              - 'null'
                            description: >-
                              Last date with data in either `youtubeActivity` or
                              `instagramActivity`, in `YYYY-MM-DD` format.
                              `null` if no days are returned.
                            example: '2026-09-09'
                          daysReturned:
                            type: integer
                            minimum: 0
                            description: >-
                              Number of distinct dates present in either
                              `youtubeActivity` or `instagramActivity`. This is
                              the number you're billed on. Can be less than the
                              number of days from `from` to `to`, inclusive,
                              because days without a snapshot are left out.
                            example: 89
                          daysRequested:
                            type: integer
                            minimum: 1
                            description: The requested `pastDayRange`.
                            example: 90
                        required:
                          - from
                          - to
                          - daysReturned
                          - daysRequested
                        description: >-
                          The range actually returned, compared with the range
                          requested. Contains the returned dates (`from`, `to`)
                          and both day counts (`daysReturned`, `daysRequested`).
                      youtubeActivity:
                        type: array
                        items:
                          type: object
                          properties:
                            date:
                              type: string
                              description: >-
                                Date of this daily snapshot, in `YYYY-MM-DD`
                                format (UTC). Most fields are totals as of this
                                date; `sponsoredContentToday` and
                                `newViewsToday` are changes since the previous
                                snapshot.
                              example: '2026-09-09'
                            sponsoredContentToday:
                              type: integer
                              description: >-
                                Change in `totalSponsoredContent` since the
                                previous snapshot. A video is counted when
                                CreatorDB matches it to the brand, which isn't
                                necessarily the day it was published. Negative
                                when videos counted before no longer are, for
                                example because they were deleted or are no
                                longer matched to the brand. After a gap of 1 or
                                2 days, the value covers the whole gap. Known
                                issue: after a gap of 3 or more days, the first
                                day back shows the full total instead of the
                                change. Don't sum this field across days. To get
                                the change over a period, subtract the earlier
                                `totalSponsoredContent` from the later one.
                              example: 3
                            newViewsToday:
                              type: integer
                              description: >-
                                Change in `totalViews` since the previous
                                snapshot. Includes new views on older videos,
                                not only on videos published on this date.
                                Negative when videos that are no longer counted
                                remove more views from the total than the
                                remaining videos gained. After a gap of 1 or 2
                                days, the value covers the whole gap. Known
                                issue: after a gap of 3 or more days, the first
                                day back shows the full total instead of the
                                change. Don't sum this field across days. To get
                                the change over a period, subtract the earlier
                                `totalViews` from the later one.
                              example: 45120
                            sponsoringCreators:
                              type: integer
                              description: >-
                                Number of distinct YouTube creators with
                                sponsored content for this brand, as of this
                                date. This is a total as of this date, not a
                                daily change. It can go down when content is
                                deleted or no longer matched to the brand. For
                                the cross-platform total, see
                                `totalSponsoredCreators` on `/sponsor/summary`.
                              example: 512
                            totalSponsoredContent:
                              type: integer
                              description: >-
                                Number of sponsored YouTube videos for this
                                brand, as of this date. This is a total as of
                                this date, not a daily change. It can go down
                                when content is deleted or no longer matched to
                                the brand. For the cross-platform total, see the
                                field with the same name on `/sponsor/summary`.
                              example: 4210
                            totalViews:
                              type: integer
                              description: >-
                                Total views across all sponsored YouTube videos,
                                as of this date. This is a total as of this
                                date, not a daily change. It can go down when
                                content is deleted or no longer matched to the
                                brand.
                              example: 982340118
                            views1d:
                              type: integer
                              description: >-
                                Sum of each sponsored YouTube video's estimated
                                views in its first day after publishing, as of
                                this date. Each video's estimate is taken once,
                                scaled from its views when CreatorDB first saw
                                it 1 to 6 days after publishing. Videos
                                CreatorDB didn't see in that window aren't
                                included. `views1d`, `views7d`, and `views30d`
                                each include a different set of videos, so don't
                                compare them directly.
                              example: 12043221
                            views7d:
                              type: integer
                              description: >-
                                Sum of each sponsored YouTube video's estimated
                                views in its first 7 days after publishing, as
                                of this date. Each video's estimate is taken
                                once, scaled from its views when CreatorDB first
                                saw it 7 to 29 days after publishing. Videos
                                CreatorDB didn't see in that window aren't
                                included. `views1d`, `views7d`, and `views30d`
                                each include a different set of videos, so don't
                                compare them directly.
                              example: 48210338
                            views30d:
                              type: integer
                              description: >-
                                Sum of each sponsored YouTube video's estimated
                                views in its first 30 days after publishing, as
                                of this date. Each video's estimate is taken
                                once, scaled from its views when CreatorDB first
                                saw it 30 to 89 days after publishing. Videos
                                CreatorDB didn't see in that window aren't
                                included. `views1d`, `views7d`, and `views30d`
                                each include a different set of videos, so don't
                                compare them directly.
                              example: 91203441
                            sponsoredContent30d:
                              type: integer
                              description: >-
                                Number of the brand's sponsored YouTube videos
                                published in the 30 days up to this date. The
                                window rolls, so the count drops as videos age
                                out.
                              example: 87
                            views30dTotal:
                              type: integer
                              description: >-
                                Total views, as of this date, of the videos
                                counted in `sponsoredContent30d`. Not the same
                                as `views30d`, which estimates each video's
                                views in its first 30 days.
                              example: 20114552
                            sponsoredContent1y:
                              type: integer
                              description: >-
                                Number of the brand's sponsored YouTube videos
                                published in the 365 days up to this date. The
                                window rolls, so the count drops as videos age
                                out.
                              example: 1043
                            views1yTotal:
                              type: integer
                              description: >-
                                Total views, as of this date, of the videos
                                counted in `sponsoredContent1y`.
                              example: 302118904
                            likes:
                              type: integer
                              description: >-
                                Total likes across the brand's sponsored YouTube
                                videos, as of this date. This is a total as of
                                this date, not a daily change. It can go down
                                when content is deleted or no longer matched to
                                the brand.
                              example: 21043118
                            comments:
                              type: integer
                              description: >-
                                Total comments across the brand's sponsored
                                YouTube videos, as of this date. This is a total
                                as of this date, not a daily change. It can go
                                down when content is deleted or no longer
                                matched to the brand.
                              example: 1204331
                            avgViews:
                              type: integer
                              description: >-
                                Average views per sponsored YouTube video as of
                                this date (`totalViews` ÷
                                `totalSponsoredContent`), rounded to the nearest
                                whole number.
                              example: 233335
                            avgLikes:
                              type: integer
                              description: >-
                                Average likes per sponsored YouTube video as of
                                this date (`likes` ÷ `totalSponsoredContent`),
                                rounded to the nearest whole number.
                              example: 4998
                            avgComments:
                              type: integer
                              description: >-
                                Average comments per sponsored YouTube video as
                                of this date (`comments` ÷
                                `totalSponsoredContent`), rounded to the nearest
                                whole number.
                              example: 286
                            avgEngagementRate:
                              type: number
                              description: >-
                                Average of each sponsored YouTube video's
                                engagement rate ((likes + comments) ÷ views), as
                                of this date, as a decimal fraction (for
                                example, 0.05 = 5%). A mean of per-video rates,
                                not total engagements ÷ total views. Not
                                rounded.
                              example: 0.05382738175942084
                          required:
                            - date
                            - sponsoredContentToday
                            - newViewsToday
                            - sponsoringCreators
                            - totalSponsoredContent
                            - totalViews
                            - views1d
                            - views7d
                            - views30d
                            - sponsoredContent30d
                            - views30dTotal
                            - sponsoredContent1y
                            - views1yTotal
                            - likes
                            - comments
                            - avgViews
                            - avgLikes
                            - avgComments
                            - avgEngagementRate
                          description: >
                            One day of the brand's YouTube sponsorship activity,
                            as recorded on that date. Every figure counts
                            sponsored YouTube videos only. Instagram activity is
                            in `instagramActivity`.


                            Fields in each entry are one of four kinds:


                            - **Daily changes** since the previous day:
                            `sponsoredContentToday`, `newViewsToday`.

                            - **Rolling windows** over the days before this
                            date: `sponsoredContent30d`, `views30dTotal`,
                            `sponsoredContent1y`, `views1yTotal`. These can
                            decrease as older content leaves the window.

                            - **Averages** across all of the brand's sponsored
                            videos to date: `avgViews`, `avgLikes`,
                            `avgComments`, `avgEngagementRate`.

                            - **Totals** as of this date: all other counts.
                            These can go down when content is deleted or no
                            longer matched to the brand.
                        description: >-
                          Daily snapshots of the brand's YouTube sponsorship
                          activity, recorded by CreatorDB and sorted by date in
                          ascending order. Days without a snapshot are left out,
                          not returned as entries with zero values, so dates may
                          not be continuous. A day with no new sponsored videos
                          is still returned. Left-out days aren't billed.
                      instagramActivity:
                        type: array
                        items:
                          type: object
                          properties:
                            date:
                              type: string
                              description: >-
                                Date of this daily snapshot, in `YYYY-MM-DD`
                                format (UTC).
                              example: '2026-09-09'
                            followers:
                              type: number
                              description: >-
                                Average number of followers across the Instagram
                                creators with sponsored content for this brand,
                                as of this date. Averaged over the creators
                                counted in `sponsoringCreators`.
                              example: 1204338
                            following:
                              type: number
                              description: >-
                                Average number of accounts followed, across the
                                Instagram creators with sponsored content for
                                this brand, as of this date. Averaged over the
                                creators counted in `sponsoringCreators`.
                              example: 412
                            totalPosts:
                              type: number
                              description: >-
                                Average number of posts per creator, across the
                                Instagram creators with sponsored content for
                                this brand, as of this date. Counts all of each
                                creator's posts, not only sponsored ones.
                                Averaged over the creators counted in
                                `sponsoringCreators`.
                              example: 3841
                            sponsoringCreators:
                              type: integer
                              description: >-
                                Number of distinct Instagram creators with
                                sponsored posts for this brand, as of this date.
                                This is a total as of this date, not a daily
                                change. It can go down when content is deleted
                                or no longer matched to the brand. Used as the
                                denominator for `followers`, `following`, and
                                `totalPosts`. For the cross-platform total, see
                                `totalSponsoredCreators` on `/sponsor/summary`.
                              example: 3
                            totalSponsoredContent:
                              type: integer
                              description: >-
                                Number of sponsored Instagram posts recorded by
                                CreatorDB for this brand, as of this date. This
                                is a total as of this date, not a daily change.
                                It can go down when content is deleted or no
                                longer matched to the brand. Used as the
                                denominator for `avgLikes`, `avgComments`, and
                                `avgPlays`. For the cross-platform total, see
                                the field of the same name on
                                `/sponsor/summary`.
                              example: 12
                            avgLikes:
                              type: number
                              description: >-
                                Average likes per sponsored Instagram post,
                                across every sponsored post CreatorDB has
                                recorded for this brand as of this date.
                                Averaged over the posts counted in
                                `totalSponsoredContent`, not only posts
                                published on this date. Recalculated daily, so
                                the value can change on days with no new posts.
                              example: 2043.5
                            avgComments:
                              type: number
                              description: >-
                                Average comments per sponsored Instagram post,
                                across every sponsored post CreatorDB has
                                recorded for this brand as of this date.
                                Averaged over the posts counted in
                                `totalSponsoredContent`, not only posts
                                published on this date. Recalculated daily, so
                                the value can change on days with no new posts.
                              example: 35.5
                            avgPlays:
                              type: number
                              description: >-
                                Average plays per sponsored Instagram post,
                                across every sponsored post CreatorDB has
                                recorded for this brand as of this date
                                (`totalSponsoredContent`), not Reels only. Known
                                issue: usually `0`, so don't rely on it yet.
                              example: 0
                          required:
                            - date
                            - followers
                            - following
                            - totalPosts
                            - sponsoringCreators
                            - totalSponsoredContent
                            - avgLikes
                            - avgComments
                            - avgPlays
                          description: >-
                            One day of the brand's Instagram sponsorship
                            activity, as recorded on that date. Every figure
                            describes the creators who posted sponsored
                            Instagram content for the brand, not an Instagram
                            account the brand owns. YouTube activity is in
                            `youtubeActivity`.
                        description: >-
                          Daily snapshots of the brand's Instagram sponsorship
                          activity, recorded by CreatorDB and sorted by date in
                          ascending order. Days without a snapshot are left out,
                          not returned as entries with zero values, so dates may
                          not be continuous. A day is also left out when
                          CreatorDB had no sponsored Instagram posts for the
                          brand that day, so this series can be shorter than
                          `youtubeActivity`, or empty.
                    required:
                      - brandId
                      - coverage
                      - youtubeActivity
                      - instagramActivity
                    description: >-
                      The brand's sponsorship history, with the brand ID, the
                      range of days returned, and one daily series per platform.
                  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.
                    example: 900
                  purchasedCreditsAvailable:
                    type: number
                    description: Purchased credits remaining after this request.
                    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: >-
                  Sponsor History API response. Contains sponsor history in
                  data, along with credit usage, trace info, and error details.
        '400':
          description: >-
            The request is invalid, for example `pastDayRange` is outside
            `1`–`400`, or the request includes an unknown parameter such as
            `fields`. `details` lists each problem. Nothing is charged.
          content:
            application/json:
              schema:
                type: object
                title: BadRequestErrorResponse
                properties:
                  success:
                    const: false
                  error:
                    type: string
                    enum:
                      - ValidationError
                    description: >-
                      The type of error. Use `errorCode` to handle errors in
                      your code.
                  message:
                    type: string
                    description: Summary of the error. Always `Request validation failed`.
                  errorCode:
                    type: string
                    enum:
                      - VALIDATION_ERROR
                  traceId:
                    type: string
                    description: Unique trace ID for each request.
                  timestamp:
                    type: integer
                    description: >-
                      Time the response was generated, represented as a Unix
                      timestamp in milliseconds.
                  details:
                    type: array
                    description: One entry for each problem found.
                    items:
                      type: object
                      properties:
                        field:
                          type: string
                          description: >-
                            Name of the query parameter with the problem.
                            `unknown` when the problem isn't tied to one
                            parameter, such as an unrecognized parameter.
                        message:
                          type: string
                          description: Description of the problem.
                        value:
                          type: string
                          description: >-
                            The value received, when relevant. For example,
                            `Received: undefined` for a missing parameter.
                      required:
                        - field
                        - message
                required:
                  - success
                  - error
                  - message
                  - errorCode
                  - traceId
                  - timestamp
                  - details
              examples:
                invalid pastDayRange:
                  summary: pastDayRange out of bounds
                  value:
                    success: false
                    error: ValidationError
                    message: Request validation failed
                    errorCode: VALIDATION_ERROR
                    traceId: c4e5af55f3bb9d11cc20481bfc80c1df
                    timestamp: 1791959292593
                    details:
                      - field: pastDayRange
                        message: pastDayRange must be between 1 and 400 days
                unknown parameter:
                  summary: Unknown parameter such as fields
                  value:
                    success: false
                    error: ValidationError
                    message: Request validation failed
                    errorCode: VALIDATION_ERROR
                    traceId: c4e5af55f3bb9d11cc20481bfc80c1df
                    timestamp: 1791959292593
                    details:
                      - field: unknown
                        message: 'Unrecognized key: "fields"'
        '402':
          description: >-
            Insufficient credits, or the API key has reached its spend limit.
            Nothing is charged.
          content:
            application/json:
              schema:
                type: object
                title: PaymentRequiredErrorResponse
                properties:
                  success:
                    const: false
                  error:
                    type: string
                    description: >-
                      The type of error. Use `errorCode` to handle errors in
                      your code.
                  message:
                    type: string
                  errorCode:
                    type: string
                    enum:
                      - INSUFFICIENT_CREDITS
                      - KEY_SPEND_THRESHOLD_EXCEEDED
                  traceId:
                    type: string
                  timestamp:
                    type: integer
                  details:
                    type: object
                    properties:
                      creditsAvailable:
                        type: number
                        description: >-
                          For `INSUFFICIENT_CREDITS`, your remaining credit
                          balance. For `KEY_SPEND_THRESHOLD_EXCEEDED`, the
                          credits remaining under this key's spend limit.
                      creditsUsed:
                        type: number
                        description: Always `0`.
                required:
                  - success
                  - error
                  - message
                  - errorCode
                  - traceId
                  - timestamp
                  - details
              examples:
                insufficient credits:
                  summary: Credit balance exhausted
                  value:
                    success: false
                    error: PaymentRequiredError
                    message: Insufficient credits
                    errorCode: INSUFFICIENT_CREDITS
                    traceId: c4e5af55f3bb9d11cc20481bfc80c1df
                    timestamp: 1791959292593
                    details:
                      creditsAvailable: 0
                      creditsUsed: 0
                key spend limit:
                  summary: API key spend limit reached
                  value:
                    success: false
                    error: PaymentRequiredError
                    message: API key spending limit exceeded
                    errorCode: KEY_SPEND_THRESHOLD_EXCEEDED
                    traceId: c4e5af55f3bb9d11cc20481bfc80c1df
                    timestamp: 1791959292593
                    details:
                      creditsAvailable: 0
                      creditsUsed: 0
        '404':
          description: No brand with this `brandId` is in CreatorDB.
          content:
            application/json:
              schema:
                type: object
                title: NotFoundErrorResponse
                properties:
                  success:
                    const: false
                  error:
                    type: string
                    description: >-
                      The type of error. Use `errorCode` to handle errors in
                      your code.
                  message:
                    type: string
                  errorCode:
                    type: string
                    enum:
                      - NOT_FOUND
                  traceId:
                    type: string
                  timestamp:
                    type: integer
                required:
                  - success
                  - error
                  - message
                  - errorCode
                  - traceId
                  - timestamp
              examples:
                brand not found:
                  summary: Brand not found
                  value:
                    success: false
                    error: NotFoundError
                    message: Brand 'no-such-brand-9q7x.com' not found
                    errorCode: NOT_FOUND
                    traceId: 22ffa847b4d0bcad08d250f165936c3b
                    timestamp: 1791959292593
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      description: The valid CreatorDB API key for authentication.
      name: api-key
      in: header

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.