Amazon best sellers API
One Amazon product, as shown in search results, a bestseller shelf, or its own product page. To get these records, set mode to bestsellers, which reads categoryUrls.
- Record type
product- Fields
- 10
- From
- $5.50 per 1,000 records
- Billed as
bestseller
Example request and record
The request below is the one this record answers, taken from a real run. The names, usernames, photos and contact details of people in it are fictional.
{ "source": "amazon", "type": "product", "asin": "B004YAVF8I", "rank": 1, "title": "Logitech M185 Compact Ambidextrous 2.4 GHz Wireless Mouse - Swift Gre… "price": { "amount": 13.99, "currency": "USD", "raw": "$13.99" }, "rating": 4.4, "reviewsCount": 45015, "image": "https://images-na.ssl-images-amazon.com/images/I/51WN5aXZWIL._AC_UL30… "url": "https://www.amazon.com/Logitech-Wireless-Mouse-M185-Swift/dp/B004YAVF8I… "categoryUrl": "https://www.amazon.com/gp/bestsellers/pc/11036491", "categoryName": "Computer Mice", "country": "US", "id": "B004YAVF8I", "event": "bestseller", "collectedAt": "2026-09-20T19:43:54.521Z"}Each field name links to its row in the field table. Long values are shortened.
| Field | Type | What it holds |
|---|---|---|
asin | string | Amazon's 10-character product identifier. |
country | string | ISO country code of the Amazon marketplace this record was read from. |
title | string | The product title as shown on the page. |
price | null | object | The current price, with keys amount, currency (ISO 4217 code), and raw. Null when no price is shown. |
rating | integer | null | number | Average star rating out of 5. Null when the page shows no rating. |
reviewsCount | integer | null | Total number of customer reviews. Null when the page shows no count. |
image | string | A single thumbnail image URL. On search and bestseller cards, not on a merged product-detail record. |
rank | integer | The item's position in the bestseller list. Only on bestseller records. Present on bestseller, product-detail. |
categoryUrl | string | URL of the bestseller category page that produced this record. Only on bestseller records. Present on bestseller, product-detail. |
categoryName | string | The bestseller category's display name, read from the page title. Only on bestseller records. Present on bestseller, product-detail. |
Fields
Records billed as bestseller carry 10 of the 55 product fields, read from real Amazon records. Each links to what it holds on the Amazon page. Each record starts with the envelope: source, type, event, id, url, collectedAt.
asinstringcountrystringtitlestringpricenull | objectratinginteger | null | numberreviewsCountinteger | nullimagestringrankintegercategoryUrlstringcategoryNamestring
Options
These inputs and switches change what comes back. Every request also takes maxItems and maxItemsPerInput.
| Option | Type | Default | What it does |
|---|---|---|---|
categoryUrls | array | none | e.g. https://www.amazon.com/Best-Sellers-Electronics/zgbs/electronics/ |
fetchProductDetails | boolean | false | Open each hit's own product page for specs, images, variants, Best Sellers ranks, rating breakdown, top reviews, other offers and seller, and merge them in. In search mode this replaces the search-card event with the richer product-detail event; in bestsellers mode the shelf item (rank, category) is still charged as a Best seller event, and the merged detail is charged an additional Product detail event per item. |
Amazon best sellers pricing
You pay once for each record you receive, at the price of the event it carries. A request that returns nothing costs nothing.
| Event | Per 1,000 records | Per record |
|---|---|---|
bestseller | $5.50 | $0.00550 |
Edge cases
rankis the position Amazon prints on the list.- Each list is read for up to 5 pages.
- With
fetchProductDetails: true, each entry's product page is merged in. The entry is billed asbestsellerand the product page asproduct-detail, so each entry costs both.