Amazon Product Trend
Query an Amazon product's historical trends by ASIN to support sales, pricing, ranking, and review analysis. asin is required. The optional type selects monthly sales volume (SalesVolume, the default), monthly sales amount (SalesAmount), price (Price), original list price (ListPrice), monthly main-category rank (Rank), daily subcategory BSR rank (BsrRank), review count (ReviewCount), star rating (Star), sales quantity for each corresponding date (DailySalesVolume), or monthly sales volume for the specified ASIN itself, separate from other child variations (AsinSalesVolume). Use optional amz_site to select US, GB, DE, FR, IN, CA, JP, ES, IT, MX, AE, AU, BR, or SA; the schema default is Unknow. Results are described as a flat key-value array; no fixed output schema or historical coverage period is specified.
Pricing
| Trend dimension | Charge |
|---|---|
| DailySalesVolume, BsrRank | 5.25 credits/call |
| Other trend dimensions | 2.62 credits/call |
Each call is charged 5.25 AE credits when type is DailySalesVolume or BsrRank, and 2.62 AE credits for other trend dimensions.
Each call queries one trend dimension for a single ASIN. If type is omitted, SalesVolume is used by default.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
asin | string | Yes | Product ASIN. Example: B0CVM8TXHP | — |
type | string | No | Trend dimension, default SalesVolume. Enum: SalesVolume=Monthly sales volume trend; SalesAmount=Monthly sales amount trend; Price=Price trend; ListPrice=Original list price trend; Rank=Main category monthly rank trend; BsrRank=Subcategory BSR daily rank trend; ReviewCount=Review count trend; Star=Star rating trend;DailySalesVolume=It indicates the sales quantity of the ASIN on Amazon's platform for the corresponding date; AsinSalesVolume=ASIN-level monthly sales volume (only current asin itself, separate child variations). | SalesVolume |
amz_site | enum (Unknow | US | GB | DE | FR | IN | CA | JP | ES | IT | MX | AE | AU | BR | SA) | No | Amazon marketplace site. Allowed: US、GB、DE、FR、IN、CA、JP、ES、IT、MX、AE、AU、BR、SA. | Unknow |
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_product_trend' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"amz_site": "US",
"asin": "B0HN286RRK",
"type": "BsrRank"
}
}'{
"data": {
"asin": "B0HN286RRK",
"data": [
{
"name": "Manual Weeders",
"node_id": "553934",
"rank": [
{
"date": "2026-10-21",
"value": -1
}
]
}
],
"type": "BsrRank"
},
"doc": {
"asin": "Product ASIN.",
"data": "Trend data array. For monthly dimension: flat key-value array, even index = month yyyyMM, odd index = value. For BsrRank: structured object array grouped by subcategory, each contains node_id, name, rank array [{date,value}]. Price / ListPrice / SalesAmoun",
"type": "Actual queried trend dimension for trace."
}
}This example shows part of the response. Copied content is valid JSON.

