Douyin Xingtu Get Item Play Count

4.13 credits/call
ae_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.

VideoSocial
4.13 credits/call

Pricing

4.13 credits/call
ConditionCharge
Each call4.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.

ParameterTypeRequiredDescriptionDefault
item_idstringYes视频(item) ID/Video (item) ID—
need_cover_urlbooleanNo是否返回封面URL/Whether to return cover URLtrue
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_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
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "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.