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.
Pricing
| Condition | Charge |
|---|---|
| Each call | 82.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.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
request_body | object | Yes | 批量查询抖音视频统计数据与详情的请求体对象;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_ids | array | Yes | 视频(item) ID列表,一次最多20个/Video (item) ID list, up to 20 per call | — |
request_body.need_cover_url | boolean | No | 是否返回封面URL/Whether to return cover URL | true |
request_body.platform_source | integer | No | 平台来源/Platform source | 1 |
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_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
}
}
}'{
"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.

