Amazon API: Search products
Searches Amazon products in a chosen country store, with price range, sort, Prime and page options. Returns the listings and prices shown to an anonymous shopper in the store's currency.
Unofficial. Not affiliated with or endorsed by Amazon.
Inputs
Values from the run on Oct 31, 2026, shown under Output.
- Page optional
page First Amazon results page to read, for example 2.
1 (default)
Whole number 1 or more.
- Sort optional
sort Order products by best match, price, newness, or customer reviews, for example price_low_to_high.
best_match (default)
One of
best_match,price_low_to_high,price_high_to_low,newest,top_rated.- Query, required
query What to search for, for example wireless earbuds.
wireless earbuds
- Country optional
country Amazon store country name or two-letter code, for example United Kingdom or GB.
United States (default)
- Max Price optional
max_price Highest price in the store's currency, for example 100.00.
Not set
Number 0 or more.
- Min Price optional
min_price Lowest price in the store's currency, for example 25.00.
Not set
Number 0 or more.
- Prime Only optional
prime_only Show only Prime-eligible results, for example true.
false (default)
True or false.
- Max Results optional
max_results Maximum products to return, for example 20 (up to 60).
20 (default)
Whole number from 1 to 60.
Input as JSON
{ "query": "wireless earbuds"}Output
{ "products": [ { "asin": "B0HDBKFHKK", "price": 19.99, "prime": true, "sponsored": false, "list_price": 199.99, "photo_link": "https://m.media-amazon.com/images/I/61aSuH86kYL._AC_UY218_.jpg" , "star_rating": 4.8, "product_link": "https://www.amazon.com/dp/B0HDBKFHKK" , "product_name": "XIAOWTEK Wireless Earbuds, 2026 Bluetooth 5.4 Headphones Bass Stereo Ear Buds with Noise Cancelling Mic, LED Display in Ear Earphones 50H Playtime Ear Buds, IP7 Waterproof for Laptop Pad Phones Black", "currency_code": "USD", "discount_percent": 90, "number_of_ratings": 883 }, { "asin": "B0HC642F1C", "price": 23.98, "prime": true, "sponsored": false, "list_price": 299.99, "photo_link": "https://m.media-amazon.com/images/I/71cmAChhQKL._AC_UY218_.jpg" , "star_rating": 4.6, "product_link": "https://www.amazon.com/dp/B0HC642F1C" , "product_name": "HAOYUYAN Wireless Earbuds, Sports Bluetooth Headphones, 80Hrs Playtime Ear Buds with LED Power Display, Noise Canceling Headset, IPX7 Waterproof Earphones for Workout/Running（Black）" , "currency_code": "USD", "discount_percent": 92, "number_of_ratings": 356 }, { "asin": "B0FQFB8FMG", "price": 234, "prime": true, "sponsored": false, "list_price": 249, "photo_link": "https://m.media-amazon.com/images/I/61solmQSSlL._AC_UY218_.jpg" , "star_rating": 4.4, "product_link": "https://www.amazon.com/dp/B0FQFB8FMG" , "product_name": "Apple AirPods Pro 3 Wireless Earbuds with Active Noise Cancellation", "currency_code": "USD", "discount_percent": 6, "number_of_ratings": 15653 } ]}Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"amazon.com/search_products","input":{"query":"wireless earbuds"}}' # Save as fous.py, then run: python3 fous.pyimport json, os, timefrom urllib.error import HTTPErrorfrom urllib.request import Request, urlopenAPI = "https://api.fous.com/v1/runs" KEY = os.environ["FOUS_API_KEY"]HEADERS = { "Authorization": f"Bearer {KEY}", "Content-Type": "application/json" ,}def call(url, body=None): data = json.dumps(body).encode() if body else None request = Request(url, data, HEADERS) try: with urlopen(request, timeout=120) as r: return r.status, json.load(r) except HTTPError as error: message = json.load(error)["error"]["message"] raise RuntimeError(message) from errorstatus, run = call(API, { "method": "amazon.com/search_products" , "input": { "query": "wireless earbuds" }})# 202: still going after 30 s. Ask again until it ends.while status == 202: time.sleep(2) status, run = call(f"{API}/{run['id']}")print(json.dumps(run["data"], indent=2))// Save as fous.mjs, then run: node fous.mjsconst api = "https://api.fous.com/v1/runs" ;const headers = { Authorization: `Bearer ${process.env.FOUS_API_KEY}`, "Content-Type": "application/json" ,};let response = await fetch(api, { method: "POST", headers, body: JSON.stringify({ "method": "amazon.com/search_products" , "input": { "query": "wireless earbuds" } }), signal: AbortSignal.timeout(120_000),});let run = await response.json();// 202: still going after 30 s. Ask again until it ends.while (response.status === 202) { await new Promise((done) => setTimeout(done, 2_000)); response = await fetch(`${api}/${run.id}`, { headers }); run = await response.json();}if (!response.ok) throw new Error(run.error.message);console.log(run.data);# Connect your agent to Fous once, over MCP (Streamable HTTP):# https://api.fous.com/mcp# Set FOUS_API_KEY first: create a key at https://app.fous.com/keys.# Claude Codeclaude mcp add \ --scope user \ --transport http fous https://api.fous.com/mcp \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Codexcodex mcp add fous \ --url https://api.fous.com/mcp \ --bearer-token-env-var FOUS_API_KEY# Cursor, VS Code, Windsurf, Cline and morenpx -y add-mcp https://api.fous.com/mcp -g -n fous \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Then ask your agent:# "Use Fous to run amazon.com/search_products# with {"query":"wireless earbuds"}"Over HTTP, the answer’s data holds the output. A run still going after 30 seconds answers 202 with its id: ask GET /v1/runs/{id} until it ends.
Schema
Input schema
{ "type": "object", "required": [ "query" ], "properties": { "page": { "type": "integer", "default": 1, "minimum": 1, "description": "First Amazon results page to read, for example 2." }, "sort": { "enum": [ "best_match", "price_low_to_high", "price_high_to_low", "newest", "top_rated" ], "type": "string", "default": "best_match", "description": "Order products by best match, price, newness, or customer reviews, for example price_low_to_high." }, "query": { "type": "string", "minLength": 1, "description": "What to search for, for example wireless earbuds." }, "country": { "type": "string", "default": "United States", "description": "Amazon store country name or two-letter code, for example United Kingdom or GB." }, "max_price": { "type": "number", "minimum": 0, "description": "Highest price in the store's currency, for example 100.00." }, "min_price": { "type": "number", "minimum": 0, "description": "Lowest price in the store's currency, for example 25.00." }, "prime_only": { "type": "boolean", "default": false, "description": "Show only Prime-eligible results, for example true." }, "max_results": { "type": "integer", "default": 20, "maximum": 60, "minimum": 1, "description": "Maximum products to return, for example 20 (up to 60)." } }}Output schema
{ "type": "object", "required": [ "products" ], "properties": { "products": { "type": "array", "items": { "type": "object", "required": [ "product_name", "price", "currency_code", "list_price", "discount_percent", "star_rating", "number_of_ratings", "prime", "sponsored", "photo_link", "product_link", "asin" ], "properties": { "asin": { "type": "string" }, "price": { "type": [ "number", "null" ] }, "prime": { "type": "boolean" }, "sponsored": { "type": "boolean" }, "list_price": { "type": [ "number", "null" ] }, "photo_link": { "type": [ "string", "null" ] }, "star_rating": { "type": [ "number", "null" ] }, "product_link": { "type": "string" }, "product_name": { "type": "string" }, "currency_code": { "type": "string" }, "discount_percent": { "type": [ "number", "null" ] }, "number_of_ratings": { "type": [ "integer", "null" ] } }, "additionalProperties": false } } }, "additionalProperties": false}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
amazon.com/search_products- Returns
- product name, price, currency, list price, discount, star rating, number of ratings, Prime, sponsored, photo, link, ASIN
Use it from your agent
Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method amazon.com/search_products with the inputs above.
Ask your agent
- Find Prime-eligible mechanical keyboards on Amazon under $80, cheapest first
- What are the top rated air fryers between £50 and £120 on the UK store? Show me about 15 with ratings and discounts.
- Look up standing desks on amazon.de sorted by newest, page 2, max 30 results
- I need a list of kids' rain boots under 40 CAD from the Canadian store with star ratings and number of reviews
- Show me the most expensive espresso machines available in Japan, with list price, discount and ASIN for each
See more
All Amazon methodsGets details for an Amazon product, found by name or by link, in a chosen country store. Offer prices, delivery and variants may be missing when Amazon does not show them publicly.
amazon.com/get_productLists current Amazon Best Sellers in the closest matching top-level category for a store country (United States, United Kingdom, Germany, India, Canada or Australia), up to 100 ranked products. Prices, ratings and photos may be missing.
amazon.com/list_best_sellersLists current public Today's Deals in page order for an Amazon store country, optionally for one deal category and a minimum discount, with deal and original prices, discount, deal type, time left, share claimed, rating and links.
amazon.com/list_dealsSearches Walmart products by keywords with optional sort and price range, returning prices, ratings, sellers and availability in Walmart's order. Uses Walmart's default location (no ZIP-based pricing).
walmart.com/search_productsSearches AliExpress listings by product words, shipping destination, price range and sort order. Unpriced promotional cards are omitted; free shipping is marked only when the listing explicitly says so.
aliexpress.com/search_productsGets an Amazon product's current listed price and lifetime price statistics from CamelCamelCamel (Amazon and third-party new), with dated Amazon low/high points and a comparison to the average. Takes a product name, an Amazon or CamelCamelCamel link, or an ASIN, for eight Amazon stores.
camelcamelcamel.com/get_price_historySearches Best Buy US products with an optional price range, sort order and page. Prices and availability come from public listings and may vary by location.
bestbuy.com/search_productsSearches Argos UK products by keyword in the selected sort order, returning prices, ratings and links. Delivery and collection availability appear only when shown on the site.
argos.co.uk/search_products