# Amazon Promotion API Documentation

<p><strong>Amazon Promotion API Documentation</strong> Read an Amazon promotion or coupon: title, saving, expiry date and terms as plain text, plus the products in it with price, list price, unit price, rating, Prime, lightning deal and delivery text. Take the id from amzn1.promotion.&lt;id&gt; on Amazon search results and product pages. The first answer holds the terms and the first products. Pass next_page_token as page_token for the next products. Title, saving and expiry come from Amazon for some markets only (US, CA, IN): other fields are null. A promotion can have no products. Supported on US, CA, IN, DE, IT, JP and AU. Costs 1 credit per successful request.</p>

- **Documentation:** [https://scrappa.co/docs/amazon-api/amazon_promotion](https://scrappa.co/docs/amazon-api/amazon_promotion)
- **API group:** Amazon API
- **Endpoint:** `GET https://scrappa.co/api/amazon/promotion/{promotionId}`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `promotionId` | string | Yes | Promotion id in the path, with or without the amzn1.promotion. prefix. Example: A1E42UE9V21EFJ. |
| `domain` | string | No | Amazon marketplace. Supported here: US, CA, IN, DE, IT, JP, AU. Default: US. |
| `page_token` | string | No | The next_page_token of the previous answer. Returns the next products and no terms. |

## Example response

```json
{
    "data": {
        "terms": "Each coupon applies only to one or more specified items.\nHow to redeem a coupon:\n- Apply the coupon to your account.",
        "title": "Save 10% on Puori Favorites",
        "domain": "US",
        "products": [
            {
                "url": "https://www.amazon.com/dp/B0D63MXRF1",
                "asin": "B0D63MXRF1",
                "brand": "Puori",
                "image": "https://m.media-amazon.com/images/I/412478yoa8L.jpg",
                "price": {
                    "whole": "32",
                    "amount": 32,
                    "symbol": "$",
                    "display": "$32.00",
                    "currency": "USD",
                    "fraction": "00"
                },
                "prime": true,
                "title": "Puori 5g Creatine Monohydrate Powder with Added Taurine, 60 Servings",
                "rating": 4.7,
                "list_price": null,
                "unit_price": "$2.81/ounce",
                "availability": null,
                "reviews_count": 321,
                "strikethrough": false,
                "lightning_deal": false,
                "delivery_message": null
            }
        ],
        "expiration": "2026-11-13",
        "source_url": "https://www.amazon.com/promotion/psp/A1E42UE9V21EFJ",
        "saving_info": "10% extra savings on the first order, applied at checkout.",
        "terms_title": "Coupon Terms",
        "promotion_id": "A1E42UE9V21EFJ",
        "has_next_page": true,
        "products_count": 16,
        "expiration_text": "Coupon Expiry Date November 13, 2026",
        "next_page_token": "eyJkIjoiVVMiLCJpIjoiQTFFNDJVRTlWMjFFRkoiLCJzIjoyNjg5ODAuMjV9"
    },
    "meta": {
        "cached": false,
        "domain": "US",
        "currency": "USD",
        "language": "en_US",
        "timestamp": "2026-11-03T22:00:00.000000Z",
        "response_time_ms": 4200
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 404 | Not Found | The promotion does not exist on this marketplace. This response is not billable. |
| 422 | Validation Error | The domain is not supported, the promotion id is malformed or the page_token does not belong to this promotion. This response is not billable. |
| 503 | Service Unavailable | Amazon could not be reached after several tries. This response is not billable. Retry shortly. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)