Douyin Index Fetch Brand Initiative Rank Weekly

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

Social
2.07 credits/call

Pricing

2.07 credits/call
ConditionCharge
Each call2.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.

ParameterTypeRequiredDescriptionDefault
app_nameenum (aweme | toutiao)No平台/Platform: aweme(抖音), toutiao(头条)aweme
end_datestringYes结束日期/End date YYYYMMDD—
brand_namestringYes品牌名称/Brand name—
start_datestringYes开始日期/Start date YYYYMMDD—

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_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"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "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.