TikTok Product Trend

Paid tiers from 2.62 credits/call
ae_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.

Social
Paid tiers from 2.62 credits/call

Pricing

ConditionCharge
(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.

ParameterTypeRequiredDescriptionDefault
siteenum (Unknow | US | MY | PH | VN | TH | ID | GB | JP)NoTikTok site.Unknow
typeintegerNotype=1 weekly (costs 10 credits); type=2 monthly (default, costs 5 credit).2
product_idstringYesThe product ID to query. Example: 1729487740917617322.—

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_product_trend' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "product_id": "1731708343322579708",
    "site": "US",
    "type": 2
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "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.