Amazon Product Variations
1.05 credits/call
ae_amazon_product_variations
Look up variation (child ASIN) details for an Amazon product. Provide one product ASIN in asin; batch-ASIN queries are not supported. Optionally set amz_site to a marketplace allowed by the input schema (default: "Unknow") and page to the result page number (default: 1; 20 records per page). The provider does not specify an output schema, so individual result fields are not guaranteed.
1.05 credits/call
Pricing
1.05 credits/call
| Condition | Charge |
|---|---|
| Each call | 1.05 credits/call |
Each call has a fixed charge of 1.05 credits.
Each call queries a specified results page for a single product ASIN. Querying another page requires a separate call and incurs another per-call charge.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
asin | string | Yes | Product ASIN, single-ASIN query only. | — |
page | integer | No | The page index of the query result. Defaults to page 1. Each page returns 20 records. | 1 |
amz_site | enum (Unknow | US | GB | DE | FR | IN | CA | JP | ES | IT | MX | AE | AU | BR | SA) | No | Amazon marketplace site. | Unknow |
Invocation example
Copy the request and explore its response example.
POST
/agent-api/v1/tool/executeX-Api-KeyRequest coderequest.sh
curl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_amazon_product_variations' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"amz_site": "US",
"asin": "B0HFMKLYLR"
}
}'Response exampleresponse.json
{
"data": [
{
"Asin": "B0HJ4Y3GZW",
"ItemIndex": 1,
"ItemTotal": 1,
"Property": "FlavorName:Strawberry,Size:1 Fl Oz (Pack of 2)",
"SalesAmount": 50
}
],
"doc": {
"asin": "Child variation ASIN",
"item_index": "Position index of the child variation (number, starting from 1), intended as a rough relative reference rather than an absolute ranking.",
"item_total": "Total number of child variations under the parent ASIN (number); indicates how many child variations the parent ASIN has in total.",
"property": "Variation property string; multiple key:value pairs separated by commas (e.g., \"Color:All the Berries,Size:16 Ounces\"); describes color, size, and other attributes of the child variation.",
"sales_volume": "Variation sales volume. Uses the most recently captured page-published sales figure for this child ASIN within the last 15 days; returns -1 if no update has been captured beyond 15 days, which does not indicate zero sales during this period."
}
}
