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.

Productivity
From 4 credits/call

Pricing

From 4 credits/call
ConditionCharge
Each call4 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.

ParameterTypeRequiredDescriptionDefault
tasksarrayYesNo parameter description.—
tasks[].tagstring | nullNoNo parameter description.—
tasks[].urlstring | nullNoNo parameter description.—
tasks[].depthinteger | nullNoNo parameter description.—
tasks[].keywordstringNo<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_bystring | nullNoNo parameter description.—
tasks[].price_maxinteger | nullNoNo parameter description.—
tasks[].price_mininteger | nullNoNo parameter description.—
tasks[].se_domainstring | nullNoNo parameter description.—
tasks[].departmentstring | nullNoNo parameter description.—
tasks[].search_paramstring | nullNoNo parameter description.—
tasks[].language_codestringNo<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_namestringNo<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_codeintegerNo<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_namestringNo<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_pagesinteger | nullNoNo parameter description.—
tasks[].location_coordinatestringNo<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-Key
Request 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
JSONPartial content
{
  "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.