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