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.
Request samples
In the code examples below, we make a request to retrieve a result from amazon.com
, 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
and the prices are displayed in USD
currency.
curl 'https://realtime.oxylabs.io/v1/queries' \
--user 'USERNAME:PASSWORD' \
-H 'Content-Type: application/json' \
-d '{
"source": "amazon_search",
"domain": "com",
"query": "nirvana tshirt",
"start_page": 2,
"pages": 2,
"parse": true,
"sort_by": "featured",
"refinements": "p_123:256097",
"context": [
{
"key": "category_id",
"value": "16391693031",
"key": "currency",
"value": "USD"
}
]
}'
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 search results.
source
Sets the scraper.
amazon_search
query
The keyword or phrase to search for.
-
- mandatory parameter
Localization
Adapt results to specific geographical locations, domains, 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
Sorting and filtering
Controls for sorting and filtering of search result pages.
sort_by
Sets the sorting type of the search results page according to one of possible values in Amazon:
"most_recent"
, "price_low_to_high"
, "price_high_to_low"
, "featured"
, "average_review"
, "bestsellers"
.
-
refinements
A list of Amazon search refinement parameters used to apply specific filters to search results. These parameters correspond to Amazon's dynamic filtering options (e.g., brand, price range, features) and follow Amazon's internal parameter format such as p_123:256097
or p_n_feature_twenty-eight_browse-bin:98209020031
.
Since filtering options vary by category and are dynamically generated by Amazon, the recommended workflow is:
First, scrape the target Amazon search page with
parse: true
to discover available refinement optionsExtract the desired filter parameters from the parsed response
Use those parameters in subsequent requests via the
refinements
field to apply specific filters
-
context
:
category_id
Search for items in a particular Amazon 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
refinements
A list of refinements available on this search page.
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
Paid
The paid
section of the search results refers to inline ad content that is displayed within the Amazon search results.

...
"paid": [
{
"pos": 1,
"url": "/sspa/click?ie=UTF8&spc=MTo3ODk3NzcxNTI0MDAzNjk1OjE3MDEwODYyODI6c3BfYXRmOjMwMDA5Mjg4ODc1NTcwMjo6MDo6&url=/IOGEAR-KeyMander-Controller-Crossover-GE1337P2/dp/B08541QCKJ/ref=sr_1_1_sspa?keywords=nintendo&qid=1701086282&sr=8-1-spons&sp_csd=d2lkZ2V0TmFtZT1zcF9hdGY&psc=1",
"asin": "B08541QCKJ",
"price": 69.99,
"title": "IOGEAR KeyMander 2 Keyboard/Mouse Adapter Plus Controller Crossover, PS4, PS5, Xbox Series X/S, Xbox One, Nintendo Switch, GE1337P2, FPS, mouse control",
"rating": 3.7,
"currency": "USD",
"is_prime": true,
"url_image": "https://m.media-amazon.com/images/I/41-AZ8CCl1L._AC_UY218_.jpg",
"best_seller": false,
"price_upper": 69.99,
"is_sponsored": true,
"manufacturer": "",
"pricing_count": 1,
"reviews_count": 1229,
"is_amazons_choice": false,
"price_strikethrough": 99.95,
"shipping_information": "FREE delivery Sun, Dec 3 Or fastest delivery Thu, Nov 30"
},
...
]
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
coupon_discount
The discounted amount.
integer (optional)
coupon_discount_type
The type of discount: nominal
or percentage
.
string (optional)
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.

