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.
Pricing
| Condition | Charge |
|---|---|
| Up to one calendar year (inclusive) | 1.05 credits/call |
| More than one calendar year | 5.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.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
site | enum (UnKonw | VN | ID | SG | TH | MY | TW | PH | BR) | No | Shopee site. | UnKonw |
query_end | string | Yes | End 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_id | string | Yes | The product ID to query. | — |
query_start | string | Yes | Start 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.
/agent-api/v1/tool/executeX-Api-Keycurl --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"
}
}'{
"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.

