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.

checked GET
Pricing

Your account will be charged only for posting a task. You can get the results of the task within the next 30 days for free.
The cost can be calculated on the Pricing page.

Description of the fields for sending a request:

Field nameTypeDescription
idstring

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 nameTypeDescription
versionstring

the current version of the API

status_codeinteger

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_messagestring

general informational message
you can find the full list of general informational messages here

timestring

execution time, seconds

costfloat

total tasks cost, USD

tasks_countinteger

the number of tasks in the tasks array

tasks_errorinteger

the number of tasks in the tasks array that were returned an error

tasksarray

array of tasks

    idstring

task identifier
unique task identifier in our system in the UUID format

    status_codeinteger

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_messagestring

informational message of the task
you can find the full list of general informational messages here

    timestring

execution time, seconds

    costfloat

cost of the task, USD

    result_countinteger

number of elements in the result array

    patharray

URL path

    dataobject

contains the same parameters that you specified in the POST request

    resultarray

array of results

        asinstring

asin received in a POST array
learn more about ASINs in this help center guide

        typestring

search engine type
possible values: sellers

        se_domainstring

search engine domain received in a POST array

        location_codeinteger

location code received in a POST array

        language_codestring

language code received in a POST array

        check_urlstring

direct URL to Amazon results
you can use it to make sure the provided results are accurate

        datetimestring

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

        titlestring

product title
title of the product relevant to the asin received in a POST array

        imagestring

product image url
image URL of the product relevant to the asin received in a POST array

        item_typesarray

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_countinteger

the number of results returned in the items array

        itemsarray

items in SERP

            amazon_seller_main_itemobject

'amazon_seller_main_item' element in SERP

                typestring

type of item = 'amazon_seller_main_item'

                rank_groupinteger

position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group

                rank_absoluteinteger

absolute rank in SERP
absolute position among all the elements found in Amazon Sellers SERP

                positionstring

alignment of the element in SERP
possible values:
left, right

                xpathstring

XPath of the element

                seller_namestring

business name of the seller

                seller_urlstring

url forwarding to the seller's page on Amazon

                ships_fromstring

sender company name

                priceobject

product pricing details
if there are no details, the value will be null

                    currentfloat

current product price with discount

                    regularfloat

regular product price without discount

                    max_valuefloat

maximal displayed price of the product

                    currencystring

currency in the ISO format
example:
USD

                    is_price_rangeboolean

price is displayed as a range
indicates whether the price is displayed as a range

                    displayed_pricestring

price as displayed in SERP
price line provided as displayed in Amazon listing

                percentage_discountfloat

value of the percentage discount

                applicable_vouchersarray

array of objects containing information about applicable vouchers

                    typestring

item type
possible values: amazon_applicable_vouchers_item

                    textstring

text of the voucher

                    fixed_discountfloat

value of the fixed discount

                    fixed_discount_currencystring

currency code of the fixed discount in the ISO format

                    percentage_discountfloat

value of the percentage discount
if the discount is fixed, the value will be null

                    important_detailsstring

important details about the terms of discount vouchers

                ratingobject

seller rating details
seller popularity rate based on customer reviews

                    typestring

type of element='rating_element'n

                    rating_typestring

the type of rating
here you can find the following elements: Max5

                    valuefloat

the value of the rating

                    votes_countinteger

the amount of feedback

                    rating_maxinteger

the maximum value for a rating_type

                conditionstring

product condition
condition of the product offered by the seller

                condition_descriptionstring

product condition details
expanded details on the condition of the product offered by the seller

                delivery_infoobject

delivery information
delivery information including free and fast delivery date ranges

                    delivery_date_fromstring

earliest delivery date
the earliest date when the product can be shipped, in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example: 2019-11-15 12:57:46 +00:00

                    delivery_date_tostring

latest delivery date
the latest date when the product can be delivered, in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example: 2019-11-15 12:57:46 +00:00

                    fastest_delivery_date_fromstring

earliest free delivery date
the earliest date when the product can be delivered with a fast delivery option, in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example: 2019-11-15 12:57:46 +00:00

                    fastest_delivery_date_tostring

latest free delivery date
the latest date when the product can be delivered with a fast delivery option, in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example: 2019-11-15 12:57:46 +00:00

                    delivery_messagestring

delivery information
message accompanying the delivery information as posted by the seller

                    delivery_priceobject

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

                        currentfloat

