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