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"
}
}工具参数
未传入的可选参数将使用平台默认值。
| 参数 | 类型 | 必填 | 说明 | 默认值 |
|---|---|---|---|---|
site | enum (Unknow | US | MY | PH | VN | TH | ID | GB | JP) | 否 | TikTok site. | Unknow |
node_id | string | 是 | The category nodeId to query. Example: 601281. | — |
trend_index | integer | 否 | 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 |

