Product Lookup Response

For Product Lookup, result contains the marketplace country code and a search_result object with every Amazon listing that matches the identifier. Every response uses the shared response envelope (request_info, request_parameters, request_metadata, result).

Response structure

result
├── country_code
└── search_result
    ├── total_product_count
    └── products[]
        ├── asin
        ├── title
        ├── brand
        ├── manufacturer
        ├── model_number
        ├── link
        ├── identifiers[]
        │   ├── type
        │   └── value
        ├── main_image { id, link }
        ├── thumb_image { id, link }
        ├── image_url          (scheduled for removal)
        └── thumb_string_url   (scheduled for removal)

Result fields

`result`

Field	Type	Description
`country_code`	string	ISO 3166 alpha-2 code of the marketplace the data comes from, for example `US`.
`search_result`	object	The lookup results. See below.

`result.search_result`

Field	Type	Description
`total_product_count`	integer	Number of Amazon listings that match the identifier.
`products`	array	One object per matching listing. See below.

`products[]`

Field	Type	Description
`asin`	string	ASIN of the listing.
`title`	string	Product title as shown on Amazon.
`brand`	string	Brand name.
`manufacturer`	string	Manufacturer name.
`model_number`	string	Manufacturer model or part number. Not present for every product.
`link`	string	Product page URL, for example `https://www.amazon.com/dp/B000024D4S`.
`identifiers`	array	Global codes registered for this listing. See below.
`main_image.id`	string	Image ID of the main image.
`main_image.link`	string	URL of the main image.
`thumb_image.id`	string	Image ID of the thumbnail.
`thumb_image.link`	string	URL of the thumbnail.
`image_url`	string	Scheduled for removal. Use `main_image.link`.
`thumb_string_url`	string	Scheduled for removal. Use `thumb_image.link`.

`products[].identifiers[]`

Field	Type	Description
`type`	string	Identifier type in lower case, for example `upc`, `ean`, `gtin`.
`value`	string	Identifier value as a string, with leading zeros kept, for example `0724382975021`.

Sample response

This sample is a UPC lookup (identifier_type=UPC, identifier=724382975021) that matches two Amazon listings. The /* ... */ comments mark the fields scheduled for removal, so the block is not valid JSON as shown.

Sample response (PRODUCT_LOOKUP, .com)

{
  "request_info": {
    "id": "7cdbc505-5642-4882-9e2e-6dd99dfbd8af",
    "success": true,
    "status_code": 200,
    "error_details": [],
    "credits_used": 1,
    "credit_used_this_request": 1,
    "credits_remaining": 99,
    "credits_reset_at": "2026-04-09T07:41:48.000Z"
  },
  "request_parameters": {
    "identifier": "724382975021",
    "identifier_type": "UPC",
    "type": "PRODUCT_LOOKUP"
  },
  "request_metadata": {
    "created_at": "2026-03-16T22:16:42.169Z",
    "processed_at": "2026-03-16T22:16:46.401Z",
    "total_time_taken": 4.232
  },
  "result": {
    "search_result": {
      "products": [
        {
          "asin": "B000024D4S",
          "brand": "Parlophone",
          "identifiers": [
            { "type": "upc", "value": "724382975021" },
            { "type": "ean", "value": "0724382975021" },
            { "type": "gtin", "value": "00724382975021" }
          ],
          /* Scheduled for Removal - Use main_image instead */
          "image_url": "https://m.media-amazon.com/images/I/71m0ofUWYXL.jpg",

          "link": "https://www.amazon.com/dp/B000024D4S",
          "main_image": {
            "id": "71m0ofUWYXL",
            "link": "https://m.media-amazon.com/images/I/71m0ofUWYXL.jpg"
          },
          "manufacturer": "Capitol",
          "model_number": "CDEMD1062",
          "thumb_image": {
            "id": "510mQlM8AVL",
            "link": "https://m.media-amazon.com/images/I/510mQlM8AVL._SL75_.jpg"
          },
          /* Scheduled for Removal - Use thumb_image instead */
          "thumb_string_url": "https://m.media-amazon.com/images/I/510mQlM8AVL._SL75_.jpg",

          "title": "Wish You Were Here"
        },
        {
          "asin": "B00745CZ3Y",
          "brand": "EMI",
          "identifiers": [
            { "type": "upc", "value": "724382975021" },
            { "type": "ean", "value": "0724382975021" }
          ],
          /* Scheduled for Removal - Use main_image instead */
          "image_url": "https://m.media-amazon.com/images/I/61h7Q2eFq0L.jpg",

          "link": "https://www.amazon.com/dp/B00745CZ3Y",
          "main_image": {
            "id": "61h7Q2eFq0L",
            "link": "https://m.media-amazon.com/images/I/61h7Q2eFq0L.jpg"
          },
          "manufacturer": "EMI",
          "thumb_image": {
            "id": "413RSoCQ+ZL",
            "link": "https://m.media-amazon.com/images/I/413RSoCQ+ZL._SL75_.jpg"
          },

          /* Scheduled for Removal - Use thumb_image instead */
          "thumb_string_url": "https://m.media-amazon.com/images/I/413RSoCQ+ZL._SL75_.jpg",

          "title": "Wish You Were Here"
        }
      ],
      "total_product_count": 2
    },
    "country_code": "US"
  }
}

Notes

One identifier can match several listings, for example bundles, multi-packs or legacy listings. If total_product_count is 1, the match is unique. If it is greater than 1, iterate over products[] and pick the listing that fits your use case.
request_parameters echoes identifier and identifier_type; the operation is echoed as type.
Check request_info.success and request_info.error_details even on HTTP 200. See Errors and status codes.