Douyin Xingtu Get Item Report Trend

6.2 credits/call
ae_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.

VideoSocial
6.2 credits/call

Pricing

6.2 credits/call
ConditionCharge
Each call6.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.

ParameterTypeRequiredDescriptionDefault
request_bodyobjectYes用于查询单个视频整体表现与趋势数据的请求体对象,其中 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_idstringYes视频(item) ID/Video (item) 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_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"
    }
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "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.