NAVNavbar
Logo
cURL php NodeJS Python cSharp

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.

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 array
learn 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 SERP
possible 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 values
positions 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 values
positions 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

‌‌