Get Amazon Sellers Results by id
This endpoint provides a list of sellers of the specified product on Amazon. The data provided for each seller includes related product condition, pricing, shipment, and rating details.
This endpoint provides a list of sellers of the specified product on Amazon. The data provided for each seller includes related product condition, pricing, shipment, and rating details.
Instead of ‘login’ and ‘password’ use your credentials from https://app.dataforseo.com/api-access
<?php // You can download this file from here https://cdn.dataforseo.com/v3/examples/php/php_RestClient.zip require('RestClient.php'); $api_url = 'https://api.dataforseo.com/'; // Instead of 'login' and 'password' use your credentials from https://app.dataforseo.com/api-access $client = new RestClient($api_url, null, 'login', 'password'); try { $result = array(); // #1 - using this method you can get a list of completed tasks // GET /v3/merchant/amazon/sellers/tasks_ready $tasks_ready = $client->get('/v3/merchant/amazon/sellers/tasks_ready'); // you can find the full list of the response codes here https://docs.dataforseo.com/v3/appendix/errors if (isset($tasks_ready['status_code']) AND $tasks_ready['status_code'] === 20000) { foreach ($tasks_ready['tasks'] as $task) { if (isset($task['result'])) { foreach ($task['result'] as $task_ready) { // #2 - using this method you can get results of each completed task // GET /v3/merchant/amazon/sellers/task_get/advanced/$id if (isset($task_ready['endpoint_advanced'])) { $result[] = $client->get($task_ready['endpoint_advanced']); } // #3 - another way to get the task results by id // GET /v3/merchant/amazon/sellers/task_get/advanced/$id /* if (isset($task_ready['id'])) { $result[] = $client->get('/v3/merchant/amazon/sellers/task_get/advanced/' . $task_ready['id']); } */ } } } } print_r($result); // do something with result } catch (RestClientException $e) { echo "n"; print "HTTP code: {$e->getHttpCode()}n"; print "Error code: {$e->getCode()}n"; print "Message: {$e->getMessage()}n"; print $e->getTraceAsString(); echo "n"; } $client = null; ?>
The above command returns JSON structured like this:
{ "version": "0.1.20210729", "status_code": 20000, "status_message": "Ok.", "time": "0.0647 sec.", "cost": 0, "tasks_count": 1, "tasks_error": 0, "tasks": [ { "id": "08021205-1535-0309-0000-00fe791dc436", "status_code": 20000, "status_message": "Ok.", "time": "0.0171 sec.", "cost": 0, "result_count": 1, "path": [ "v3", "merchant", "amazon", "sellers", "task_get", "advanced", "08021205-1535-0309-0000-00fe791dc436" ], "data": { "se_type": "sellers_list", "se": "amazon", "api": "merchant", "function": "sellers", "language_code": "en_US", "location_code": 9004056, "asin": "B07D528W98", "device": "desktop", "os": "windows" }, "result": [ { "asin": "B07D528W98", "type": "sellers_list", "se_domain": "amazon.com", "location_code": 9004056, "language_code": "en_US", "check_url": "https://www.amazon.com/dp/B07D528W98/ref=olp_aod_redir_impl1?_encoding=UTF8&aod=1", "datetime": "2021-08-02 09:05:43 +00:00", "title": "YOSUDA Indoor Cycling Bike Stationary - Cycle Bike with Ipad Mount &Comfortable Seat Cushion (Gray)", "image": "https://images-na.ssl-images-amazon.com/images/I/416qnPQkItL.jpg", "item_types": [ "amazon_seller_main_item", "amazon_seller_item" ], "items_count": 11, "items": [ { "type": "amazon_seller_main_item", "rank_group": 1, "rank_absolute": 1, "position": "left", "xpath": "/#document", "seller_name": "MASOU", "seller_url": "http://amazon.com/gp/aag/main?ie=UTF8&seller=A2XS9KO5PUQHMV&isAmazonFulfilled=1&asin=B07D528W98&ref_=olp_merch_name_0", "ships_from": "Amazon.com", "price": { "current": 279.99, "regular": null, "max_value": null, "currency": "USD", "is_price_range": false, "displayed_price": "$279.99" }, "rating": { "type": "rating_element", "position": "left", "rating_type": "Max5", "value": "4.5", "votes_count": 14438, "rating_max": "5" }, "condition": null, "condition_description": null, "delivery_info": { "delivery_date_from": "2021-08-08T00:00:00+00:00", "delivery_date_to": null, "fastest_delivery_date_from": null, "fastest_delivery_date_to": null, "delivery_message": "FREE delivery: Sunday, Aug 8", "delivery_price": null } }, { "type": "amazon_seller_item", "rank_group": 1, "rank_absolute": 2, "position": "left", "xpath": "/span[1]/span[1]/span[1]/div[1]/div[1]/div[4]/div[1]", "seller_name": "Amazon Warehouse", "seller_url": "https://www.amazon.com/Warehouse-Deals/b?ie=UTF8&node=10158976011", "ships_from": "Amazon.com", "price": { "current": 196.23, "regular": null, "max_value": null, "currency": "USD", "is_price_range": false, "displayed_price": "$196.23" }, "rating": null, "condition": null, "condition_description": "Missing assembly hardware (screws/fasteners). Item will come in original packaging. Packaging will be damaged.", "delivery_info": { "delivery_date_from": "2021-08-09T00:00:00+00:00", "delivery_date_to": null, "fastest_delivery_date_from": null, "fastest_delivery_date_to": null, "delivery_message": "FREE delivery: Monday, Aug 9", "delivery_price": null } }, { "type": "amazon_seller_item", "rank_group": 2, "rank_absolute": 3, "position": "left", "xpath": "/span[1]/span[1]/span[1]/div[1]/div[1]/div[4]/div[2]", "seller_name": "Amazon Warehouse", "seller_url": "https://www.amazon.com/Warehouse-Deals/b?ie=UTF8&node=10158976011", "ships_from": "Amazon.com", "price": { "current": 205.15, "regular": null, "max_value": null, "currency": "USD", "is_price_range": false, "displayed_price": "$205.15" }, "rating": null, "condition": null, "condition_description": "Item will come repackaged.", "delivery_info": { "delivery_date_from": "2021-08-09T00:00:00+00:00", "delivery_date_to": null, "fastest_delivery_date_from": null, "fastest_delivery_date_to": null, "delivery_message": "FREE delivery: Monday, Aug 9", "delivery_price": null } }, { "type": "amazon_seller_item", "rank_group": 3, "rank_absolute": 4, "position": "left", "xpath": "/span[1]/span[1]/span[1]/div[1]/div[1]/div[4]/div[3]", "seller_name": "Amazon Warehouse", "seller_url": "https://www.amazon.com/Warehouse-Deals/b?ie=UTF8&node=10158976011", "ships_from": "Amazon.com", "price": { "current": 205.15, "regular": null, "max_value": null, "currency": "USD", "is_price_range": false, "displayed_price": "$205.15" }, "rating": null, "condition": null, "condition_description": "Small cosmetic imperfection on top, front or sides of item. Item will come in original packaging. Packaging will be damaged.", "delivery_info": { "delivery_date_from": "2021-08-08T00:00:00+00:00", "delivery_date_to": null, "fastest_delivery_date_from": null, "fastest_delivery_date_to": null, "delivery_message": "FREE delivery: Sunday, Aug 8", "delivery_price": null } }, { "type": "amazon_seller_item", "rank_group": 4, "rank_absolute": 5, "position": "left", "xpath": "/span[1]/span[1]/span[1]/div[1]/div[1]/div[4]/div[4]", "seller_name": "Amazon Warehouse", "seller_url": "https://www.amazon.com/Warehouse-Deals/b?ie=UTF8&node=10158976011", "ships_from": "Amazon.com", "price": { "current": 205.15, "regular": null, "max_value": null, "currency": "USD", "is_price_range": false, "displayed_price": "$205.15" }, "rating": null, "condition": null, "condition_description": "Item will come in original packaging. Packaging will be damaged.", "delivery_info": { "delivery_date_from": "2021-08-08T00:00:00+00:00", "delivery_date_to": null, "fastest_delivery_date_from": null, "fastest_delivery_date_to": null, "delivery_message": "FREE delivery: Sunday, Aug 8", "delivery_price": null } }, { "type": "amazon_seller_item", "rank_group": 5, "rank_absolute": 6, "position": "left", "xpath": "/span[1]/span[1]/span[1]/div[1]/div[1]/div[4]/div[5]", "seller_name": "Amazon Warehouse", "seller_url": "https://www.amazon.com/Warehouse-Deals/b?ie=UTF8&node=10158976011", "ships_from": "Amazon.com", "price": { "current": 205.15, "regular": null, "max_value": null, "currency": "USD", "is_price_range": false, "displayed_price": "$205.15" }, "rating": null, "condition": null, "condition_description": "Small cosmetic imperfection on top, front or sides of item. Small cosmetic imperfection on bottom or back of item. Item will come in original packaging. Packaging will be damaged.", "delivery_info": { "delivery_date_from": "2021-08-12T00:00:00+00:00", "delivery_date_to": null, "fastest_delivery_date_from": "2021-08-08T00:00:00+00:00", "fastest_delivery_date_to": "2021-08-10T00:00:00+00:00", "delivery_message": "FREE delivery: Thursday, Aug 12 Fastest delivery: Aug 8 - 10", "delivery_price": null } }, { "type": "amazon_seller_item", "rank_group": 6, "rank_absolute": 7, "position": "left", "xpath": "/span[1]/span[1]/span[1]/div[1]/div[1]/div[4]/div[6]", "seller_name": "Amazon Warehouse", "seller_url": "https://www.amazon.com/Warehouse-Deals/b?ie=UTF8&node=10158976011", "ships_from": "Amazon.com", "price": { "current": 205.15, "regular": null, "max_value": null, "currency": "USD", "is_price_range": false, "displayed_price": "$205.15" }, "rating": null, "condition": null, "condition_description": "Small cosmetic imperfections on the corner of the item. Item will come in original packaging. Packaging will be damaged.", "delivery_info": { "delivery_date_from": "2021-08-11T00:00:00+00:00", "delivery_date_to": null, "fastest_delivery_date_from": null, "fastest_delivery_date_to": null, "delivery_message": "FREE delivery: Wednesday, Aug 11", "delivery_price": null } }, { "type": "amazon_seller_item", "rank_group": 7, "rank_absolute": 8, "position": "left", "xpath": "/span[1]/span[1]/span[1]/div[1]/div[1]/div[4]/div[7]", "seller_name": "Amazon Warehouse", "seller_url": "https://www.amazon.com/Warehouse-Deals/b?ie=UTF8&node=10158976011", "ships_from": "Amazon.com", "price": { "current": 205.15, "regular": null, "max_value": null, "currency": "USD", "is_price_range": false, "displayed_price": "$205.15" }, "rating": null, "condition": null, "condition_description": "Small cosmetic imperfection on top, front or sides of item. Small cosmetic imperfection on bottom or back of item. Small cosmetic imperfections on the corner of the item. Item will come in original packaging. Packaging will be damaged.", "delivery_info": { "delivery_date_from": "2021-08-08T00:00:00+00:00", "delivery_date_to": null, "fastest_delivery_date_from": null, "fastest_delivery_date_to": null, "delivery_message": "FREE delivery: Sunday, Aug 8", "delivery_price": null } }, { "type": "amazon_seller_item", "rank_group": 8, "rank_absolute": 9, "position": "left", "xpath": "/span[1]/span[1]/span[1]/div[1]/div[1]/div[4]/div[8]", "seller_name": "Amazon Warehouse", "seller_url": "https://www.amazon.com/Warehouse-Deals/b?ie=UTF8&node=10158976011", "ships_from": "Amazon.com", "price": { "current": 211.84, "regular": null, "max_value": null, "currency": "USD", "is_price_range": false, "displayed_price": "$211.84" }, "rating": null, "condition": null, "condition_description": "Item will come in original packaging. Packaging will be damaged.", "delivery_info": { "delivery_date_from": "2021-08-08T00:00:00+00:00", "delivery_date_to": null, "fastest_delivery_date_from": null, "fastest_delivery_date_to": null, "delivery_message": "FREE delivery: Sunday, Aug 8", "delivery_price": null } }, { "type": "amazon_seller_item", "rank_group": 9, "rank_absolute": 10, "position": "left", "xpath": "/span[1]/span[1]/span[1]/div[1]/div[1]/div[4]/div[9]", "seller_name": "MASOU", "seller_url": "http://amazon.com/gp/aag/main?ie=UTF8&seller=A2XS9KO5PUQHMV&isAmazonFulfilled=1&asin=B07D528W98&ref_=olp_merch_name_9", "ships_from": "Amazon.com", "price": { "current": 279.99, "regular": null, "max_value": null, "currency": "USD", "is_price_range": false, "displayed_price": "$279.99" }, "rating": { "type": "rating_element", "position": "left", "rating_type": "Max5", "value": "4.5", "votes_count": null, "rating_max": "5" }, "condition": null, "condition_description": null, "delivery_info": { "delivery_date_from": "2021-08-08T00:00:00+00:00", "delivery_date_to": null, "fastest_delivery_date_from": null, "fastest_delivery_date_to": null, "delivery_message": "FREE delivery: Sunday, Aug 8", "delivery_price": null } }, { "type": "amazon_seller_item", "rank_group": 10, "rank_absolute": 11, "position": "left", "xpath": "/span[1]/span[1]/span[1]/div[1]/div[1]/div[4]/div[10]", "seller_name": "MASOU", "seller_url": "http://amazon.com/gp/aag/main?ie=UTF8&seller=A2XS9KO5PUQHMV&isAmazonFulfilled=1&asin=B07D528W98&ref_=olp_merch_name_10", "ships_from": "Amazon.com", "price": { "current": 279.99, "regular": null, "max_value": null, "currency": "USD", "is_price_range": false, "displayed_price": "$279.99" }, "rating": { "type": "rating_element", "position": "left", "rating_type": "Max5", "value": "4.5", "votes_count": null, "rating_max": "5" }, "condition": null, "condition_description": null, "delivery_info": { "delivery_date_from": "2021-08-12T00:00:00+00:00", "delivery_date_to": null, "fastest_delivery_date_from": null, "fastest_delivery_date_to": null, "delivery_message": "FREE delivery: Thursday, Aug 12", "delivery_price": null } } ] } ] } ] }
Description of the fields for sending a request:
Field name | Type | Description |
---|---|---|
id |
string | task identifier unique task identifier in our system in the UUID format you will be able to use it within 30 days to request the results of the task at any time |
As a response of the API server, you will receive JSON-encoded data containing a tasks
array with the information specific to the set tasks.
You can also get all available SERP features by making a request to the following Sandbox URL:
https://sandbox.dataforseo.com/v3/merchant/amazon/sellers/task_get/advanced/00000000-0000-0000-0000-000000000000
The response will include all available items in the Amazon Sellers Advanced endpoint with the fields containing dummy data.
You won’t be charged for using Sandbox endpoints.
Description of the fields in the results array:
Field name | Type | Description |
---|---|---|
version |
string | the current version of the API |
status_code |
integer | general status code you can find the full list of the response codes here Note: we strongly recommend designing a necessary system for handling related exceptional or error conditions |
status_message |
string | general informational message you can find the full list of general informational messages here |
time |
string | execution time, seconds |
cost |
float | total tasks cost, USD |
tasks_count |
integer | the number of tasks in the tasks array |
tasks_error |
integer | the number of tasks in the tasks array that were returned an error |
tasks |
array | array of tasks |
id |
string | task identifier unique task identifier in our system in the UUID format |
status_code |
integer | status code of the task generated by DataForSEO; can be within the following range: 10000-60000 you can find the full list of the response codes here |
status_message |
string | informational message of the task you can find the full list of general informational messages here |
time |
string | execution time, seconds |
cost |
float | cost of the task, USD |
result_count |
integer | number of elements in the result array |
path |
array | URL path |
data |
object | contains the same parameters that you specified in the POST request |
result |
array | array of results |
asin |
string | asin received in a POST arraylearn more about ASINs in this help center guide |
type |
string | search engine type possible values: sellers_list |
se_domain |
string | search engine domain received in a POST array |
location_code |
integer | location code received in a POST array |
language_code |
string | language code received in a POST array |
check_url |
string | direct URL to Amazon results you can use it to make sure the provided results are accurate |
datetime |
string | date and time when the result was received in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00” example: 2019-11-15 12:57:46 +00:00 |
title |
string | product title title of the product relevant to the asin received in a POST array |
image |
string | product image url image URL of the product relevant to the asin received in a POST array |
item_types |
array | types of search results found in Amazon Sellers SERP contains types of all search results ( items ) found in the returned SERPpossible item types: amazon_seller_main_item , amazon_seller_item |
items_count |
integer | the number of results returned in the items array |
items |
array | items in SERP |
‘amazon_seller_main_item’ | ||
type |
string | type of item = ‘amazon_seller_main_item’ |
rank_group |
integer | position within a group of elements with identical type valuespositions of elements with different type values are omitted from rank_group |
rank_absolute |
integer | absolute rank in SERP absolute position among all the elements found in Amazon Sellers SERP |
position |
string | alignment of the element in SERP possible values: left , right |
xpath |
string | XPath of the element |
seller_name |
string | business name of the seller |
seller_url |
string | url forwarding to the seller’s page on Amazon |
ships_from |
string | sender company name |
price |
object | product pricing details if there are no details, the value will be null |
current |
float | current product price with discount |
regular |
float | regular product price without discount |
max_value |
float | maximal displayed price of the product |
currency |
string | currency in the ISO format example: USD |
is_price_range |
boolean | price is displayed as a range indicates whether the price is displayed as a range |
displayed_price |
string | price as displayed in SERP price line provided as displayed in Amazon listing |
rating |
object | seller rating details seller popularity rate based on customer reviews |
type |
string | type of element = ‘rating_element’ |
rating_type |
string | the type of rating here you can find the following elements: Max5 |
value |
string | the value of the rating |
votes_count |
integer | the amount of feedback |
rating_max |
integer | the maximum value for a rating_type |
condition |
string | product condition condition of the product offered by the seller |
condition_description |
string | product condition details expanded details on the condition of the product offered by the seller |
delivery_info |
object | delivery information delivery information including free and fast delivery date ranges |
delivery_date_from |
string | earliest delivery date the earliest date when the product can be shipped |
delivery_date_to |
string | latest delivery date the latest date when the product can be delivered |
fastest_delivery_date_from |
string | earliest free delivery date the earliest date when the product can be delivered with a fast delivery option |
fastest_delivery_date_to |
string | latest free delivery date the latest date when the product can be delivered with a fast delivery option |
delivery_message |
string | delivery information message accompanying the delivery information as posted by the seller |
delivery_price |
object | price for the delivery price of the delivery based on the location you specified in the POST request; if free delivery is available, the value is null |
current |
float | current delivery price |
regular |
float | regular undiscounted delivery price |
max_value |
float | maximum undiscounted delivery price |
currency |
string | currency in the ISO format |
is_price_range |
boolean | indicates whether the delivary price is a range |
displayed_price |
string | price line provided as displayed in Amazon listing |
‘amazon_seller_item’ | ||
type |
string | type of item = ‘amazon_seller_item’ |
rank_group |
integer | position within a group of elements with identical type valuespositions of elements with different type values are omitted from rank_group |
rank_absolute |
integer | absolute rank in SERP absolute position among all the elements found in Amazon Sellers SERP |
position |
string | alignment of the element in SERP can take the following values: left , right |
xpath |
string | XPath of the element |
seller_name |
string | business name of the seller |
seller_url |
string | url forwarding to the seller’s page on Amazon |
ships_from |
string | sender company name |
price |
object | product pricing details if there are no details, the value will be null |
current |
float | current product price with discount |
regular |
float | regular product price without discount |
max_value |
float | maximal displayed price of the product |
currency |
string | currency in the ISO format example: USD |
is_price_range |
boolean | price is displayed as a range indicates whether the price is displayed as a range |
displayed_price |
string | price as displayed in SERP price line provided as displayed in Amazon listing |
rating |
object | seller rating details seller popularity rate based on customer reviews |
type |
string | type of element = ‘rating_element’ |
rating_type |
string | the type of rating here you can find the following elements: Max5 |
value |
string | the value of the rating |
votes_count |
integer | the amount of feedback |
rating_max |
integer | the maximum value for a rating_type |
condition |
string | product condition condition of the product offered by the seller |
condition_description |
string | product condition details expanded details on the condition of the product offered by the seller |
delivery_info |
object | delivery information delivery information including free and fast delivery date ranges |
delivery_date_from |
string | earliest delivery date the earliest date when the product can be shipped |
delivery_date_to |
string | latest delivery date the latest date when the product can be delivered |
fastest_delivery_date_from |
string | earliest free delivery date the earliest date when the product can be delivered with a fast delivery option |
fastest_delivery_date_to |
string | latest free delivery date the latest date when the product can be delivered with a fast delivery option |
delivery_message |
string | delivery information message accompanying the delivery information as posted by the seller |
delivery_price |
object | price for the delivery price of the delivery based on the location you specified in the POST request; if free delivery is available, the value is null |
current |
float | current delivery price |
regular |
float | regular undiscounted delivery price |
max_value |
float | maximum undiscounted delivery price |
currency |
string | currency in the ISO format |
is_price_range |
boolean | indicates whether the delivary price is a range |
displayed_price |
string | price line provided as displayed in Amazon listing |