Shopping
Amazon API
Read public Amazon creator storefronts, products, reviews, sellers, search, best sellers and deals.
Read Amazon creator storefronts, products, reviews, sellers, search results, best sellers and deals.
API availability: Available
http://localhost:3024Public API: https://api.scrapeatlas.com.Endpoints
/v1/amazon/shopGet an Amazon creator storefront
Read a public amazon.com/shop/{handle} storefront with profile, idea lists, shoppable photos and videos, trending picks and curations. Pass pageToken to retrieve the next feed page.
Reference/v1/amazon/productGet an Amazon product
Read a public Amazon product by ASIN: title, brand, feature bullets, merchant, price, rating, image gallery and availability.
Reference/v1/amazon/reviewsGet Amazon product reviews
Read the customer reviews embedded in the public product page (typically the top reviews, about eight). Each row carries id, title, text, stars, author, verified flag, helpful votes, images and the review date. Sibling variants can contribute reviews; entity_id is always the requested ASIN. Up to five equivalent mobile and desktop views are read to collect the embedded list; reviews_not_embedded marks a response whose page views carried none.
Reference/v1/amazon/sellersGet Amazon sellers and offers for a product
Read the buy-box offer shown on the public product page: merchant id and name, price, the product rating and availability.
Reference/v1/amazon/product-searchSearch Amazon products
Read organic keyword search results (sponsored cards are skipped), 16-48 per page with page/cursor continuation, or up to 300 products in one call with depth. Result order and sponsored slots vary per request on Amazon itself.
Reference/v1/amazon/best-sellersGet Amazon best sellers in a category
Read an Amazon best-seller list with product rankings, identifiers, titles, prices and URLs.
Reference/v1/amazon/dealsGet current Amazon deals
Read Amazon deals with product identifiers, titles, deal prices, list prices and images.
Reference/v1/amazon/sellerGet an Amazon seller profile
Read a public seller profile page: name, profile URL and the lifetime feedback rating and count.
ReferenceQuick start
Create an API key on your account page, then call the public API. Values below are placeholders.
curl "https://api.scrapeatlas.com/v1/amazon/shop?url=https%3A%2F%2Fwww.amazon.com%2Fshop%2Fexample" \
-H "x-api-key: YOUR_API_KEY"Coverage & limits
- Four concurrent requests; 25-second deadline; two upstream attempts including one transient retry (up to five page views for reviews, three for best sellers, eight for deep search); 6 MiB decoded HTML per request.
- Thirteen marketplaces via country; the marketplace currency is pinned with a static preference cookie and pages are read without an account. Sign-in walls, robot checks and HTTP 503 are reported as explicit challenges.
- Storefront: the first feed page (20 entries) plus pageToken continuation; trending picks and curations come from the first page.
- Reviews: the customer reviews embedded in the product page (about eight to thirteen per ASIN), collected with up to five mobile and desktop page views per request.
- Sellers returns the buy-box offer. Best sellers return all 50 ranks per page; deals return the first grid batch of the deals page.
- Search and deals reflect what Amazon served for this request; sponsored cards are skipped and result sets vary between requests.
| HTTP | failure.code | Meaning |
|---|---|---|
| 400 | invalid_request | Missing, duplicate, unsupported or invalid parameters. |
| 401 | unauthorized | Missing or invalid service key. |
| 404 | not_found | Storefront, product, category or seller page not found. |
| 429 | upstream_rate_limited | Amazon rate limited the request; no automatic retry. |
| 502 | upstream_challenged | Robot check, sign-in wall or HTTP 503 from Amazon. |
| 502 | unsupported_page unsafe_redirect response_too_large payload_too_complex request_limit upstream_error | Bounded retrieval failed or the page did not match the requested entity. |
| 503 | busy | All worker slots occupied. |
| 504 | timeout | Deadline exceeded. |
| 200 | partial | Coverage warnings such as lazy_loaded_ranks_omitted or record_limit. |
