item_idstringrequired
Video (item) ID
https://api.sandbase.ai/v1/api/douyin/xingtu-v2/item-play-countGet the play count (watch_cnt) of a Douyin video from XingTu, plus video details such as author, cover, duration and publish time.
[
{
"data": {
"exist": true,
"item": {
"author_id": "78050876812",
"cover_uri": "tos-cn-i-0813c001/okH4NI7QDNMW1CqOgEf3AZAAbF1cApAAr229eG",
"cover_url": "https://p3-star-fe-sign.byteimg.com/tos-cn-i-0813c001/okH4NI7QDNMW1CqOgEf3AZAAbF1cApAAr229eG~tplv-9hvokabxw2-thumbnail.webp?rk3s=5ec46d44&x-expires=2102579308&x-signature=zOiUpoAGH9Yx8DCJ7u%2Bvj%2Bh%2F9t8%3D",
"create_time": "1776506300",
"duration": 28.234,
"id": "7630036460159111515",
"stats": {
"avg_watch_dura": "0",
"comment_cnt": "860",
"favorite_cnt": "12980",
"interact_rate": 0.0157,
"like_cnt": "141916",
"share_cnt": "52350",
"watch_cnt": "12422085"
},
"status": 102,
"title": "哈哈哈哈哈哈哈哈哈 我还以为真不怕痛呢 哈哈哈哈哈哈哈哈",
"topic_ids": [],
"url": "https://www.iesdouyin.com/share/video/7630036460159111515/?region=CN&mid=7630036389983603510&u_code=ml5dbid3&did=MS4wLjABAAAANwkJuWIRFOzg5uCpDRpMj4OX-QryoDgn-yYlXQnRwQQ&iid=MS4wLjABAAAANwkJuWIRFOzg5uCpDRpMj4OX-QryoDgn-yYlXQnRwQQ&with_sec_did=1&video_share_track_ver=&titleType=title&share_sign=rvQEuRC_JC8L3NjxKnzoyiKZAcgB_eWZRaZb3HoT1fY-&share_version=260800&ts=1787217323&from_aid=1128&from_ssr=1&share_track_info=%7B%22link_description_type%22%3A%22%22%7D",
"video_id": "v0d00fg10000d7hlb0vog65k07cn1neg"
},
"item_id": "7630036460159111515",
"stats": {
"avg_watch_dura": "0",
"comment_cnt": "860",
"favorite_cnt": "12980",
"interact_rate": 0.0157,
"like_cnt": "141916",
"share_cnt": "52350",
"watch_cnt": "12422085"
},
"watch_cnt": 12422085
}
}
]Select an example to load its inputs and result into the playground.
Returns the play count (watch_cnt) of a Douyin video, plus video details such as author ID, title, cover URL, duration, publish time and engagement stats. It needs the video ID in item_id.
like_cnt, share_cnt and comment_cnt against watch_cnt to judge how well a video engages viewers.item.author_id.curl -X POST "https://api.sandbase.ai/v1/api/douyin/xingtu-v2/item-play-count" \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"item_id": "7630036460159111515"}'
The result is returned in outputs[0].data.
| Name | Type | Required | Description |
|---|---|---|---|
item_id | string | Yes | Video (item) ID |
need_cover_url | boolean | No | Whether to return cover URL, default true |
platform_source | integer | No | Platform source, default 1 |
Real response for the request above, trimmed: lists keep their first item and long strings are cut.
{
"exist": true,
"item": {
"author_id": "78050876812",
"cover_uri": "tos-cn-i-0813c001/okH4NI7QDNMW1CqOgEf3AZAAbF1cApAAr229eG",
"cover_url": "https://p26-star-fe-sign.byteimg.com/tos-cn-i-0813c001/okH4NI7QDNMW1CqOgEf3AZAAb…",
"create_time": "1776506300",
"duration": 28.234,
"id": "7630036460159111515",
"stats": {
"avg_watch_dura": "0",
"comment_cnt": "905",
"favorite_cnt": "13473",
"interact_rate": 0.0155,
"like_cnt": "143631",
"share_cnt": "52842",
"watch_cnt": "12706869"
},
"status": 102,
"title": "哈哈哈哈哈哈哈哈哈 我还以为真不怕痛呢 哈哈哈哈哈哈哈哈",
"topic_ids": [],
"url": "https://www.iesdouyin.com/share/video/7630036460159111515/?region=CN&mid=7630036…",
"video_id": "v0d00fg10000d7hlb0vog65k07cn1neg"
},
"item_id": "7630036460159111515",
"stats": {
"avg_watch_dura": "0",
"comment_cnt": "905",
"favorite_cnt": "13473",
"interact_rate": 0.0155,
"like_cnt": "143631",
"share_cnt": "52842",
"watch_cnt": "12706869"
},
"watch_cnt": 12706869
}
| Field | Meaning |
|---|---|
watch_cnt | Play count of the video as a number. The same value also appears as a string in stats.watch_cnt. |
exist | Whether the video was found. A true value means the video data is filled in. |
stats.like_cnt / stats.comment_cnt / stats.favorite_cnt / stats.share_cnt | Counts of likes, comments, favorites and shares. They come back as strings. |
stats.interact_rate | Interaction rate of the video as a decimal number, for example 0.0155. |
stats.avg_watch_dura | Average watch duration. The sample value is "0", and the unit is not shown in the response. |
item.title | Video caption text. |
item.author_id | ID of the creator who posted the video. |
item.create_time | Publish time as a Unix timestamp in seconds, returned as a string. |
item.duration | Video length. The sample value is 28.234. |
item.cover_url | Link to the video cover image. It is a signed URL with an x-expires parameter. |
item_id is the numeric Douyin video ID, which also appears in the item.url share link.need_cover_url defaults to true. Set it to false if you do not need item.cover_url.stats object and watch_cnt are also at the top level, so you can read the play count without opening item.$0.002 per successful call. Failed calls are not charged. It is included in the daily free quota of each organization.
Start building
Platform API endpoint with unified authentication and usage tracking.
# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
-X POST "https://api.sandbase.ai/v1/api/douyin/xingtu-v2/item-play-count" \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
-H "Content-Type: application/json" \
--data-binary @- <<'SANDBASE_JSON'
{
"item_id": "7630036460159111515",
"need_cover_url": true,
"platform_source": 1
}
SANDBASE_JSON
)
printf '%s\n' "$result"Set your SandBase API key in your server environment. Requests use Bearer authentication.
export SANDBASE_API_KEY="YOUR_API_KEY"Keep your key on the server. Do not expose it in browser code.
item_idstringrequiredVideo (item) ID
need_cover_urlbooleanWhether to return cover URL, default true
Default: true
platform_sourceintegerPlatform source, default 1
Default: 1
Saved example response for this API; no live request is made when viewing it.
[
{
"data": {
"exist": true,
"item": {
"author_id": "78050876812",
"cover_uri": "tos-cn-i-0813c001/okH4NI7QDNMW1CqOgEf3AZAAbF1cApAAr229eG",
"cover_url": "https://p3-star-fe-sign.byteimg.com/tos-cn-i-0813c001/okH4NI7QDNMW1CqOgEf3AZAAbF1cApAAr229eG~tplv-9hvokabxw2-thumbnail.webp?rk3s=5ec46d44&x-expires=2102579308&x-signature=zOiUpoAGH9Yx8DCJ7u%2Bvj%2Bh%2F9t8%3D",
"create_time": "1776506300",
"duration": 28.234,
"id": "7630036460159111515",
"stats": {
"avg_watch_dura": "0",
"comment_cnt": "860",
"favorite_cnt": "12980",
"interact_rate": 0.0157,
"like_cnt": "141916",
"share_cnt": "52350",
"watch_cnt": "12422085"
},
"status": 102,
"title": "哈哈哈哈哈哈哈哈哈 我还以为真不怕痛呢 哈哈哈哈哈哈哈哈",
"topic_ids": [],
"url": "https://www.iesdouyin.com/share/video/7630036460159111515/?region=CN&mid=7630036389983603510&u_code=ml5dbid3&did=MS4wLjABAAAANwkJuWIRFOzg5uCpDRpMj4OX-QryoDgn-yYlXQnRwQQ&iid=MS4wLjABAAAANwkJuWIRFOzg5uCpDRpMj4OX-QryoDgn-yYlXQnRwQQ&with_sec_did=1&video_share_track_ver=&titleType=title&share_sign=rvQEuRC_JC8L3NjxKnzoyiKZAcgB_eWZRaZb3HoT1fY-&share_version=260800&ts=1787217323&from_aid=1128&from_ssr=1&share_track_info=%7B%22link_description_type%22%3A%22%22%7D",
"video_id": "v0d00fg10000d7hlb0vog65k07cn1neg"
},
"item_id": "7630036460159111515",
"stats": {
"avg_watch_dura": "0",
"comment_cnt": "860",
"favorite_cnt": "12980",
"interact_rate": 0.0157,
"like_cnt": "141916",
"share_cnt": "52350",
"watch_cnt": "12422085"
},
"watch_cnt": 12422085
}
}
]Explore more
| API | Price | Response |
|---|---|---|
Douyin Video Play CountThis API Douyin | $0.002 per call | JSON |
Douyin | $0.002 per call | JSON |
Douyin | $0.002 per call | JSON |
Douyin | $0.01 per call | JSON |
Douyin | $0.003 per call | JSON |
Douyin | $0.001 per call | JSON |
Questions
Send a POST request to https://api.sandbase.ai/v1/api/douyin/xingtu-v2/item-play-count with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.
$0.002 per call. Every organization gets 100 free calls per UTC day, shared across eligible SandBase APIs including this one; after that each call is billed at this price from your SandBase balance. There is no subscription.
Required: item_id (string). Optional: need_cover_url (boolean) and platform_source (integer). The Parameters table and the Playground on this page list every field.
A JSON response returned in the same HTTP request (synchronous). The README on this page includes a sample response.
No. Douyin Video Play Count runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for Douyin API access separately.