Amazon deals

Today's Amazon deals as JSON: deal price, list price, percent off, lightning deal end times, ratings and reviews, by department, brand or rating.

Embed
Preview of the card
<a href="https://scrapelyserp.com/docs/amazon-deals"><img src="https://scrapelyserp.com/docs/_api/public/orgs/affc5b0f-d3c2-423a-8143-9d10db5736ae/spaces/981e6275-da3f-446c-82de-889f59c83b6f/pages/1d8712f5-aa45-49da-b22d-f0ad834fccb3/social-card.svg?v=3e7ae33eec8b" alt="Amazon deals" width="600" height="315"></a>

Today's Amazon deals as JSON: deal price, list price, percent off, lightning deal end times, ratings and reviews, by department, brand or rating.

At a glance

GET /v1/structured/amazon/deals answers { endpoint, url, credits, duration_ms, data } with one page of today's deals, in Amazon's own order. Each call is charged for the data it moves: about 2 million deals per credit is typical. A call that fails is 502 TARGET_FAILED and costs nothing.

Per page

Up to 100 deals (limit, default 60). Typical time: 1–4 s.

The list

About 500 deals in all, the same list as the deals page. Past the end a page is empty, with next_page null.

Search

Deals take no keyword. To price ASINs you already have, use POST /v1/products.

Marketplace

Amazon US.

curl -G "https://api.scrapelyserp.com/v1/structured/amazon/deals" \
  -H "Authorization: Bearer $SCRAPELY_API_KEY" \
  -d department=electronics \
  -d min_rating=4 \
  -d limit=20

Parameters

Parameter

Type

Default

Description

department

string

—

Only deals in one department: our slug (e.g. electronics) or Amazon's name (Home & Kitchen). filters.departments lists them with their deals.

brand

string

—

Only deals of one brand: its id from filters.brands (with include_filters=true), e.g. 323125 (Amazon).

min_rating

4

—

4: only products rated 4 stars and up (the one rating filter Amazon offers here).

access

prime_exclusive

—

prime_exclusive: only deals for Prime members.

page

integer

1

Page, 1–100. The list runs to about 500 deals; next_page is null on the last page.

limit

integer

60

Deals per page, 1–100. Pages are limit apart: keep it the same while paging.

include_filters

boolean

false

Also return filters: the departments, brands (the top 20), ratings and access programs of the deals that match, with the ids these parameters take.

Filters combine. Brand ids come from filters.brands: call once with include_filters=true (in a department, to get that department's top brands), then pass the id as brand. An unknown department is a free 400 INVALID_PARAM.

department

Amazon name

appliances

Appliances

arts-crafts

Arts, Crafts & Sewing

audible

Audible Books & Originals

automotive

Automotive

baby

Baby Products

beauty

Beauty & Personal Care

books

Books

music

CDs & Vinyl

cell-phones

Cell Phones & Accessories

fashion

Clothing, Shoes & Jewelry

collectibles

Collectibles & Fine Art

electronics

Electronics

everything-else

Everything Else

gift-cards

Gift Cards

grocery

Grocery & Gourmet Food

health

Health & Household

home

Home & Kitchen

industrial

Industrial & Scientific

movies-tv

Movies & TV

musical-instruments

Musical Instruments

office

Office Products

garden

Patio, Lawn & Garden

pets

Pet Supplies

software

Software

sports

Sports & Outdoors

tools

Tools & Home Improvement

toys

Toys & Games

video-games

Video Games

What comes back

data has page, limit, next_page (null on the last page) and deals. Each deal has position (its place in the whole list), asin, title, url, image, brand and brand_id, price (the deal price) and list_price, percent_off, deal_type (best_deal or lightning_deal), badge (the deal's message, such as Limited time deal or Limited Prime deal), deal_state, ends_at and claimed_percent for lightning deals, rating, reviews_count and variations (how many ASINs the product family has). A value Amazon does not show is null.

With include_filters=true, filters lists the departments, brands (the top 20), ratings and access programs of the deals that match, each as { id, label }, where id is what the parameter takes. Prices are the deal page's: a Limited Prime deal price is for Prime members. Deals carry no stock count; for the buy box, stock and delivery, send the ASINs to POST /v1/products.

Full reference → GET /v1/structured/amazon/deals

Updated