Douyin Index Fetch Item Analysis
Retrieve comparison analysis for a Douyin video over a specified date range to understand its performance relative to similar videos or broader benchmarks. Required inputs: - item_id: The Douyin video (aweme) ID, supplied as a string containing only digits. - start_date: The start date as a YYYYMMDD string. - end_date: The end date as a YYYYMMDD string. The response contains comparison results in data, which may be null. The available schema does not specify individual metrics or comparison dimensions; use the fields actually returned. Example inputs: item_id="7660090930283744575", start_date="20260704", end_date="20260710".
Pricing
| Condition | Charge |
|---|---|
| Each call | 2.07 credits/call |
2.07 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 |
|---|---|---|---|---|
item_id | string | Yes | 视频ID(抖音 aweme id,纯数字)/Video ID (Douyin aweme id, numeric). Example: 7660090930283744575 | — |
end_date | string | Yes | 结束日期/End date YYYYMMDD | — |
start_date | string | Yes | 开始日期/Start date YYYYMMDD | — |
Invocation example
Parameter templateGenerated from the parameter configuration. Replace the sample values before use.
/agent-api/v1/tool/executeX-Api-Keycurl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_douyin_index_fetch_item_analysis' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"item_id": "xxx",
"end_date": "xxx",
"start_date": "xxx"
}
}'No response example available yet.

