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".
Pricing
| Condition | Charge |
|---|---|
| Each call | 2.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.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
aweme_ids | string | Yes | 作品id/Video id | — |
Invocation example
Copy the request and explore its response example.
/agent-api/v1/tool/executeX-Api-Keycurl --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"
}
}'{
"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.

