TikTok User Search

2 credits

Search TikTok users by text.

POST/api/v1/tools/tiktok/user/search

Parameters

queriesstring[]required

Texts to search for users. A query that gives no users gets an entry in errors.

resultsPerQuerynumber

Most users for each query. 0 reads every user, up to the plan limit for the whole call. Default: 0.

Response Schema

dataobject

TikTok user search result

usersobject[]

The users of every query, in the order of the queries.

countnumber

Number of users returned

errorsobject[]

One entry for each query that gave no users.

metaobject

Request metadata

toolstring

Tool name (tiktok-user-search)

creditsUsednumber

Credits consumed (2 for each query)

requestIdstring

Unique request ID

Request

curl -X POST https://scraper.run/api/v1/tools/tiktok/user/search \
  -H "Authorization: Bearer sc_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "queries": ["coffee"],
    "resultsPerQuery": 20
  }'

Response Example

{
  "data": {
    "users": [
      {
        "query": "coffee",
        "userId": "6812345678901234567",
        "uniqueId": "morningcoffee",
        "nickname": "Morning Coffee",
        "followerCount": 154000,
        "videoCount": 320,
        "verified": false,
        "bioDescription": "Daily brews and latte art"
      }
    ],
    "count": 1,
    "errors": []
  },
  "meta": {
    "tool": "tiktok-user-search",
    "creditsUsed": 2,
    "requestId": "req_abc123"
  }
}