Sellers

The amazon_sellers data source is designed to retrieve Amazon Sellers pages.

Explore data dictionary for Sellers, offering a brief description, screenshot, parsed JSON code snippet, and a table defining each parsed field. Navigate through the details using the right-side navigation or scrolling down the page.

Query parameters

Parameter	Description	Default Value
source	Data source. More info.	amazon_sellers
domain	Domain localization for Amazon. The full list of available domains can be found here.	com
query	13-character seller ID	-
geo_location	The Deliver to location. See our guide to using this parameter here.	-
user_agent_type	Device type and browser. The full list can be found here.	desktop
render	Enables JavaScript rendering. More info.
callback_url	URL to your callback endpoint. More info.	-
parse	true will return structured data. Please note that right now we only support parsed output for desktop device type. However, there is no apparent reason to get sellers pages with any other device type, as seller data is going to be exactly the same across all devices.	-

- required parameter

Code examples

In the code examples below, we make a request to retrieve the seller page for seller ID A2MUQS6AX5GGR on amazon.de marketplace.

JSON

{
    "source": "amazon_sellers", 
    "domain": "de", 
    "query": "A2MUQS6AX5GGR",
    "parse": true
}

cURL

curl --user "user:pass1" 'https://realtime.oxylabs.io/v1/queries' -H "Content-Type: application/json" \
 -d '{"source": "amazon_sellers", "domain": "de", "query": "A2MUQS6AX5GGR", "parse": true}'

Python

import requests
from pprint import pprint


# Structure payload.
payload = {
    'source': 'amazon_sellers',
    'domain': 'de',
    'query': 'A2MUQS6AX5GGR',
    'parse': True
}


# Get response.
response = requests.request(
    'POST',
    'https://realtime.oxylabs.io/v1/queries',
    auth=('user', 'pass1'),
    json=payload,
)

# Print prettified response to stdout.
pprint(response.json())

PHP

<?php

$params = array(
    'source' => 'amazon_sellers',
    'domain' => 'de',
    'query' => 'A2MUQS6AX5GGR',
    'parse' => true
);

$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, "https://realtime.oxylabs.io/v1/queries");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($params));
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_USERPWD, "user" . ":" . "pass1");


$headers = array();
$headers[] = "Content-Type: application/json";
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);

$result = curl_exec($ch);
echo $result;

if (curl_errno($ch)) {
    echo 'Error:' . curl_error($ch);
}
curl_close($ch);

C#

using System;
using System.Collections.Generic;
using System.Net.Http;
using System.Net.Http.Json;
using System.Threading.Tasks;

namespace OxyApi
{
    class Program
    {
        static async Task Main()
        {
            const string Username = "YOUR_USERNAME";
            const string Password = "YOUR_PASSWORD";

            var parameters = new Dictionary<string, string>()
            {
                { "source", "amazon_sellers" },
                { "domain", "de" },
                { "query", "A2MUQS6AX5GGR" },
                { "parse", true },
            };


            var client = new HttpClient();

            Uri baseUri = new Uri("https://realtime.oxylabs.io");
            client.BaseAddress = baseUri;

            var requestMessage = new HttpRequestMessage(HttpMethod.Post, "/v1/queries");
            requestMessage.Content = JsonContent.Create(parameters);

            var authenticationString = $"{Username}:{Password}";
            var base64EncodedAuthenticationString = Convert.ToBase64String(System.Text.ASCIIEncoding.UTF8.GetBytes(authenticationString));
            requestMessage.Headers.Add("Authorization", "Basic " + base64EncodedAuthenticationString);

            var response = await client.SendAsync(requestMessage);
            var contents = await response.Content.ReadAsStringAsync();

            Console.WriteLine(contents);
        }
    }
}

Golang

package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"io/ioutil"
	"net/http"
)

func main() {
	const Username = "YOUR_USERNAME"
	const Password = "YOUR_PASSWORD"

	payload := map[string]string{
		"source": "amazon_sellers",
		"domain": "de",
		"query": "A2MUQS6AX5GGR",
		"parse": "true",
	}

	jsonValue, _ := json.Marshal(payload)

	client := &http.Client{}
	request, _ := http.NewRequest("POST",
		"https://realtime.oxylabs.io/v1/queries",
		bytes.NewBuffer(jsonValue),
	)

	request.SetBasicAuth(Username, Password)
	response, _ := client.Do(request)

	responseText, _ := ioutil.ReadAll(response.Body)
	fmt.Println(string(responseText))
}

