← API Store
E-commerce
Amazon
Amazon
Amazon search
GET /amazon/v1/searchq also takes a product code: a UPC, EAN, GTIN or ISBN finds the matching product when Amazon has it listed under that code. Pass next_page back as page. next_page is null on the last page.
Every response includes credits_used: the credits this call cost.
Each call costs 3 credits; failed calls are free. Run it in the console playground to see a live result.
Parameters
| Name | Type | Description |
|---|---|---|
qrequired | string | Example: coffee maker |
sort | featured | price_asc | price_desc | reviews | newest | bestsellers | featured (default), price_asc, price_desc, reviews, newest, bestsellers. |
min_price | number | Minimum price, USD. Example: 20 |
max_price | number | Maximum price, USD. Example: 80 |
rating | integer | Average customer rating of at least this many stars (1-4). Example: 4 |
prime | boolean | 1 to show Prime-eligible items only. |
category | string | Amazon department alias (electronics, books, fashion, kitchen, garden, toys-and-games, beauty, sporting, automotive, ...). Example: kitchen |
brand | string | Brand name as Amazon spells it. Example: Keurig |
domain | string | Amazon marketplace: com (default), co.uk, de, fr, it, es, ca, com.mx, com.br, com.au, in, co.jp, nl, se, pl, com.be, com.tr, ae, sa, sg, eg, ie. Example: co.uk |
page | integer | Page number. Pass `next_page` from the previous response; `next_page` is null on the last page. |
node | string | Amazon browse node id: search inside that category node (the `node=` / `rh=n:` value in Amazon category links). Example: 172282 |
seller | string | Only this seller's products (a seller id such as A2L77EE7U53NWQ, as in `/amazon/v1/seller`). |
zip | string | Delivery ZIP / postcode: prices, availability and delivery dates for that location (Amazon's own location picker). The applied location (zip, city, state, country) is returned in `location`. Adds 3 credits to the call. Example: 10001 |
country | string | Delivery country (ISO code such as US, GB, DE, IN): prices, availability and delivery dates for delivery to that country (Amazon's "deliver outside" list). The marketplace's own country uses `zip`. The applied location is returned in `location`. Adds 3 credits to the call. Example: GB |
Every endpoint also takes: raw、fields、fresh、output、records
{
"cached": false,
"credits_used": 3,
"domain": "amazon.com",
"next_page": 2,
"page": 1,
"products": [
{
"asin": "B0D14N2QZF",
"badges": [
"Overall Pick",
"Overall Pick"
],
"bought_past_month": "5K+ bought in past month",
"brand": null,
"climate_pledge": false,
"coupon": null,
"deal": "Overall Pick",
"delivery": "GBP 7.47 delivery Fri, Oct 30Ships to United Kingdom",
"image": "https://m.media-amazon.com/images/I/61MC8BK0w0L._AC_UY218_.jpg",
"images": [
"https://m.media-amazon.com/images/I/61MC8BK0w0L._AC_UY218_.jpg",
"https://m.media-amazon.com/images/I/61MC8BK0w0L._AC_UY327_QL65_.jpg",
"… 3 more"
],
"link": "https://www.amazon.com/F75-Pro/dp/B0D14N2QZF/ref=sr_1_1?dib=eyJ2IjoiMSJ9.gYxyFrxGrEc666btgjysl2nUkxHsCZ07zYLe7G1F3lyMXSRQ5r4YJZi1bbuY2UAnWTh…",
"list_price": "GBP 59.78",
"list_price_value": 59.78,
"position": 2,
"price": "GBP 48.57",
"price_value": 48.57,
"prime": false,
"rating": 4.6,
"rating_count": 1874,
"sponsored": false,
"sustainability": [
"Recycled materials +2 more",
"Sustainability features",
"… 15 more"
],
"text": "Overall PickAmazon's Choice: Overall Pick Products highlighted as 'Overall Pick' are: Rated 4+ starsPurchased oftenReturned infrequentlyAULA…",
"title": "AULA F75 Pro Wireless Mechanical Keyboard,75% Hot Swappable Custom Keyboard with Knob,RGB Backlit,Pre-lubed Reaper Switches,Side Printed PBT…",
"title_short": "AULA F75 Pro Wireless Mechanical Keyboard,75% Hot Swappable Custom Keyboard with Knob,RGB Backlit,Pre-lubed Reaper Switches,Side Printed PBT…",
"unit_price": "List: GBP 59.78",
"url": "https://www.amazon.com/dp/B0D14N2QZF",
"variations": null
},
{
"asin": "B08Z6X4NK3",
"badges": [],
"bought_past_month": "2K+ bought in past month",
"brand": null,
"climate_pledge": false,
"coupon": null,
"deal": null,
"delivery": "GBP 7.47 delivery Fri, Oct 30Ships to United Kingdom",
"image": "https://m.media-amazon.com/images/I/61thTSgqWOL._AC_UY218_.jpg",
"images": [
"https://m.media-amazon.com/images/I/61thTSgqWOL._AC_UY218_.jpg",
"https://m.media-amazon.com/images/I/61thTSgqWOL._AC_UY327_QL65_.jpg",
"… 3 more"
],
"link": "https://www.amazon.com/Logitech-Full-Size-Mechanical-Anti-Ghosting-Keys-White/dp/B08Z6X4NK3/ref=sr_1_2?dib=eyJ2IjoiMSJ9.gYxyFrxGrEc666btgjys…",
"list_price": "GBP 67.25",
"list_price_value": 67.25,
"position": 3,
"price": "GBP 51.64",
"price_value": 51.64,
"prime": false,
"rating": 4.5,
"rating_count": 1675,
"sponsored": false,
"sustainability": [],
"text": "Logitech G413 SE Full-Size Mechanical Gaming Keyboard - Black Backlit, anti-ghosting, compatible with Windows and macOS, aluminum material4.…",
"title": "Logitech G413 SE Full-Size Mechanical Gaming Keyboard - Black",
"title_short": "Logitech G413 SE Full-Size Mechanical Gaming Keyboard - Black",
"unit_price": "List: GBP 67.25",
"url": "https://www.amazon.com/dp/B08Z6X4NK3",
"variations": null
},
"… 14 more"
],
"query": "mechanical keyboard",
"total_results": 30869
} Response fields (40)
Field paths and types observed in the sample response; the live response is authoritative.
$ | object |
$.cached | boolean |
$.credits_used | integer |
$.domain | string |
$.next_page | integer |
$.page | integer |
$.products | array |
$.products[] | object | string |
$.products[].asin | string |
$.products[].badges | array |
$.products[].badges[] | string |
$.products[].bought_past_month | string |
$.products[].brand | null |
$.products[].climate_pledge | boolean |
$.products[].coupon | null |
$.products[].deal | null | string |
$.products[].delivery | string |
$.products[].image | string |
$.products[].images | array |
$.products[].images[] | string |
$.products[].link | string |
$.products[].list_price | string |
$.products[].list_price_value | number |
$.products[].position | integer |
$.products[].price | string |
$.products[].price_value | number |
$.products[].prime | boolean |
$.products[].rating | number |
$.products[].rating_count | integer |
$.products[].sponsored | boolean |
$.products[].sustainability | array |
$.products[].sustainability[] | string |
$.products[].text | string |
$.products[].title | string |
$.products[].title_short | string |
$.products[].unit_price | string |
$.products[].url | string |
$.products[].variations | null |
$.query | string |
$.total_results | integer |