Search
The amazon_search
source is designed to retrieve Amazon search result pages. To see the response example with retrieved data, download this sample output file in HTML format or check structured data output here.
Explore output data dictionary for each Amazon Search feature, 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.
Request samples
In the code examples below, we make a request to retrieve a result from amazon.nl
, which includes 2
search results pages, starting from page #2
, for the search term nirvana tshirt
. Additionally, the search is be limited to category ID: 16391693031
.
We use Realtime integration method in our examples. If you would like to use some other integration method in your request (e.g. Push-Pull or Proxy Endpoint), refer to the integration methods section.
Request parameter values
Generic
Basic setup and customization options for scraping Amazon search results.
source
Sets the scraper.
amazon_search
query
UTF-encoded keyword.
-
- mandatory parameter
Localization
Adapt results to specific geographical locations, domains, and languages.
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.
Pagination
Controls for managing the pagination and retrieval of search results.
start_page
Starting page number.
1
pages
Number of pages to retrieve.
1
Other
Additional advanced settings and controls for specialized requirements.
context
:
category_id
Search for items in a particular browse node (product category).
-
context
:
merchant_id
Search for items sold by a particular seller.
-
Structured data
Output data dictionary
API returns a HTML or JSON object that contains the search results retrieved from the Amazon.
HTML example
JSON structure
All search results are contained within the results
JSON array. Each search result includes a combination of paid
, organic
, suggested
, amazons_choices
,instant_recommendations
listings. Additionally, variations may be present, and they are captured within the variations
key, providing details about different types or categories of products, such as various models, editions, or versions.
url
The URL of the Amazon search page.
string
page
The current page number.
integer
pages
The total number of pages.
integer
query
The search query used.
string
results
A dictionary containing the results of the search.
object
results.paid
A list of sponsored products with their respective details.
array
results.organic
A list of organic products with their respective details.
array
results.suggested
A list of suggested products with their respective details.
array
results.amazons_choices
A list of Amazon's choices with their respective details.
array
results.instant_recommendations
A list of instant recommendations with their respective details.
array
parse_status_code
The status code of the parsing job. You can see the parser status codes described here.
integer
total_results_count
The total number of results found for the search query.
integer
created_at
The timestamp when the scraping job was created.
string
updated_at
The timestamp when the scraping job was finished.
string
job_id
The ID of the job associated with the scraping job.
string
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.
Paid
The paid
section of the search results refers to inline ad content that is displayed within the Amazon search results.
url
The URL of the product.
string
asin
Amazon Standard Identification Number.
string
price
The price of the product.
float
title
The title of the product.
string
rating
The rating of the product.
float
rel_pos
The relative position of the product in the search results.
(either pos
or rel_pos
is present)
integer
pos
A unique indicator denoting the position in the listing. (either pos
or rel_pos
is present)
integer
currency
The currency in which the price is denominated.
string
url_image
The URL of the product image.
string
best_seller
Indicates whether the product is a best seller.
boolean
price_upper
The upper limit of the price if applicable.
float
is_sponsored
Indicates whether the product is sponsored.
boolean
manufacturer
The name of the manufacturer of the product.
string
pricing_count
The count of offers for the product.
integer
reviews_count
The count of reviews for the product.
integer
is_amazons_choice
Indicates whether the product is marked as “Amazon's choice”.
boolean
no_price_reason
Indicator why the price is not present, if it’s equal to 0.0
string (optional)
sales_volume
The sales volume or number of units sold for a particular product.
string (optional)
is_prime
Indicates whether the product is eligible for Amazon Prime.
boolean
shipping_information
Information about the shipping details for the produc
string
Organic
The organic
section of the search results refers to non-sponsored content that appears naturally based on Amazon's search algorithm.
pos
A unique indicator denoting the position in the listing.
integer
url
The URL of the product.
string
asin
Amazon Standard Identification Number.
string
price
The price of the product.
float
title
The title of the product.
string
rating
The rating of the product.
float
currency
The currency in which the price is denominated.
string
url_image
The URL of the product image.
string
best_seller
Indicates whether the product is a best seller.
boolean
price_upper
The upper limit of the price if applicable.
float
is_sponsored
Indicates whether the product is sponsored.
boolean
manufacturer
The name of the manufacturer of the product.
string
pricing_count
The count of pricings for the product.
integer
reviews_count
The count of reviews for the product.
integer
is_amazons_choice
Indicates whether the product is Amazon's choice.
boolean
no_price_reason
Indicator why the price is not present, if it’s equal to 0.0
string(optional)
is_prime
Indicates whether the product is eligible for Amazon Prime.
boolean
sales_volume
The sales volume or number of units sold for a particular product.
string(optional)
variations
List of different versions or models of a product
Array
Suggested
The suggested
section in the search results typically contains product listings recommended by the platform based on the user's search query, browsing history, or purchase behavior.
url
The URL of the product.
string
asin
Amazon Standard Identification Number.
string
price
The price of the product.
float
title
The title of the product.
string
rating
The rating of the product.
float
currency
The currency in which the price is denominated.
string
url_image
The URL of the product image.
string
best_seller
Indicates whether the product is a best seller.
boolean
price_upper
The upper limit of the price if applicable.
float
is_sponsored
Indicates whether the product is sponsored.
boolean
manufacturer
The name of the manufacturer of the product.
string
pricing_count
The count of pricing for the product.
integer
reviews_count
The count of reviews for the product.
integer
is_amazons_choice
Indicates whether the product is Amazon's choice.
boolean
pos
A unique indicator denoting the position in the listing.
integer
is_prime
Indicates whether the product is eligible for Amazon Prime.
boolean
shipping_information
Information about the shipping details for the product.
string
sales_volume
The sales volume or number of units sold for a particular product.
string(optional)
no_price_reason
Indicator why the price is not present, if it’s equal to 0.0
string(optional)
suggested_query
The suggested query provided by Amazon as part of the search results.
string
Amazon's Choices
The amazons_choices
section features products with 'Amazon's Choice' badge and are recommended by the platform for their perceived quality and value.
url
The URL of the product.
string
asin
Amazon Standard Identification Number.
string
price
The price of the product.
float
title
The title of the product.
string
rating
The rating of the product.
float
currency
The currency in which the price is denominated.
string
url_image
The URL of the product image.
string
best_seller
Indicates whether the product is a best seller.
boolean
price_upper
The upper limit of the price if applicable.
float
is_sponsored
Indicates whether the product is sponsored.
boolean
manufacturer
The name of the manufacturer of the product.
string
pricing_count
The count of pricing for the product.
integer
reviews_count
The count of reviews for the product.
integer
is_amazons_choice
Indicates whether the product is Amazon's choice.
boolean
pos
A unique indicator denoting the position in the listing.
integer
is_prime
Indicates whether the product is eligible for Amazon Prime.
boolean
shipping_information
Information about the shipping details for the product.
string
sales_volume
The sales volume or number of units sold for a particular product.
string(optional)
no_price_reason
Indicator why the price is not present, if it’s equal to 0.0
string(optional)
variations
List of different versions or models of a product
Array
Instant Recommendations
The instant_recommendations
section may include products that are suggested to users based on their current search or viewing activity in real-time.
url
The URL of the product.
string
asin
Amazon Standard Identification Number.
string
price
The price of the product.
float
title
The title of the product.
string
rating
The rating of the product.
float
currency
The currency in which the price is denominated.
string
url_image
The URL of the product image.
string
best_seller
Indicates whether the product is a best seller.
boolean
price_upper
The upper limit of the price if applicable.
float
is_sponsored
Indicates whether the product is sponsored.
boolean
manufacturer
The name of the manufacturer of the product.
string
pricing_count
The count of pricings for the product.
integer
reviews_count
The count of reviews for the product.
integer
is_amazons_choice
Indicates whether the product is Amazon's choice.
boolean
pos
A unique indicator denoting the position in the listing.
integer
sales_volume
The sales volume or number of units sold for a particular product.
string(optional)
no_price_reason
Indicator why the price is not present, if it’s equal to 0.0
string(optional)
Variations
The variations
section lists different versions or models of a product, providing a detailed overview of available options in the specified category.
asin
Amazon Standard Identification Number
string
title
Title of the variation
string
price
Price of the variation
float
price_strikethrough
The original price before any discounts or promotions
float
not_available
Indicates if the variation is currently unavailable
boolean
Last updated