Douyin Fetch Video Statistics

2.07 credits/call
ae_douyin_fetch_video_statistics

Retrieve statistics for one or two Douyin videos. Input: aweme_ids is required and must be a string containing a single video ID or two video IDs separated by a comma. A maximum of two IDs is supported per request. Returns: Video statistics, including documented metrics for likes (digg_count), downloads (download_count), plays (play_count), and shares (share_count). The statistics are returned in the response's data field; its detailed structure is not specified. Example: aweme_ids = "7448118827402972455,7126745726494821640".

SocialVideo
2.07 credits/call

Pricing

2.07 credits/call
ConditionCharge
Each call2.07 credits/call

Each call has a fixed charge of 2.07 credits. Charges are per query. A successful query is billed even if it returns no results.

Each call can retrieve statistics for one or two videos at the same charge. To query two videos, separate their video IDs with an English comma.

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
aweme_idsstringYes作品id/Video id—

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_fetch_video_statistics' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "aweme_ids": "7701270922778694074"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "code": 200,
  "data": {
    "statistics_list": [
      {
        "aweme_id": "7701270922778694074",
        "digg_count": 16,
        "play_count": 2345,
        "share_count": 2
      }
    ]
  },
  "docs": "https://api.tikhub.io/#/Douyin-App-V3-API/fetch_video_statistics_api_v1_douyin_app_v3_fetch_video_statistics_get",
  "message": "Request successful. This request will incur a charge.",
  "message_zh": "请求成功,本次请求将被计费。",
  "params": {
    "aweme_ids": "7701270922778694074"
  }
}

This example shows part of the response. Copied content is valid JSON.