GET /api/amazon/product/variants — Product Variants

Retrieve every available variant for a given Amazon product — covering dimensions such as color, size, style, material, and more. Each variant in the response carries its own ASIN, display label, direct URL, attribute set, and current price, giving you everything you need to render a complete variant selector or compare pricing across options.

Request

GET https://api.glade.dev/api/amazon/product/variants

Query Parameters

string

default:"US"

The Amazon marketplace to query. Accepted values: US UK CA DE FR IT ES AU IN MX BR JP PL. Defaults to US when omitted.

string

The Amazon Standard Identification Number of the product (e.g. B09XS7JWHH). Provide at least one of asin, url, or gtin.

string

A full Amazon product URL. Provide at least one of asin, url, or gtin.

string

A Global Trade Item Number (barcode) such as a UPC or EAN. Provide at least one of asin, url, or gtin.

Response

Variants are returned as an array under data.amazonProduct.variants.

object[]

Hide variant item fields

string

The unique ASIN for this specific variant, matching the pattern ^[A-Z0-9]{10}$.

string

Human-readable display label for this variant (e.g. Black / Large).

string

Direct Amazon URL that links to this variant’s listing.

object[]

Show attribute item

string

Attribute dimension, e.g. Color, Size, or Style.

string

Attribute value for this variant, e.g. Midnight Black or Extra Large.

object

Show price fields

string

Currency symbol, e.g. $.

number

Numeric price value, e.g. 279.99.

string

ISO 4217 currency code, e.g. USD.

string

Human-readable price string, e.g. $279.99.

Example Response

{
  "data": {
    "amazonProduct": {
      "variants": [
        {
          "asin": "B09XS7JWHH",
          "text": "Black",
          "url": "https://www.amazon.com/dp/B09XS7JWHH",
          "attributes": [
            { "name": "Color", "value": "Black" }
          ],
          "price": {
            "symbol": "$",
            "value": 279.99,
            "currency": "USD",
            "display": "$279.99"
          }
        },
        {
          "asin": "B09XS7MWVS",
          "text": "Silver",
          "url": "https://www.amazon.com/dp/B09XS7MWVS",
          "attributes": [
            { "name": "Color", "value": "Silver" }
          ],
          "price": {
            "symbol": "$",
            "value": 279.99,
            "currency": "USD",
            "display": "$279.99"
          }
        },
        {
          "asin": "B0BXJZWQ1T",
          "text": "Midnight Blue",
          "url": "https://www.amazon.com/dp/B0BXJZWQ1T",
          "attributes": [
            { "name": "Color", "value": "Midnight Blue" }
          ],
          "price": {
            "symbol": "$",
            "value": 299.99,
            "currency": "USD",
            "display": "$299.99"
          }
        },
        {
          "asin": "B0CKRGS9KN",
          "text": "Black / Bundle with Case",
          "url": "https://www.amazon.com/dp/B0CKRGS9KN",
          "attributes": [
            { "name": "Color", "value": "Black" },
            { "name": "Style", "value": "Bundle with Carrying Case" }
          ],
          "price": {
            "symbol": "$",
            "value": 319.99,
            "currency": "USD",
            "display": "$319.99"
          }
        }
      ]
    }
  }
}

Error Handling

All errors follow a consistent envelope. The HTTP status code mirrors the code field inside the errors array.

Status	Meaning
`400`	Bad request — a required parameter is missing or malformed.
`401`	Unauthorized — your API key is missing or invalid.
`402`	Payment required — your plan limit has been reached.
`429`	Too many requests — you have exceeded the rate limit for your plan.
`502`	Bad gateway — Amazon returned an unexpected response; retry with exponential back-off.

{
  "success": false,
  "errors": [
    {
      "code": 400,
      "message": "Missing required parameter: asin, url, or gtin must be provided"
    }
  ]
}

curl Example

curl --request GET \
  --url 'https://api.glade.dev/api/amazon/product/variants?asin=B09XS7JWHH&domain=US' \
  --header 'API-KEY: YOUR_API_KEY'

Products

Search & Discovery

Sellers & Categories

GET /api/amazon/product/variants — Product Variants

Request

Query Parameters

Response

Example Response

Error Handling

curl Example

​Request

​Query Parameters

​Response

​Example Response

​Error Handling

​curl Example

Request

Query Parameters

Response

Example Response

Error Handling

curl Example