Request

Endpoint

POST 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.

Optional Parameters

Parameter	Type	Description
associate_id	string	Adds your Amazon Associate (Affiliate) ID to product URLs in the response.
address_id	string	Performs the search using a predefined shipping address (zip code) saved in your account.
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).
currency	string	Requests product prices in the selected currency (e.g. usd, eur).
sort_by	string	Sorts search results by criteria like featured, price-asc-rank, price-desc-rank, etc.
refinements	string	Applies filters like category or attributes (format: n:category_id,p_123:filter_id).
include_html	boolean	If true, includes raw HTML of the search result page in the response.
cookie	string	Custom cookies in key=value format, separated by semicolons. Sent via HTTP header.
exclude_sponsored	boolean	If true, excludes sponsored (ad) products from the search results.
min_page	integer	Starting page number for paginated search results.
max_page	integer	Ending page number for paginated search results.

Notes on Selected Parameters

• Examples of sort_by values:

  • featured – Default sorting (Amazon’s featured order)

  • price-asc-rank – Sort by lowest to highest price

  • price-desc-rank – Sort by highest to lowest price

  • review-rank – Sort by most reviewed products

  • date-desc-rank – Sort by newest listings

• refinements format:

  • Used to target categories and filters. Example: n:7141123011,p_123:502215 Where:

    • n: → category ID

    • p_123: → specific filter ID (e.g., size, color, brand)

You can extract these IDs from Amazon search URLs or define them based on your own filtering needs. Alternatively, you can also send a Search request first and refer to the refinements field in the response to discover available filters and their corresponding IDs dynamically.

Example Request

cURL

curl --location 'https://realtime.easyparser.com/v1/request?api_key=YOUR_API_KEY&platform=AMZ&domain=.com&associate_id=helloexample&address_id=710&parameters=key%3Dvalue%3Bkey%3Dvalue&language=en_US&currency=usd&output=json&sort_by=featured&refinements=n%3A7141123011%2Cp_123%3A502215&include_html=true&cookie=key%3Dvalue%3Bkey%3Dvalue&exclude_sponsored=true&min_page=1&max_page=5&operation=SEARCH&keyword=winter'

Python

import requests

url = "https://realtime.easyparser.com/v1/request?api_key=YOUR_API_KEY&platform=AMZ&domain=.com&associate_id=helloexample&address_id=710&parameters=key=value;key=value&language=en_US&currency=usd&output=json&sort_by=featured&refinements=n:7141123011,p_123:502215&include_html=true&cookie=key=value;key=value&exclude_sponsored=true&min_page=1&max_page=5&operation=SEARCH&keyword=winter"

payload = {}
headers = {}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)

Node.js

var request = require('request');
var options = {
  'method': 'GET',
  'url': 'https://realtime.easyparser.com/v1/request?api_key=YOUR_API_KEY&platform=AMZ&domain=.com&associate_id=helloexample&address_id=710&parameters=key=value;key=value&language=en_US&currency=usd&output=json&sort_by=featured&refinements=n:7141123011,p_123:502215&include_html=true&cookie=key=value;key=value&exclude_sponsored=true&min_page=1&max_page=5&operation=SEARCH&keyword=winter',
  'headers': {
  }
};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});

HTTP

GET /v1/request?api_key=YOUR_API_KEY&platform=AMZ&domain=.com&associate_id=helloexample&address_id=710&parameters=key=value;key=value&language=en_US&currency=usd&output=json&sort_by=featured&refinements=n:7141123011,p_123:502215&include_html=true&cookie=key=value;key=value&exclude_sponsored=true&min_page=1&max_page=5&operation=SEARCH&keyword=winter HTTP/1.1
Host: realtime.easyparser.com

PHP

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://realtime.easyparser.com/v1/request?api_key=YOUR_API_KEY&platform=AMZ&domain=.com&associate_id=helloexample&address_id=710&parameters=key%3Dvalue%3Bkey%3Dvalue&language=en_US&currency=usd&output=json&sort_by=featured&refinements=n%3A7141123011%2Cp_123%3A502215&include_html=true&cookie=key%3Dvalue%3Bkey%3Dvalue&exclude_sponsored=true&min_page=1&max_page=5&operation=SEARCH&keyword=winter',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'GET',
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

GO

package main

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

func main() {

  url := "https://realtime.easyparser.com/v1/request?api_key=YOUR_API_KEY&platform=AMZ&domain=.com&associate_id=helloexample&address_id=710&parameters=key%3Dvalue%3Bkey%3Dvalue&language=en_US&currency=usd&output=json&sort_by=featured&refinements=n%3A7141123011%2Cp_123%3A502215&include_html=true&cookie=key%3Dvalue%3Bkey%3Dvalue&exclude_sponsored=true&min_page=1&max_page=5&operation=SEARCH&keyword=winter"
  method := "GET"

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, nil)

  if err != nil {
    fmt.Println(err)
    return
  }
  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := io.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}

C#

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://realtime.easyparser.com/v1/request?api_key=YOUR_API_KEY&platform=AMZ&domain=.com&associate_id=helloexample&address_id=710&parameters=key=value;key=value&language=en_US&currency=usd&output=json&sort_by=featured&refinements=n:7141123011,p_123:502215&include_html=true&cookie=key=value;key=value&exclude_sponsored=true&min_page=1&max_page=5&operation=SEARCH&keyword=winter");
var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());

Java

OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("text/plain");
RequestBody body = RequestBody.create(mediaType, "");
Request request = new Request.Builder()
  .url("https://realtime.easyparser.com/v1/request?api_key=YOUR_API_KEY&platform=AMZ&domain=.com&associate_id=helloexample&address_id=710&parameters=key=value;key=value&language=en_US&currency=usd&output=json&sort_by=featured&refinements=n:7141123011,p_123:502215&include_html=true&cookie=key=value;key=value&exclude_sponsored=true&min_page=1&max_page=5&operation=SEARCH&keyword=winter")
  .method("GET", body)
  .build();
Response response = client.newCall(request).execute();