current delivery price

                        regularfloat

regular undiscounted delivery price

                        max_valuefloat

maximum undiscounted delivery price

                        currencystring

currency in the ISO format

                        is_price_rangeboolean

indicates whether the delivary price is a range

                        displayed_pricestring

price line provided as displayed in Amazon listing

            amazon_seller_itemobject

'amazon_seller_item' element in SERP

                typestring

type of item = 'amazon_seller_item'

                rank_groupinteger

position within a group of elements with identical type values
positions of elements with different type values are omitted from rank_group

                rank_absoluteinteger

absolute rank in SERP
absolute position among all the elements found in Amazon Sellers SERP

                positionstring

alignment of the element in SERP
can take the following values:
left, right

                xpathstring

XPath of the element

                seller_namestring

business name of the seller

                seller_urlstring

url forwarding to the seller's page on Amazon

                ships_fromstring

sender company name

                priceobject

product pricing details
if there are no details, the value will be null

                    currentfloat

current product price with discount

                    regularfloat

regular product price without discount

                    max_valuefloat

maximal displayed price of the product

                    currencystring

currency in the ISO format
example:
USD

                    is_price_rangeboolean

price is displayed as a range
indicates whether the price is displayed as a range

                    displayed_pricestring

price as displayed in SERP
price line provided as displayed in Amazon listing

                percentage_discountfloat

value of the percentage discount

                applicable_vouchersarray

array of objects containing information about applicable vouchers

                    typestring

item type
possible values: amazon_applicable_vouchers_item

                    textstring

text of the voucher

                    fixed_discountfloat

value of the fixed discount

                    fixed_discount_currencystring

currency code of the fixed discount

                    percentage_discountfloat

value of the percentage discount
if the discount is fixed, the value will be null

                    important_detailsstring

important details about the terms of discount vouchers

                ratingobject

seller rating details
seller popularity rate based on customer reviews

                    typestring

type of element='rating_element'n

                    rating_typestring

the type of rating
here you can find the following elements: Max5

                    valuefloat

the value of the rating

                    votes_countinteger

the amount of feedback

                    rating_maxinteger

the maximum value for a rating_type

                conditionstring

product condition
condition of the product offered by the seller

                condition_descriptionstring

product condition details
expanded details on the condition of the product offered by the seller

                delivery_infoobject

delivery information
delivery information including free and fast delivery date ranges

                    delivery_date_fromstring

earliest delivery date
the earliest date when the product can be shipped, in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example: 2019-11-15 12:57:46 +00:00

                    delivery_date_tostring

latest delivery date
the latest date when the product can be delivered, in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example: 2019-11-15 12:57:46 +00:00

                    fastest_delivery_date_fromstring

earliest free delivery date
the earliest date when the product can be delivered with a fast delivery option, in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example: 2019-11-15 12:57:46 +00:00

                    fastest_delivery_date_tostring

latest free delivery date
the latest date when the product can be delivered with a fast delivery option, in the UTC format: “yyyy-mm-dd hh-mm-ss +00:00”
example: 2019-11-15 12:57:46 +00:00

                    delivery_messagestring

delivery information
message accompanying the delivery information as posted by the seller

                    delivery_priceobject

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

                        currentfloat

current delivery price

                        regularfloat

regular undiscounted delivery price

                        max_valuefloat

maximum undiscounted delivery price

                        currencystring

currency in the ISO format

                        is_price_rangeboolean

indicates whether the delivary price is a range

                        displayed_pricestring

price line provided as displayed in Amazon listing


‌‌

Instead of ‘login’ and ‘password’ use your credentials from https://app.dataforseo.com/api-access

# Instead of 'login' and 'password' use your credentials from https://app.dataforseo.com/api-access 
login="login" 
password="password" 
cred="$(printf ${login}:${password} | base64)" 
id="04171157-0696-0183-0000-4f63affdd40a" 
curl --location --request GET "https://api.dataforseo.com/v3/merchant/amazon/sellers/task_get/advanced/${id}" 
--header "Authorization: Basic ${cred}"  
--header "Content-Type: application/json" 
--data-raw ""
<?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;
?>
const task_id = '02231453-2604-0066-2000-64d39c6677d4';

const axios = require('axios');

