Detail Request

Send a GET request with operation=DETAIL to the Real-Time API. Identify the product with exactly one of asin or url.

Endpoint

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

Required parameters

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

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: `DETAIL`.
`domain`	string	Yes	Amazon marketplace, written with a leading dot, for example `.com`. When you send `url` or `address_id`, use the domain of that URL or address. See Supported Marketplaces.
`asin`	string	Conditional	Amazon product ID: 10 upper-case letters or digits, for example `B0CJB6V2L5`. Required when `url` is not sent. Send `asin` or `url`, not both; `asin` is recommended.
`url`	string	Conditional	Full Amazon product URL, URL-encoded, for example `https://www.amazon.com/dp/B0CJB6V2L5`. Required when `asin` is not sent. Send `asin` or `url`, not both.

Optional parameters

Parameter	Type	Required	Description
`a_plus_content`	boolean	No	Adds the A+ content ("From the manufacturer" section) to the response as `result.detail.a_plus_content`. Adds 1 credit. Default: `false`. Allowed: `true`, `false`.
`seller_id`	string	No	Returns the product as offered by this seller. Seller IDs start with `A` and have 11 to 15 characters, for example `A1MCYUGJD2ILFU`.
`associate_id`	string	No	Amazon Associates tag added to product links in the response, for example `mytag-20`.
`address_id`	integer	No	ID of an Active saved address for the same `domain`, from the Addresses page. Default: marketplace default address.
`zip_code`	string	No	Inline delivery address: zip or postal code. Join two-part codes with a comma, for example `N0E,1Y0`.
`city`	string	No	Inline delivery address: city. Required with `zip_code` on `.com.au` and with `district` on `.ae`; send it alone on `.sa` and `.eg`.
`district`	string	No	Inline delivery address: area within `city`. Only on `.ae`, together with `city`.
`country_code`	string	No	Inline delivery address: ISO 3166 alpha-2 country code, for example `CA`.
`language`	string	No	Language of the returned content, as a locale code valid for the `domain`, for example `en_US`. Default: marketplace default.
`currency`	string	No	Currency of returned prices, as a lower-case ISO 4217 code valid for the `domain`, for example `usd`. Default: marketplace default.
`parameters`	string	No	Extra Amazon URL query parameters, URL-encoded as one value, for example `tag%3Dmytag-20%26ref%3Dcustom` for `tag=mytag-20&ref=custom`. Separate pairs with an encoded `&` (`%26`); semicolons do not work.
`cookie`	string	No	Cookies forwarded to Amazon in the HTTP `Cookie` header: `key=value` pairs separated by `;`, URL-encoded as one value.

The valid language and currency values for each marketplace are listed in Supported Marketplaces. Address options are explained in Address Management.

Credit cost

Condition	Credits
Default	1
`a_plus_content=true`	2

Failed requests are not charged. 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=DETAIL" \
  --data-urlencode "domain=.com" \
  --data-urlencode "asin=B0CJB6V2L5" \
  --data-urlencode "language=en_US" \
  --data-urlencode "currency=usd"

import requests

params = {
    "api_key": "YOUR_API_KEY",
    "platform": "AMZ",
    "operation": "DETAIL",
    "domain": ".com",
    "asin": "B0CJB6V2L5",
    "language": "en_US",
    "currency": "usd",
}

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: "DETAIL",
  domain: ".com",
  asin: "B0CJB6V2L5",
  language: "en_US",
  currency: "usd",
});

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=DETAIL&domain=.com&asin=B0CJB6V2L5&language=en_US&currency=usd HTTP/1.1
Host: realtime.easyparser.com

<?php
$params = [
    'api_key' => 'YOUR_API_KEY',
    'platform' => 'AMZ',
    'operation' => 'DETAIL',
    'domain' => '.com',
    'asin' => 'B0CJB6V2L5',
    'language' => 'en_US',
    'currency' => 'usd',
];

$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", "DETAIL")
  params.Add("domain", ".com")
  params.Add("asin", "B0CJB6V2L5")
  params.Add("language", "en_US")
  params.Add("currency", "usd")

  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"] = "DETAIL",
    ["domain"] = ".com",
    ["asin"] = "B0CJB6V2L5",
    ["language"] = "en_US",
    ["currency"] = "usd",
};

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", "DETAIL");
        params.put("domain", ".com");
        params.put("asin", "B0CJB6V2L5");
        params.put("language", "en_US");
        params.put("currency", "usd");

        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

Detail supports addresses through address_id or the inline fields (zip_code, city, district, country_code). Inline fields take precedence over address_id; no error is returned. See Address Management.
Inline address fields raise the server timeout from 15 to 45 seconds. Set your client timeout to at least 60 seconds.
A language that the marketplace does not offer returns MSG1015 ("Invalid language for domain").
To fetch many products in one job, use the Bulk API with the asins or urls payload key.