Skip to main content
GET
/
v1
/
tiktok
/
search
/
users
Search Users
curl --request GET \
  --url https://scrapebadger.com/v1/tiktok/search/users \
  --header 'x-api-key: <api-key>'
{
  "users": [
    {
      "id": "6784129854561813509",
      "sec_uid": "MS4wLjABAAAA...",
      "unique_id": "charlidamelio",
      "nickname": "charli d'amelio",
      "avatar_thumb": "https://p16-sign.tiktokcdn-us.com/avatar.jpeg",
      "signature": "no bio yet",
      "verified": true,
      "follower_count": 155600000,
      "following_count": 1300,
      "heart_count": 11800000000,
      "video_count": 2700,
      "region": "US"
    }
  ],
  "pagination": {
    "has_more": true,
    "cursor": "30",
    "count": 30,
    "search_id": null
  },
  "region": "US"
}
Each request costs 5 credits. Failed requests are not charged.

Authorizations

x-api-key
string
header
required

Query Parameters

query
string
required

Search keyword.

region
string
default:US

Content region (ISO 3166-1 alpha-2). Routes the request through a proxy and signer for that locale.

count
integer
default:20

Maximum number of items to return (1-50).

Required range: 1 <= x <= 50
cursor
string

Pagination cursor — pass the pagination.cursor value from a prior response to fetch the next page. Omit for the first page. It is an opaque composite token.

Response

200 - application/json

User search results

region
string
required
users
object[]
pagination
object

Cursor pagination metadata shared by all list endpoints.