Amazon APIamazon.com ↗
Access Amazon product data via 8 endpoints: search by keyword, get product details, reviews, seller offers, best sellers, deals, and cart management.
What is the Amazon API?
The Amazon API covers 8 endpoints that expose product search, detail pages, customer reviews, seller offers, best-seller rankings, and live deals. The search_products endpoint accepts a keyword query and returns paginated results including ASIN, price, rating, review count, and a "bought in past month" sales figure. Full product detail pages are available through get_product_details, returning structured specifications, bullet-point descriptions, and per-star rating breakdowns.
curl -X GET 'https://api.parse.bot/scraper/e1dc349c-16b6-498a-a7e6-2462aef5b5b4/search_products?page=1&sort=price-asc-rank&brand=Schylling&query=usb+cable&category=electronics&sold_by_amazon=true' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products on Amazon by keyword. Returns paginated results with product title, price, rating, and image. Supports optional category filtering, sort order, brand filtering, and filtering to only Amazon-sold items.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination (1-based). |
| sort | string | Sort order for results. |
| brand | string | Filter results by brand name (e.g. 'Schylling', 'Anker'). Case-sensitive as passed to Amazon's refinement filter. |
| queryrequired | string | Search keyword (e.g. 'usb cable', 'laptop'). |
| category | string | Amazon department/category code passed as the 'i' parameter (e.g. 'electronics', 'books'). |
| sold_by_amazon | boolean | When true, filters results to only products sold by Amazon.com (excludes third-party marketplace sellers). |
{
"type": "object",
"fields": {
"page": "string indicating the current page number",
"products": "array of product objects with asin, title, price, rating, review_count, image, and total_sold"
},
"sample": {
"data": {
"page": "1",
"products": [
{
"asin": "B07DD5YHMH",
"image": "https://m.media-amazon.com/images/I/715afhb+qJL._AC_UY218_.jpg",
"price": "$8.99",
"title": "Anker Cable [2 Pack 3ft], USB A to USB C Cable",
"rating": "4.7",
"review_count": null
}
]
},
"status": "success"
}
}About the Amazon API
Product Search and Detail
The search_products endpoint accepts a required query string and optional filters: category (Amazon department code), brand, sort order, and a sold_by_amazon boolean that restricts results to items fulfilled directly by Amazon. Results come back paginated — pass a page integer to navigate — with each product object carrying asin, title, price, rating, review_count, image, and total_sold (units bought in the past month when Amazon surfaces that figure).
The get_product_details endpoint takes a single asin and returns the full detail page: title, brand, price, description (array of bullet strings), specifications (key-value map of tech specs), images (array of high-resolution URLs), rating, review_count, and a rating_breakdown object with percentage shares for each star level (5_star through 1_star).
Reviews and Offers
get_product_reviews retrieves the customer review listing for an ASIN. Each entry in the reviews array includes author, rating, title, body, and date. A summary object at the top level repeats the overall star rating and total review count. get_product_offers returns all seller listings for an ASIN — useful for comparing third-party marketplace pricing against the main offer.
Best Sellers, Deals, and Cart
get_best_sellers accepts an optional category path segment (e.g. electronics, books) and defaults to the site-wide rankings when omitted. Each item in the response includes rank, asin, title, price, rating, review_count, image, and total_sold. get_deals requires no inputs and returns the current deals page as an array of objects with asin, title, price, and image. Two cart endpoints round out the API: add_to_cart (POST with asin and optional quantity) and get_cart (returns items array and subtotal string).
The Amazon API is a managed, monitored endpoint for amazon.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when amazon.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official amazon.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Track price changes for a watchlist of ASINs using
get_product_detailson a scheduled interval. - Build a comparison tool that pulls
specificationsandrating_breakdownfor multiple ASINs side-by-side. - Aggregate best-seller rankings across categories via
get_best_sellersto spot trending products. - Feed
get_product_reviewsresults into a sentiment analysis pipeline for brand monitoring. - Surface live promotional pricing by polling
get_dealsand cross-referencing with normal prices. - Identify lowest-cost marketplace sellers for a product using
get_product_offers. - Filter
search_productsbybrandandsold_by_amazonto build a curated storefront for a specific manufacturer's first-party listings.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Amazon have an official developer API?+
What does `rating_breakdown` contain, and when is it null?+
rating_breakdown is an object with keys 5_star, 4_star, 3_star, 2_star, and 1_star, each holding a percentage string (e.g. '72%'). Amazon only surfaces this breakdown on products with a sufficient number of reviews, so the field is returned as null for products where that breakdown is not present on the detail page.Does the API expose seller profile details inside `get_product_offers`?+
get_product_offers response currently returns an array of offer objects for an ASIN. Detailed seller profiles — seller ratings, fulfillment metrics, or storefront data — are not included. You can fork the API on Parse and revise it to add a dedicated seller-detail endpoint if that data is needed.Does pagination work the same across all listing endpoints?+
search_products accepts a page integer parameter for paginating through results. get_best_sellers, get_deals, and get_product_reviews do not currently expose a pagination parameter — they return a single page of results. You can fork the API on Parse and revise those endpoints to add page controls.Are product availability or inventory stock levels returned?+
search_products nor get_product_details returns an explicit in-stock or inventory count field. Price and offer data from get_product_offers can serve as an indirect availability signal. You can fork the API on Parse and revise it to surface availability text if the product page exposes it.