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

# Search TikTok users

`GET /tiktok/search/user`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/tiktok/search/user`
- Auth: API key in header `x-api-key`

Searches TikTok users for `keyword`, with `cursor` (default 0) for paging. The response has `user_list` with the matching accounts, plus a `cursor` and `has_more` to continue. Pass the returned `cursor` back to fetch the next page.

## Query parameters

- `keyword` string, required
- `cursor` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- TiktokSearchUserResponseDoc
  - `code` integer
  - `data` TiktokSearchUserResp
    - `challenge_list` unknown
    - `cursor` integer: Cursor to pass in the next request to get the next page of results.
    - `extra` unknown
    - `feedback_type` string: Feedback type label that TikTok returns with the search results.
    - `global_doodle_config` unknown
    - `has_more` integer: Whether more results remain after this page, as a number (`1` for yes).
    - `input_keyword` string: Search keyword that was run.
    - `log_pb` object: Request tracking information from TikTok, holding the `impr_id` impression id.
      - `impr_id` string
    - `music_list` unknown
    - `qc` string: Query token that TikTok returns with the search results.
    - `rid` string: Request id that TikTok returns with the search results.
    - `status_code` integer: TikTok status code for the request. `0` on a successful response.
    - `status_msg` string: Status message that goes with the status code.
    - `type` integer: Result type code that TikTok returns with the search results.
    - `user_list` unknown[]: Accounts matching the keyword, one entry per account, as TikTok returns them.
      - unknown
  - `msg` string

## Other responses

- `400`: Invalid input
- `429`: Rate limit exceeded
- `500`: Internal server error

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/afac9b012a27?raw)