TikTok Product Trend
Query historical trends for a TikTok product to examine changes in sales, pricing, reviews, ratings, and promotional activity. Provide the required product_id. Optionally select site from Unknow (default), US, MY, PH, VN, TH, ID, GB, or JP, and set type to 1 for weekly data or 2 for monthly data (default). Documented metrics include sales count, cumulative sales count, sales amount, average price, review count, star rating, new promotional video count, and new promotional author count. The provider does not specify a structured output schema.
Pricing
| Condition | Charge |
|---|---|
| (trend interval == 1) | 5.25 credits/call |
| ((trend interval == not provided) || (trend interval == 2)) | 2.62 credits/call |
Each call selects one fixed price based on the request. The table lists the verified tiers. (trend interval == 1): 5.25 credits/call. ((trend interval == not provided) || (trend interval == 2)): 2.62 credits/call.
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 |
type | integer | No | type=1 weekly (costs 10 credits); type=2 monthly (default, costs 5 credit). | 2 |
product_id | string | Yes | The product ID to query. Example: 1729487740917617322. | — |
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_product_trend' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"product_id": "1731708343322579708",
"site": "US",
"type": 2
}
}'{
"data": {
"avg_price_trend": [
"2025-09"
],
"cumulative_sale_count_trend": [
"2025-09"
],
"influencer_count_trend": [
"2025-09"
],
"product_id": "1731708343322579708",
"review_count_trend": [
"2025-09"
],
"sale_amount_trend": [
"2025-09"
]
},
"doc": {
"avg_price_trend": "Average price trend, flat alternating array, same format. A data point is recorded only when the average price changes (unchanged prices are not recorded); the last entry marks the recording cutoff period.",
"cumulative_sale_count_trend": "Cumulative sales count trend (value at the end of each period), flat alternating array, same format.",
"influencer_count_trend": "New affiliate creator count trend (US site only), flat alternating array, same format.",
"product_id": "Product ID.",
"review_count_trend": "Review count trend (the last captured review count within each period), flat alternating array, same format.",
"sale_amount_trend": "Sales amount trend, in the site's local currency, flat alternating array, same format."
}
}This example shows part of the response. Copied content is valid JSON.

