Search APIs
Loading…
← API Store
E-commerce

Amazon

Amazon

Amazon search

GET /amazon/v1/search
Test this endpoint

q 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

NameTypeDescription
qrequiredstring Example: coffee maker
sortfeatured | price_asc | price_desc | reviews | newest | bestsellersfeatured (default), price_asc, price_desc, reviews, newest, bestsellers.
min_pricenumberMinimum price, USD. Example: 20
max_pricenumberMaximum price, USD. Example: 80
ratingintegerAverage customer rating of at least this many stars (1-4). Example: 4
primeboolean1 to show Prime-eligible items only.
categorystringAmazon department alias (electronics, books, fashion, kitchen, garden, toys-and-games, beauty, sporting, automotive, ...). Example: kitchen
brandstringBrand name as Amazon spells it. Example: Keurig
domainstringAmazon 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
pageintegerPage number. Pass `next_page` from the previous response; `next_page` is null on the last page.
nodestringAmazon browse node id: search inside that category node (the `node=` / `rh=n:` value in Amazon category links). Example: 172282
sellerstringOnly this seller's products (a seller id such as A2L77EE7U53NWQ, as in `/amazon/v1/seller`).
zipstringDelivery 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
countrystringDelivery 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
$.cachedboolean
$.credits_usedinteger
$.domainstring
$.next_pageinteger
$.pageinteger
$.productsarray
$.products[]object | string
$.products[].asinstring
$.products[].badgesarray
$.products[].badges[]string
$.products[].bought_past_monthstring
$.products[].brandnull
$.products[].climate_pledgeboolean
$.products[].couponnull
$.products[].dealnull | string
$.products[].deliverystring
$.products[].imagestring
$.products[].imagesarray
$.products[].images[]string
$.products[].linkstring
$.products[].list_pricestring
$.products[].list_price_valuenumber
$.products[].positioninteger
$.products[].pricestring
$.products[].price_valuenumber
$.products[].primeboolean
$.products[].ratingnumber
$.products[].rating_countinteger
$.products[].sponsoredboolean
$.products[].sustainabilityarray
$.products[].sustainability[]string
$.products[].textstring
$.products[].titlestring
$.products[].title_shortstring
$.products[].unit_pricestring
$.products[].urlstring
$.products[].variationsnull
$.querystring
$.total_resultsinteger