axios({
    method: 'get',
    url: 'https://api.dataforseo.com/v3/merchant/amazon/sellers/task_get/advanced/' + task_id,
    auth: {
        username: 'login',
        password: 'password'
    },
    headers: {
        'content-type': 'application/json'
    }
}).then(function (response) {
    var result = response['data']['tasks'];
    // Result data
    console.log(result);
}).catch(function (error) {
    console.log(error);
});
from client import RestClient
# You can download this file from here https://cdn.dataforseo.com/v3/examples/python/python_Client.zip
client = RestClient("login", "password")
# 1 - using this method you can get a list of completed tasks
# GET /v3/merchant/amazon/sellers/tasks_ready
response = 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 response['status_code'] == 20000:
    results = []
    for task in response['tasks']:
        if (task['result'] and (len(task['result']) > 0)):
            for resultTaskInfo in task['result']:
                # 2 - using this method you can get results of each completed task
				# GET /v3/merchant/amazon/sellers/task_get/advanced/$id
                if(resultTaskInfo['endpoint_advanced']):
                    results.append(client.get(resultTaskInfo['endpoint_advanced']))                
                '''
                # 3 - another way to get the task results by id
                # GET /v3/merchant/amazon/sellers/task_get/advanced/$id              
                if(resultTaskInfo['id']):
                    results.append(client.get("/v3/merchant/amazon/sellers/task_get/advanced/" + resultTaskInfo['id']))
                '''
    print(results)
    # do something with result
else:
    print("error. Code: %d Message: %s" % (response["status_code"], response["status_message"]))
using Newtonsoft.Json;
using System;
using System.Collections.Generic;
using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;
using System.Threading.Tasks;

namespace DataForSeoDemos
{
    public static partial class Demos
    {
        public static async Task merchant_amazon_sellers_task_get()
        {
            var httpClient = new HttpClient
            {
                BaseAddress = new Uri("https://api.dataforseo.com/"),
                // Instead of 'login' and 'password' use your credentials from https://app.dataforseo.com/api-access
                DefaultRequestHeaders = { Authorization = new AuthenticationHeaderValue("Basic", Convert.ToBase64String(Encoding.ASCII.GetBytes("login:password"))) }
            };
            // #1 - using this method you can get a list of completed tasks
            // GET /v3/merchant/amazon/sellers/tasks_ready
            var response = await httpClient.GetAsync("/v3/merchant/amazon/sellers/tasks_ready");
            var tasksInfo = JsonConvert.DeserializeObject<dynamic>(await response.Content.ReadAsStringAsync());
            var tasksResponses = new List<object>();
            // you can find the full list of the response codes here https://docs.dataforseo.com/v3/appendix/errors
            if (tasksInfo.status_code == 20000)
            {
                if (tasksInfo.tasks != null)
                {
                    foreach (var tasks in tasksInfo.tasks)
                    {
                        if (tasks.result != null)
                        {
                            foreach (var task in tasks.result)
                            {
                                if (task.endpoint_advanced != null)
                                {
                                    // #2 - using this method you can get results of each completed task
                                    // GET /v3/merchant/amazon/sellers/task_get/advanced/$id
                                    var taskGetResponse = await httpClient.GetAsync((string)task.endpoint_advanced);
                                    var taskResultObj = JsonConvert.DeserializeObject<dynamic>(await taskGetResponse.Content.ReadAsStringAsync());
                                    if (taskResultObj.tasks != null)
                                    {
                                        var fst = taskResultObj.tasks.First;
                                        // you can find the full list of the response codes here https://docs.dataforseo.com/v3/appendix/errors
                                        if (fst.status_code >= 40000 || fst.result == null)
                                            Console.WriteLine($"error. Code: {fst.status_code} Message: {fst.status_message}");
                                        else
                                            tasksResponses.Add(fst.result);
                                    }
                                    // #3 - another way to get the task results by id
                                    // GET /v3/merchant/amazon/sellers/task_get/advanced/$id
                                    /*
                                    var tasksGetResponse = await httpClient.GetAsync("/v3/merchant/amazon/sellers/task_get/advanced/" + (string)task.id);
                                    var taskResultObj = JsonConvert.DeserializeObject<dynamic>(await tasksGetResponse.Content.ReadAsStringAsync());
                                    if (taskResultObj.tasks != null)
                                    {
                                        var fst = taskResultObj.tasks.First;
                                        // you can find the full list of the response codes here https://docs.dataforseo.com/v3/appendix/errors
                                        if (fst.status_code >= 40000 || fst.result == null)
                                            Console.WriteLine($"error. Code: {fst.status_code} Message: {fst.status_message}");
                                        else
                                            tasksResponses.Add(fst.result);
                                    }
                                    */
                                }
                            }
                        }
                    }
                }
                if (tasksResponses.Count > 0)
                    // do something with result
                    Console.WriteLine(String.Join(Environment.NewLine, tasksResponses));
                else
                    Console.WriteLine("No completed tasks");
            }
            else
                Console.WriteLine($"error. Code: {tasksInfo.status_code} Message: {tasksInfo.status_message}");
        }
    }
}

