Douyin Fetch Douplus Promotable Item List
2.07积分/次
ae_douyin_fetch_douplus_promotable_item_list
## 用途 获取指定抖音账号在 DOU+ 投放页可推广的作品列表,以及作品信息和互动数据。本工具只查询列表,不发起推广,也不等同于获取账号的全部作品。 ## 输入 必须提供 `request_body` 对象,其中包含: - `sec_uid`(必填,字符串):要查询的投放账号标识。 - `count`(可选,整数):返回作品数量,默认 30。 - `target_id`(可选,整数):用于筛选可投作品的推广目标,默认 31。目标对应关系:31=点赞评论量,32=粉丝量,33=主页浏览量,37=视频播放量,40=直播间人气,45=评论链接点击,63=展示给粉丝,78=高质量互动。仅查询可推广作品列表时,保留默认值 31 即可。 - `aim_ids`(可选,字符串):高级投放优化目标编码,多个编码用逗号分隔。通常省略,由系统按 `target_id` 自动匹配。 ## 返回含义 响应数据包含所选推广目标下的可推广作品列表,可包括作品 ID、标题、封面及点赞量、评论量、播放量等信息。作品列表的详细结构未明确规定,具体可用字段以实际响应为准。
2.07积分/次
价格说明
2.07积分/次
| 条件 | 费用 |
|---|---|
| 每次调用 | 2.07积分/次 |
2.07积分/次 按查询次数计费。查询成功但未返回结果时,也会扣除积分。
API 调用
通过统一工具网关发起同步请求,鉴权和计费由 AgentEarth 处理。
cURL
curl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_douyin_fetch_douplus_promotable_item_list' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"request_body": {
"sec_uid": "MS4wLjABAAAA9fe7vGjwyiaOjL6REhX8rvmSb32VzA_XsKca9F3_YSHRXlEqgT2cpX54WGbtgnsA"
}
}
}'- 请求方式
- POST
- 接口地址
- /agent-api/v1/tool/execute
- 鉴权方式
- X-Api-Key
- 超时时间
- 60 秒
响应示例
{
"error_no": 0,
"error_msg": "",
"result": [
{
"type": "text",
"text": "xxx"
}
],
"platform_annotations": {
"source": "AgentEarth",
"platform_note": "xxx",
"platform_suggestion": "xxx"
}
}工具参数
未传入的可选参数将使用平台默认值。
| 参数 | 类型 | 必填 | 说明 | 默认值 |
|---|---|---|---|---|
request_body | object | 是 | 获取指定抖音账号在 DOU+ 投放页可推广作品列表的请求体对象。包含必填的账号标识 sec_uid,以及可选的返回作品数量 count、推广目标 target_id 和投放优化目标编码 aim_ids。/Request body object for retrieving a Douyin account's promotable works on the DOU+ delivery page. Contains the required account sec_uid and optional item count, promotion target_id, and optimization objective codes aim_ids. | — |
request_body.count | integer | null | 否 | 返回作品数量/Number of items | 30 |
request_body.aim_ids | string | null | 否 | 可选高级参数:投放优化目标编码,多个逗号分隔;留空即可(按 target_id 自动匹配),一般无需填写/Optional advanced param: optimization objective code(s), comma separated; leave empty (auto-matched by target_id), usually no need to set | — |
request_body.sec_uid | string | 是 | 投放账号的 sec_uid/Delivery account sec_uid | — |
request_body.target_id | integer | null | 否 | 推广目标(DOU+ 页面上的目标卡片)ID/Promotion target id (the goal card on the page). 31=点赞评论量, 32=粉丝量, 33=主页浏览量, 37=视频播放量, 40=直播间人气, 45=评论链接点击, 63=展示给粉丝, 78=高质量互动. 仅用于按推广目标筛选可投作品;只拉作品列表用默认 31 即可/Only filters promotable items by goal; keep 31 for a plain video list | 31 |

