---
title: "Search Users"
method: GET
path: "/v1/tiktok/search/users"
tags: ["TikTok Search"]
---

# Search Users

`GET /v1/tiktok/search/users`

Search TikTok users by keyword.

## Query parameters

- `query` string, required
- `region` string
- `count` integer
- `cursor` string

## Response `200`

User search results

- UserSearchResponse
  - `users` TikTokAuthor[]
    - `id` string — Numeric user id.
    - `sec_uid` string — Secure user id (sec_uid) used for downstream list calls.
    - `unique_id` string — The @handle.
    - `nickname` string — Display name.
    - `avatar_thumb` string
    - `avatar_medium` string
    - `avatar_larger` string
    - `signature` string — Bio text.
    - `verified` boolean
    - `private_account` boolean
    - `follower_count` integer
    - `following_count` integer
    - `heart_count` integer — Total likes received.
    - `video_count` integer
    - `digg_count` integer — Likes given.
    - `region` string
    - `verify_reason` string
    - `verification_type` integer
    - `account_region` string
    - `language` string
    - `original_musician` boolean
    - `is_star` boolean
    - `ins_id` string — Linked Instagram handle.
    - `twitter_name` string
    - `youtube_channel_title` string
    - `room_id` string — Non-empty while the user is live.
    - `commerce_user_level` integer
    - `with_shop_entry` boolean
  - `pagination` TikTokCursorPage — Cursor pagination metadata shared by all list endpoints.
    - `has_more` boolean — True when more pages are available.
    - `cursor` string — Opaque cursor; pass back as ?cursor= for the next page.
    - `count` integer — Number of items in this page.
    - `search_id` string — Search endpoints chain rid → search_id across pages.
  - `region` string, required

---

[API](https://skmtc.net/scrapebadger/apis/scrapebadger-account-api.md) · [All operations](https://skmtc.net/scrapebadger/apis/scrapebadger-account-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/scrapebadger/scrapebadger-account-api/revisions/4a1ef8777baf/schema)