GetVariations

Description

Given an ASIN, the GetVariations operation returns a set of items that are the same product, but differ according to a consistent theme, for example size and color. These items which differ according to a consistent theme are called variations. A variation is a child ASIN. The parent ASIN is an abstraction of the children items. For example, a shirt is a parent ASIN and parent ASINs cannot be sold. A child ASIN would be a blue shirt, size 16, sold by MyApparelStore. This child ASIN is one of potentially many variations. The ways in which variations differ are called dimensions. In the preceding example, size and color are the dimensions. Refer Organization of Items on Amazon and Variations Guide for more information.

GetVariations supports the following high-Level resources:

Availability

All locales, however, the parameter support varies by locale.

Request Parameters

Check Common Request Parameters for more information on common input parameters. For detailed information on how to create and send a request, refer Sending a Request. All GetVariations input parameters are listed below:

Name Description Required
ASIN Amazon Standard Identification Number.
  • Type: Non-Empty String
  • Default Value: None
  • Usage: {"ASIN" : "B0199980K4"}
Yes
Condition The condition parameter filters offers by condition type. For example, Condition:Used will return items having atleast one offer of Used condition type. For more information and valid values, refer Condition Parameter.
  • Type: String
  • Default Value: Any
  • Usage: {"Condition":"Used"}
No
CurrencyOfPreference Currency of preference in which the prices information should be returned in response. By default the prices are returned in the default currency of the marketplace. Expected currency code format is the ISO 4217 currency code (i.e. USD, EUR etc.). For information on default currency and valid currencies for a marketplace, refer Locale Reference.
  • Type: String (Non-Empty)
  • Default Value: None
  • Usage: {"CurrencyOfPreference":"USD"}
No
LanguagesOfPreference Languages of preference in which the information should be returned in response. By default the information is returned in the default language of the marketplace. Expected locale format is the ISO 639 language code followed by underscore followed by the ISO 3166 country code (i.e. en_US, fr_CA etc.). For information on default language and valid languages for a marketplace, refer Locale Reference.
  • Type: List of Strings (Non-Empty)
  • Default Value: None
  • Usage: {"LanguagesOfPreference":["en_US"]}
No
Marketplace Target Amazon Locale. For more information, refer Common Request Parameters.
  • Type: String
  • Default Value: None
  • Usage: {"Marketplace":"www.amazon.com"}
No
Merchant Filters search results to return items having at least one offer sold by target merchant. For more information and valid values, refer Merchant Parameter.
  • Type: String
  • Default Value: All
  • Usage: {"Merchant":"Amazon"}
No
OfferCount The number of offers desired for each item in the search results. Offers are returned if any of Offers Resources are requested.
  • Type: Positive Integer Less than 10
  • Default Value: 1
  • Usage: {"OfferCount":1}
No
PartnerTag Unique Id for a partner. For more information, refer Common Request Parameters.
  • Type: String (Non-Empty)
  • Default Value: None
  • Usage: {"PartnerTag":"xyz-20"}
Yes
PartnerType Type of Amazon program. For more information and valid values, refer Common Request Parameters.
  • Type: String
  • Default Value: None
  • Usage: {"PartnerType":"Associates"}
Yes
Resources Specifies the types of values to return. You can specify multiple resources in one request. For list of valid Resources for GetItems operation, refer Resources Parameter.
  • Type: List of Strings
  • Default Value: ["ItemInfo.Title"]
  • Usage: "Resources" : [ "Images.Primary.Small", "ItemInfo.ProductInfo"]
No
VariationCount Number of variations to be returned per page in GetVariations. By default, GetVariations returns 10 variations per page.
  • Type: Positive Integer Less than 10
  • Default Value:10
  • Usage: {"VariationCount":10}
No
VariationPage Page number of variations returned by GetVariations. By default, GetVariations returns 10 variations. Use VariationPage to return a subsection of the response. By default, there are 10 variations per page.
  • Type: Positive Integer
  • Default Value:1
  • Usage: {"VariationPage":1}
No

Condition Parameter

Note that, a GetVariations request with a particular Condition parameter may return 0 offers if there are no offers with the specified condition.

Condition Value Description
Any Offer Listings for items across any condition
New Offer Listings for New items
Used Offer Listings for Used items
Collectible Offer Listings for Collectible items
Refurbished Offer Listings for Certified Refurbished items

