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.
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 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.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
request_body | object | Yes | 按分类搜索或筛选 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.name | string | null | No | 达人分类名/搜索词(取自达人分类接口);留空为全部/Category name or keyword (from the talent category endpoint); empty for all | "" |
request_body.page | integer | null | No | 页码,从0开始/Page index from 0 | 0 |
request_body.limit | integer | null | No | 每页数量/Page size | 20 |
request_body.cookie | string | null | No | 用户 www.douyin.com 网页版 Cookie/User www.douyin.com web Cookie | — |
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_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
}
}
}'{
"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.

