TikTok Category Trend

1.05 credits/call
ae_tiktok_category_trend

Query historical market trends for a TikTok category using its category node ID. Select a metric with trend_index (0–33), covering sales counts and amounts, growth rates, selling prices, reviews and star ratings, Top-10 product or seller sales shares, recently listed products, and average variation count. node_id is required; site defaults to Unknow and trend_index defaults to 0 (monthly sales count). Supported site values are Unknow, US, MY, PH, VN, TH, ID, GB and JP. A custom date range is not an available input, and the provider has not specified a structured result schema.

Social
1.05 credits/call

Pricing

1.05 credits/call
ConditionCharge
Each call1.05 credits/call

Each call is charged 1.05 AE credits.

The per-call charge is the same for all supported sites and trend metrics.

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
siteenum (Unknow | US | MY | PH | VN | TH | ID | GB | JP)NoTikTok site.Unknow
node_idstringYesThe category nodeId to query. Example: 601281.—
trend_indexintegerNoHistorical 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

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_tiktok_category_trend' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "node_id": "965128",
    "site": "GB",
    "trend_index": 0
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "data": [
    20260111
  ],
  "doc": {
    "_note": "The sample is a real response for trend_index=0 (monthly sales count trend), truncated to the first 6 data points. The actual response covers nearly 2 years, with one data point every 5-7 days."
  }
}

This example shows part of the response. Copied content is valid JSON.