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_bodyobject是获取指定抖音账号在 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.countinteger | null否返回作品数量/Number of items30
request_body.aim_idsstring | 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_uidstring是投放账号的 sec_uid/Delivery account sec_uid—
request_body.target_idinteger | 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 list31