GetItems

Description

Given an Item identifier, the GetItems operation returns some or all of the item attributes, depending on the resources specified in the request.

GetItems supports the following high-Level resources:

• BrowseNodeInfo
• Images
• ItemInfo
• Offers
• OffersV2

To look up more than one item at a time, separate the item identifiers by commas.

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 GetItems input parameters are listed below:

Condition Parameter

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

ItemIdType Parameter

Merchant Parameter

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

Resources Parameter

| ParentASIN | Returns the parent ASIN for a given item. For more information, refer ParentASIN Resource |

Response Elements

Examples

The following is the sample json payload for GetItems request.

{
        "ItemIds": ["B0199980K4","B000HZD168","B01180YUXS","B00BKQTA4A"],
        "ItemIdType": "ASIN",
        "LanguagesOfPreference": ["en_US"],
        "Marketplace": "www.amazon.com",
        "PartnerTag": "xyz-20",
        "PartnerType": "Associates",
        "Resources": ["Images.Primary.Small","ItemInfo.Title","ItemInfo.Features",
"Offers.Summaries.HighestPrice","ParentASIN"]
}

Sample Response

The following code snippet is a response to the first request. It shows all of the item attributes that are returned by default.

{
  "Errors": [
    {
      "__type": "com.amazon.paapi#ErrorData",
      "Code": "ItemNotAccessible",
      "Message": "The ItemId B01180YUXS is not accessible through the Product Advertising API."
    }
  ],
  "ItemResults": {
    "Items": [
      {
        "ASIN": "B0199980K4",
        "DetailPageURL": "https://www.amazon.com/dp/B0199980K4?tag=xyz-20&linkCode=ogi&language=en_US&th=1&psc=1",
        "Images": {
          "Primary": {
            "Small": {
              "Height": 75,
              "URL": "https://m.media-amazon.com/images/I/61s4tTAizUL._SL75_.jpg",
              "Width": 56
            }
          }
        },
        "ItemInfo": {
          "Title": {
            "DisplayValue": "Genghis: The Legend of the Ten",
            "Label": "Title",
            "Locale": "en_US"
          }
        },
        "Offers": {
          "Summaries": [
            {
              "Condition": {
                "DisplayValue": "nuevo",
                "Label": "Condición",
                "Locale": "es_US",
                "Value": "New"
              },
              "HighestPrice": {
                "Amount": 11.99,
                "Currency": "USD",
                "DisplayAmount": "$11.99"
              }
            }
          ]
        },
        "ParentASIN": "B07QGKM68X"
      },
      {
        "ASIN": "B00BKQTA4A",
        "DetailPageURL": "https://www.amazon.com/dp/B00BKQTA4A?tag=xyz-20&linkCode=ogi&language=en_US&th=1&psc=1",
        "Images": {
          "Primary": {
            "Small": {
              "Height": 75,
              "URL": "https://m.media-amazon.com/images/I/41OiLOcQVJL._SL75_.jpg",
              "Width": 46
            }
          }
        },
        "ItemInfo": {
          "Features": {
            "DisplayValues": [
              "Round watch featuring logoed white dial with stick indices",
              "36 mm stainless steel case with mineral dial window",
              "Quartz movement with analog display",
              "Leather calfskin band with buckle closure",
              "Water resistant to 30 m (99 ft): In general, withstands splashes or brief immersion in water, but not suitable for swimming"
            ],
            "Label": "Features",
            "Locale": "en_US"
          },
          "Title": {
            "DisplayValue": "Daniel Wellington Women's 0608DW Sheffield Stainless Steel Watch",
            "Label": "Title",
            "Locale": "en_US"
          }
        },
        "Offers": {
          "Summaries": [
            {
              "Condition": {
                "DisplayValue": "nuevo",
                "Label": "Condición",
                "Locale": "es_US",
                "Value": "New"
              },
              "HighestPrice": {
                "Amount": 199,
                "Currency": "USD",
                "DisplayAmount": "$199.00"
              }
            }
          ]
        },
        "ParentASIN": "B07L5N7P32"
      },
      {
        "ASIN": "B000HZD168",
        "DetailPageURL": "https://www.amazon.com/dp/B000HZD168?tag=xyz-20&linkCode=ogi&language=en_US&th=1&psc=1",
        "Images": {
          "Primary": {
            "Small": {
              "Height": 75,
              "URL": "https://m.media-amazon.com/images/I/61ZRPpZoBvL._SL75_.jpg",
              "Width": 56
            }
          }
        },
        "ItemInfo": {
          "Title": {
            "DisplayValue": "Star Trek II: The Wrath of Khan",
            "Label": "Title",
            "Locale": "en_US"
          }
        },
        "Offers": {
          "Summaries": [
            {
              "Condition": {
                "DisplayValue": "nuevo",
                "Label": "Condición",
                "Locale": "es_US",
                "Value": "New"
              },
              "HighestPrice": {
                "Amount": 9.99,
                "Currency": "USD",
                "DisplayAmount": "$9.99"
              }
            }
          ]
        },
        "ParentASIN": "B07G9PHJJH"
      }
    ]
  }
}