Skip to main content
GET
/
v1
/
amazon
/
deals
Today's Deals
curl --request GET \
  --url https://scrapebadger.com/v1/amazon/deals \
  --header 'x-api-key: <api-key>'
{
  "domain": "com",
  "category": null,
  "results": [
    {
      "position": 1,
      "asin": "B0C7KMR3T5",
      "title": "Sony WH-1000XM5 Wireless Headphones",
      "link": "https://www.amazon.com/dp/B0C7KMR3T5",
      "image": "https://m.media-amazon.com/images/I/61deal.jpg",
      "deal_price": {
        "value": 298,
        "currency": "USD",
        "symbol": "$",
        "raw": "$298.00"
      },
      "list_price": {
        "value": 399.99,
        "currency": "USD",
        "symbol": "$",
        "raw": "$399.99"
      },
      "discount_percent": 25,
      "deal_type": "Best Deal",
      "is_lightning_deal": false,
      "badge": "Limited time deal",
      "ends_at_utc": null,
      "ends_at": null
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.scrapebadger.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Query Parameters

​
domain
string
default:"com"
Amazon marketplace TLD or code.Examples: com, co.uk, de
​
category
string
Category alias to scope the deals feed. Use /v1/amazon/categories to look up aliases.
​
page
integer
default:1
Page number for paginated deals. Starts at 1.

​
Response

​
domain
string
Marketplace domain.
​
category
string
Category the deals were scoped to (nullable).
​
results
array
Array of current deals.

​
Example Response

{
  "domain": "com",
  "category": null,
  "results": [
    {
      "position": 1,
      "asin": "B0C7KMR3T5",
      "title": "Sony WH-1000XM5 Wireless Headphones",
      "link": "https://www.amazon.com/dp/B0C7KMR3T5",
      "image": "https://m.media-amazon.com/images/I/61deal.jpg",
      "deal_price": { "value": 298.0, "currency": "USD", "symbol": "$", "raw": "$298.00" },
      "list_price": { "value": 399.99, "currency": "USD", "symbol": "$", "raw": "$399.99" },
      "discount_percent": 25,
      "deal_type": "Best Deal",
      "is_lightning_deal": false,
      "badge": "Limited time deal",
      "ends_at": null
    }
  ]
}
Each deals request costs 5 credits. Failed requests are not charged.

Authorizations

​
x-api-key
string
header
required

Query Parameters

​
domain
string
default:com

Amazon marketplace TLD or code (com, co.uk, de, ...).

​
category
string

Category alias to scope the deals feed.

​
page
integer
default:1

Page number for paginated deals.

Required range: x >= 1

Response

200 - application/json

Deals list

​
domain
string
​
category
string | null
​
results
object[]