Douyin Fetch Douplus Talents By Category

2.07 credits/call
ae_douyin_fetch_douplus_talents_by_category

Search or filter Douyin DOU+ creators by category name or keyword. Inputs: Provide a required request_body object. All fields inside it are optional: - name: Category name or search keyword from the talent category lookup. Defaults to an empty string, meaning all categories. - page: Zero-based page index; default 0. - limit: Number of entries per page; default 20. - cookie: Your www.douyin.com web Cookie. Returns: A response containing the creator-list data and status metadata. The documented schema does not specify individual creator fields or the nested structure of data. Leaving name empty removes the category filter, but results remain paginated.

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 call to search or filter DOU+ creators by category name or keyword has a fixed charge. Leaving the category name or keyword empty removes the category filter; results are still paginated.

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
request_bodyobjectYes按分类搜索或筛选 DOU+ 达人的请求体对象,可包含分类名称或搜索词 name、页码 page、每页数量 limit 及用户 www.douyin.com 网页版 Cookie cookie。/ Request body object for searching or filtering DOU+ creators by category, with fields for category name or keyword (name), page index (page), page size (limit), and the user's www.douyin.com web Cookie (cookie).—
request_body.namestring | nullNo达人分类名/搜索词(取自达人分类接口);留空为全部/Category name or keyword (from the talent category endpoint); empty for all""
request_body.pageinteger | nullNo页码,从0开始/Page index from 00
request_body.limitinteger | nullNo每页数量/Page size20
request_body.cookiestring | nullNo用户 www.douyin.com 网页版 Cookie/User www.douyin.com web Cookie—

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_fetch_douplus_talents_by_category' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "request_body": {
      "limit": 50,
      "name": "",
      "page": 0
    }
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "code": 200,
  "data": {
    "code": 0,
    "data": {
      "page": 0
    }
  },
  "docs": "https://api.tikhub.io/#/Douyin-DouPlus-API/fetch_talents_by_category_api_v1_douyin_douplus_fetch_talents_by_category_post",
  "message": "Request successful. This request will incur a charge."
}

This example shows part of the response. Copied content is valid JSON.