Java

package org.example;

import okhttp3.*;
import org.json.JSONObject;

public class Main implements Runnable {
    private static final String AUTHORIZATION_HEADER = "Authorization";
    public static final String USERNAME = "YOUR_USERNAME";
    public static final String PASSWORD = "YOUR_PASSWORD"
    public void run() {
        JSONObject jsonObject = new JSONObject();
        jsonObject.put("source", "amazon_sellers");
        jsonObject.put("domain", "de");
        jsonObject.put("query", "A2MUQS6AX5GGR");
        jsonObject.put("parse", true);

        Authenticator authenticator = (route, response) -> {
            String credential = Credentials.basic(USERNAME, PASSWORD);

            return response
                    .request()
                    .newBuilder()
                    .header(AUTHORIZATION_HEADER, credential)
                    .build();
        };

        var client = new OkHttpClient.Builder()
                .authenticator(authenticator)
                .build();

        var mediaType = MediaType.parse("application/json; charset=utf-8");
        var body = RequestBody.create(jsonObject.toString(), mediaType);
        var request = new Request.Builder()
                .url("https://realtime.oxylabs.io/v1/queries")
                .post(body)
                .build();

        try (var response = client.newCall(request).execute()) {
            assert response.body() != null;
            System.out.println(response.body().string());
        } catch (Exception exception) {
            System.out.println("Error: " + exception.getMessage());
        }

        System.exit(0);
    }

    public static void main(String[] args) {
        new Thread(new Main()).start();
    }
}

Node.js

import fetch from 'node-fetch';

const username = 'YOUR_USERNAME';
const password = 'YOUR_PASSWORD';
const body = {
  'source': 'amazon_sellers',
  'domain': 'de',
  'query': 'A2MUQS6AX5GGR',
  'parse': true
};
const response = await fetch('https://realtime.oxylabs.io/v1/queries', {
  method: 'post',
  body: JSON.stringify(body),
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Basic ' + Buffer.from(`${username}:${password}`).toString('base64'),
  }
});

console.log(await response.json());

HTTP

https://realtime.oxylabs.io/v1/queries?source=amazon_sellers&domain=de&query=A2MUQS6AX5GGR&domain=de&parse=true&access_token=12345abcde

The example above uses the Realtime integration method. If you would like to use some other integration method in your query (e.g. Push-Pull or Proxy Endpoint), refer to the integration methods section.

Structured data

Below you can find a structured output example for amazon_sellers.

Amazon_sellers structured output

