aweme_idsstringrequired
Video id, supports multiple video ids, separated by commas, no more than 2, single is also possible, no need for commas.
https://api.sandbase.ai/v1/api/douyin/app-v3/video-statisticsReturns statistical metrics including like counts, play counts, and share counts for specified Douyin videos by ID.
[
{
"data": {
"statistics_list": [
{
"aweme_id": "7448118827402972455",
"digg_count": 4557,
"play_count": 239527,
"share_count": 69
},
{
"aweme_id": "7126745726494821640",
"digg_count": 36465,
"download_count": 4515,
"play_count": 1222995,
"share_count": 8493
}
]
}
}
]Select an example to load its inputs and result into the playground.
Returns like, play and share counts for one or two Douyin videos. You pass the video IDs in aweme_ids, separated by a comma.
share_count to see how often a video was shared.download_count on videos that report it.curl -X POST "https://api.sandbase.ai/v1/api/douyin/app-v3/video-statistics" \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"aweme_ids": "7448118827402972455,7126745726494821640"}'
The result is returned in outputs[0].data.
| Name | Type | Required | Description |
|---|---|---|---|
aweme_ids | string | Yes | Video id, supports multiple video ids, separated by commas, no more than 2, single is also possible, no need for commas. |
Real response for the request above, trimmed: lists keep their first item and long strings are cut.
{
"statistics_list": [
{
"aweme_id": "7448118827402972455",
"digg_count": 4553,
"play_count": 239913,
"share_count": 69
}
]
}
| Field | Meaning |
|---|---|
statistics_list[] | One entry per video ID you sent. |
statistics_list[].aweme_id | The ID of the video these counts belong to. Use it to match each entry to your input. |
statistics_list[].digg_count | Number of likes on the video. |
statistics_list[].play_count | Number of plays on the video. |
statistics_list[].share_count | Number of shares of the video. |
statistics_list[].download_count | Number of downloads of the video. It appears only for some videos, so the first video in the example does not have it. |
aweme_ids. For one video, send the ID without a comma.aweme_id values are long numeric strings. Keep them as strings.download_count can be missing from an entry, so check for it before you read it.$0.001 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/app-v3/video-statistics" \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
-H "Content-Type: application/json" \
--data-binary @- <<'SANDBASE_JSON'
{
"aweme_ids": "7448118827402972455,7126745726494821640"
}
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.
aweme_idsstringrequiredVideo id, supports multiple video ids, separated by commas, no more than 2, single is also possible, no need for commas.
Saved example response for this API; no live request is made when viewing it.
[
{
"data": {
"statistics_list": [
{
"aweme_id": "7448118827402972455",
"digg_count": 4557,
"play_count": 239527,
"share_count": 69
},
{
"aweme_id": "7126745726494821640",
"digg_count": 36465,
"download_count": 4515,
"play_count": 1222995,
"share_count": 8493
}
]
}
}
]Explore more
| API | Price | Response |
|---|---|---|
Douyin Video StatisticsThis API Douyin | $0.001 per call | JSON |
Douyin | $0.001 per call | JSON |
Douyin | $0.001 per call | JSON |
Douyin | $0.001 per call | JSON |
Douyin | $0.001 per call | JSON |
Douyin | $0.001 per call | JSON |
Questions
Send a POST request to https://api.sandbase.ai/v1/api/douyin/app-v3/video-statistics 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.001 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: aweme_ids (string). 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 Statistics 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.