GET /deals 1 credit

Amazon Deals API

The live deals feed for a marketplace with discount percentage, deal price and badge.

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
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/deals?marketplace=US&zip=10001" \
  -H "x-api-key: YOUR_API_KEY"

Response

200 OK application/json
{
  "count": 73,
  "results": [
    {
      "url": "https://www.amazon.com/dp/B0GVG9DKJP",
      "asin": "B0GVG9DKJP",
      "badge": null,
      "image": "https://m.media-amazon.com/images/I/21HlOO4X++L.jpg",
      "price": {
        "amount": 23.99,
        "display": "$23.99",
        "currency": "USD"
      },
      "title": null,
      "deal_id": null,
      "discount": "20% off"
    },
    {
      "url": "https://www.amazon.com/dp/B0B4KMZRC3",
      "asin": "B0B4KMZRC3",
      "badge": null,
      "image": "https://m.media-amazon.com/images/I/41BU8bonGdL.jpg",
      "price": {
        "amount": 39.99,
        "display": "$39.99",
        "currency": "USD"
      },
      "title": null,
      "deal_id": null,
      "discount": "20% off"
    }
  ],
  "marketplace": "US"
}

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", "marketplace"],
      "msg": "Field required",
      "type": "missing",
      "input": null
    }
  ]
}

Related endpoints