Merchant Parameter

Note that, a GetVariations request with a particular Merchant parameter may return 0 offers if there are no offers from the specified Merchant.

Merchant Value Description
All List offers from all Merchants
Amazon List offers only from Amazon

Resources Parameter

Resource Value Description
BrowseNodeInfo.BrowseNodes Get the browse nodes associated with the item. Using this resource only will return Id, DisplayName, ContextFreeName and IsRoot information associated with each browse node. For more information, refer BrowseNodeInfo Resources.
BrowseNodeInfo.BrowseNodes.Ancestor Get the Ancestry ladder associated with each of the browse nodes the item falls under. Using this resource will return ancestry ladder along with Id, DisplayName, ContextFreeName and IsRoot information associated with each browse node. For more information, refer BrowseNodeInfo Resources.
BrowseNodeInfo.BrowseNodes.SalesRank Get the SalesRank information with each of the browse nodes the item falls under. Using this resource will return sales rank along with Id, DisplayName, ContextFreeName and IsRoot information associated with each browse node. For more information, refer BrowseNodeInfo Resources.
BrowseNodeInfo.WebsiteSalesRank Get WebsiteSalesRank information associated with the item. For more information, refer BrowseNodeInfo Resources.
Images.Primary.Small Returns small-sized primary image for each item. For more information, refer Images Resources
Images.Primary.Medium Returns medium-sized primary image for each item. For more information, refer Images Resources
Images.Primary.Large Returns large-sized primary image for each item. For more information, refer Images Resources
Images.Variants.Small Returns small-sized variant images for each item. For more information, refer Images Resources
Images.Variants.Medium Returns medium-sized variant images for each item. For more information, refer Images Resources
Images.Variants.Large Returns large-sized variant images for each item. For more information, refer Images Resources
ItemInfo.ByLineInfo Returns set of attributes that specifies basic information of the item. For more information, refer ItemInfo Resources
ItemInfo.Classifications Returns set of attributes that are used to classify an item into a particular category. For more information, refer ItemInfo Resources
ItemInfo.ContentInfo Returns set of attributes that are specific to the content like Books, Movies, etc. For more information, refer ItemInfo Resources
ItemInfo.ContentRating Returns set of attributes that specifies what age group is suitable to view said media. For more information, refer ItemInfo Resources
ItemInfo.ExternalIds Returns set of identifiers that is used globally to identify a particular product. For more information, refer ItemInfo Resources
ItemInfo.Features Returns set of attributes that specifies an item's key features. For more information, refer ItemInfo Resources
ItemInfo.ManufactureInfo Returns set of attributes that specifies manufacturing related information of an item. For more information, refer ItemInfo Resources
ItemInfo.ProductInfo Returns set of attributes that describe non-technical aspects of an item. For more information, refer ItemInfo Resources
ItemInfo.TechnicalInfo Returns set of attributes that describes the technical aspects of the item. For more information, refer ItemInfo Resources
ItemInfo.Title Returns the title of the product. For more information, refer ItemInfo Resources
ItemInfo.TradeInInfo Returns set of attributes that specifies trade-in information of an item. For more information, refer ItemInfo Resources
Offers.Listings.Availability.MaxOrderQuantity Returns maximum number of quantity that can be purchased for a product. For more information, refer Offers Resources
Offers.Listings.Availability.Message Returns Availability message of the product. For more information, refer Offers Resources
Offers.Listings.Availability.MinOrderQuantity Returns minimum number of quantity needed to make the purchase of the product. For more information, refer Offers Resources
Offers.Listings.Availability.Type Returns availability type of the product. For more information, refer Offers Resources
Offers.Listings.Condition Returns condition of the product. For more information, refer Offers Resources
Offers.Listings.Condition.SubCondition Returns subcondition of the product. For more information, refer Offers Resources
Offers.Listings.DeliveryInfo.IsAmazonFulfilled Returns whether an offer for the product is fulfilled by Amazon. For more information, refer Offers Resources
Offers.Listings.DeliveryInfo.IsFreeShippingEligible Returns whether an offer for the product is eligible for free shipping. For more information, refer Offers Resources
Offers.Listings.DeliveryInfo.IsPrimeEligible Returns whether an offer for the product is prime eligible. For more information, refer Offers Resources
Offers.Listings.IsBuyBoxWinner Returns whether the given offer for the product is buy box winner on the detail page of the product. For more information, refer Offers Resources
Offers.Listings.LoyaltyPoints.Points Returns loyalty points related information for an offer (Currently only supported in Japan marketplace). For more information, refer Offers Resources
Offers.Listings.MerchantInfo Returns seller information for the offer of the product. For more information, refer Offers Resources
Offers.Listings.Price Returns offer buying price of a product. For more information, refer Offers Resources
Offers.Listings.ProgramEligibility.IsPrimeExclusive Returns whether a product is associated with prime exclusive members. For more information, refer Offers Resources
Offers.Listings.ProgramEligibility.IsPrimePantry Returns whether a product is associated with prime pantry program. For more information, refer Offers Resources
Offers.Listings.Promotions Returns various promotions for a product. For more information, refer Offers Resources
Offers.Listings.SavingBasis Returns strike-though price for a particular offer of the product. For more information, refer Offers Resources
Offers.Summaries.HighestPrice Returns highest buying price among all offers for a given item for a particular condition. For more information, refer Offers Resources
Offers.Summaries.LowestPrice Returns lowest buying price among all offers for a given item for a particular condition. For more information, refer Offers Resources
Offers.Summaries.OfferCount Returns total number of offers for a given item for a particular condition. For more information, refer Offers Resources
ParentASIN Returns the parent ASIN for a given item. For more information, refer ParentASIN Resource
VariationSummary.Price.HighestPrice Returns the highest price among the child ASINs. For more information, refer VariationSummary Resource
VariationSummary.Price.LowestPrice Returns the lowest price among the child ASINs. For more information, refer VariationSummary Resource
VariationSummary.VariationDimension Returns the details about the dimensions on which the attribute varies. For more information, refer VariationSummary Resource

