Shopee Product Trend

From 1.05 credits/call
ae_shopee_product_trend

Draft pending review: query historical trends for a Shopee product across star rating, comment count, price, cumulative sales, and last-30-day sales. Provide product_id; optionally choose site (Unknown, VN, ID, SG, TH, MY, TW, PH, BR; default Unknown) and query_start/query_end in yyyy-MM-dd format. The default period is the last year through the current time. The provider does not specify the result structure. This description does not indicate that the tool is live. Both query_start and query_end are required ISO dates (YYYY-MM-DD); no dates are filled automatically.

Productivity
From 1.05 credits/call

Pricing

From 1.05 credits/call
ConditionCharge
Up to one calendar year (inclusive)1.05 credits/call
More than one calendar year5.25 credits/call

The charge per call is 1.05 credits for a date range up to one calendar year, or 5.25 credits for a longer range.

The starting charge applies to normal successful queries for a single product over a date range up to one calendar year, inclusive. Provide the product ID and both the query start and end dates in yyyy-MM-dd format; no default date range is assumed. All trend dimensions belong to the same query and are not charged separately by dimension.

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
siteenum (UnKonw | VN | ID | SG | TH | MY | TW | PH | BR)NoShopee site.UnKonw
query_endstringYesEnd date in yyyy-MM-dd format. Required: provide both query_start and query_end explicitly; no default date is assumed. Ranges longer than one calendar year use the longer-range pricing tier.—
product_idstringYesThe product ID to query.—
query_startstringYesStart date in yyyy-MM-dd format. Required: provide both query_start and query_end explicitly; no default date is assumed. Ranges longer than one calendar year use the longer-range pricing tier.—

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_shopee_product_trend' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "product_id": "43578764656",
    "query_end": "2026-11-02",
    "query_start": "2026-01-01",
    "site": "ID"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "data": {
    "price_trend": [
      "2026-06-09"
    ],
    "product_id": "43578764656",
    "review_count_trend": [
      "2026-06"
    ],
    "sale_count_trend": [
      "2026-06-09"
    ],
    "sale_total_count_trend": [
      "2026-06-09"
    ],
    "star_trend": [
      "2026-06"
    ]
  },
  "doc": {
    "price_trend": "Price history trend (daily), flat array [date, price, ...]; price in the site's local currency, e.g. MYR (main currency unit, not cents).",
    "product_id": "Shopee product ID.",
    "review_count_trend": "Review count trend (monthly), flat array [month(YYYY-MM), count, ...].",
    "sale_count_trend": "Last-30-day sales volume trend (daily), flat array [date(YYYY-MM-DD), value, date(YYYY-MM-DD), value, ...].",
    "sale_total_count_trend": "Cumulative sales volume trend (daily), flat array.",
    "star_trend": "Star rating trend (monthly), flat array [month(YYYY-MM), star, ...]."
  }
}

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