Amazon Category Products
Retrieve an Amazon category's BestSeller Top100 product list in one call, with no pagination. Provide the required node_id (category node ID, for example 7073960011). Optionally specify amz_site as US, GB, DE, FR, IN, CA, JP, ES, IT, MX, AE, AU, BR, or SA; the schema also accepts and defaults to the literal Unknow. Use the returned product information to support competitive research, price-band comparisons, and product-launch analysis. The provider describes information such as ASIN, title, brand, price, sales volume, rating, category, and seller; no formal output schema is supplied, so the actual response determines the available fields.
Pricing
| Condition | Charge |
|---|---|
| Each call | 5.25 credits/call |
Each call has a fixed charge of 5.25 credits.
The category bestseller product list is returned in one call without pagination. The charge does not increase with the number of products returned.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
node_id | string | Yes | Category NodeId. Example:7073960011 | — |
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_category_products' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"amz_site": "SA",
"node_id": "28071559031"
}
}'"No data available."