The above command returns JSON structured like this:

{
  "version": "0.1.20250812",
  "status_code": 20000,
  "status_message": "Ok.",
  "time": "0.0779 sec.",
  "cost": 0,
  "tasks_count": 1,
  "tasks_error": 0,
  "tasks": [
    {
      "id": "08271608-1535-0309-0000-7f699f88a32b",
      "status_code": 20000,
      "status_message": "Ok.",
      "time": "0.0177 sec.",
      "cost": 0,
      "result_count": 1,
      "path": [
        "v3",
        "merchant",
        "amazon",
        "sellers",
        "task_get",
        "advanced",
        "08271608-1535-0309-0000-7f699f88a32b"
      ],
      "data": {
        "se_type": "sellers",
        "se": "amazon",
        "api": "merchant",
        "function": "sellers",
        "language_code": "en_US",
        "location_code": 9004056,
        "asin": "B07D528W98",
        "device": "desktop",
        "os": "windows"
      },
      "result": [
        {
          "asin": "B07D528W98",
          "type": "sellers",
          "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": "2025-08-27 13:08:57 +00:00",
          "title": "YOSUDA Exercise Bike, Brake Pad Stationary Bike for Home with Exclusive App, Magnetic Indoor Cycling Bike with 300 lb Weight Capacity, Low Noise, Tablet Holder and Fitness Courses for Weight Loss",
          "image": "https://m.media-amazon.com/images/I/41hIirUY1HL.jpg",
          "item_types": [
            "amazon_seller_main_item",
            "amazon_seller_item"
          ],
          "items_count": 2,
          "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": 246.98,
                "regular": 329.99,
                "max_value": null,
                "currency": "USD",
                "is_price_range": false,
                "displayed_price": "$246.98"
              },
              "percentage_discount": 25,
              "applicable_vouchers": null,
              "rating": {
                "type": "rating_element",
                "position": "left",
                "rating_type": "Max5",
                "value": 4.3,
                "votes_count": 24538,
                "rating_max": 5
              },
              "condition": null,
              "condition_description": null,
              "delivery_info": {
                "delivery_date_from": "2025-09-01T00:00:00+00:00",
                "delivery_date_to": null,
                "fastest_delivery_date_from": "2025-08-29T00:00:00+00:00",
                "fastest_delivery_date_to": null,
                "delivery_message": "FREE delivery Monday, September 1 Or Prime members get FREE delivery Friday, August 29. Order within 14 hrs 51 mins. Join Prime",
                "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]/div[1]",
              "seller_name": "MASOU",
              "seller_url": "http://amazon.com/gp/aag/main?ie=UTF8&seller=A2XS9KO5PUQHMV&isAmazonFulfilled=1&asin=B07D528W98&ref_=olp_merch_name_1",
              "ships_from": "Amazon.com",
              "price": {
                "current": 399.99,
                "regular": null,
                "max_value": null,
                "currency": "USD",
                "is_price_range": false,
                "displayed_price": "$399.99"
              },
              "percentage_discount": null,
              "applicable_vouchers": null,
              "rating": {
                "type": "rating_element",
                "position": "left",
                "rating_type": "Max5",
                "value": 5,
                "votes_count": 3619,
                "rating_max": 5
              },
              "condition": "New",
              "condition_description": null,
              "delivery_info": {
                "delivery_date_from": "2025-09-01T00:00:00+00:00",
                "delivery_date_to": null,
                "fastest_delivery_date_from": "2025-08-29T00:00:00+00:00",
                "fastest_delivery_date_to": null,
                "delivery_message": "FREE delivery Monday, September 1 Or Prime members get FREE delivery Friday, August 29. Order within 14 hrs 51 mins. Join Prime",
                "delivery_price": null
              }
            }
          ]
        }
      ]
    }
  ]
}