# Douyin user search

Fetch a list of users from Douyin App based on search keywords. Takes keyword, cursor, douyin user fans and more, all optional. Served by TikHub.

Purpose:
- Fetch a list of users from Douyin App based on search keywords.
- Supports filtering by fan count and user type.

Notes:
- Set `cursor` to 0 and `search_id` to an empty string for the first request.
- Only user information is returned. No videos, music, or hashtags.

Parameters:
- keyword: Search keyword, e.g., "AI"
- cursor: Pagination cursor (0 for first page)
- douyin_user_fans: Fan count filter
  - Empty: No limit
  - "0_1k": Below 1000 fans
  - "1k_1w": 1,000 to 10,000 fans
  - "1w_10w": 10,000 to 100,000 fans
  - "10w_100w": 100,000 to 1,000,000 fans
  - "100w_": Above 1,000,000 fans
- douyin_user_type: User type filter
  - Empty: No limit
  - "common_user": Regular user
  - "enterprise_user": Enterprise-verified user
  - "personal_user": Personal-verified user
- search_id: Search session ID for pagination

Request Body Example:
```json
payload = {
    "keyword": "AI",
    "cursor": 0,
    "douyin_user_fans": "",
    "douyin_user_type": "",
    "search_id": ""
}
```

Response (common fields, actual response may contain more fields):
- `cursor`: Cursor for next page
- `has_more`: Whether more data is available (1=Yes, 0=No)
- `user_list[]`: List of users
  - `user_info`:
    - `uid`: User ID
    - `nickname`: Nickname
    - `gender`: Gender (0=Unknown, 1=Male, 2=Female)
    - `unique_id`: Douyin ID
    - `sec_uid`: Secured UID
    - `signature`: Personal bio
    - `follower_count`: Number of followers
    - `avatar_thumb.url_list`: List of thumbnail avatar URLs
    - `avatar_medium.url_list`: List of medium avatar URLs
    - `avatar_larger.url_list`: List of

- Tool ID: `tikhub/douyin-search-fetch-user-search`
- Variant: API v1
- Name in the catalog: Douyin, Fetch user search
- Provider: [TikHub](/providers/tikhub.md)
- Capability: [Douyin search](/tools/douyin/search.md)
- Price: $0.01 per call
- Authentication: an authorised Agentik workspace is required for execution, including zero-price tools.

## Pricing contract

The provider’s price, with no markup. Billed for measured usage.


```json
{
  "model": "per_call",
  "amountUsd": 0.01
}
```

Pricing source: [https://api.tikhub.io/api/v1/tikhub/user/get_all_endpoints_info](https://api.tikhub.io/api/v1/tikhub/user/get_all_endpoints_info). Official per-success route price USD 0.01; daily upstream discounts may reduce provider cost. No discount invented for the customer. 10/second.

Price verification date: 2026-10-05.

## Complete input schema


```json
{
  "type": "object",
  "properties": {
    "keyword": {
      "type": "string",
      "title": "Keyword",
      "description": "关键词 / Keyword",
      "default": "猫咪"
    },
    "cursor": {
      "type": "integer",
      "title": "Cursor",
      "description": "偏移游标，用于翻页，从上一次请求返回的响应中获取 / Offset cursor for pagination, obtained from the last response",
      "default": 0
    },
    "douyin_user_fans": {
      "type": "string",
      "title": "Douyin User Fans",
      "description": "粉丝数过滤：空=不限 0_1k=1千以下 1k_5k=1千到5千 5k_10k=5千到1万 10k_100k=1万到10万 100k_1M=10万到100万 1M_=100万以上 / Fans filter: empty=No limit, 0_1k=Under 1k, etc.",
      "default": ""
    },
    "douyin_user_type": {
      "type": "string",
      "title": "Douyin User Type",
      "description": "用户类型过滤：空=不限 300=创作者 900=小店 700=音乐人 800=明星 / User type filter: empty=No limit, 300=Creator, 900=Shop, 700=Musician, 800=Celebrity",
      "default": ""
    },
    "search_id": {
      "type": "string",
      "title": "Search Id",
      "description": "搜索ID，用于翻页，从上一次请求返回的响应中获取 / Search ID for pagination, obtained from the last response",
      "default": ""
    }
  },
  "additionalProperties": false
}
```

## Published example

This is the provider tool’s published example. Replace example values with the user’s requested inputs, respecting the schema; do not execute an example merely to test a connection.


```json
{
  "tool_id": "tikhub/douyin-search-fetch-user-search",
  "input": {
    "keyword": "猫咪",
    "cursor": 0,
    "douyin_user_fans": "",
    "douyin_user_type": "",
    "search_id": ""
  }
}
```

## Execute and retrieve

Inspect again before execution, explain the price and obtain the required authority. Use MCP run_tool or POST /v1/run with this tool ID, valid input and an idempotency key. Save the returned run ID and follow the actual state. If Agentik answers that the tool is temporarily unavailable, do not retry it blindly; use discovery to propose an alternative.

A partial or uncertain result can still have consumed provider resources. Consult [billing](/docs/billing.md), [idempotency](/docs/idempotency.md) and [asynchronous results](/docs/async.md).

[Provider documentation](https://api.tikhub.io/#/Douyin-Search-API/fetch_user_search_api_v1_douyin_search_fetch_user_search_post)

[REST inspection](https://api.agentik.cc/v1/tools/tikhub/douyin-search-fetch-user-search) · [OpenAPI](/openapi.json) · [Connection guide](/connect.md)

---

[HTML page](/providers/tikhub/douyin-search-fetch-user-search) · [Agent index](/llms.txt)