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.
Pricing
| Condition | Charge |
|---|---|
| Each call | 1.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.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
site | enum (Unknow | US | MY | PH | VN | TH | ID | GB | JP) | No | TikTok site. | Unknow |
node_id | string | Yes | The category nodeId to query. Example: 601281. | — |
trend_index | integer | No | 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 |
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_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
}
}'{
"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.

