> ## 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.
# Search Brands
> 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.
## OpenAPI
````yaml /api-v3/api-v3.yaml post /sponsor/search
openapi: 3.1.0
info:
version: 1.0.0
title: CreatorDB Headless API V3
description: '# CreatorDB Headless API V3'
contact:
name: CreatorDB
url: https://www.creatordb.app
email: support@creatordb.app
license:
url: http://www.apache.org/licenses/LICENSE-2.0.html
name: Apache 2.0
servers:
- url: https://apiv3.creatordb.app
description: Production Environment (CreatorDB Headless API V3)
security:
- ApiKeyAuth: []
tags:
- name: Brand
description: Brand analysis endpoints including sponsor search and brand reports.
- name: Facebook
description: Facebook creator data endpoints with metrics and search capabilities.
- name: General Operations
description: >-
General-purpose endpoints such as API status, content retrieval, and
cross-platform operations.
- name: Instagram
description: >-
Instagram creator data endpoints with metrics and advanced search
capabilities.
- name: Niches
description: >-
Niche-related endpoints for content category analysis and related
searches.
- name: Threads
description: Threads creator data endpoints with basic metrics and historical data.
- name: TikTok
description: >-
TikTok creator data endpoints with metrics and advanced search
functionality.
- name: Topic
description: Topic-based analysis and reporting endpoints for content categorization.
- name: YouTube
description: >-
YouTube creator data endpoints including basic metrics, historical data,
and detailed analytics.
paths:
/sponsor/search:
post:
tags:
- Sponsor
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
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`, `>`, `=`, `<`.
-String fields accept:
`=`, `in`.
Number fields accept: `>`, `=`,
`<`.
Boolean fields accept: `=`
value:
anyOf:
- type: string
- type: number
- type: array
maxItems: 100
items:
type: string
- 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
description: >-
When `true`, performs a fuzzy match for `string` type
`filterName`.
default: false
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#available-filtername-&-sortby).
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
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
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.
example: 975
creditsUsed:
type: number
description: Number of API credits consumed by this request.
example: 25
errorCode:
type: string
description: >-
Error code returned if the request fails. Empty if the
request 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
- errorCode
- errorDescription
- success
description: >-
Sponsor Search API response. Contains search results in data,
along with credit usage, trace info, and error details.
components:
securitySchemes:
ApiKeyAuth:
type: apiKey
description: The valid CreatorDB API key for authentication.
name: api-key
in: header
````