# Detail: Request

> Request parameters for the Easyparser Detail operation (DETAIL): ASIN or URL, A+ content, seller, address, language and currency, with a cURL example.

Source: https://docs.easyparser.com/real-time-integration/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

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

## Required parameters

All parameters go in the query string. See [Common Request Fields](/real-time-integration/common-required-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](https://app.easyparser.com/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](/essentials/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](https://app.easyparser.com/addresses). 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](/essentials/supported-marketplaces). Address options are explained in [Address Management](/essentials/address-management).

## Credit cost

| Condition | Credits |
|---|---|
| Default | 1 |
| `a_plus_content=true` | 2 |

Failed requests are not charged. See [Credit Consumption](/essentials/credit-consumption).

## Example request

**cURL**

```bash
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"
```

**Python**

```python
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())
```

**Node.js**

```javascript
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);
```

**HTTP**

```http
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**

```php
<?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);
```

**Go**

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

**C#**

```csharp
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);
```

**Java**

```java
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

> **INFO:** Send either `asin` or `url`. A request with both, or with neither, is rejected.

- 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](/essentials/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](/bulk-integration/bulk-service-request) with the `asins` or `urls` payload key.