Douyin Xingtu Get Playlet Actor Rank List
## Purpose Retrieve short-drama actor popularity ranking data for a selected statistical date and weekly or monthly period. ## Inputs All parameters are optional. - `category` (string): Ranking category; defaults to `playlet_actor_list`. - `name` (string): Ranking name; defaults to `playlet_actor_composite_list`, meaning the composite ranking. - `qualifier` (string): Actor-type filter; defaults to `""` for no restriction. Other filter values are not documented. - `period` (integer): Statistical period: `7` for a weekly ranking or `30` for a monthly ranking. Default: `30`. - `date` (string): Statistical date in `YYYYMMDD` format. Default: `20251130`. This is a fixed date, not an automatic selection of the current date; specify the intended date explicitly. ## Result Returns a response whose `data` contains the requested actor ranking data and may be null. The available schema does not specify individual ranking-entry fields or metrics. ## Example `{"category":"playlet_actor_list","name":"playlet_actor_composite_list","qualifier":"","period":30,"date":"20251130"}` ## Available ranking periods Only ranking periods available from the upstream source can be queried; a ranking for the current date is not guaranteed. First call ae_douyin_xingtu_get_playlet_actor_rank_catalog to obtain available periods and dates, then use values returned by that catalog. The fixed default date is historical and does not identify the latest ranking. If the requested period is absent from the catalog, do not repeatedly retry different dates.
Pricing
| Condition | Charge |
|---|---|
| Each call | 4.13 credits/call |
4.13 credits/call Charges are per query. A successful query is billed even if it returns no results.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
date | string | No | 统计日期,格式 YYYYMMDD。仅支持上游已有榜期,请先调用 ae_douyin_xingtu_get_playlet_actor_rank_catalog 获取可用周期和日期后填写;不保证支持当天。默认 20251130 为固定历史日期,不代表最新榜单。/ Statistical date in YYYYMMDD. Use a period/date combination returned by ae_douyin_xingtu_get_playlet_actor_rank_catalog; the current date is not guaranteed. The fixed default 20251130 is historical, not the latest ranking. | 20251130 |
name | string | No | 榜单名称/Ranking name | playlet_actor_composite_list |
period | integer | No | 统计周期,7=周榜,30=月榜/Period, 7=weekly, 30=monthly | 30 |
category | string | No | 分类/Category | playlet_actor_list |
qualifier | string | No | 达人类型,空字符串=不限/Actor type, empty=all | "" |
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_xingtu_get_playlet_actor_rank_list' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"date": "20261116",
"period": 7
}
}'{
"detail": {
"code": 400,
"docs": "https://api.tikhub.io/#/Douyin-Xingtu-V2-API/get_playlet_actor_rank_list_api_v1_douyin_xingtu_v2_get_playlet_actor_rank_list_get",
"headers": {},
"message": "Request failed. Please retry. Check the docs below to verify your parameters, test with the default demo parameters, and send the response JSON to support. You won't be charged for this request.",
"message_zh": "请求失败,请重试。请查看下方文档核对参数,使用默认演示参数测试,并将响应 JSON 提交给支持团队。本次请求不会被扣费。",
"params": {
"category": "playlet_actor_list",
"date": "20261116",
"name": "playlet_actor_composite_list",
"period": "7",
"qualifier": ""
}
}
}This example shows part of the response. Copied content is valid JSON.

