Skip to main content
GET
cURL
🪙3 creditsper request

Copy for AI

🤖 Why Code When AI Can Do It For You?

Stop writing code like it’s 1970! Let AI do the heavy lifting - click the sparkles to copy a perfectly formatted prompt for ChatGPT, Claude, or your favorite AI assistant.

Authorizations

Authorization
string
header
required

API key for authentication. Format: sk_live_xxxxxxxxxxxxx Get your API key from the Dashboard.

Query Parameters

query
string
required

Search query (supports both free-form text queries or a product asin).

Example:

"Phone"

page
number
default:1

Results page to return

country
string
default:US

Sets the Amazon domain, marketplace country, language and currency Allowed values: US, AU, BR, CA, CN, FR, DE, IN, IT, MX, NL, SG, ES, TR, AE, GB, JP, SA, PL, SE, BE, EG, ZA, IE

sort_by
string
default:RELEVANCE

Return the results in a specific sort order Allowed values: RELEVANCE, LOWEST_PRICE, HIGHEST_PRICE, REVIEWS, NEWEST, BEST_SELLERS

category_id
string
default:aps

Find products in a specific category / department (e.g. computers-intl-ship). Use the Product Category List endpoint to get a list of valid categories and their ids for the country specified in the request. For numeric Amazon category IDs, use the category parameter instead

category
string

Filter by specific numeric Amazon category. The category ID can be obtained from the Amazon category results URL, for example: https://amazon.com/s?node=2858778013 - the Amazon Category ID is 2858778013. Multiple category values can be separated by comma (e.g. categoryId1,categoryId2)

min_price
number
default:1

Only return product offers with price greater than a certain value. Specified in the currency of the selected country. For example, in case country=US, a value of 105.34 means $105.34

max_price
number
default:1000

Only return product offers with price lower than a certain value. Specified in the currency of the selected country. For example, in case country=US, a value of 105.34 means $105.34

product_condition
string
default:ALL

Return products in a specific condition Allowed values: ALL, NEW, USED, RENEWED, COLLECTIBLE

brand
string

Find products with a specific brand. Multiple brands can be specified as a comma (,) separated list. The brand values can be seen from Amazon's search left filters panel, as seen here Examples: SAMSUNG Google,Apple

seller_id
string

Find products sold by specific seller (merchant). Multiple sellers can be specified as a comma (,) separated list Examples: A02211013Q5HP3OMSZC7W AM7YCCDZROLB2,A1D09S7Q0OD6TH

is_prime
boolean
default:false

Only return prime products

deals_and_discounts
string
default:NONE

Return deals and discounts in a specific condition Allowed values: NONE, ALL_DISCOUNTS, TODAYS_DEALS

four_stars_and_up
boolean

Return product listings with ratings of 4 stars & up

language
string

The language of the results. In case not specified, results will be returned in the default domain language Supported languages per country: US: en_US, es_US AU: en_AU BR: pt_BR CA: en_CA, fr_CA FR: fr_FR, en_GB DE: de_DE, en_GB, cs_CZ, nl_NL, pl_PL, tr_TR, da_DK IN: en_IN, hi_IN, ta_IN, te_IN, kn_IN, ml_IN, bn_IN, mr_IN IT: it_IT, en_GB MX: es_MX NL: nl_NL, en_GB SG: en_SG ES: es_ES, pt_PT, en_GB TR: tr_TR AE: en_AE, ar_AE GB: en_GB JP: ja_JP, en_US, zh_CN SA: ar_AE, en_AE PL: pl_PL SE: sv_SE, en_GB BE: fr_BE, nl_BE, en_GB EG: ar_AE, en_AE ZA: en_ZA IE: en_IE

additional_filters
string

Any filters available on the Amazon page but not part of this endpoint's parameters. The filter values can be extracted from the rh parameter in the Amazon search URL after applying the filter of interest on the Amazon search results page. Multiple filters are supported and can be separated by comma (,).

For example, when searching for science books with the Paperback book format filter selected, the Amazon URL is: https://www.amazon.com/s?k=science+books&rh=p_n_feature_browse-bin%3A2656022011 and the rh parameter value is p_n_feature_browse-bin%3A2656022011 - To filter for Paperback books, set the value of additional_parameters=p_n_feature_browse-bin%3A2656022011.

fields
string

A comma separated list of product fields to include in the response (field projection). By default all fields are returned. Example: product_price,product_url,is_best_seller,sales_volume

Response

The response is of type object.