Shopee Category Trend

1.05 credits/call
ae_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.

Productivity
1.05 credits/call

Pricing

1.05 credits/call
ConditionCharge
Each call1.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.

ParameterTypeRequiredDescriptionDefault
siteenum (Unknown | VN | ID | SG | TH | MY | TW | PH | BR)NoShopee site.Unknown
node_idstringNoThe category node ID to query.—
trend_indexenum (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)NoThe historical trend type to query.MonthlySalesVolume

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_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"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "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