Douyin Video Statistics

API docs
https://api.sandbase.ai/v1/api/douyin/app-v3/video-statistics

Returns statistical metrics including like counts, play counts, and share counts for specified Douyin videos by ID.

Price
$0.001USD / call
Method
POST
Response
JSON
Parameters
1 required · 0 optional
100 free calls / dayFirst 100 calls per day free (shared per organization) · Resets at 00:00 UTC. Pay per call after that.

Playground

Input
Video id, supports multiple video ids, separated by commas, no more than 2, single is also possible, no need for commas.
OutputExample
Responseoutputs · 415 B · 21 lines
[
  {
    "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
        }
      ]
    }
  }
]

Examples

Select an example to load its inputs and result into the playground.

API README

Douyin Video Statistics API

Returns like, play and share counts for one or two Douyin videos. You pass the video IDs in aweme_ids, separated by a comma.

Use cases

  • Check the play and like counts of a single Douyin post.
  • Compare engagement between two Douyin videos in one call.
  • Read share_count to see how often a video was shared.
  • Check download_count on videos that report it.

Request

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.

Parameters

NameTypeRequiredDescription
aweme_idsstringYesVideo id, supports multiple video ids, separated by commas, no more than 2, single is also possible, no need for commas.

Example response

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
    }
  ]
}

Response fields

FieldMeaning
statistics_list[]One entry per video ID you sent.
statistics_list[].aweme_idThe ID of the video these counts belong to. Use it to match each entry to your input.
statistics_list[].digg_countNumber of likes on the video.
statistics_list[].play_countNumber of plays on the video.
statistics_list[].share_countNumber of shares of the video.
statistics_list[].download_countNumber of downloads of the video. It appears only for some videos, so the first video in the example does not have it.

Notes

  • Send at most two IDs in 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.
  • To count more than two videos at once, use Douyin Video Statistics (Batch).

Pricing

$0.001 per successful call. Failed calls are not charged. It is included in the daily free quota of each organization.

Explore more

Related APIs

All APIs
APIPriceResponse
Douyin$0.001 per callJSON
Douyin$0.001 per callJSON
Douyin$0.001 per callJSON
Douyin$0.001 per callJSON
Douyin$0.001 per callJSON
Douyin$0.001 per callJSON

Questions

FAQ

How do I use the Douyin Video Statistics API?

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.

How much does the Douyin Video Statistics API cost?

$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.

What parameters does the Douyin Video Statistics API accept?

Required: aweme_ids (string). The Parameters table and the Playground on this page list every field.

What does the Douyin Video Statistics API return?

A JSON response returned in the same HTTP request (synchronous). The README on this page includes a sample response.

Do I need a Douyin developer account or API key?

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.