> 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/detail/request.md).

# Request

### 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).

### Optional Parameters

| Parameter        | Type    | Description                                                                                                                                                                                                                           |
| ---------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `seller_id`      | string  | Retrieve the product from a specific Amazon seller by their Seller ID.                                                                                                                                                                |
| `associate_id`   | string  | Adds your Amazon Associate (Affiliate) ID to the product URLs returned in the response.                                                                                                                                               |
| `a_plus_content` | boolean | <p>If <code>true</code>, includes the "From the manufacturer" section (A+ content) in the response (This feature consumes an extra credit. See <a href="/pages/PJXaWrFyvVeLR0NlGS7A">Credit Consumption</a><br>for details.).<br></p> |
| `address_id`     | string  | Uses a specific zip code (defined in your Addresses page) to simulate geographic location.                                                                                                                                            |
| `parameters`     | string  | Additional query parameters to append to the request (e.g., sorting, filters).                                                                                                                                                        |
| `language`       | string  | Language code to request the Amazon page in (e.g., `en_US`, `de_DE`).                                                                                                                                                                 |
| `currency`       | string  | Currency in which product prices should be displayed (e.g., `usd`, `eur`, `aed`).                                                                                                                                                     |
| `cookie`         | string  | Custom cookies to use during the request (must be URL-encoded, sent via HTTP header).                                                                                                                                                 |
| `include_html`   | boolean | If `true`, includes raw HTML of the page in the response (larger payload).                                                                                                                                                            |

### Example Request

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

```javascript
curl --location 'https://realtime.easyparser.com/v1/request?api_key=YOUR_API_KEY&
  platform=AMZ&
  operation=DETAIL&
  address_id=756&
  domain=.com&
  associate_id=helloExample&
  language=en_US&
  cookie=key%3Dvalue%3Bkey%3Dvalue&
  asin=B0B7P81K6S&
  a_plus_content=true&
  currency=mxn&
  parameters=tag%3Dmytag&
  seller_id=123'
```

{% 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": "DETAIL",
  "address_id": "756",
  "domain": ".com",
  "associate_id": "helloExample",
  "language": "en_US",
  "cookie": "key=value;key=value",
  "asin": "B0B7P81K6S",
  "a_plus_content": "true",
  "currency": "mxn",
  "parameters": "tag=mytag",
  "seller_id": "123",
}

# 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: "DETAIL",
  address_id: "756",
  domain: ".com",
  associate_id: "helloExample",
  language: "en_US",
  cookie: "key=value;key=value",
  asin: "B0B7P81K6S",
  a_plus_content: "true",
  currency: "mxn",
  parameters: "tag=mytag",
  seller_id: "123",
}

// 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=DETAIL&
  address_id=756&
  domain=.com&
  associate_id=helloExample&
  language=en_US&
  cookie=key%3Dvalue%3Bkey%3Dvalue&
  asin=B0B7P81K6S&
  a_plus_content=true&
  currency=mxn&
  parameters=tag%3Dmytag&
  seller_id=123 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" => "DETAIL",
  "address_id" => "756",
  "domain" => ".com",
  "associate_id" => "helloExample",
  "language" => "en_US",
  "cookie" => "key=value;key=value",
  "asin" => "B0B7P81K6S",
  "a_plus_content" => "true",
  "currency" => "mxn",
  "parameters" => "tag=mytag",
  "seller_id" => "123",
];

# 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", "DETAIL")
params.Add("address_id", "756")
params.Add("domain", ".com")
params.Add("associate_id", "helloExample")
params.Add("language", "en_US")
params.Add("cookie", "key=value;key=value")
params.Add("asin", "B0B7P81K6S")
params.Add("a_plus_content", "true")
params.Add("currency", "mxn")
params.Add("parameters", "tag=mytag")
params.Add("seller_id", "123")
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"] = "DETAIL";
query["address_id"] = "756";
query["domain"] = ".com";
query["associate_id"] = "helloExample";
query["language"] = "en_US";
query["cookie"] = "key=value;key=value";
query["asin"] = "B0B7P81K6S";
query["a_plus_content"] = "true";
query["currency"] = "mxn";
query["parameters"] = "tag=mytag";
query["seller_id"] = "123";
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", "DETAIL");
builder.addParameter("address_id", "756");
builder.addParameter("domain", ".com");
builder.addParameter("associate_id", "helloExample");
builder.addParameter("language", "en_US");
builder.addParameter("cookie", "key=value;key=value");
builder.addParameter("asin", "B0B7P81K6S");
builder.addParameter("a_plus_content", "true");
builder.addParameter("currency", "mxn");
builder.addParameter("parameters", "tag=mytag");
builder.addParameter("seller_id", "123");
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 %}

{% hint style="info" %}

> **In your requests, you must choose between providing an ASIN or a product URL — using both at the same time is not supported.**
> {% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://easyparser.gitbook.io/easyparser-documentation/real-time-integration/detail/request.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
