# Amazon product search results for a keyword, live

This endpoint provides results from Amazon product listings according to the specified keyword (product name), location, and language parameters.

|  |  |
| --- | --- |
| Tool id | `dataforseo.x-merchant-amazon-products-live-advanced` |
| Platform | [Amazon](https://www.orcarouter.ai/tools/amazon.md) |
| Capability | [Sellers \& shops](https://www.orcarouter.ai/tools/amazon/seller-info.md) |
| Price | $0.00363 per call |
| Health | OK |
| p50 latency | — |
| Success (7 days) | — |
| Runs (30 days) | — |
| Idempotent | no |
| Data class | unclassified |

## Input

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `department` | string | no | \<em>amazon product department\</em>\<br>optional field\<br>specify one of the following amazon departments for extracting product listings:\<br>\<code>"Arts \& Crafts"\</code>, \<code>"Automotive"\</code>, \<code>"Baby"\</code>, \<code>"Beauty \& Personal Care"\</code>, \<code>"Books"\</code>, \<code>"Computers"\</co |
| `depth` | integer | no | \<em>parsing depth\</em>\<br>optional field\<br>number of results to be retrieved from the Amazon results page\<br>default value: \<code>100\</code>\<br>max value: \<code>700\</code>\<br>\<strong>Your account will be billed per each SERP containing up to 100 results;\</strong> \<br>Setting depth above 100 may res |
| `keyword` | string | no | \<em>keyword\</em>\<br>\<strong>required field\</strong>\<br>you can specify \<strong>up to 700 characters\</strong> in this field\<br>\<strong>all %## will be decoded (plus character ‘+’ will be decoded to a space character)\</strong>\<br>if you need to use the “%” character for your \<code>keyword\</code>, plea |
| `language_code` | string | no | \<em>search engine language code\</em>\<br>\<strong>required field if you don't specify\</strong> \<code>language_name\</code>\<br>\<strong>if you use this field, you don't need to specify \<code>language_name\</code>\</strong>\<br>you can receive the list of available languages with their \<code>language_code\</c |
| `language_name` | string | no | \<em>full name of search engine language\</em>\<br>\<strong>required field if you don't specify\</strong> \<code>language_code\</code>\<br>\<strong>if you use this field, you don't need to specify \<code>language_code\</code>\</strong>\<br>you can receive the list of available languages with their \<code>language |
| `location_code` | integer | no | \<em>search engine location code\</em>\<br>\<strong>required field if you don't specify\</strong> \<code>location_name\</code> or \<code>location_coordinate\</code>\<br>\<strong>if you use this field, you don't need to specify \<code>location_name\</code> or \<code>location_coordinate\</code>\</strong>\<br>you can r |
| `location_coordinate` | string | no | \<em>GPS coordinates of a location\</em>\<br>\<strong>required field if you don't specify\</strong> \<code>location_name\</code> or \<code>location_code\</code>\<br>\<strong>if you use this field, you don't need to specify \<code>location_name\</code> or \<code>location_code\</code>\</strong>\<br>\<code>location_coor |
| `location_name` | string | no | \<em>full name of search engine location\</em>\<br>\<strong>required field if you don't specify\</strong> \<code>location_code\</code> or \<code>location_coordinate\</code>\<br>\<strong>if you use this field, you don't need to specify \<code>location_code\</code> or \<code>location_coordinate\</code>\</strong>\<br>y |
| `max_crawl_pages` | integer | no | \<em>page crawl limit\</em>\<br>optional field\<br>number of search results pages to crawl\<br>max value: \<code>7\</code>\<br>\<strong>Note:\</strong> the \<code>max_crawl_pages\</code> and \<code>depth\</code> parameters complement each other;\<br>learn more at \<a href="https://dataforseo.com/help-center/what-is |
| `price_max` | integer | no | \<em>maximum product price\</em>\<br>optional field\<br>maximum price of the returned products listed on Amazon for the specified query\<br>example:\<br>\<code>100\</code>\<br>\<strong>Note:\</strong> if you specify \<code>price_max\</code>, the \<code>search_param\</code> parameter will be ignored |
| `price_min` | integer | no | \<em>minimum product price\</em>\<br>optional field\<br>minimum price of the returned products listed on Amazon for the specified query\<br>example:\<br>\<code>5\</code>\<br>\<strong>Note:\</strong> if you specify \<code>price_min\</code>, the \<code>search_param\</code> parameter will be ignored |
| `se_domain` | string | no | \<em>search engine domain\</em>\<br>optional field\<br>we choose the relevant search engine domain automatically according to the location and language you specify\<br>however, you can set a custom search engine domain in this field\<br>example:\<br>\<code>\<em>amazon.com\</em>\</code>, \<code>\<em>amazon.co.uk\< |
| `search_param` | string | no | \<em>additional parameters of the search query\</em>\<br>optional field\<br>you can use the following Amazon search URL parameters for customizing the search\<br>example:\<br>\<code>\&low-price=52\</code> - search for products that cost \<em>more than 52 USD\</em>;\<br>\<code>\&high-price=45\</code> - search for p |
| `sort_by` | string | no | \<em>results sorting rules\</em>\<br>optional field\<br>the following sorting rules are supported:\<br>\<code>relevance\</code>, \<code>price_low_to_high\</code>, \<code>price_high_to_low\</code>, \<code>featured\</code>, \<code>avg_customer_review\</code>, \<code>newest_arrival\</code>\<br>example:\<br>\<code>sort_by: |
| `tag` | string | no | \<em>user-defined task identifier\</em>\<br>optional field\<br>\<em>the character limit is 255\</em>\<br>you can use this parameter to identify the task and match it with the result\<br>you will find the specified \<code>tag\</code> value in the \<code>data\</code> object of the response |
| `url` | string | no | \<em>direct URL of the search query\</em>\<br>optional field\<br>you can specify a direct URL and we will sort it out to the necessary fields. Note that this method is the most difficult for our API to process and also requires you to specify the exact language and location in the URL. In most cases, we |

## Call it

```bash
curl -sS https://api.orcarouter.ai/v1/tools/dataforseo.x-merchant-amazon-products-live-advanced/run \
  -H "Authorization: Bearer $ORCAROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{}}'
```

```python
import os, requests

resp = requests.post(
    "https://api.orcarouter.ai/v1/tools/dataforseo.x-merchant-amazon-products-live-advanced/run",
    headers={"Authorization": f"Bearer {os.environ['ORCAROUTER_API_KEY']}"},
    json={"input":{}},
)
print(resp.json())
```

## Alternatives

| Tool | Source | Price | Health |
| --- | --- | --- | --- |
| [Amazon Shop storefront by URL — profile, products](https://www.orcarouter.ai/tools/amazon/seller-info/x-v1-amazon-shop.md) | — | $0.002068 per credit | OK |
| [Amazon sellers of a product by ASIN, live](https://www.orcarouter.ai/tools/amazon/seller-info/x-merchant-amazon-sellers-live-advanced.md) | — | $0.00363 per call | OK |
| [Amazon ASINs for all variations of a product, live](https://www.orcarouter.ai/tools/amazon/seller-info/x-merchant-amazon-asin-live-advanced.md) | — | $0.0055 per call | OK |

## FAQ

### How much does Amazon product search results for a keyword, live cost?

Amazon product search results for a keyword, live costs $0.00363 per call: 1,000 calls cost $3.63.

### What does a $10 budget buy with Amazon product search results for a keyword, live?

About 2754 calls at $0.00363 per call.

### What inputs does Amazon product search results for a keyword, live need?

It has no required inputs.

### How do I call Amazon product search results for a keyword, live?

Send POST /v1/tools/{id}/run with your OrcaRouter API key and a JSON body {"input": {…}}, where {id} is the tool id POST /v1/tools/discover returns for it.

---

Markdown version of https://www.orcarouter.ai/tools/amazon/seller-info/x-merchant-amazon-products-live-advanced