GET /products/search 1 credit

Amazon Product Search API

Run a keyword search and get back a ranked page of products with price, rating, review count, Prime eligibility, badges and delivery copy. Supports auto-pagination, price bands, department scoping and sponsored filtering.

Try it

You are not signed in, so this runs against sample data and costs nothing. Create a free account to run it against your own key.
Returns sample data — no account needed.
Send a request to see the response.

Query parameters

NameTypeDefaultDescription
query
required
string Search keywords.
page integer 1 1-based page number.
limit integer 0 Auto-paginate until N items are collected. 0 returns a single page. Max 200.
sort string Result ordering.
relevanceprice_ascprice_descratingnewestbestseller
department string Restrict to a department, e.g. electronics.
min_price number Lowest price to include, in the marketplace's currency.
max_price number Highest price to include.
prime_only boolean false Only return Prime-eligible results.
include_sponsored boolean true Keep sponsored placements in the results.
marketplace string US Two-letter marketplace code (US, UK, DE, FR, IT, ES, CA, JP, IN, AU, …).
zip string Delivery postcode. Without one, many listings report “cannot be shipped to your location” and come back with no price or images. Always send it for price-accurate data.

Request

curl -sS "https://amazoncrawler.com/v1/products/search?query=wireless+mouse&marketplace=US&zip=10001" \
  -H "x-api-key: YOUR_API_KEY"

Response

200 OK application/json
{
  "page": 1,
  "sort": null,
  "count": 20,
  "query": "wireless mouse",
  "results": [
    {
      "url": "https://www.amazon.com/dp/B07CMS5Q6P/ref=sr_1_1_sspa",
      "asin": "B07CMS5Q6P",
      "badge": "Best Seller",
      "image": "https://m.media-amazon.com/images/I/51sg9BLSMTL.jpg",
      "price": {
        "amount": 29.99,
        "display": "$29.99",
        "currency": "USD",
        "list_price": 49.99
      },
      "prime": false,
      "title": "Logitech G305 Lightspeed Wireless Gaming Mouse - Black | HERO sensor, 12,000 DPI, Six programmable buttons, 250-hour battery, On-board memory",
      "rating": 4.6,
      "delivery": "FREE delivery Mon, Aug 10 on $35 of items shipped by Amazon",
      "position": 4,
      "sponsored": true,
      "reviews_count": 39364,
      "bought_past_month": "10K+ bought in past month"
    },
    {
      "url": "https://www.amazon.com/dp/B005EJH6Z4/ref=sr_1_2_ffob_sspa",
      "asin": "B005EJH6Z4",
      "badge": null,
      "image": "https://m.media-amazon.com/images/I/61YQeAUIboL.jpg",
      "price": {
        "amount": 12.58,
        "display": "$12.58",
        "currency": "USD",
        "list_price": null
      },
      "prime": false,
      "title": "Amazon Basics 2.4 GHz Wireless Optical Computer Mouse with USB Nano Receiver",
      "rating": 4.5,
      "delivery": "FREE delivery Mon, Aug 10 on $35 of items shipped by Amazon",
      "position": 5,
      "sponsored": true,
      "reviews_count": 69507,
      "bought_past_month": "10K+ bought in past month"
    }
  ],
  "marketplace": "US",
  "has_next_page": true,
  "total_results": 42555
}

Errors

Beyond the shared error codes, this endpoint returns 422 when a parameter fails validation — the detail array names the field.

422 Unprocessable Entity
{
  "detail": [
    {
      "loc": ["query", "query"],
      "msg": "Field required",
      "type": "missing",
      "input": null
    }
  ]
}

Related endpoints