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.

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

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 --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'

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)

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);
});

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

$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;

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

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());

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();

PreviousSearch NextResponse

Last updated 1 month ago