Saks Fifth Avenue

Saks Fifth Avenue Sale & New Arrivals API

Saks Fifth Avenue sale and new-arrival listings: all Sale, Women's Clothing Sale, Men's Sale, Women's New Arrivals or Men's New Arrivals, 24 grid positions per page with the search sorts and filters (designer, color, size, any price range, any facet). Each item has id, title, brand, URL, image, current, regular and sale price, percent off, review count, badge, final sale, clearance and returnable flags and promotions. Also returns total, total_pages, next_start and the facets with counts. Saks lists no clearance or final-sale page. Costs 2 credits per request.

POST/api/v1/saks/deals

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).

Body

application/json

typestring

sale (all sale, default), womens_sale (women's clothing sale), mens_sale, womens_new_arrivals or mens_new_arrivals.

Example: sale

sale — Sale: every sale item (default).
womens_sale — Women's Clothing Sale.
mens_sale — Men's Sale.
womens_new_arrivals — Women's New Arrivals.
mens_new_arrivals — Men's New Arrivals.

brandstring | string[]

Only these designers, spelled as the brand (Designer) facet lists them (Prada, ALICE + OLIVIA). A list of up to 20 matches any of them.

Example: Prada

pageinteger

Results page, 1-based, up to 500. Defaults to 1. 24 grid positions per page.

Example: 1

startinteger

Item offset instead of page (0 to 12,000): pass a previous response's next_start to walk every item without gaps. Send page or start, not both.

Example: 24

sortstring

featured (default, the site's own order), best_sellers, newest, price_high_to_low, price_low_to_high, sale_first or brand_az.

colorstring | string[]

Only these colors, as the colorRefinement facet lists them (Black, Blue, Red...). A list matches any of them.

Example: Black

sizestring | string[]

Only these sizes, spelled as the sizeRefinement facet LABEL lists them ("Medium", "X-Small, 0"). "M" matches nothing. A list matches any of them.

Example: Medium

min_pricenumber

Lowest price in US dollars. Any bound works, not only the site's price buckets.

Example: 500

max_pricenumber

Highest price in US dollars.

Example: 2000

on_saleboolean

Only items on sale (the isSale facet).

new_arrivalsboolean

Only new arrivals (the isNew facet).

filtersobject

Any other facet from a previous response's facets list: its id to one value or a list, up to 10 facets and 20 values each, e.g. {"refGender": "Women's", "refMaterial": "Cashmere"}.

Example: {"refGender": "Women's"}

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

# Designer sale: two designers, deepest prices first.
res = client.saks.deals(type="sale", brand=["Balenciaga", "Gucci"], sort="price_low_to_high")["data"]

print(res["label"], res["total"])
for item in res["items"]:
    print(item["brand"], item["title"], item["price"], item["regular_price"], item["percent_off"])

Response

"type": "sale",

"label": "Sale",

"total": 15390,

"page": 1,

"total_pages": 642,

"per_page": 24,

"start": 0,

"next_start": 24,

"sort": "featured",

"count": 24,

"applied_filters": {},

"currency": "USD"

"response_time": 4927

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") # Designer sale: two designers, deepest prices first. res = client.saks.deals(type="sale", brand=["Balenciaga", "Gucci"], sort="price_low_to_high")["data"] print(res["label"], res["total"]) for item in res["items"]: print(item["brand"], item["title"], item["price"], item["regular_price"], item["percent_off"])