Douyin Index Fetch Brand Initiative Rank Weekly
Retrieve weekly brand initiative ranking data for a brand on Douyin or Toutiao. Inputs: - brand_name (required): Brand name. - start_date and end_date (required): Start and end dates as YYYYMMDD strings. - app_name (optional): aweme for Douyin (default), or toutiao for Toutiao. Returns: A response containing status information and a data payload with the requested weekly brand initiative ranking data. Detailed payload fields and ranking metric definitions are not specified.
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 |
|---|---|---|---|---|
app_name | enum (aweme | toutiao) | No | 平台/Platform: aweme(抖音), toutiao(头条) | aweme |
end_date | string | Yes | 结束日期/End date YYYYMMDD | — |
brand_name | string | Yes | 品牌名称/Brand name | — |
start_date | string | Yes | 开始日期/Start date YYYYMMDD | — |
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_index_fetch_brand_initiative_rank_weekly' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"brand_name": "泡泡玛特",
"end_date": "20261024",
"start_date": "20261018"
}
}'{
"code": 200,
"data": {
"BaseResp": {
"StatusCode": 0
},
"brand_rank": "3",
"category_id": "20"
},
"docs": "https://api.tikhub.io/#/Douyin-Index-API/fetch_brand_initiative_rank_weekly_api_v1_douyin_index_fetch_brand_initiative_rank_weekly_post",
"message": "Request successful. This request will incur a charge."
}This example shows part of the response. Copied content is valid JSON.