...
"organic": [
...
{
"pos": 5,
"url": "/Purifiers-2200sq-ft-MOOKA-purifier-PR1/dp/B0DCBC8KKV/ref=sr_1_5?dib=eyJ2IjoiMSJ9.Qoe5cUAPMM1voliSq4zLfiJ0JVl_hsy805T9yDeoZdvRcrqICV-PjwCg0I67jvJVJ_PSunMweX8SvSH3-M-pI2-ugdCQ85ZkACZeyo0mFA_x-tDj-q1JTf8V3SdCA7KJlxMyHDeIT2N6NHGk7cyVsOpK-UlfWiNJ-dnu6KUIZcC82Zm0ugL-vdGTf8Qj-uDJJcWp35jlmA3m6N3XV3l8BuJVNVIXrsniboQa_FpLjLY.o9cWjzsvdrHpX_CV82v3VY104qfYcK7CkfXDFYuwlC8&dib_tag=se&keywords=air+purifier&qid=1753104496&sr=8-5",
"asin": "B0DCBC8KKV",
"price": 99.99,
"title": "Air Purifiers for Home Large Room up to 2200sq.ft, MOOKA Air purifier for Home Pets with Washable Filter, PM 2.5 Display Air Quality Sensor Air Cleaner for Bedroom, Dorm room, Pets, Office, PR1",
"rating": 4.6,
"currency": "USD",
"is_prime": false,
"url_image": "https://m.media-amazon.com/images/I/81spn7Ork+L._AC_UY218_.jpg",
"best_seller": false,
"price_upper": 99.99,
"is_sponsored": false,
"manufacturer": "",
"sales_volume": "10K+ bought in past month",
"pricing_count": 1,
"reviews_count": 1431,
"coupon_discount": 15,
"is_amazons_choice": false,
"price_strikethrough": 105.97,
"coupon_discount_type": "nominal",
"shipping_information": "FREE delivery Sat, Jul 26Or fastest delivery Wed, Jul 23"
},
...
]
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
is_prime
Indicates whether the product is eligible for Amazon Prime.
boolean
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
sales_volume
The sales volume or number of units sold for a particular product.
string (optional)
pricing_count
The count of pricings for the product.
integer
reviews_count
The count of reviews for the product.
integer
coupon_discount
The discounted amount.
integer (optional)
coupon_discount_type
The type of discount: nominal
or percentage
.
string (optional)
is_amazons_choice
Indicates whether the product is Amazon's choice.
boolean
price_strikethrough
Original price before any discounts.
float
shipping_information
Delivery dates and shipping cost details.
string
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
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.

...
"suggested": [
{
"pos": 3,
"asin": "B07L4ZRJ7P",
"best_seller": false,
"is_sponsored": false,
"is_amazons_choice": false,
"manufacturer": "",
"pricing_count": 1,
"rating": 4.0,
"reviews_count": 1,
"title": "The Supercar Story",
"url": "/Supercar-Story-Patrick-Mark/dp/B07L4ZRJ7P/ref=sr_1_fkmr0_1?keywords=details about mercedes benz head unit e-class w213 comand navi gps unit a21390050813&qid=1636460216&sr=8-1-fkmr0",
"url_image": "https://m.media-amazon.com/images/I/81uC-IclZqL._AC_UY218_.jpg",
"is_prime": false,
"price": 0.0,
"price_upper": 0.0,
"no_price_reason": "unknown",
"pos": 1,
"currency": "USD",
"suggested_query": "details benz head"
},
...
]
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
coupon_discount
The discounted amount.
integer (optional)
coupon_discount_type
The type of discount: nominal
or percentage
.
string (optional)
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.

...
"amazons_choices": [
{
"asin": "B07STGGQ18",
"best_seller": false,
"is_sponsored": false,
"is_amazons_choice": true,
"manufacturer": "",
"pricing_count": 1,
"rating": 4.8,
"reviews_count": 9,
"title": "AMD Ryzen 5 3600 4, 2GHz AM4 35MB Cache Wraith Stealth",
"url": "/AMD-Ryzen-3600-Wraith-Stealth/dp/B07STGGQ18/ref=sr_1_3?dchild=1&keywords=0730143309936&qid=1600153905&sr=8-3",
"url_image": "https://m.media-amazon.com/images/I/71WPGXQLcLL._AC_UY218_.jpg",
"is_prime": true,
"price": 179.0,
"price_upper": 179.0,
"shipping_information": "Lieferung bis Freitag, 18. September GRATIS Versand durch Amazon",
"pos": 3,
"currency": "EUR"
},
...
]
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
coupon_discount
The discounted amount.
integer (optional)
coupon_discount_type
The type of discount: nominal
or percentage
.
string (optional)
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
Variations
The variations
section lists different versions or models of a product, providing a detailed overview of available options in the specified category.

...
"variations": [
{
"asin": "B08KXB6SZH",
"title": "PlayStation 5",
"price": 29.99,
"not_available": false
},
{
"asin": "B08L6FZM6D",
"title": "PlayStation 4",
"not_available": false,
"no_price_reason": "unknown"
},
{
"asin": "B08N766Q9W",
"title": "Xbox Digial Code",
"not_available": true,
"no_price_reason": "Currently unavailable."
}
],
...
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
Was this helpful?