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,
    "quotaUsed": 1,
    "quotaUsedTotal": 1,
    "remainingQuota": -1
  },
  "traceId": "f790925aeaa82fa64b24c1400cbf5e3e",
  "timestamp": 1768326490384,
  "errorCode": "",
  "errorDescription": "",
  "success": true
}

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. You can combine up to 10 filters per request to narrow search results.

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

Indicates the number of records to skip before returning results. Used for pagination.

Required range: x >= 0
​
desc
boolean

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

​
sortBy
string

The field to sort results 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.

​
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 March 20, 2026