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

# Request

To retrieve a seller's products, send a GET request with the SELLER PRODUCTS operation.

### Endpoint

{% code overflow="wrap" %}

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

{% endcode %}

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

| Parameter     | Type   | Description                                           | Example                                                                                |
| ------------- | ------ | ----------------------------------------------------- | -------------------------------------------------------------------------------------- |
| `api_key`     | String | Your unique API key.                                  | `YOUR_API_KEY`                                                                         |
| `platform`    | String | The platform to target (e.g., `AMZ` for Amazon).      | AMZ                                                                                    |
| `operation`   | String | The operation to perform, which is `SELLER_PRODUCTS`. | `SELLER_PRODUCTS`                                                                      |
| `domain`      | String | The Amazon domain to target                           | e.g., `.com`, `.de`, `.co.uk`                                                          |
| `seller_id`\* | String | The unique ID of the target seller.                   | `"AXCB29L39I26U"`                                                                      |
| `url`\*       | String | The full Amazon seller storefront URL. (e.g., )       | `https://www.amazon.com/s?me=A1DX3A7J4BF3GC&marketplaceID=ATVPDKIKX0DER&A6R3MV8PEIEMD` |

{% hint style="info" %}
\*Your request must contain exactly one of these parameters: `seller_id` or `url`. Including both seller\_id and url at the same time or omitting both will lead to a validation error.
{% endhint %}

### Optional Parameters

| Parameter             | Type    | Description                                                                              |
| --------------------- | ------- | ---------------------------------------------------------------------------------------- |
| `min_page`            | Integer | Minimum page number to crawl.                                                            |
| `max_page`            | Integer | Maximum page number to crawl.                                                            |
| `exclude_refinements` | Boolean | Excludes refinement options in search results.                                           |
| `associate_id`        | String  | Adds your Amazon Associate (Affiliate) ID to product URLs in the response.               |
| `parameters`          | String  | Appends additional query parameters in `key=value` format, separated by semicolons.      |
| `language`            | String  | Displays the Amazon page in the specified language (e.g., `en_US`, `de_DE`).             |
| `cookie`              | String  | Custom cookies in `key=value` format, separated by semicolons. Sent via HTTP header.     |
| `sort_by`             | String  | Sorts search results by criteria like `featured-rank`, `exact-aware-popularity-rank`etc. |

### 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=SELLER_PRODUCTS&
  address_id=990&
  domain=.com&
  exclude_refinements=true&
  sort_by=exact-aware-popularity-rank&
  language=en_US&
  cookie=ubid-main%3D123-4567890-1234567%3B&
  min_page=1&
  max_page=5&
  parameters=p_n_availability%3D2661601011%26n%3D228013&
  seller_id=A1MCYUGJD2ILFU'
```

{% 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": "SELLER_PRODUCTS",
  "address_id": "990",
  "domain": ".com",
  "exclude_refinements": "true",
  "sort_by": "exact-aware-popularity-rank",
  "language": "en_US",
  "cookie": "ubid-main=123-4567890-1234567;",
  "min_page": "1",
  "max_page": "5",
  "parameters": "p_n_availability=2661601011&n=228013",
  "seller_id": "A1MCYUGJD2ILFU",
}

# 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: "SELLER_PRODUCTS",
  address_id: "990",
  domain: ".com",
  exclude_refinements: "true",
  sort_by: "exact-aware-popularity-rank",
  language: "en_US",
  cookie: "ubid-main=123-4567890-1234567;",
  min_page: "1",
  max_page: "5",
  parameters: "p_n_availability=2661601011&n=228013",
  seller_id: "A1MCYUGJD2ILFU",
}

// 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=SELLER_PRODUCTS&
  address_id=990&
  domain=.com&
  exclude_refinements=true&
  sort_by=exact-aware-popularity-rank&
  language=en_US&
  cookie=ubid-main%3D123-4567890-1234567%3B&
  min_page=1&
  max_page=5&
  parameters=p_n_availability%3D2661601011%26n%3D228013&
  seller_id=A1MCYUGJD2ILFU 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" => "SELLER_PRODUCTS",
  "address_id" => "990",
  "domain" => ".com",
  "exclude_refinements" => "true",
  "sort_by" => "exact-aware-popularity-rank",
  "language" => "en_US",
  "cookie" => "ubid-main=123-4567890-1234567;",
  "min_page" => "1",
  "max_page" => "5",
  "parameters" => "p_n_availability=2661601011&n=228013",
  "seller_id" => "A1MCYUGJD2ILFU",
];

# 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", "SELLER_PRODUCTS")
params.Add("address_id", "990")
params.Add("domain", ".com")
params.Add("exclude_refinements", "true")
params.Add("sort_by", "exact-aware-popularity-rank")
params.Add("language", "en_US")
params.Add("cookie", "ubid-main=123-4567890-1234567;")
params.Add("min_page", "1")
params.Add("max_page", "5")
params.Add("parameters", "p_n_availability=2661601011&n=228013")
params.Add("seller_id", "A1MCYUGJD2ILFU")
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"] = "SELLER_PRODUCTS";
query["address_id"] = "990";
query["domain"] = ".com";
query["exclude_refinements"] = "true";
query["sort_by"] = "exact-aware-popularity-rank";
query["language"] = "en_US";
query["cookie"] = "ubid-main=123-4567890-1234567;";
query["min_page"] = "1";
query["max_page"] = "5";
query["parameters"] = "p_n_availability=2661601011&n=228013";
query["seller_id"] = "A1MCYUGJD2ILFU";
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", "SELLER_PRODUCTS");
builder.addParameter("address_id", "990");
builder.addParameter("domain", ".com");
builder.addParameter("exclude_refinements", "true");
builder.addParameter("sort_by", "exact-aware-popularity-rank");
builder.addParameter("language", "en_US");
builder.addParameter("cookie", "ubid-main=123-4567890-1234567;");
builder.addParameter("min_page", "1");
builder.addParameter("max_page", "5");
builder.addParameter("parameters", "p_n_availability=2661601011&n=228013");
builder.addParameter("seller_id", "A1MCYUGJD2ILFU");
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 %}