> 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/offer/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                                                                         |
| --------------------------- | ------- | ----------------------------------------------------------------------------------- |
| `associate_id`              | string  | Adds your Amazon Associate (Affiliate) ID to the product URLs in the response.      |
| `parameters`                | string  | Additional query parameters to append to the request (e.g., sorting, filters).      |
| `include_html`              | boolean | If `true`, includes raw HTML of the offer listings (increases response size).       |
| `cookie`                    | string  | Custom cookies in `key:value` format, separated by semicolons. Sent in HTTP header. |
| `min_page`                  | integer | Defines the starting page number when paginating through offers.                    |
| `max_page`                  | integer | Defines the ending page number for paginated offer listings.                        |
| `prime`                     | boolean | If `true`, filters to show only Prime-eligible offers.                              |
| `free_shipping`             | boolean | If `true`, includes only offers with free shipping.                                 |
| `condition_new`             | boolean | If `true`, includes new condition offers.                                           |
| `condition_used_like_new`   | boolean | If `true`, includes used items in “Like New” condition.                             |
| `condition_used_very_good`  | boolean | If `true`, includes used items in “Very Good” condition.                            |
| `condition_used_good`       | boolean | If `true`, includes used items in “Good” condition.                                 |
| `condition_used_acceptable` | boolean | If `true`, includes used items in “Acceptable” condition.                           |

{% hint style="info" %}
💡 **Note:** When using pagination parameters (`min_page` and `max_page`), each page consumes **1 credit**.\
You can request up to **5 pages per operation**.\
For more details, see the [Credit Consumption](/easyparser-documentation/amazon/credit-consumption.md).
{% endhint %}

### 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=OFFER&
  domain=.de&
  associate_id=helloexample&
  language=en_GB&
  cookie=key%3Dvalue%3Bkey%3Dvalue&
  min_page=1&
  max_page=5&
  asin=B005CWEQEW&
  parameters=tag%3Dmytag&
  prime=true&
  free_shipping=true&
  condition_new=true&
  condition_used_good=true&
  condition_used_very_good=true&
  condition_used_like_new=true&
  condition_used_acceptable=true'
```

{% 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": "OFFER",
  "domain": ".de",
  "associate_id": "helloexample",
  "language": "en_GB",
  "cookie": "key=value;key=value",
  "min_page": "1",
  "max_page": "5",
  "asin": "B005CWEQEW",
  "parameters": "tag=mytag",
  "prime": "true",
  "free_shipping": "true",
  "condition_new": "true",
  "condition_used_good": "true",
  "condition_used_very_good": "true",
  "condition_used_like_new": "true",
  "condition_used_acceptable": "true",
}

# 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: "OFFER",
  domain: ".de",
  associate_id: "helloexample",
  language: "en_GB",
  cookie: "key=value;key=value",
  min_page: "1",
  max_page: "5",
  asin: "B005CWEQEW",
  parameters: "tag=mytag",
  prime: "true",
  free_shipping: "true",
  condition_new: "true",
  condition_used_good: "true",
  condition_used_very_good: "true",
  condition_used_like_new: "true",
  condition_used_acceptable: "true",
}

// 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=OFFER&
  domain=.de&
  associate_id=helloexample&
  language=en_GB&
  cookie=key%3Dvalue%3Bkey%3Dvalue&
  min_page=1&
  max_page=5&
  asin=B005CWEQEW&
  parameters=tag%3Dmytag&
  prime=true&
  free_shipping=true&
  condition_new=true&
  condition_used_good=true&
  condition_used_very_good=true&
  condition_used_like_new=true&
  condition_used_acceptable=true 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" => "OFFER",
  "domain" => ".de",
  "associate_id" => "helloexample",
  "language" => "en_GB",
  "cookie" => "key=value;key=value",
  "min_page" => "1",
  "max_page" => "5",
  "asin" => "B005CWEQEW",
  "parameters" => "tag=mytag",
  "prime" => "true",
  "free_shipping" => "true",
  "condition_new" => "true",
  "condition_used_good" => "true",
  "condition_used_very_good" => "true",
  "condition_used_like_new" => "true",
  "condition_used_acceptable" => "true",
];

# 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" %}

```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", "OFFER")
params.Add("domain", ".de")
params.Add("associate_id", "helloexample")
params.Add("language", "en_GB")
params.Add("cookie", "key=value;key=value")
params.Add("min_page", "1")
params.Add("max_page", "5")
params.Add("asin", "B005CWEQEW")
params.Add("parameters", "tag=mytag")
params.Add("prime", "true")
params.Add("free_shipping", "true")
params.Add("condition_new", "true")
params.Add("condition_used_good", "true")
params.Add("condition_used_very_good", "true")
params.Add("condition_used_like_new", "true")
params.Add("condition_used_acceptable", "true")
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))
}
```

{% 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"] = "OFFER";
query["domain"] = ".de";
query["associate_id"] = "helloexample";
query["language"] = "en_GB";
query["cookie"] = "key=value;key=value";
query["min_page"] = "1";
query["max_page"] = "5";
query["asin"] = "B005CWEQEW";
query["parameters"] = "tag=mytag";
query["prime"] = "true";
query["free_shipping"] = "true";
query["condition_new"] = "true";
query["condition_used_good"] = "true";
query["condition_used_very_good"] = "true";
query["condition_used_like_new"] = "true";
query["condition_used_acceptable"] = "true";
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" %}

```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", "OFFER");
builder.addParameter("domain", ".de");
builder.addParameter("associate_id", "helloexample");
builder.addParameter("language", "en_GB");
builder.addParameter("cookie", "key=value;key=value");
builder.addParameter("min_page", "1");
builder.addParameter("max_page", "5");
builder.addParameter("asin", "B005CWEQEW");
builder.addParameter("parameters", "tag=mytag");
builder.addParameter("prime", "true");
builder.addParameter("free_shipping", "true");
builder.addParameter("condition_new", "true");
builder.addParameter("condition_used_good", "true");
builder.addParameter("condition_used_very_good", "true");
builder.addParameter("condition_used_like_new", "true");
builder.addParameter("condition_used_acceptable", "true");
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());
```

{% endtab %}
{% endtabs %}