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


---

# 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, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.