Response Elements

Name Description
Errors List of errors.
VariationsResult Container for variations result. It contains Items container and VariationSummary container.
Items Container for item information including ASIN, Title and other attributes depending on resources requested.
VariationSummary Container for VariationSummary resource.

Example Use Cases

Example 1

Get variations for a parent ASIN.

Request Payload

{
 "ASIN": "B00422MCUS",
 "Resources": [
  "ItemInfo.Title",
  "VariationSummary.Price.HighestPrice",
  "VariationSummary.Price.LowestPrice",
  "VariationSummary.VariationDimension"
 ],
 "VariationPage": 1,
 "PartnerTag": "xyz-20",
 "PartnerType": "Associates",
 "Marketplace": "www.amazon.co.uk",
 "Operation": "GetVariations"
}

Response

{
  "VariationsResult": {
    "Items": [
      {
        "ASIN": "B019MNBMS4",
        "DetailPageURL": "https://www.amazon.co.uk/dp/B019MNBMS4?tag=xyz-20&linkCode=ogv&th=1&psc=1",
        "ItemInfo": {
          "Title": {
            "DisplayValue": "Tommy Hilfiger Men's Ranger Leather Passcase Wallet with Removable Card Holder,Navy,One Size",
            "Label": "Title",
            "Locale": "en_GB"
          }
        },
        "VariationAttributes": [
          {
            "Name": "size_name",
            "Value": "One Size"
          },
          {
            "Name": "color_name",
            "Value": "Navy"
          }
        ]
      },
      {
        "ASIN": "B073211XCB",
        "DetailPageURL": "https://www.amazon.co.uk/dp/B073211XCB?tag=xyz-20&linkCode=ogv&th=1&psc=1",
        "ItemInfo": {
          "Title": {
            "DisplayValue": "Tommy Hilfiger mens Rfid Blocking 100% Leather Passcase Wallet Wallet - Brown -",
            "Label": "Title",
            "Locale": "en_GB"
          }
        },
        "VariationAttributes": [
          {
            "Name": "size_name",
            "Value": "One Size"
          },
          {
            "Name": "color_name",
            "Value": "Logan - Tan"
          }
        ]
      },
      {
        "ASIN": "B00422MCW6",
        "DetailPageURL": "https://www.amazon.co.uk/dp/B00422MCW6?tag=xyz-20&linkCode=ogv&th=1&psc=1",
        "ItemInfo": {
          "Title": {
            "DisplayValue": "Tommy Hilfiger Men's Ranger Leather Passcase Wallet with Removable Card Holder,Black,One Size",
            "Label": "Title",
            "Locale": "en_GB"
          }
        },
        "VariationAttributes": [
          {
            "Name": "size_name",
            "Value": "One Size"
          },
          {
            "Name": "color_name",
            "Value": "Black"
          }
        ]
      },
      {
        "ASIN": "B01M2C97VG",
        "DetailPageURL": "https://www.amazon.co.uk/dp/B01M2C97VG?tag=xyz-20&linkCode=ogv&th=1&psc=1",
        "ItemInfo": {
          "Title": {
            "DisplayValue": "Tommy Hilfiger Men's Ranger Leather Passcase Wallet with Removable Card Holder,Cognac,One Size",
            "Label": "Title",
            "Locale": "en_GB"
          }
        },
        "VariationAttributes": [
          {
            "Name": "size_name",
            "Value": "One Size"
          },
          {
            "Name": "color_name",
            "Value": "Cognac"
          }
        ]
      },
      {
        "ASIN": "B00422MCVW",
        "DetailPageURL": "https://www.amazon.co.uk/dp/B00422MCVW?tag=xyz-20&linkCode=ogv&th=1&psc=1",
        "ItemInfo": {
          "Title": {
            "DisplayValue": "Tommy Hilfiger Men's Ranger Leather Passcase Wallet with Removable Card Holder,Brown,One Size",
            "Label": "Title",
            "Locale": "en_GB"
          }
        },
        "VariationAttributes": [
          {
            "Name": "size_name",
            "Value": "One Size"
          },
          {
            "Name": "color_name",
            "Value": "Brown"
          }
        ]
      },
      {
        "ASIN": "B00422MCVM",
        "DetailPageURL": "https://www.amazon.co.uk/dp/B00422MCVM?tag=xyz-20&linkCode=ogv&th=1&psc=1",
        "ItemInfo": {
          "Title": {
            "DisplayValue": "Tommy Hilfiger Men's Ranger Leather Passcase Wallet with Removable Card Holder,Tan,One Size",
            "Label": "Title",
            "Locale": "en_GB"
          }
        },
        "VariationAttributes": [
          {
            "Name": "size_name",
            "Value": "One Size"
          },
          {
            "Name": "color_name",
            "Value": "Tan"
          }
        ]
      },
      {
        "ASIN": "B01M5J1551",
        "DetailPageURL": "https://www.amazon.co.uk/dp/B01M5J1551?tag=xyz-20&linkCode=ogv&th=1&psc=1",
        "ItemInfo": {
          "Title": {
            "DisplayValue": "Tommy Hilfiger Men's Ranger Leather Passcase Wallet with Removable Card Holder,Red,One Size",
            "Label": "Title",
            "Locale": "en_GB"
          }
        },
        "VariationAttributes": [
          {
            "Name": "size_name",
            "Value": "One Size"
          },
          {
            "Name": "color_name",
            "Value": "Red"
          }
        ]
      },
      {
        "ASIN": "B07321HQRM",
        "DetailPageURL": "https://www.amazon.co.uk/dp/B07321HQRM?tag=xyz-20&linkCode=ogv&th=1&psc=1",
        "ItemInfo": {
          "Title": {
            "DisplayValue": "Tommy Hilfiger mens Ranger Passcase Wallet Wallet - Black -",
            "Label": "Title",
            "Locale": "en_GB"
          }
        },
        "VariationAttributes": [
          {
            "Name": "size_name",
            "Value": "One Size"
          },
          {
            "Name": "color_name",
            "Value": "Rfid-black"
          }
        ]
      },
      {
        "ASIN": "B01MG81M6E",
        "DetailPageURL": "https://www.amazon.co.uk/dp/B01MG81M6E?tag=xyz-20&linkCode=ogv&th=1&psc=1",
        "ItemInfo": {
          "Title": {
            "Value": "Tommy Hilfiger Men's Ranger Leather Passcase Wallet with Removable Card Holder,Green,One Size",
            "Label": "Title",
            "Locale": "en_GB"
          }
        },
        "VariationAttributes": [
          {
            "Name": "size_name",
            "Value": "One Size"
          },
          {
            "Name": "color_name",
            "Value": "Green"
          }
        ]
      },
      {
        "ASIN": "B0731XHR2W",
        "DetailPageURL": "https://www.amazon.co.uk/dp/B0731XHR2W?tag=xyz-20&linkCode=ogv&th=1&psc=1",
        "ItemInfo": {
          "Title": {
            "DisplayValue": "Tommy Hilfiger mens Ranger Passcase Wallet Wallet - Blue -",
            "Label": "Title",
            "Locale": "en_GB"
          }
        },
        "VariationAttributes": [
          {
            "Name": "size_name",
            "Value": "One Size"
          },
          {
            "Name": "color_name",
            "Value": "Rfid-navy"
          }
        ]
      }
    ],
    "VariationSummary": {
      "PageCount": 2,
      "Price": {
        "HighestPrice": {
          "Amount": 30.87,
          "Currency": "GBP",
          "DisplayAmount": "£30.87"
        },
        "LowestPrice": {
          "Amount": 17.03,
          "Currency": "GBP",
          "DisplayAmount": "£17.03"
        }
      },
      "VariationCount": 13,
      "VariationDimensions": [
        {
          "DisplayName": "Size",
          "Name": "size_name",
          "Values": [
            "One Size"
          ]
        },
        {
          "DisplayName": "Colour",
          "Name": "color_name",
          "Values": [
            "Brown",
            "Navy",
            "Black",
            "Burgundy",
            "Cognac",
            "Gray",
            "Green",
            "Logan - Tan",
            "Navy/Black",
            "Red",
            "Rfid-black",
            "Rfid-navy",
            "Tan"
          ]
        }
      ]
    }
  }
}

