Douyin Fetch Douplus Promotable Item List

2.07 credits/call
ae_douyin_fetch_douplus_promotable_item_list

## Purpose Retrieve the works available for promotion on a specified Douyin account's DOU+ promotion page, with item details and engagement metrics. This query does not start a promotion and is not an unrestricted list of all account posts. ## Inputs Pass a required `request_body` object containing: - `sec_uid` (required string): Identifier of the account whose promotable works you want to retrieve. - `count` (optional integer): Number of works to return; default is 30. - `target_id` (optional integer): Promotion goal used to filter eligible works; default is 31. Goals: 31 = likes and comments; 32 = followers; 33 = profile views; 37 = video plays; 40 = live-room popularity; 45 = comment-link clicks; 63 = show to followers; 78 = high-quality interaction. Keep 31 for a basic promotable-works query. - `aim_ids` (optional string): Advanced optimization objective codes, separated by commas. Normally omit this field so objectives are automatically matched to `target_id`. ## Result Returns response data containing the promotable works list, including information such as item IDs, titles, covers, and like, comment, and play counts. Eligibility is evaluated for the selected promotion goal. The detailed list structure is not specified, so available fields should be read from the actual response.

SocialVideo
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.

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
request_bodyobjectYes获取指定抖音账号在 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 | nullNo返回作品数量/Number of items30
request_body.aim_idsstring | nullNo可选高级参数:投放优化目标编码,多个逗号分隔;留空即可(按 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_uidstringYes投放账号的 sec_uid/Delivery account sec_uid—
request_body.target_idinteger | nullNo推广目标(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

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_promotable_item_list' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "request_body": {
      "count": 30,
      "sec_uid": "MS4wLjABAAAA8HpZGyQ9AY1nEvF2kk6ooUWEz-P_D8H-VhxfzSb5n_g",
      "target_id": 31
    }
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "code": 200,
  "data": {
    "cursor": "1786270732000",
    "has_more": 1,
    "item_info_list": [
      {
        "aweme_info": {
          "author": {
            "avatar_medium": {},
            "nickname": "小柔趣远方✈️",
            "sec_uid": "MS4wLjABAAAA8HpZGyQ9AY1nEvF2kk6ooUWEz-P_D8H-VhxfzSb5n_g"
          },
          "aweme_id": "7700982293070997474",
          "can_play": false,
          "create_time": 1793024665000,
          "desc": "为什么说不建议自由行来成都?很多人来了只打卡宽窄巷子,看看爬墙熊猫再吃顿火锅就匆匆的返程#成都旅游攻略 #宽窄巷子 #成都美食 #四川dou知道 #成都景点推荐",
          "is_daily_story": false
        },
        "disable_multi_select": false,
        "is_ad": false,
        "is_friend_video": false,
        "is_item_promotional": false,
        "is_over_90_days": false
      }
    ]
  },
  "docs": "https://api.tikhub.io/#/Douyin-DouPlus-API/fetch_promotable_item_list_api_v1_douyin_douplus_fetch_promotable_item_list_post",
  "message": "Request successful. This request will incur a charge.",
  "message_zh": "请求成功,本次请求将被计费。",
  "request_id": "63828d63-1a99-464f-a805-7a85e38338c7"
}

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