Shopee Category Trend
Query a Shopee category's historical market trend using site, node_id (category node ID), and trend_index. Supported site codes are VN, ID, SG, TH, MY, TW, PH, and BR; site defaults to Unknown. Choose one trend_index value per call; it defaults to MonthlySalesVolume. Dimensions include monthly sales volume and amount, average price, reviews and ratings, seller and brand counts, store-type metrics, listing-age groups of 1/3/6/12/24 months, and top-3/top-5/top-10 product or seller sales shares. Query different dimensions in separate calls. The input contract has no date-range selector, and the provider does not specify historical coverage or a fixed output structure.
Pricing
| Condition | Charge |
|---|---|
| Each call | 1.05 credits/call |
Each call is charged 1.05 AE credits.
Each call queries one trend metric for the specified Shopee site and category. To query multiple metrics, make separate calls; each call is charged separately.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
site | enum (Unknown | VN | ID | SG | TH | MY | TW | PH | BR) | No | Shopee site. | Unknown |
node_id | string | No | The category node ID to query. | — |
trend_index | enum (MonthlySalesVolume | MonthlySalesAmount | AveragePrice | AverageReviewCount | AverageStarRating | SellerCount | AverageVariantCount | BrandCount | FlagshipStoreCount | FlagshipStoreRatio | FlagshipStoreMonthlySales | FlagshipStoreMonthlySalesRatio | PreferredStoreCount | PreferredStoreRatio | PreferredStoreMonthlySales | PreferredStoreMonthlySalesRatio | OrdinaryStoreCount | OrdinaryStoreRatio | OrdinaryStoreMonthlySales | OrdinaryStoreMonthlySalesRatio | Listed1MonthProductCount | Listed1MonthProductCountRatio | Listed1MonthSalesVolume | Listed1MonthSalesVolumeRatio | Listed1MonthSalesAmount | Listed1MonthSalesAmountRatio | Listed1MonthAvgStarRating | Listed1MonthAvgReviewCount | Listed1MonthAvgPrice | Listed3MonthProductCount | Listed3MonthProductCountRatio | Listed3MonthSalesVolume | Listed3MonthSalesVolumeRatio | Listed3MonthSalesAmount | Listed3MonthSalesAmountRatio | Listed3MonthAvgStarRating | Listed3MonthAvgReviewCount | Listed3MonthAvgPrice | Listed6MonthProductCount | Listed6MonthProductCountRatio | Listed6MonthSalesVolume | Listed6MonthSalesVolumeRatio | Listed6MonthSalesAmount | Listed6MonthSalesAmountRatio | Listed6MonthAvgStarRating | Listed6MonthAvgReviewCount | Listed6MonthAvgPrice | Listed12MonthProductCount | Listed12MonthProductCountRatio | Listed12MonthSalesVolume | Listed12MonthSalesVolumeRatio | Listed12MonthSalesAmount | Listed12MonthSalesAmountRatio | Listed12MonthAvgStarRating | Listed12MonthAvgReviewCount | Listed12MonthAvgPrice | Listed24MonthProductCount | Listed24MonthProductCountRatio | Listed24MonthSalesVolume | Listed24MonthSalesVolumeRatio | Listed24MonthSalesAmount | Listed24MonthSalesAmountRatio | Listed24MonthAvgStarRating | Listed24MonthAvgReviewCount | Listed24MonthAvgPrice | Top3ProductSalesVolumeRatio | Top3ProductSalesAmountRatio | Top3SellerSalesVolumeRatio | Top3SellerSalesAmountRatio | Top5ProductSalesVolumeRatio | Top5ProductSalesAmountRatio | Top5SellerSalesVolumeRatio | Top5SellerSalesAmountRatio | Top10ProductSalesVolumeRatio | Top10ProductSalesAmountRatio | Top10SellerSalesVolumeRatio | Top10SellerSalesAmountRatio) | No | The historical trend type to query. | MonthlySalesVolume |
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_category_trend' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"node_id": "11107129",
"site": "MY",
"trend_index": "MonthlySalesVolume"
}
}'{
"data": [
20250921
],
"doc": {
"_note": "The return value is a flat key-value array: odd-index entries are date strings (yyyyMMdd), even-index entries are the corresponding numerical values (float). Different trend_index values correspond to different statistical metrics (e.g. MonthlySalesVolume "
}
}This example shows part of the response. Copied content is valid JSON.
Guides using this tool
See how this tool fits into real workflows

