Amazon Commerce API · Endpoint

Amazon Commerce Listings Search API

Q: What do I send?

Send query. The input fields below list every option with its type and limits.

Q: Can my AI agent call it?

Yes, over MCP: the agent finds amazon.products.search, checks its price and runs it with the same credits as the REST API.

Search Amazon US like a shopper, with sort, department, category and price filters. Each result has the ASIN, title, price, rating, review count, Prime, sponsored flag and position.

0.5 credits per call
Failed calls are free
Updated 10 Oct 2026
amazon.products.search

Start free, 100 credits API reference

Response completed

{  "has_next": true,  "marketplace": "US",  "results": [    {      "title": "Apple AirPods Pro 3 Wireless Earbuds with Active Noise Cancellation",      "price": "$179.00",      "rating": 4.4,      "asin": "B0FQFB8FMG",      "badge": "Ends in",      "currency": "USD",      "position": 1,      "price_numeric": 179,      "prime": false,      "reviews_count": 16,      "sponsored": false,      "url": "https://www.amazon.com/dp/B0FQFB8FMG"    },    {      "title": "JBL Vibe Beam - True Wireless Earbuds - Black",      "price": "$27.95",      "rating": 4.2,      "asin": "B0BQPNMXQV",      "badge": "Overall Pick",      "currency": "USD",      "position": 2,      "price_numeric": 27.95,      "prime": false,      "reviews_count": 40,      "sponsored": false,      "url": "https://www.amazon.com/dp/B0BQPNMXQV"    }  ]}

6 rows

#	Title	Price	Rating	Reviews	ASIN	Badge	Currency	Position	Price numeric	Prime
1	Apple AirPods Pro 3 Wireless Earbuds with Active Noise Cancella…	$179.00	4.4	16	B0FQFB8FMG	Ends in	USD	1	179	false
2	JBL Vibe Beam - True Wireless Earbuds - Black	$27.95	4.2	40	B0BQPNMXQV	Overall Pick	USD	2	27.95	false
3	Soundcore P30i by Anker Noise Cancelling Earbuds, Hands-Free Vi…	$23.68	4.3	43	B0CRTR3PMF	Ends in	USD	3	23.68	false
4	TOZO A1 Wireless Earbuds Bluetooth 5.3 Light Weight in Ear Head…	$13.26	4.3	117	B09FT58QQP	Ends in	USD	4	13.26	false
5	TOZO T10 Wireless Earbuds Powerful Bass Stereo Wireless Chargin…	$17.99	4.3	259	B07J2Z5DBM	Ends in	USD	5	17.99	false
6	TOZO A1 Wireless Earbuds Bluetooth 5.3 Light Weight in Ear Head…	$14.76	4.3	117	B0CMSYTP6Q	Ends in	USD	6	14.76	false

Try it live, free

Input

What you send

The input object of the request, with every field the endpoint accepts.

Field	Type	Required	What it does	Example
query	string	yes	What a shopper would type, such as wireless earbuds.	wireless earbuds
department	string	no	Search inside one department, such as electronics.
limit	integer	no	How many products to return, up to 100.	6
marketplace	string	no	The Amazon store. Amazon US is the one available.	US
max_price	number	no	Highest price to include, in dollars.
min_price	number	no	Lowest price to include, in dollars.
node	string	no	Search inside one category, by its category ID from the category endpoint.
page	integer	no	Which results page, from 1 to 20.	1
refinements	array<string>	no	Filters from the category endpoint, such as a screen-size range.
sort	string	no	How results are ordered: featured, price low to high or high to low, average review, most recent or best sellers.	featured · price_low_to_high · price_high_to_lo…

Response

Fields it returns

What each record in the response holds, with the values from the sample above.

Field	Type	What it is	Example
results[].title	string	The product title as Amazon shows it.	Apple AirPods Pro 3 Wireless Earbuds with Active Noise Cancella…
results[].price	string	The price as Amazon shows it.	$179.00
results[].rating	number	The average star rating.	4.4
results[].reviews_count	integer	How many ratings the product has.	16
results[].prime	boolean	Whether the listing shows Prime delivery.	false
results[].sponsored	boolean	Whether the result is a sponsored placement.	false
results[].asin	string	Amazon's product ID (ASIN).	B0FQFB8FMG
results[].badge	string	The badge Amazon shows on the result.	Ends in
results[].currency	string	The currency of the price.	USD
results[].position	integer	The result's position in the list.	1
results[].price_numeric	integer	The price as a number.	179
results[].url	string	The product page on Amazon.	https://www.amazon.com/dp/B0FQFB8FMG
has_next	boolean	Whether another page follows; ask for the next page number.	true
marketplace	string	The Amazon store searched.	US
results	array	The products found.	6 records

REST API · MCP server

Call it from your code, or ask your agent

Set UPSCRAPE_API_KEY to your key and copy a working request.

curl --request POST \  --url https://data.upscrape.com/execute \  --header "Authorization: Bearer $UPSCRAPE_API_KEY" \  --header "Content-Type: application/json" \  --header "Prefer: wait=30" \  --data '{  "capability": "amazon.products.search",  "input": {    "limit": 6,    "page": 1,    "query": "wireless earbuds"  }}'

import jsonimport osimport requestspayload = json.loads(r'''{  "capability": "amazon.products.search",  "input": {    "limit": 6,    "page": 1,    "query": "wireless earbuds"  }}''')response = requests.post(    "https://data.upscrape.com/execute",    headers={        "Authorization": f"Bearer {os.environ['UPSCRAPE_API_KEY']}",        "Content-Type": "application/json",        "Prefer": "wait=30",    },    json=payload,)response.raise_for_status()print(json.dumps(response.json(), indent=2))

const response = await fetch("https://data.upscrape.com/execute", {  method: "POST",  headers: {    "Authorization": `Bearer ${process.env.UPSCRAPE_API_KEY}`,    "Content-Type": "application/json",    "Prefer": "wait=30",  },  body: JSON.stringify({  "capability": "amazon.products.search",  "input": {    "limit": 6,    "page": 1,    "query": "wireless earbuds"  }}),});if (!response.ok) {  throw new Error(`Upscrape request failed: ${response.status}`);}console.log(JSON.stringify(await response.json(), null, 2));