Amazon Category Trend
Query Amazon sub-category market trends using statistics for the sub-category's top 100 products. Provide a sub-category node_id; optionally select the Amazon marketplace with amz_site and the metric with trend_index. Metrics cover sales count, brand and seller product counts, average price, average rating count and score, and sales-amount shares for new products, Amazon, and the top three products, brands, or sellers. The default metric is SalesCount and the default marketplace value is Unknow. These statistics describe the top-100-product sample, not the entire market; the provider does not specify a fixed output schema.
Pricing
| Condition | Charge |
|---|---|
| Each call | 1 credits/call |
Each call queries one trend metric for one sub-category. Statistics cover the sub-category’s top-ranked products and do not represent the entire market.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
node_id | string | Yes | The sub-category node_id to query; data type: string. | — |
amz_site | enum (Unknow | US | GB | DE | FR | IN | CA | JP | ES | IT | MX | AE | AU | BR | SA) | No | Amazon marketplace site. | Unknow |
trend_index | enum (SalesCount | BrandProductCount | SellerProductCount | AvgPrice | AvgRatingCount | AvgScore | NewProductSalesAmountShare | AmazonSalesAmountShare | Top3ProductSalesAmountShare | Top3BrandSalesAmountShare | Top3SellerSalesAmountShare) | No | The trend type. Defaults to SalesCount. | SalesCount |
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_amazon_category_trend' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"amz_site": "US",
"node_id": "671804011",
"trend_index": "SalesCount"
}
}'{
"data": [
"2024-11=92006"
],
"doc": {
"category_monthly_sales_volume_trend": "Array of monthly category trend points; each element is a text of \"yyyy-MM=N\"."
}
}This example shows part of the response. Copied content is valid JSON.