Example 2

Get variations for a child ASIN.

Request Payload

{
 "ASIN": "B01M2C97VG",
 "Resources": [
  "ItemInfo.Title",
  "VariationSummary.Price.HighestPrice",
  "VariationSummary.Price.LowestPrice",
  "VariationSummary.VariationDimension"
 ],
 "VariationPage": 1,
 "PartnerTag": "xyz-20",
 "PartnerType": "Associates",
 "Marketplace": "www.amazon.co.uk",
 "Operation": "GetVariations"
}

Response

{
  "VariationsResult": {
    "Items": [
      {
        "ASIN": "B019MNBMS4",
        "DetailPageURL": "https://www.amazon.co.uk/dp/B019MNBMS4?tag=xyz-20&linkCode=ogv&th=1&psc=1",
        "ItemInfo": {
          "Title": {
            "DisplayValue": "Tommy Hilfiger Men's Ranger Leather Passcase Wallet with Removable Card Holder,Navy,One Size",
            "Label": "Title",
            "Locale": "en_GB"
          }
        },
        "VariationAttributes": [
          {
            "Name": "size_name",
            "Value": "One Size"
          },
          {
            "Name": "color_name",
            "Value": "Navy"
          }
        ]
      },
      {
        "ASIN": "B073211XCB",
        "DetailPageURL": "https://www.amazon.co.uk/dp/B073211XCB?tag=xyz-20&linkCode=ogv&th=1&psc=1",
        "ItemInfo": {
          "Title": {
            "DisplayValue": "Tommy Hilfiger mens Rfid Blocking 100% Leather Passcase Wallet Wallet - Brown -",
            "Label": "Title",
            "Locale": "en_GB"
          }
        },
        "VariationAttributes": [
          {
            "Name": "size_name",
            "Value": "One Size"
          },
          {
            "Name": "color_name",
            "Value": "Logan - Tan"
          }
        ]
      },
      {
        "ASIN": "B00422MCW6",
        "DetailPageURL": "https://www.amazon.co.uk/dp/B00422MCW6?tag=xyz-20&linkCode=ogv&th=1&psc=1",
        "ItemInfo": {
          "Title": {
            "DisplayValue": "Tommy Hilfiger Men's Ranger Leather Passcase Wallet with Removable Card Holder,Black,One Size",
            "Label": "Title",
            "Locale": "en_GB"
          }
        },
        "VariationAttributes": [
          {
            "Name": "size_name",
            "Value": "One Size"
          },
          {
            "Name": "color_name",
            "Value": "Black"
          }
        ]
      },
      {
        "ASIN": "B01M2C97VG",
        "DetailPageURL": "https://www.amazon.co.uk/dp/B01M2C97VG?tag=xyz-20&linkCode=ogv&th=1&psc=1",
        "ItemInfo": {
          "Title": {
            "DisplayValue": "Tommy Hilfiger Men's Ranger Leather Passcase Wallet with Removable Card Holder,Cognac,One Size",
            "Label": "Title",
            "Locale": "en_GB"
          }
        },
        "VariationAttributes": [
          {
            "Name": "size_name",
            "Value": "One Size"
          },
          {
            "Name": "color_name",
            "Value": "Cognac"
          }
        ]
      },
      {
        "ASIN": "B00422MCVW",
        "DetailPageURL": "https://www.amazon.co.uk/dp/B00422MCVW?tag=xyz-20&linkCode=ogv&th=1&psc=1",
        "ItemInfo": {
          "Title": {
            "DisplayValue": "Tommy Hilfiger Men's Ranger Leather Passcase Wallet with Removable Card Holder,Brown,One Size",
            "Label": "Title",
            "Locale": "en_GB"
          }
        },
        "VariationAttributes": [
          {
            "Name": "size_name",
            "Value": "One Size"
          },
          {
            "Name": "color_name",
            "Value": "Brown"
          }
        ]
      },
      {
        "ASIN": "B00422MCVM",
        "DetailPageURL": "https://www.amazon.co.uk/dp/B00422MCVM?tag=xyz-20&linkCode=ogv&th=1&psc=1",
        "ItemInfo": {
          "Title": {
            "DisplayValue": "Tommy Hilfiger Men's Ranger Leather Passcase Wallet with Removable Card Holder,Tan,One Size",
            "Label": "Title",
            "Locale": "en_GB"
          }
        },
        "VariationAttributes": [
          {
            "Name": "size_name",
            "Value": "One Size"
          },
          {
            "Name": "color_name",
            "Value": "Tan"
          }
        ]
      },
      {
        "ASIN": "B01M5J1551",
        "DetailPageURL": "https://www.amazon.co.uk/dp/B01M5J1551?tag=xyz-20&linkCode=ogv&th=1&psc=1",
        "ItemInfo": {
          "Title": {
            "DisplayValue": "Tommy Hilfiger Men's Ranger Leather Passcase Wallet with Removable Card Holder,Red,One Size",
            "Label": "Title",
            "Locale": "en_GB"
          }
        },
        "VariationAttributes": [
          {
            "Name": "size_name",
            "Value": "One Size"
          },
          {
            "Name": "color_name",
            "Value": "Red"
          }
        ]
      },
      {
        "ASIN": "B07321HQRM",
        "DetailPageURL": "https://www.amazon.co.uk/dp/B07321HQRM?tag=xyz-20&linkCode=ogv&th=1&psc=1",
        "ItemInfo": {
          "Title": {
            "DisplayValue": "Tommy Hilfiger mens Ranger Passcase Wallet Wallet - Black -",
            "Label": "Title",
            "Locale": "en_GB"
          }
        },
        "VariationAttributes": [
          {
            "Name": "size_name",
            "Value": "One Size"
          },
          {
            "Name": "color_name",
            "Value": "Rfid-black"
          }
        ]
      },
      {
        "ASIN": "B01MG81M6E",
        "DetailPageURL": "https://www.amazon.co.uk/dp/B01MG81M6E?tag=xyz-20&linkCode=ogv&th=1&psc=1",
        "ItemInfo": {
          "Title": {
            "DisplayValue": "Tommy Hilfiger Men's Ranger Leather Passcase Wallet with Removable Card Holder,Green,One Size",
            "Label": "Title",
            "Locale": "en_GB"
          }
        },
        "VariationAttributes": [
          {
            "Name": "size_name",
            "Value": "One Size"
          },
          {
            "Name": "color_name",
            "Value": "Green"
          }
        ]
      },
      {
        "ASIN": "B0731XHR2W",
        "DetailPageURL": "https://www.amazon.co.uk/dp/B0731XHR2W?tag=xyz-20&linkCode=ogv&th=1&psc=1",
        "ItemInfo": {
          "Title": {
            "DisplayValue": "Tommy Hilfiger mens Ranger Passcase Wallet Wallet - Blue -",
            "Label": "Title",
            "Locale": "en_GB"
          }
        },
        "VariationAttributes": [
          {
            "Name": "size_name",
            "Value": "One Size"
          },
          {
            "Name": "color_name",
            "Value": "Rfid-navy"
          }
        ]
      }
    ],
    "VariationSummary": {
      "PageCount": 2,
      "Price": {
        "HighestPrice": {
          "Amount": 30.87,
          "Currency": "GBP",
          "DisplayAmount": "£30.87"
        },
        "LowestPrice": {
          "Amount": 17.03,
          "Currency": "GBP",
          "DisplayAmount": "£17.03"
        }
      },
      "VariationCount": 13,
      "VariationDimensions": [
        {
          "DisplayName": "Size",
          "Name": "size_name",
          "Values": [
            "One Size"
          ]
        },
        {
          "DisplayName": "Colour",
          "Name": "color_name",
          "Values": [
            "Brown",
            "Navy",
            "Black",
            "Burgundy",
            "Cognac",
            "Gray",
            "Green",
            "Logan - Tan",
            "Navy/Black",
            "Red",
            "Rfid-black",
            "Rfid-navy",
            "Tan"
          ]
        }
      ]
    }
  }
}

