DataForSEO Merchant Amazon Products Live Advanced
From 4 credits/call
ae_dataforseo_merchant_amazon_products_live_advanced
Search for Amazon products by keyword using DataForSEO to retrieve titles, prices, ratings, and other details.
From 4 credits/call
Pricing
From 4 credits/call
| Condition | Charge |
|---|---|
| Each call | 4 credits |
A fixed fee applies to each call.
The starting price applies to a single query.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
tasks | array | Yes | No parameter description. | — |
tasks[].tag | string | null | No | No parameter description. | — |
tasks[].url | string | null | No | No parameter description. | — |
tasks[].depth | integer | null | No | No parameter description. | — |
tasks[].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>, please specify it as “%25”;<p>learn more about rules and limitations of <code>keyword</code> and <code>keywords</code> fields in DataForSEO APIs in this <a href="https://dataforseo.com/help-center/rules-and-limitations-of-keyword-and-keywords-fields-in-dataforseo-apis" rel="noopener noreferrer" target="_blank">Help Center article</a> | — |
tasks[].sort_by | string | null | No | No parameter description. | — |
tasks[].price_max | integer | null | No | No parameter description. | — |
tasks[].price_min | integer | null | No | No parameter description. | — |
tasks[].se_domain | string | null | No | No parameter description. | — |
tasks[].department | string | null | No | No parameter description. | — |
tasks[].search_param | string | null | No | No parameter description. | — |
tasks[].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</code> parameters by making a separate request to the <code>https://api.dataforseo.com/v3/merchant/amazon/languages</code><em><br></em>example:<em><br></em><code class="long-string">en_GB</code> | — |
tasks[].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_name</code> parameters by making a separate request to the<br><code>https://api.dataforseo.com/v3/merchant/amazon/languages</code><br>example:<br><code class="long-string">English (United Kingdom)</code> | — |
tasks[].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 receive the list of available locations with their <code>location_code</code> parameters by making a separate request to the<br><code>https://api.dataforseo.com/v3/merchant/amazon/locations</code><br>example:<br><code class="long-string">9045969</code> | — |
tasks[].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>you can receive the list of available locations with their <code>location_name</code> parameters by making a separate request to the <code>https://api.dataforseo.com/v3/merchant/amazon/locations</code><br>example:<br><code class="long-string">HA1,England,United Kingdom</code> | — |
tasks[].max_crawl_pages | integer | null | No | No parameter description. | — |
tasks[].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_coordinate</code> parameter should be specified in the <em>"latitude,longitude,radius"</em> format<br>the maximum number of decimal digits for <em>"latitude"</em> and <em>"longitude"</em>: 7<br>the minimum value for <em>"radius"</em>: 199.9<br>example:<br><code class="long-string">53.476225,-2.243572,200</code> | — |
Invocation example
Copy the request and explore its response example.
POST
/agent-api/v1/tool/executeX-Api-KeyRequest coderequest.sh
curl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_dataforseo_merchant_amazon_products_live_advanced' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"tasks": [
{
"depth": 100,
"keyword": "carregador carro eletrico",
"language_name": "Portuguese (Brazil)",
"location_name": "Brazil",
"se_domain": "amazon.com.br"
}
]
}
}'Response exampleresponse.json
{
"cost": 0.0033,
"status_code": 20000,
"status_message": "Ok.",
"tasks": [
{
"cost": 0.0033,
"data": {
"api": "merchant",
"depth": 100,
"device": "desktop",
"function": "products",
"keyword": "carregador carro eletrico",
"language_name": "Portuguese (Brazil)"
},
"id": "11171000-2802-0644-0000-cef9cad6bd15",
"path": [
"v3"
],
"result": [
{
"check_url": "https://www.amazon.com.br/s?k=carregador+carro+eletrico&crid=LGF4PQD3LXGZ&sprefix=carregador%2Bcarro%2Beletrico%2Caps%2C258&language=pt_BR&ref=nb_sb_noss",
"datetime": "2026-11-17 10:00:51 +00:00",
"item_types": [
"amazon_serp"
],
"items_count": 112,
"keyword": "carregador carro eletrico",
"type": "organic"
}
],
"result_count": 1
}
],
"tasks_count": 1,
"tasks_error": 0
}This example shows part of the response. Copied content is valid JSON.





