Sellers
The amazon_sellers
data source is designed to retrieve Amazon Sellers pages.
Request samples
In the code examples below, we make a request to retrieve the seller page for seller ID A2MUQS6AX5GGR
on amazon.de
marketplace.
curl 'https://realtime.oxylabs.io/v1/queries' \
--user 'USERNAME:PASSWORD' \
-H 'Content-Type: application/json' \
-d '{
"source": "amazon_sellers",
"domain": "de",
"query": "A2MUQS6AX5GGR",
"parse": true
}'
We use synchronous Realtime integration method in our examples. If you would like to use Proxy Endpoint or asynchronous Push-Pull integration, refer to the integration methods section.
Request parameter values
Generic
Basic setup and customization options for scraping Amazon Seller pages.
source
Sets the scraper.
amazon_sellers
query
13-character seller ID
-
- mandatory parameter
Localization
Adapt results to specific geographical locations, domains, and languages.
domain
Domain localization for Amazon. The full list of available domains can be found here.
com
locale
Accept-Language
header value, which sets the interface language of the Amazon page. More info.
-
IMPORTANT: On most page types, Amazon tailors the returned results based on the delivery location of their customers. Therefore, we advise using the geo_location
parameter to set your preferred delivery location. You can read more about using geo_location
with Amazon here.
Structured data
Below you can find a structured output example for amazon_sellers
. 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.
Output 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.
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
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
},
...
],
...
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%"
},
...
}
...
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
Last updated
Was this helpful?