Example 3

Get next set of variations for an ASIN using VariationPage parameter.

Request Payload

{
 "ASIN": "B00422MCUS",
 "Resources": [
  "ItemInfo.Title",
  "VariationSummary.Price.HighestPrice",
  "VariationSummary.Price.LowestPrice",
  "VariationSummary.VariationDimension"
 ],
 "VariationPage": 2,
 "PartnerTag": "xyz-20",
 "PartnerType": "Associates",
 "Marketplace": "www.amazon.co.uk",
 "Operation": "GetVariations"
}

Response


 "VariationsResult": {
  "Items": [
   {
    "ASIN": "B075TFCB3R",
    "DetailPageURL": "https://www.amazon.co.uk/dp/B075TFCB3R?tag=xyz-20&linkCode=ogv&th=1&psc=1",
    "ItemInfo": {
     "Title": {
      "DisplayValue": "Tommy Hilfiger Men's RFID Blocking 100% Leather Ranger Passcase Wallet Bi-Fold, Navy/Black, One Size",
      "Label": "Title",
      "Locale": "en_GB"
     }
    },
    "VariationAttributes": [
     {
      "Name": "size_name",
      "Value": "One Size"
     },
     {
      "Name": "color_name",
      "Value": "Navy/Black"
     }
    ]
   },
   {
    "ASIN": "B0743JLQKT",
    "DetailPageURL": "https://www.amazon.co.uk/dp/B0743JLQKT?tag=xyz-20&linkCode=ogv&th=1&psc=1",
    "ItemInfo": {
     "Title": {
      "DisplayValue": "Tommy Hilfiger Men's Ranger Leather Passcase Wallet, Gray",
      "Label": "Title",
      "Locale": "en_GB"
     }
    },
    "VariationAttributes": [
     {
      "Name": "size_name",
      "Value": "One Size"
     },
     {
      "Name": "color_name",
      "Value": "Gray"
     }
    ]
   },
   {
    "ASIN": "B0743JL719",
    "DetailPageURL": "https://www.amazon.co.uk/dp/B0743JL719?tag=xyz-20&linkCode=ogv&th=1&psc=1",
    "ItemInfo": {
     "Title": {
      "DisplayValue": "Tommy Hilfiger Men's Ranger Leather Passcase Wallet, Burgundy",
      "Label": "Title",
      "Locale": "en_GB"
     }
    },
    "VariationAttributes": [
     {
      "Name": "size_name",
      "Value": "One Size"
     },
     {
      "Name": "color_name",
      "Value": "Burgundy"
     }
    ]
   }
  ],
  "VariationSummary": {
   "PageCount": 2,
   "Price": {
    "HighestPrice": {
     "Amount": 30.87,
     "Currency": "GBP",
     "DisplayAmount": "£30.87"
    },
    "LowestPrice": {
     "Amount": 17.03,
     "Currency": "GBP",
     "DisplayAmount": "£17.03"
    }
   },
   "VariationCount": 13,
   "VariationDimensions": [
    {
     "DisplayName": "Size",
     "Name": "size_name",
     "Values": [
      "One Size"
     ]
    },
    {
     "DisplayName": "Colour",
     "Name": "color_name",
     "Values": [
      "Brown",
      "Navy",
      "Black",
      "Burgundy",
      "Cognac",
      "Gray",
      "Green",
      "Logan - Tan",
      "Navy/Black",
      "Red",
      "Rfid-black",
      "Rfid-navy",
      "Tan"
     ]
    }
   ]
  }
 }
}

