GET /promotions 1 credit

Amazon Promo Code Details API

Resolve a promotion id into its terms: discount, eligibility, validity window and applicable items.

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
promo_id
required
string Promotion identifier.
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/promotions?promo_id=A2XKPQ9RL3M1&marketplace=US&zip=10001" \
  -H "x-api-key: YOUR_API_KEY"

Response

200 OK application/json
{
  "url": "https://www.amazon.com/promotion/psp/A2XKPQ9RL3M1",
  "terms": "Apply at checkout. One redemption per customer.",
  "title": "Save 15% on select Logitech peripherals",
  "ends_at": null,
  "discount": "15%",
  "promo_id": "A2XKPQ9RL3M1",
  "starts_at": null,
  "marketplace": "US",
  "eligible_items": [
    "B07CMS5Q6P"
  ]
}

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

Related endpoints