DataForSEO Labs Amazon Product Competitors

From 14.4 credits/call
ae_dataforseo_labs_amazon_product_competitors

Find competing Amazon products that appear in the same search results as a specific ASIN using DataForSEO.

Search
From 14.4 credits/call

Pricing

From 14.4 credits/call
ConditionCharge
Base processing fee per call14.4 credits
Per record0.2 credits

Charges depend on the actual returned results.

The starting price is the base query fee; returned records add the listed charges.

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
tasksarrayYesNo parameter description.—
tasks[].tagstring | nullNoNo parameter description.—
tasks[].asinstringNo<em>product ID</em><br><strong>required field</strong><br><a href="https://dataforseo.com/help-center/asin-in-amazon-api" target="_blank" rel="noopener noreferrer">unique product identifier (ASIN)</a> on Amazon;<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>—
tasks[].limitinteger | nullNoNo parameter description.—
tasks[].offsetinteger | nullNoNo parameter description.—
tasks[].filtersarray | nullNoNo parameter description.—
tasks[].order_byarray | nullNoNo parameter description.—
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_competitors' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "tasks": [
      {
        "asin": "B003O2RXUQ",
        "language_code": "en",
        "limit": 1,
        "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",
        "asin": "B003O2RXUQ",
        "function": "product_competitors",
        "language_code": "en",
        "limit": 1,
        "location_code": 2840
      },
      "id": "10261121-2802-0375-0000-bc80b525c69b",
      "path": [
        "v3"
      ],
      "result": [
        {
          "asin": "B003O2RXUQ",
          "items": [
            {}
          ],
          "items_count": 1,
          "language_code": "en",
          "location_code": 2840,
          "se_type": "amazon"
        }
      ],
      "result_count": 1
    }
  ],
  "tasks_count": 1,
  "tasks_error": 0
}

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