TikTok Category Trend

1积分/次
ae_tiktok_category_trend

通过 TikTok 类目节点 ID 查询该类目市场的历史趋势。使用 trend_index 选择指标(0–33),涵盖销量、销售额及其环比变化、售价、评论数与星级评分、前十商品或卖家的销售占比、近 3 个月或 6 个月上架商品的相关指标,以及平均变体数。node_id 为必填字符串;site 默认为 Unknow,支持 Unknow、US、MY、PH、VN、TH、ID、GB、JP;trend_index 默认为 0(月销量)。输入契约不包含自定义日期范围,上游未提供结构化结果 Schema。

社交
1积分/次

价格说明

1积分/次
条件费用
每次调用1积分/次

选择不同的站点或趋势指标不影响每次调用的费用。

API 调用

通过统一工具网关发起同步请求,鉴权和计费由 AgentEarth 处理。

cURL
curl --request POST \
  --url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_tiktok_category_trend' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "node_id": "xxx"
  }
}'
请求方式
POST
接口地址
/agent-api/v1/tool/execute
鉴权方式
X-Api-Key
超时时间
60 秒
响应示例
{
  "error_no": 0,
  "error_msg": "",
  "result": [
    {
      "type": "text",
      "text": "xxx"
    }
  ],
  "platform_annotations": {
    "source": "AgentEarth",
    "platform_note": "xxx",
    "platform_suggestion": "xxx"
  }
}

工具参数

未传入的可选参数将使用平台默认值。

参数类型必填说明默认值
siteenum (Unknow | US | MY | PH | VN | TH | ID | GB | JP)否TikTok site.Unknow
node_idstring是The category nodeId to query. Example: 601281.—
trend_indexinteger否Historical trend type: 0=monthly sales count, 1=monthly sales count MoM, 2=monthly sales amount, 3=monthly sales amount MoM, 4=weekly sales count, 5=weekly sales count WoW, 6=weekly sales amount, 7=weekly sales amount WoW, 8=cumulative sales count, 9=average selling price, 10=average price MoM, 11=median selling price, 12=median price MoM, 13=average review count, 14=average star rating, 15=Top-10 product monthly sales share, 16=Top-10 product weekly sales share, 17=Top-10 seller monthly sales share, 18=Top-10 seller weekly sales share, 19=product count listed within 3 months, 20=monthly sales count of products listed within 3 months, 21=monthly sales amount of products listed within 3 months, 22=average price of products listed within 3 months, 23=monthly sales share of products listed within 3 months, 24=average star of products listed within 3 months, 25=average review count of products listed within 3 months, 26=product count listed within 6 months, 27=monthly sales count of products listed within 6 months, 28=monthly sales amount of products listed within 6 months, 29=average price of products listed within 6 months, 30=monthly sales share of products listed within 6 months, 31=average star of products listed within 6 months, 32=average review count of products listed within 6 months, 33=average variation count.0