Skip to content

List Amazon’s current deals with price, price before the discount, savings, rating and review count. Filters are optional.

GET · POST1 credit / successful callCursor-paginated
GEThttps://api.scrapier.io/api/v2/amazon-todays-deals/Open in Playground

Call it with no parameters to get the deals Amazon currently lists, each with ASIN, title, link, price to pay, price before the discount, savings amount and percentage, deal type and state, rating, review count and image.

Narrow the list on the first call with department, deal_type (all, best_deal, lightning_deal or coupon), prime_exclusive, min_discount and max_discount (percent) and min_price and max_price (USD). The filters are locked into the cursor. Page through the deals by passing next_cursor back as cursor.

  • Watch daily discounts in categories you sell in.
  • Alert on deals for products you track.
  • Feed a deals newsletter or channel.
Terminal window
curl -G "https://api.scrapier.io/api/v2/amazon-todays-deals/" \
-H "X-API-Key: YOUR_API_KEY" \
--max-time 210
NameTypeRequiredDefaultDescription
X-API-Key headerstringyes—Your API key from the dashboard.
cursorstringno—Pagination cursor returned in the previous response's next_cursor. Pass it back unchanged to fetch the next page. When next_cursor is null, you have reached the last page.
departmentstringno—First call only (locked into the cursor). Optional department name (e.g. Electronics, Home & Kitchen, Books, Toys & Games) or Amazon browse-node id. Empty = all.
deal_typestringnoallFirst call only. all | best_deal | lightning_deal | coupon
allbest_deallightning_dealcoupon
prime_exclusivebooleannofalseFirst call only. Only Prime-exclusive deals
min_discountintegerno—First call only. Minimum discount % (0-100)
max_discountintegerno—First call only. Maximum discount % (0-100)
min_priceintegerno—First call only. Minimum price in USD
max_priceintegerno—First call only. Maximum price in USD
Advanced
NameTypeDefaultDescription
use_proxybooleantrueRoute the request through Scrapier's residential proxy pool. Default: true. Leave as is unless support tells you otherwise.
raw_databooleanfalseWhen true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under raw_responses, in place of the formatted items. When false (default) you get the formatted output. Pagination (cursor / next_cursor) works the same in both modes.
{
"success": true,
"data": {
"index": 0,
"page_size": 60,
"deals": [
{
"asin": "B0GZTKN3MN",
"basis_price": 1099.99,
"price_to_pay": 749,
"currency": "USD",
"savings_amount": 350.99,
"savings_percentage_value": 32,
"title": "ECOVACS DEEBOT Robot Vacuum and Mop, X11S OMNICYCLONE",
"link": "https://www.amazon.com/ECOVACS-DEEBOT-Robot-Vacuum-OMNICYCLONE/dp/B0GZTKN3MN",
"deal_state": "AVAILABLE",
"deal_type": "BEST_DEAL",
"image": "https://m.media-amazon.com/images/I/71FQzChMWDL.jpg",
"rating": 4.6,
"reviews_count": 83
}
],
"next_cursor": "zc1.eNrtwTEBAAAAwqD1T20KP6AAAAAAAAAA..."
}
}

Sample from the live catalog; arrays trimmed to 3 items. Results are in data.deals.

FieldTypeExampleDescription
indexinteger0—
page_sizeinteger60—
dealsarray[1 item]The results.
next_cursorstringzc1.eNrtwTEBAAAAwqD1T20KP6AAAAAAAAAA...Pass back as cursor for the next page. null on the last page.
deals[].asinstringB0GZTKN3MN—
deals[].basis_pricenumber1099.99Price before the discount.
deals[].price_to_payinteger749Price you pay for the deal.
deals[].currencystringUSD—
deals[].savings_amountnumber350.99Amount saved against the price before the discount.
deals[].savings_percentage_valueinteger32Discount in percent.
deals[].titlestringECOVACS DEEBOT Robot Vacuum and Mop, X11S OMN…—
deals[].linkstringhttps://www.amazon.com/ECOVACS-DEEBOT-Robot-V…Link to the product page.
deals[].deal_statestringAVAILABLEWhether the deal is currently available.
deals[].deal_typestringBEST_DEALKind of deal, for example BEST_DEAL.
deals[].imagestringhttps://m.media-amazon.com/images/I/71FQzChMW…—
deals[].ratingnumber4.6—
deals[].reviews_countinteger83—

Pass data.next_cursor back as cursor until it is null. Required inputs are ignored once a cursor is sent. Each page is one billed call. More in Pagination.

const url = "https://api.scrapier.io/api/v2/amazon-todays-deals/";
let params = {};
const items = [];
for (let page = 0; page < 10; page++) { // each page is one billed call
const res = await fetch(`${url}?${new URLSearchParams(params)}`, {
headers: { "X-API-Key": "YOUR_API_KEY" },
signal: AbortSignal.timeout(210_000),
});
const body = await res.json();
if (!res.ok) throw new Error(body.error ?? body.detail ?? `HTTP ${res.status}`);
const data = body.data;
items.push(...(data.deals ?? []));
if (!data.next_cursor) break; // null = last page
params = { cursor: data.next_cursor };
}

Failed calls are free. Branch on the HTTP status and read the message from error (or detail). Full details in Errors.

StatusMeaningRetry?Charged?
400Bad or missing input.No — fix the paramsNo
401 / 403Missing, invalid or revoked API key.No — fix the keyNo
402Out of credits (body has balance).No — top upNo
404Unknown endpoint slug.No — check the slugNo
429 / 503Busy or throttled.Yes — after Retry-AfterNo
5xxTarget site or upstream failure, or timeout.Yes — with backoffNo
  • No input is required; every filter is optional.
  • The filters (department, deal_type, prime_exclusive, min_discount, max_discount, min_price, max_price) are read on the first call only and locked into the cursor.
  • Amazon Best Sellers — Get ranked products from an Amazon Best Sellers category URL, with price, rating, review count and list position.
  • Amazon Search — Search Amazon by keyword and get product results with price, rating and position, with marketplace and sort order options.
  • Amazon Products — Search Amazon by keyword or URL and get product listings, or send a product URL to get that single product.