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.

Productivity
1.05 credits/call

Pricing

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

ParameterTypeRequiredDescriptionDefault
asinstringYesProduct ASIN, single-ASIN query only.—
pageintegerNoThe page index of the query result. Defaults to page 1. Each page returns 20 records.1
amz_siteenum (Unknow | US | GB | DE | FR | IN | CA | JP | ES | IT | MX | AE | AU | BR | SA)NoAmazon marketplace site. Unknow

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_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
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."
  }
}