Skip to main content
POST
Search Creators Across Platforms

Authorizations

api-key
string
header
required

The valid CreatorDB API key for authentication.

Body

application/json

Search for creators across YouTube, Instagram, and TikTok by attributes, by a known account, or by email address.

filters
object[]
required

Filter objects that include filterName, op, and value. For the keywords and searchName filters, you can also set the optional isFuzzySearch. For all accepted filterName values and their data types, see Configuring Custom Search Filters and Examples.

Required array length: 1 - 10 elements
pageSize
integer
required

Number of results per page. Maximum: 100.

Required range: 1 <= x <= 100
offset
integer
required

Number of records to skip before returning results.

Required range: x >= 0
desc
boolean
default:true

Sort order for results. true for descending, false for ascending order. Defaults to true.

sortBy
enum<string>
default:creatorDBScore

Field to sort creators by. For example, mainPlatformFollowers sorts by follower count on each creator's primary platform. Defaults to creatorDBScore.

Available options:
creatorDBScore,
mainPlatformFollowers,
followerGrowth,
addedDate,
lastActive

Response

Creator search results returned successfully.

Creator Search API response with creator list and pagination.

data
object
required

Creator search response with matching creators and pagination information.

traceId
string
required

Unique trace ID for each request.

Example:

"f8e4a3b2c1d0e9f8a7b6c5d4e3f2a1b0"

timestamp
integer
required

Time the response was generated, represented as a Unix timestamp in milliseconds.

Example:

1750732453635

creditsAvailable
number
required

Number of API credits remaining. Equals planCreditsAvailable plus purchasedCreditsAvailable.

Example:

975

creditsUsed
number
required

Number of API credits consumed by this request.

Example:

25

planCreditsAvailable
number
required

Plan credits remaining after this request.

Example:

900

purchasedCreditsAvailable
number
required

Purchased credits remaining after this request.

Example:

75

errorCode
string
required

Error code returned if the request fails. Empty if the request is successful.

Example:

""

errorDescription
string
required

Description of the error. Empty if the request is successful.

Example:

""

success
boolean
required

true if the request is successful.

Example:

true

keyCreditsAvailable
number

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