Amazon Category Market Statistics

1.05 credits/call
ae_amazon_category_market_statistics

Query an Amazon category market statistics report to assess market size, competitive concentration and potential return risk. Provide a category node_id; optionally select an Amazon marketplace with amz_site and a date range using query_start and query_date (yyyy-MM-dd). Supported date spans are 3–40 days, historical coverage is approximately two years, and the latest available end date is two days before the current date. The report uses monthly statistics based on the category's Top100 products, with historical Top100 products combined for date-range queries. The provider describes 19 statistical dimensions, including sales volume and sales value, Top3 product/brand/seller concentration, brand and seller lists, prices, rating and review distributions, return rate, conversion rate, and average days listed. Product rankings are not included. Exact response field names are not specified by the provider.

Productivity
1.05 credits/call

Pricing

1.05 credits/call
ConditionCharge
Each call1.05 credits/call

Each call is charged 1.05 AE credits.

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
node_idstringYesCategory NodeId. Example:7073960011—
amz_siteenum (Unknow | US | GB | DE | FR | IN | CA | JP | ES | IT | MX | AE | AU | BR | SA)NoAmazon marketplace site. Allowed: US、GB、DE、FR、IN、CA、JP、ES、IT、MX、AE、AU、BR、SA.Unknow
query_datestringNoQuery end date, format yyyy-MM-dd. Optional. Combine historical Top100 products, latest available up to 2 days before current date. Valid span: 3-40 days. Example:2026-08-10""
query_startstringNoQuery start date, format yyyy-MM-dd. Optional. Combine historical Top100 products, maximum available for nearly 2 years. Valid span: 3-40 days. Example:2026-08-01""

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_amazon_category_market_statistics' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "amz_site": "AU",
    "node_id": "10554306051",
    "query_date": "2026-10-31",
    "query_start": "2026-10-01"
  }
}'
Response exampleresponse.json
JSON
"No data available."

Guides using this tool

See how this tool fits into real workflows