Example 4

Get 3 variations for an ASIN using VariationCount parameter.

Request Payload

{
 "ASIN": "B00422MCUS",
 "Resources": [
  "ItemInfo.Title",
  "VariationSummary.Price.HighestPrice",
  "VariationSummary.Price.LowestPrice",
  "VariationSummary.VariationDimension"
 ],
 "VariationCount": 3,
 "PartnerTag": "xyz-20",
 "PartnerType": "Associates",
 "Marketplace": "www.amazon.co.uk",
 "Operation": "GetVariations"
}

Response

{
  "VariationsResult": {
    "Items": [
      {
        "ASIN": "B00422MCVM",
        "DetailPageURL": "https://www.amazon.co.uk/dp/B00422MCVM?tag=xyz-20&linkCode=ogv&th=1&psc=1",
        "ItemInfo": {
          "Title": {
            "DisplayValue": "Tommy Hilfiger Men's Ranger Leather Passcase Wallet with Removable Card Holder,Tan,One Size",
            "Label": "Title",
            "Locale": "en_GB"
          }
        },
        "VariationAttributes": [
          {
            "Name": "size_name",
            "Value": "One Size"
          },
          {
            "Name": "color_name",
            "Value": "Tan"
          }
        ]
      },
      {
        "ASIN": "B00422MCW6",
        "DetailPageURL": "https://www.amazon.co.uk/dp/B00422MCW6?tag=xyz-20&linkCode=ogv&th=1&psc=1",
        "ItemInfo": {
          "Title": {
            "DisplayValue": "Tommy Hilfiger Men's Ranger Leather Passcase Wallet with Removable Card Holder,Black,One Size",
            "Label": "Title",
            "Locale": "en_GB"
          }
        },
        "VariationAttributes": [
          {
            "Name": "size_name",
            "Value": "One Size"
          },
          {
            "Name": "color_name",
            "Value": "Black"
          }
        ]
      },
      {
        "ASIN": "B00422MCVW",
        "DetailPageURL": "https://www.amazon.co.uk/dp/B00422MCVW?tag=xyz-20&linkCode=ogv&th=1&psc=1",
        "ItemInfo": {
          "Title": {
            "DisplayValue": "Tommy Hilfiger Men's Ranger Leather Passcase Wallet with Removable Card Holder,Brown,One Size",
            "Label": "Title",
            "Locale": "en_GB"
          }
        },
        "VariationAttributes": [
          {
            "Name": "size_name",
            "Value": "One Size"
          },
          {
            "Name": "color_name",
            "Value": "Brown"
          }
        ]
      }
    ],
    "VariationSummary": {
      "PageCount": 5,
      "Price": {
        "HighestPrice": {
          "Amount": 30.87,
          "Currency": "GBP",
          "DisplayAmount": "£30.87"
        },
        "LowestPrice": {
          "Amount": 17.03,
          "Currency": "GBP",
          "DisplayAmount": "£17.03"
        }
      },
      "VariationCount": 13,
      "VariationDimensions": [
        {
          "DisplayName": "Size",
          "Name": "size_name",
          "Values": [
            "One Size"
          ]
        },
        {
          "DisplayName": "Colour",
          "Name": "color_name",
          "Values": [
            "Brown",
            "Navy",
            "Black",
            "Burgundy",
            "Cognac",
            "Gray",
            "Green",
            "Logan - Tan",
            "Navy/Black",
            "Red",
            "Rfid-black",
            "Rfid-navy",
            "Tan"
          ]
        }
      ]
    }
  }
}

results matching ""

    No results matching ""