Amazon API: Get product
Gets 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.
Unofficial. Not affiliated with or endorsed by Amazon.
Inputs
Values from the run on Oct 23, 2026, shown under Output.
- Country optional
country Amazon store country name or two-letter code, such as United Kingdom or GB.
United States
Default
United States.- Product, required
product Product name, such as Apple AirPods Pro 2, or an Amazon product link.
https://www.amazon.com/dp/B0D1XD1ZV3
Input as JSON
{ "country": "United States", "product": "https://www.amazon.com/dp/B0D1XD1ZV3" }Output
{ "asin": "B0D1XD1ZV3", "brand": "Apple", "title": "Apple AirPods Pro 2 Wireless Earbuds, Active Noise Cancellation, Hearing Aid Feature, Bluetooth Headphones, Transparency, Personalized Spatial Audio, High-Fidelity Sound, H2 Chip, USB-C Charging", "sold_by": "Amazon Resale", "currency": "USD", "variants": [ { "name": "Without AppleCare+", "price": 227.22, "currency": "USD", "product_link": "https://www.amazon.com/dp/B0D1XD1ZV3" } ], "list_price": null, "ships_from": "Amazon", "image_links": [ "https://m.media-amazon.com/images/I/61SUj2aKoEL._AC_SL1500_.jpg" , "https://m.media-amazon.com/images/I/611pEx7220L._AC_SL1500_.jpg" , "https://m.media-amazon.com/images/I/81Zg3Ev2M5L._AC_SL1500_.jpg" ], "star_rating": 4.6, "availability": "Only 1 left in stock - order soon.", "product_link": "https://www.amazon.com/dp/B0D1XD1ZV3" , "current_price": 227.22, "savings_amount": null, "specifications": [ { "name": "Brand", "value": "Apple" }, { "name": "Color", "value": "White" }, { "name": "Ear Placement", "value": "In Ear" } ], "feature_bullets": [ "PIONEERING HEARING — AirPods Pro 2 unlock the world’s first all-in-one hearing health experience: a scientifically validated Hearing Test,* clinical-grade and active Hearing Protection.*", "INTELLIGENT NOISE CONTROL — Active Noise Cancellation removes up to 2x more background noise.* Transparency mode lets you hear the world around you, and Adaptive Audio seamlessly blends Active Noise Cancellation and Transparency mode for the best listening experience in any environment.* And when yo…", "IMPROVED SOUND AND CALL QUALITY — The Apple-designed H2 chip helps to create deeply immersive sound. The low-distortion, custom-built driver delivers crisp, clear high notes and full, rich bass in stunning definition. Voice Isolation improves the quality of phone calls in loud conditions.*" ], "savings_percent": null, "delivery_estimate": "FREE delivery Wednesday, October 28 Or Prime members get FREE delivery Sunday, October 25 . Order within 8 hrs 16 mins . Join Prime", "number_of_ratings": 47028, "ratings_by_star_percent": {}}Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"amazon.com/get_product","input":{"country":"United States","product":"https://www.amazon.com/dp/B0D1XD1ZV3"}}' # 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/get_product" , "input": { "country": "United States", "product": "https://www.amazon.com/dp/B0D1XD1ZV3" }})# 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/get_product" , "input": { "country": "United States", "product": "https://www.amazon.com/dp/B0D1XD1ZV3" } }), 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/get_product# with {"country":"United States","product":"https://www.amazon.com/dp/B0D1XD1ZV3"}"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": [ "product" ], "properties": { "country": { "type": "string", "default": "United States", "description": "Amazon store country name or two-letter code, such as United Kingdom or GB." }, "product": { "type": "string", "description": "Product name, such as Apple AirPods Pro 2, or an Amazon product link." } }}Output schema
{ "type": "object", "required": [ "title", "currency", "product_link", "asin" ], "properties": { "asin": { "type": "string", "description": "Amazon product identifier." }, "brand": { "type": [ "string", "null" ], "description": "Product brand." }, "title": { "type": "string", "description": "Product title." }, "sold_by": { "type": [ "string", "null" ], "description": "Displayed seller." }, "currency": { "type": "string", "description": "ISO currency code." }, "variants": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "price": { "type": [ "number", "null" ] }, "currency": { "type": "string" }, "product_link": { "type": "string" } } }, "description": "Displayed product variants, with price if known." }, "list_price": { "type": [ "number", "null" ], "description": "List or typical price." }, "ships_from": { "type": [ "string", "null" ], "description": "Displayed fulfillment provider." }, "image_links": { "type": "array", "items": { "type": "string" }, "description": "Product image links." }, "star_rating": { "type": [ "number", "null" ], "description": "Average star rating." }, "availability": { "type": [ "string", "null" ], "description": "Availability shown by Amazon." }, "product_link": { "type": "string", "description": "Amazon product page link." }, "current_price": { "type": [ "number", "null" ], "description": "Current displayed offer price." }, "savings_amount": { "type": [ "number", "null" ], "description": "Savings compared with list price." }, "specifications": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "value": { "type": "string" } } } }, "feature_bullets": { "type": "array", "items": { "type": "string" }, "description": "Product feature bullet points." }, "savings_percent": { "type": [ "number", "null" ], "description": "Percent saved from list price." }, "delivery_estimate": { "type": [ "string", "null" ], "description": "Displayed delivery estimate." }, "number_of_ratings": { "type": [ "integer", "null" ], "description": "Total ratings." }, "ratings_by_star_percent": { "type": "object", "description": "Percent of ratings per star, 5 through 1 when available.", "additionalProperties": { "type": "integer" } } }}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
amazon.com/get_product- Returns
- title, brand, prices, availability, seller, delivery, ratings, bullets, specifications, images, variants
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/get_product with the inputs above.
Ask your agent
- Can you pull up the full details for the Apple AirPods Pro 2 from the US Amazon store, including price, seller and ratings?
- I need the specs, bullet points and available color variants for a Sony WH-1000XM5 headphone listing on Amazon UK.
- Look up this Amazon link https://www.amazon.com/dp/B0BDHWDR12 and tell me its brand, availability and delivery estimate.
- What does the Amazon Germany listing for a Dyson V15 Detect vacuum say about its images, prices and seller?
- Find the Kindle Paperwhite product page on the Amazon store in Canada and summarize its ratings and specifications.
See more
All Amazon methodsSearches 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.
amazon.com/search_productsLists 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_dealsLists 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_sellersGets 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_historyGet one AliExpress product’s prices, variants, reviews, shipping to a chosen country, seller and specifications from its link or the best-selling name match. Sold counts may be rounded, and shipping options are those shown for the displayed variant.
aliexpress.com/get_productGets details, price and availability for a Walmart product by name or product link, using Walmart's default location.
walmart.com/get_productGets current Apple Store prices and the configurations on sale for a product in one country. It includes only models sold on that country's public store.
apple.com/get_product_pricesGets a Nike product's details by name or product link for a chosen country. Returns its colourways, size availability, price and reviews.
nike.com/get_product