{
    "results": [
        {
            "content": {
                "url": "https://www.amazon.com/sp?seller=A151FB8X73UXPJ",
                "query": "A151FB8X73UXPJ",
                "rating": 4.5,
                "page_type": "Seller",
                "description": "Service with a smile! Gamer Girlz LLC loves making our customers happy by providing the quickest service & highest quality products. Every order is packaged with care & includes a special THANK YOU for choosing Gamer Girlz to provide you with the first class shopping experience you deserve!",
                "business_name": "Gamer Girlz",
                "recent_feedback": [
                    {
                        "feedback": "The product never came, and was very very expensive. Wasn't eligible for refund for some reason.",
                        "rated_by": "By Juli on May 8, 2022.",
                        "rating_stars": 1
                    },
                    {
                        "feedback": "Favorite game",
                        "rated_by": "By DF on May 8, 2022.",
                        "rating_stars": 5
                    },
                    {
                        "feedback": "It works perfectly and I love the games on it.",
                        "rated_by": "By John on May 8, 2022.",
                        "rating_stars": 5
                    },
                    {
                        "feedback": "All the games I got came super fast and it amazing condition! Would definitely buy from them again and recommend seller to others!",
                        "rated_by": "By Brianna c. on May 6, 2022.",
                        "rating_stars": 5
                    },
                    {
                        "feedback": "They were fast with shipping and provided quality merchandise. A label of authenticity was included with the game I bought to ensure me that I bought a genuine version.",
                        "rated_by": "By anonymous  on May 6, 2022.",
                        "rating_stars": 5
                    }
                ],
                "business_address": "1020 Michigan St. Sandpoint ID 83864 US",
                "parse_status_code": 12000,
                "feedback_summary_table": {
                    "counts": {
                        "30_days": 44,
                        "90_days": 146,
                        "all_time": 7857,
                        "12_months": 611
                    },
                    "neutral": {
                        "30_days": "5%",
                        "90_days": "2%",
                        "all_time": "2%",
                        "12_months": "1%"
                    },
                    "negative": {
                        "30_days": "7%",
                        "90_days": "7%",
                        "all_time": "3%",
                        "12_months": "8%"
                    },
                    "positive": {
                        "30_days": "89%",
                        "90_days": "91%",
                        "all_time": "95%",
                        "12_months": "91%"
                    }
                }
            },
            "created_at": "2022-05-09 06:57:47",
            "updated_at": "2022-05-09 06:57:50",
            "page": 1,
            "url": "https://www.amazon.com/sp?seller=A151FB8X73UXPJ",
            "job_id": "6929323518437886977",
            "status_code": 200,
            "parser_type": ""
        }
    ]
}

Data dictionary

HTML example

JSON structure

The amazon_sellers structured output includes fields like URL, query, rating, and others. The table below presents a detailed list of each field we parse, along with its description and data type. The table also includes some metadata.

Key	Description	Type
url	The URL of the Amazon seller page.	string
query	A 13-character seller ID used as the original search term.	string
rating	The rating of the seller.	integer
page_type	The type of the Amazon page.	string
description	A short description about the seller.	string
seller_name	The name of the seller.	string
business_name	The name of the business.	string
recent_feedback	A list of most recent feedback items with its respective details.	array
business_address	The address of the business.	string
parse_status_code	The status code of the parsing job. You can see the parser status codes described here.	integer
feedback_summary_data	A list of details available regarding the ratings of the seller.	object
created_at	The timestamp when the scraping job was created.	timestamp
updated_at	The timestamp when the scraping job was finished.	timestamp
job_id	The ID of the job associated with the scraping job.	integer
status_code	The status code of the scraping job. You can see the scraper status codes described here.	integer
parser_type	The type of parser used for parsing the data.	string

In the following sections, parsed JSON code snippets are shortened where more than one item for the result type is available.

Recent feedback

The recent_feedback data shows recent customer reviews and feedback left for a specific product listing on the Amazon marketplace.

...
"recent_feedback": [
    {
        "feedback": "We truly appreciate you taking time out of your busy day to leave such a nice review. As a small business we truly like dealing with customers like you who share their positive experience.",
        "rated_by": "By Troy on January 29, 2024.",
        "rating_stars": 5
    },
...
],
...

Key (recent_feedback)	Description	Type
feedback	The feedback submitted for the seller or seller’s product.	string
rated_by	Information on the user who has submitted the feedback and data.	string
rating_stars	The number of stars submitted.	integer

Feedback summary data

The feedback_summary_data is feedback statistics provided for a particular product listing on the Amazon marketplace. The feedback summary data includes information for different time periods, allowing sellers and analysts to track changes in customer sentiment over time.

...               
 "feedback_summary_data": {
    "1_month": {
        "count": 3,
        "1_star": "33%",
        "2_star": "0%",
        "3_star": "0%",
        "4_star": "33%",
        "5_star": "33%"
    },
    "3_month": {
        "count": 10,
        "1_star": "10%",
        "2_star": "0%",
        "3_star": "0%",
        "4_star": "20%",
        "5_star": "70%"
    },
 ...
}
...

Key (content.feedback_summary_data)	Description	Type
1_month/3_month/12_month/all_time	A filter to review ratings information per defined timeframe.	object
1_month/3_month/12_month/all_time.count	The number of reviews available for a certain timeframe.	integer
1_month-all_time.1_star-5_star	The percentage distribution of rating stars for a certain timeframe.	percentage