# Product Lookup: Response

> Response fields of the Easyparser PRODUCT_LOOKUP operation: matching Amazon listings, ASINs, identifiers, brand, manufacturer and images.

Source: https://docs.easyparser.com/real-time-integration/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](/real-time-integration/overview#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)

```json
{
  "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](/real-time-integration/overview#errors-and-status-codes).

> **WARNING:** `image_url` and `thumb_string_url` are scheduled for removal. Read images from `main_image.link` and `thumb_image.link` instead.