GetItems
Looks up products by their ASIN, the 10-character product ID in every Amazon product URL
(e.g. B09B2SBHQK). Use it when you already know which products you want to show, for example to
keep prices and availability on your site up to date.
You can ask for up to 10 ASINs per request, and it still counts as one request against your limit.
With resources you choose which data comes back. Only ask for what you display, it keeps
responses small and fast.
POST https://creatorsapi.amazon/catalog/v1/getItems
Parameters
Section titled “Parameters”| Name | Required | Notes |
|---|---|---|
itemIds |
yes | 1 to 10 ASINs |
itemIdType |
no | ASIN (only value) |
partnerTag |
yes | tag of the requested marketplace |
marketplace |
yes | e.g. www.amazon.de, also as x-marketplace header |
resources |
no | which data to return, e.g. images.primary.medium, offersV2.listings.price; default is the title only |
condition |
no | Any or New |
currencyOfPreference, languagesOfPreference |
no | per marketplace |
Example request
Section titled “Example request”{ "itemIds": ["B09B2SBHQK", "B09B8V1LZ3"], "itemIdType": "ASIN", "marketplace": "www.amazon.com", "partnerTag": "xyz-20", "resources": ["images.primary.small", "itemInfo.title", "offersV2.listings.price", "parentASIN"]}Response
Section titled “Response”Items are in itemsResult.items. If some ASINs fail, they appear in an errors array with HTTP 200
(InvalidParameterValue); if all fail, you get
ResourceNotFoundException. The order of items can differ
from your itemIds, so match them by asin.