Similar Products Request

Send a GET request with operation=SIMILAR_PRODUCTS to the Real-Time API. The operation takes a single product identifier, the asin.

Endpoint

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

Required parameters

All parameters go in the query string. See Common Request Fields for details on the shared parameters.

Parameter	Type	Required	Description
`api_key`	string	Yes	Your API key, sent as a query parameter. Find it at Account > Plan.
`platform`	string	Yes	Target platform. Allowed: `AMZ` (Amazon).
`operation`	string	Yes	Operation code in upper case. Allowed: `SIMILAR_PRODUCTS`.
`domain`	string	Yes	Amazon marketplace, written with a leading dot, for example `.com`. See Supported Marketplaces.
`asin`	string	Yes	Amazon product ID: 10 upper-case letters or digits, for example `B0CJB6V2L5`. Product URLs are not accepted; extract the ASIN first.

Optional parameters

Parameter	Type	Required	Description
`similar_limit`	string	No	Maximum number of items in the `similar` array. Sets the credit cost. Default: `10`. Allowed: `10`, `50`, `100`.

This operation has no language or currency parameter, and it does not support delivery addresses (see Notes).

Credit cost

Condition	Credits
`similar_limit=10` (default)	1
`similar_limit=50`	6
`similar_limit=100`	11
Empty `similar` list (the `product` object is returned)	1
Unknown ASIN (HTTP `404`)	1
Failed request with no data (HTTP `504`)	0 (refunded)

See Credit Consumption.

Example request

curl --get "https://realtime.easyparser.com/v1/request" \
  --data-urlencode "api_key=YOUR_API_KEY" \
  --data-urlencode "platform=AMZ" \
  --data-urlencode "operation=SIMILAR_PRODUCTS" \
  --data-urlencode "domain=.com" \
  --data-urlencode "asin=B0CJB6V2L5" \
  --data-urlencode "similar_limit=10"

import requests

params = {
    "api_key": "YOUR_API_KEY",
    "platform": "AMZ",
    "operation": "SIMILAR_PRODUCTS",
    "domain": ".com",
    "asin": "B0CJB6V2L5",
    "similar_limit": "10",
}

response = requests.get("https://realtime.easyparser.com/v1/request", params=params)
print(response.json())

const params = new URLSearchParams({
  api_key: "YOUR_API_KEY",
  platform: "AMZ",
  operation: "SIMILAR_PRODUCTS",
  domain: ".com",
  asin: "B0CJB6V2L5",
  similar_limit: "10",
});

const response = await fetch(`https://realtime.easyparser.com/v1/request?${params}`);
const data = await response.json();
console.log(data);

GET /v1/request?api_key=YOUR_API_KEY&platform=AMZ&operation=SIMILAR_PRODUCTS&domain=.com&asin=B0CJB6V2L5&similar_limit=10 HTTP/1.1
Host: realtime.easyparser.com

<?php
$params = [
    'api_key' => 'YOUR_API_KEY',
    'platform' => 'AMZ',
    'operation' => 'SIMILAR_PRODUCTS',
    'domain' => '.com',
    'asin' => 'B0CJB6V2L5',
    'similar_limit' => '10',
];

$url = 'https://realtime.easyparser.com/v1/request?' . http_build_query($params);
$response = file_get_contents($url);
$data = json_decode($response, true);
print_r($data);

package main

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

func main() {
  params := url.Values{}
  params.Add("api_key", "YOUR_API_KEY")
  params.Add("platform", "AMZ")
  params.Add("operation", "SIMILAR_PRODUCTS")
  params.Add("domain", ".com")
  params.Add("asin", "B0CJB6V2L5")
  params.Add("similar_limit", "10")

  resp, err := http.Get("https://realtime.easyparser.com/v1/request?" + params.Encode())
  if err != nil {
    panic(err)
  }
  defer resp.Body.Close()

  body, _ := io.ReadAll(resp.Body)
  fmt.Println(string(body))
}

using System;
using System.Collections.Generic;
using System.Linq;
using System.Net.Http;

var parameters = new Dictionary<string, string>
{
    ["api_key"] = "YOUR_API_KEY",
    ["platform"] = "AMZ",
    ["operation"] = "SIMILAR_PRODUCTS",
    ["domain"] = ".com",
    ["asin"] = "B0CJB6V2L5",
    ["similar_limit"] = "10",
};

var query = string.Join("&", parameters.Select(p =>
    $"{Uri.EscapeDataString(p.Key)}={Uri.EscapeDataString(p.Value)}"));

using var client = new HttpClient();
var response = await client.GetStringAsync($"https://realtime.easyparser.com/v1/request?{query}");
Console.WriteLine(response);

import java.net.URI;
import java.net.URLEncoder;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.nio.charset.StandardCharsets;
import java.util.LinkedHashMap;
import java.util.Map;
import java.util.stream.Collectors;

public class EasyparserRequest {
    public static void main(String[] args) throws Exception {
        Map<String, String> params = new LinkedHashMap<>();
        params.put("api_key", "YOUR_API_KEY");
        params.put("platform", "AMZ");
        params.put("operation", "SIMILAR_PRODUCTS");
        params.put("domain", ".com");
        params.put("asin", "B0CJB6V2L5");
        params.put("similar_limit", "10");

        String query = params.entrySet().stream()
            .map(e -> URLEncoder.encode(e.getKey(), StandardCharsets.UTF_8) + "="
                + URLEncoder.encode(e.getValue(), StandardCharsets.UTF_8))
            .collect(Collectors.joining("&"));

        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://realtime.easyparser.com/v1/request?" + query))
            .GET()
            .build();

        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

Notes

similar_limit is an upper bound. The number of items returned depends on what Amazon lists for the ASIN, so a response can contain fewer items, or an empty similar array.
An unknown ASIN is still charged 1 credit, unlike other failed requests. Check that the ASIN exists in the requested domain before you send large batches.
To fetch similar products for many ASINs in one job, use the Bulk API with the asins payload key.