Douyin Xingtu Get Item Report Trend
Retrieve overall performance and trend data for a single Douyin video. Input: Provide the required request_body object with item_id set to the video ID as a string. Example: {"request_body":{"item_id":"7451907165419359488"}} Returns: A response whose data field contains the video performance and trend report when available, or may be null. The documented schema does not specify individual report metrics or time granularity. No date-range or metric-selection parameters are available.
Pricing
| Condition | Charge |
|---|---|
| Each call | 6.2 credits/call |
6.2 credits/call Charges are per query. A successful query is billed even if it returns no results.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
request_body | object | Yes | 用于查询单个视频整体表现与趋势数据的请求体对象,其中 item_id 为视频 ID。 / Request body object for retrieving a single video's overall performance and trend data; item_id is the video ID. | — |
request_body.item_id | string | Yes | 视频(item) ID/Video (item) 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_xingtu_get_item_report_trend' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"request_body": {
"item_id": "7702793264046378283"
}
}
}'{
"code": 200,
"data": {
"base_resp": {
"status_code": 0
},
"date_values": {
"collect_cnt_list": [
{
"value": "0",
"visit_date": 20261031
}
],
"comment_cnt_list": [
{
"value": "0",
"visit_date": 20261031
}
],
"finish_rate_list": [
{
"value": "145",
"visit_date": 20261031
}
],
"hot_score_list": [
{
"value": "658",
"visit_date": 20261031
}
],
"interact_cnt_list": [
{
"value": "0",
"visit_date": 20261031
}
],
"interact_rate_list": [
{
"value": "0",
"visit_date": 20261031
}
]
}
},
"docs": "https://api.tikhub.io/#/Douyin-Xingtu-V2-API/get_item_report_trend_api_v1_douyin_xingtu_v2_get_item_report_trend_post",
"message": "Request successful. This request will incur a charge."
}This example shows part of the response. Copied content is valid JSON.

