Amazon Category Trend

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

Productivity
1 credits/call

Pricing

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

ParameterTypeRequiredDescriptionDefault
node_idstringYesThe sub-category node_id to query; data type: string.—
amz_siteenum (Unknow | US | GB | DE | FR | IN | CA | JP | ES | IT | MX | AE | AU | BR | SA)NoAmazon marketplace site. Unknow
trend_indexenum (SalesCount | BrandProductCount | SellerProductCount | AvgPrice | AvgRatingCount | AvgScore | NewProductSalesAmountShare | AmazonSalesAmountShare | Top3ProductSalesAmountShare | Top3BrandSalesAmountShare | Top3SellerSalesAmountShare)NoThe trend type. Defaults to SalesCount.SalesCount

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