Douyin Xingtu Multi Get Item Stats

82.62 credits/call
ae_douyin_xingtu_multi_get_item_stats

Retrieve statistics and details for up to 20 Douyin videos in one request. Inputs: - request_body is required. Set request_body.item_ids to an array of video ID strings. Empty entries and duplicates are automatically removed; requests exceeding 20 IDs return an error. - request_body.platform_source: optional integer identifying the platform source; defaults to 1. - request_body.need_cover_url: optional boolean controlling whether cover URLs are returned; defaults to true. Results: - Matched items with video details and stats: watch_cnt (plays), like_cnt (likes), comment_cnt (comments), share_cnt (shares), favorite_cnt (favorites), interact_rate (interaction rate), and avg_watch_dura (average watch duration per viewer). - watch_cnt includes paid promotion and must not be interpreted as organic-only plays. - Invalid or deleted video IDs may be omitted, so fewer items may be returned than requested.

VideoSocial
82.62 credits/call

Pricing

82.62 credits/call
ConditionCharge
Each call82.62 credits/call

82.62 credits/call Charges are per query. A successful query is billed even if it returns no results.

Charges are per call, regardless of the number of video IDs submitted or items returned. Invalid or deleted video IDs may be omitted, so fewer items may be returned than submitted.

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
request_bodyobjectYes批量查询抖音视频统计数据与详情的请求体对象;item_ids 为待查询的视频ID字符串数组,platform_source 指定平台来源,need_cover_url 控制是否返回封面URL。/Request body object for batch retrieval of Douyin video statistics and details; item_ids is an array of video ID strings to query, platform_source specifies the platform source, and need_cover_url controls whether cover URLs are returned.—
request_body.item_idsarrayYes视频(item) ID列表,一次最多20个/Video (item) ID list, up to 20 per call—
request_body.need_cover_urlbooleanNo是否返回封面URL/Whether to return cover URLtrue
request_body.platform_sourceintegerNo平台来源/Platform source1

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_xingtu_multi_get_item_stats' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "request_body": {
      "item_ids": [
        "7706878249640974458",
        "7706879546671027067",
        "7706880246113549157",
        "7706850920303370739",
        "7706859442725842170",
        "7706880411696052810",
        "7706845452947663857"
      ],
      "need_cover_url": false
    }
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "code": 200,
  "data": {
    "base_resp": {
      "status_code": 0,
      "status_message": ""
    },
    "items": [
      {
        "author_id": "1927866683240044",
        "cover_uri": "tos-cn-i-0813c000-ce/o4S95eiDaA32l0enAvs8NNwEBfA4iEAGIEAqhI",
        "id": "7706845452947663857",
        "status": 102,
        "title": "无聊时可以这样逗逗男朋友#恋爱日常#聊天记录#哄男朋友#日常套路",
        "url": "https://www.iesdouyin.com/share/note/7706845452947663857/?region=CN&mid=7691189954370635814&u_code=[REDACTED]&did=[REDACTED]&iid=[REDACTED]&with_sec_did=1&video_share_track_ver=&titleType=title&schema_type=37&share_sign=[REDACTED]&share_version=260800&ts=1"
      }
    ]
  },
  "docs": "https://api.tikhub.io/#/Douyin-Xingtu-V2-API/multi_get_item_stats_api_v1_douyin_xingtu_v2_multi_get_item_stats_post",
  "message": "Request successful. This request will incur a charge.",
  "message_zh": "请求成功,本次请求将被计费。",
  "params": {}
}

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