DataForSEO Labs Amazon Product Rank Overview

From 14.6 credits/call
ae_dataforseo_labs_amazon_product_rank_overview

Check organic and paid search ranking positions for up to 1,000 Amazon ASINs using DataForSEO.

Search
From 14.6 credits/call

Pricing

From 14.6 credits/call
ConditionCharge
Base processing fee per call14.4 credits
Per item0.2 credits

Charges depend on submitted items.

The starting price is for one submitted query item.

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
tasksarrayYesNo parameter description.—
tasks[].tagstring | nullNoNo parameter description.—
tasks[].asinsarrayNo<em>product IDs to compare</em><br><strong>required field</strong><br>product IDs to receive ranking data for;<br><strong>the maximum number of ASINs you can specify in this array is 1000;</strong><br>you can receive the <code>asin</code> parameter by making a separate request to the <a href="/v3/merchant/amazon/products/task_post/" target="_blank" rel="noopener noreferrer">Amazon Products endpoint</a><p><strong>Note:</strong> all letters in ASIN code must be specified in uppercase format;<br>example:<br><code>B01LW2SL7R</code>—
tasks[].language_codestring | nullNoNo parameter description.—
tasks[].language_namestringNo<em>full name of the language</em><br><strong>required field if don't specify <code>language_code</code></strong><br>you can receive the list of available languages with their <code>language_name</code> by making a separate request to the <br><code>https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages</code><br>example:<br><code class="long-string">English</code>—
tasks[].location_codeintegerNo<em>location code</em><br><strong>required field if don't specify <code>location_name</code></strong><br>you can receive the list of available locations with their <code>location_code</code> by making a separate request to <br><code>https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages</code>;<br><strong>Note:</strong> this endpoint currently supports the US, Egypt, Saudi Arabia, and the United Arab Emirates locations only;<br>example:<br><code class="long-string">2840</code>—
tasks[].location_namestringNo<em>full name of the location</em><br><strong>required field if don't specify <code>location_code</code></strong><br>you can receive the list of available locations with their <code>location_name</code> by making a separate request to <br><code>https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages</code>;<br><strong>Note:</strong> this endpoint currently supports the US, Egypt, Saudi Arabia, and the United Arab Emirates locations only;<br>example:<br><code class="long-string">United States</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_labs_amazon_product_rank_overview' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "tasks": [
      {
        "asins": [
          "B003O2RXUQ"
        ],
        "language_code": "en",
        "location_code": 2840
      }
    ]
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "cost": 0.01212,
  "status_code": 20000,
  "status_message": "Ok.",
  "tasks": [
    {
      "cost": 0.01212,
      "data": {
        "api": "dataforseo_labs",
        "asins": [
          "B003O2RXUQ"
        ],
        "function": "product_rank_overview",
        "language_code": "en",
        "location_code": 2840,
        "se_type": "amazon"
      },
      "id": "10261121-2802-0378-0000-b7f29f6b188f",
      "path": [
        "v3"
      ],
      "result": [
        {
          "items": [
            {}
          ],
          "items_count": 1,
          "language_code": "en",
          "location_code": 2840,
          "se_type": "amazon",
          "total_count": 1
        }
      ],
      "result_count": 1
    }
  ],
  "tasks_count": 1,
  "tasks_error": 0
}

This example shows part of the response. Copied content is valid JSON.