Douyin Xingtu Get Item Play Count
Retrieve the total play count and full details for one Douyin video. Inputs: - item_id: Required video ID as a string. - platform_source: Optional integer platform source; defaults to 1. - need_cover_url: Optional boolean specifying whether to return a cover URL; defaults to true. Returned video data: - exist: Whether the video exists; false for a deleted video or invalid ID. - watch_cnt: Total play count as an integer, or null if unavailable. - stats: Statistics including likes, comments, shares, favorites, engagement rate, and average watch duration. - item: Video details including title, cover, duration, publication time, and author ID. Important: watch_cnt includes paid promotion (ad boosting) and is not an organic-only view count. A null play count means the value is unavailable, not zero.
Pricing
| Condition | Charge |
|---|---|
| Each call | 4.13 credits/call |
4.13 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.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
item_id | string | Yes | 视频(item) ID/Video (item) ID | — |
need_cover_url | boolean | No | 是否返回封面URL/Whether to return cover URL | true |
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_get_item_play_count' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"item_id": "7706859442725842170",
"need_cover_url": false
}
}'{
"code": 200,
"data": {
"exist": false,
"item": null,
"item_id": "7706859442725842170",
"stats": null,
"watch_cnt": null
},
"docs": "https://api.tikhub.io/#/Douyin-Xingtu-V2-API/get_item_play_count_api_v1_douyin_xingtu_v2_get_item_play_count_get",
"message": "Request successful. This request will incur a charge.",
"message_zh": "请求成功,本次请求将被计费。",
"params": {
"item_id": "7706859442725842170",
"need_cover_url": "false",
"platform_source": "1"
}
}This example shows part of the response. Copied content is valid JSON.

