Skip to main content
POST
/
tiktok
/
search
cURL
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
  }'
{
  "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": "π”½π•šπ•˜π•™π•₯π•šπ•Ÿπ•˜",
        "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": -1
  },
  "traceId": "f790925aeaa82fa64b24c1400cbf5e3e",
  "timestamp": 1768326490384,
  "errorCode": "",
  "errorDescription": "",
  "success": true
}

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.

Authorizations

​
api-key
string
header
required

The valid CreatorDB API key for authentication.

Body

application/json

TikTok search request parameters.

​
filters
object[]
required

Filter objects that include filterName, op, and value. For all accepted filterName values and their data types, see Configuring Custom Search Filters and Examples.

Maximum array length: 10
​
pageSize
integer
required

Specifies the maximum number of results to return in a single response. The upper limit is 100.

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

Number of records to skip before returning results.

Required range: x >= 0
​
desc
boolean

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

​
sortBy
string

Field to sort creators by. For example, totalFollowers sorts by follower count.

Response

TikTok search results returned successfully.

​
data
object
required

Search results containing TikTok creators and pagination information.

​
creditsUsed
integer
required

Number of API credits consumed by this request.

Example:

1

​
creditsAvailable
integer
required

Number of API credits remaining. Returns -1 if the quota is unlimited.

Example:

-1

​
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

​
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

Last modified on May 8, 2026