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