Douyin Search Douplus User

2.07 credits/call
ae_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.

Social
2.07 credits/call

Pricing

2.07 credits/call
ConditionCharge
Each call2.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.

ParameterTypeRequiredDescriptionDefault
request_bodyobjectYesDOU+ 用户搜索请求体: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.countinteger | nullNo每页数量/Number of results per page20
request_body.cursorinteger | nullNo翻页游标,首页传 0,后续传上一页响应里的 cursor/Pagination cursor, 0 for first page, then pass the cursor from the previous response0
request_body.keywordstringYes搜索关键词,支持抖音号/ID/昵称/Search keyword (Douyin ID / nickname)—

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key
Request coderequest.sh
curl --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": "野心豹"
    }
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "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.