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.
From 14.6 credits/call
Pricing
From 14.6 credits/call
| Condition | Charge |
|---|---|
| Base processing fee per call | 14.4 credits |
| Per item | 0.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.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
tasks | array | Yes | No parameter description. | — |
tasks[].tag | string | null | No | No parameter description. | — |
tasks[].asins | array | No | <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_code | string | null | No | No parameter description. | — |
tasks[].language_name | string | No | <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_code | integer | No | <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_name | string | No | <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-KeyRequest 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
{
"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.




