> For the complete documentation index, see [llms.txt](https://easyparser.gitbook.io/easyparser-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://easyparser.gitbook.io/easyparser-documentation/real-time-integration/product-lookup/request.md).

# Request

To perform a product lookup, send a GET request to the Real-Time API endpoint. This operation acts as a universal bridge, allowing you to submit a specific identifier (such as a UPC or ASIN) and receive a structured mapping of the product’s identity across the Amazon ecosystem.

### Endpoint

```
GET https://realtime.easyparser.com/v1/request
```

### Required Parameters

This operation requires certain common parameters to be included in every request. For more details, see [Common Required Request Fields](/easyparser-documentation/real-time-integration/common-required-request-fields.md).

The following parameters are mandatory for every `PRODUCT LOOKUP` request. These fields ensure that the engine targets the correct marketplace and uses the appropriate identifier type for matching.

| Parameter        | Type   | Required | Description                                                                                  | Example          |
| ---------------- | ------ | -------- | -------------------------------------------------------------------------------------------- | ---------------- |
| api\_key         | String | Yes      | Your unique Easyparser API key used for authentication.                                      | `YOUR_API_KEY`   |
| platform         | String | Yes      | The target e-commerce platform (Always `AMZ` for Amazon).                                    | `AMZ`            |
| operation        | String | Yes      | The specific operation to execute.                                                           | `PRODUCT_LOOKUP` |
| domain           | String | Yes      | The Amazon marketplace domain extension.                                                     | `.com`           |
| identifier\_type | String | Yes      | The type of code provided. Supported: `ASIN`, `EAN`, `GTIN`, `ISBN`, `JAN`, `MINSAN`, `UPC`. | `UPC`            |
| identifier       | String | Yes      | The actual numerical or alphanumeric value of the product code.                              | `724382975021`   |

### Optional Parameters

There are no operation-specific optional parameters for the PRODUCT LOOKUP operation.

### **Example Request**

{% tabs %}
{% tab title="cURL" %}
{% code overflow="wrap" %}

```javascript
curl --location 'https://realtime.easyparser.com/v1/request?
  api_key=YOUR_API_KEY&
  platform=AMZ&
  operation=PRODUCT_LOOKUP&
  domain=.com&
  identifier_type=UPC&
  identifier=724382975021'
```

{% endcode %}
{% endtab %}

{% tab title="Python" %}
{% code overflow="wrap" %}

```python

import requests
import json

# set up the request parameters
params = {
  "api_key": "YOUR_API_KEY",
  "platform": "AMZ",
  "operation": "PRODUCT_LOOKUP",
  "domain": ".com",
  "identifier_type": "UPC",
  "identifier": "724382975021",
}

# make the http GET request to Easyparser API
api_result = requests.get("https://realtime.easyparser.com/v1/request", params=params)

# print the JSON response from Easyparser API
print(json.dumps(api_result.json(), indent=2))
```

{% endcode %}
{% endtab %}

{% tab title="Node.js" %}
{% code overflow="wrap" %}

```javascript

const axios = require("axios");

// set up the request parameters
const params = {
  api_key: "YOUR_API_KEY",
  platform: "AMZ",
  operation: "PRODUCT_LOOKUP",
  domain: ".com",
  identifier_type: "UPC",
  identifier: "724382975021",
}

// make the http GET request to Easyparser API
axios.get("https://realtime.easyparser.com/v1/request", { params })
.then(response => {
  // print the JSON response from Easyparser API
  console.log(JSON.stringify(response.data, null, 2));
})
```

{% endcode %}
{% endtab %}

{% tab title="HTTP" %}
{% code overflow="wrap" %}

```http

GET /v1/request?
  api_key=YOUR_API_KEY&
  platform=AMZ&
  operation=PRODUCT_LOOKUP&
  domain=.com&
  identifier_type=UPC&
  identifier=724382975021 HTTP/1.1
Host: realtime.easyparser.com
```

{% endcode %}
{% endtab %}

{% tab title="PHP" %}
{% code overflow="wrap" %}

```php

<?php

# set up the request parameters
$params = [
  "api_key" => "YOUR_API_KEY",
  "platform" => "AMZ",
  "operation" => "PRODUCT_LOOKUP",
  "domain" => ".com",
  "identifier_type" => "UPC",
  "identifier" => "724382975021",
];

# make the http GET request to Easyparser API
$response = file_get_contents("https://realtime.easyparser.com/v1/request?" . http_build_query($params));

# print the JSON response from Easyparser API
echo $response;
```

{% endcode %}
{% endtab %}

{% tab title="GO" %}
{% code overflow="wrap" %}

```go

package main

import (
  "fmt"
  "net/http"
  "io"
)

func main() {
  // set up the request parameters
  url := "https://realtime.easyparser.com/v1/request?params := url.Values{}
params.Add("api_key", "YOUR_API_KEY")
params.Add("platform", "AMZ")
params.Add("operation", "PRODUCT_LOOKUP")
params.Add("domain", ".com")
params.Add("identifier_type", "UPC")
params.Add("identifier", "724382975021")
fullURL := fmt.Sprintf("%s?%s", baseURL, params.Encode())
"
  
  // make the http GET request to Easyparser API
  res, _ := http.Get(url)
  defer res.Body.Close()
  
  // print the JSON response from Easyparser API
  body, _ := io.ReadAll(res.Body)
  fmt.Println(string(body))
}
```

{% endcode %}
{% endtab %}

{% tab title="C#" %}
{% code overflow="wrap" %}

```csharp

using System.Net.Http;

// set up the request parameters
var client = new HttpClient();

// make the http GET request to Easyparser API
var response = await client.GetAsync("https://realtime.easyparser.com/v1/request?var query = HttpUtility.ParseQueryString(string.Empty);
query["api_key"] = "YOUR_API_KEY";
query["platform"] = "AMZ";
query["operation"] = "PRODUCT_LOOKUP";
query["domain"] = ".com";
query["identifier_type"] = "UPC";
query["identifier"] = "724382975021";
var fullUrl = baseUrl + "?" + query.ToString();
");

// print the JSON response from Easyparser API
var result = await response.Content.ReadAsStringAsync();
Console.WriteLine(result);
```

{% endcode %}
{% endtab %}

{% tab title="Java" %}
{% code overflow="wrap" %}

```java

import okhttp3.*;

// set up the request parameters
OkHttpClient client = new OkHttpClient();

// make the http GET request to Easyparser API
Request request = new Request.Builder()
  .url("https://realtime.easyparser.com/v1/request?URIBuilder builder = new URIBuilder(baseUrl);
builder.addParameter("api_key", "YOUR_API_KEY");
builder.addParameter("platform", "AMZ");
builder.addParameter("operation", "PRODUCT_LOOKUP");
builder.addParameter("domain", ".com");
builder.addParameter("identifier_type", "UPC");
builder.addParameter("identifier", "724382975021");
String fullUrl = builder.build().toString();
")
  .build();

// print the JSON response from Easyparser API
Response response = client.newCall(request).execute();
System.out.println(response.body().string());
```

{% endcode %}
{% endtab %}
{% endtabs %}