Douyin Search Douplus User
## Purpose Find Douyin users by account ID or nickname in the DOU+ promotion context, with cursor-based pagination. ## Inputs Provide a required `request_body` object containing: - `keyword` (required string): Douyin account ID or nickname to search for. - `count` (optional integer or null): Results per page; defaults to 20. - `cursor` (optional integer or null): Pagination cursor; defaults to 0. Use 0 for the first page, then the cursor returned by the previous response. ## Results Returns matching users with details such as nickname, Douyin account ID, `sec_uid`, and follower count, plus pagination information. The returned `cursor` is used to request the next page, and `has_more` indicates whether more results are available. The exact user-record structure is not fixed by the response schema. This tool searches accounts only; it does not create or submit a promotion campaign.
Pricing
| Condition | Charge |
|---|---|
| Each call | 2.07 credits/call |
2.07 credits/call Charges are per query. A successful query is billed even if it returns no results.
Each search request is charged separately. Requesting the next page with a cursor counts as another call.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
request_body | object | Yes | DOU+ 用户搜索请求体:keyword 为必填的搜索关键词,支持抖音号/ID/昵称;count 指定每页数量,默认 20;cursor 为翻页游标,首页传 0,后续传上一页响应返回的 cursor。 / Request body for searching Douyin users in the DOU+ context: keyword is the required search term (Douyin account ID or nickname); count sets the number of results per page and defaults to 20; cursor is the pagination cursor, using 0 for the first page and the cursor returned by the previous response for subsequent pages. | — |
request_body.count | integer | null | No | 每页数量/Number of results per page | 20 |
request_body.cursor | integer | null | No | 翻页游标,首页传 0,后续传上一页响应里的 cursor/Pagination cursor, 0 for first page, then pass the cursor from the previous response | 0 |
request_body.keyword | string | Yes | 搜索关键词,支持抖音号/ID/昵称/Search keyword (Douyin ID / nickname) | — |
Invocation example
Copy the request and explore its response example.
/agent-api/v1/tool/executeX-Api-Keycurl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_douyin_search_douplus_user' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"request_body": {
"count": 20,
"cursor": 0,
"keyword": "野心豹"
}
}
}'{
"code": 200,
"data": {
"cursor": 0,
"has_more": false,
"status_code": 0,
"status_msg": ""
},
"docs": "https://api.tikhub.io/#/Douyin-DouPlus-API/search_user_api_v1_douyin_douplus_search_user_post",
"message": "Request successful. This request will incur a charge.",
"message_zh": "请求成功,本次请求将被计费。",
"params": {}
}This example shows part of the response. Copied content is valid JSON.

