↑ ↓ to move ↵ to open

Amazon Commerce API reference

Get Amazon US products as clean JSON: search results with prices and ratings, full product pages, every seller's offer, best sellers, deals and seller profiles. Send a search or an ASIN and get structured data back.

At a glance

Platform ID
amazon
Endpoints
10
Price
From 0.5 credits per call; failed calls are free
Pin in MCP
https://data.upscrape.com/mcp?platforms=amazon
Pin tools
OpenAPI
openapi.json
Download

The Amazon Commerce API has 10 endpoints, called the same way: POST /execute with the endpoint ID as capability and its fields as input, or pin Amazon Commerce in the MCP server and call each one as a tool. The data comes back as JSON in results[0].data, with what the call cost in billing.credits_charged.

The inputs you send most are seller_id, asin and node. Prices run from 0.5 credits to 3 credits per call, and a failed call costs nothing.

Endpoints

Open an endpoint for its input, the fields it returns and the request in cURL, Python and Node.js.

EndpointWhat it returnsPrice
amazon.products.search Search Amazon US like a shopper, with sort, department, category and price filters. 1 credit
amazon.product.get Get one product from its ASIN: title, brand, price, stock message, Prime, rating, review count, seller, bullet points and image links. 2 credits
amazon.product.offers List every seller's offer on a product: price, condition, who sells it and who ships it. 2 credits
amazon.bestsellers.list Get the ranked Best Sellers list for a category, with rank, title, price, rating and review count. 0.75 credits
amazon.deals.list List current Amazon deals with deal price, discount and product title. 3 credits
amazon.seller.get Get a seller's profile from its seller ID: name, description, rating, positive feedback share and feedback count. 0.5 credits
amazon.seller.feedback Read a seller's public feedback with rating, date and text, filtered by star rating and time period. 0.5 credits
amazon.seller.products List the products a seller offers, with title, rating, review count and Prime. 0.75 credits
amazon.search.suggestions Get Amazon's search suggestions for the start of a query, the way the search box completes it. 1 credit
amazon.category.tree Explore a category: its sub-categories and the filters Amazon offers inside it, ready to pass to search. 3 credits

What to know

  • Prices as text and as a number Each price comes as Amazon shows it and as a number you can sort and compare.
  • Sponsored results are marked Search results say which listings are sponsored and where each one sits, so you can keep or drop ads.
  • Missing fields stay empty A product with no deal, badge or Prime offer simply has none. Nothing is filled in.
  • Numbers at the moment of the call Prices, ranks, ratings and review counts are Amazon's own at the time you call.

Something missing or unclear? Ask the team that builds the Amazon Commerce endpoints.