Saks Fifth Avenue

Saks Fifth Avenue Brand API

Browse one designer's saksfifthavenue.com (US) page by slug (from the designers endpoint) or URL: 24 grid positions per page, sorted featured, best sellers, newest, by price or sale first, and filtered by color, size, any price range, on sale, new arrivals or any other facet. Each item has id, title, URL, image, current, regular and sale price, percent off, review count, badge, final sale, clearance and returnable flags and promotions. Also returns the brand's name, slug and URL, total, total_pages, next_start and the facets with counts. Costs 2 credits per request.

POST/api/v1/saks/brand

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

brandstring

A designer slug from /api/v1/saks/designers (gucci, chloé, alice-olivia). A plain name is slugified. brand or url is required.

Example: gucci

urlstring

A saksfifthavenue.com /brand/ URL. Filters, sort and page already in the URL are kept. Alternative to brand.

Example: https://www.saksfifthavenue.com/brand/gucci

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: {"refCategory": "Shoes"}

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

# A designer sale tracker: one designer's sale items, sale-first, every page.
start, items = 0, []
while start is not None:
    res = client.saks.brand(brand="gucci", on_sale=True, start=start)["data"]
    items += res["items"]
    start = res["next_start"]

for item in items:
    print(item["id"], item["title"], item["price"], item["regular_price"], item["percent_off"])

Response

"total": 682,

"page": 1,

"total_pages": 29,

"per_page": 24,

"start": 0,

"next_start": 24,

"sort": "featured",

"count": 24,

"applied_filters": {},

"currency": "USD"

"response_time": 6915

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") # A designer sale tracker: one designer's sale items, sale-first, every page. start, items = 0, [] while start is not None: res = client.saks.brand(brand="gucci", on_sale=True, start=start)["data"] items += res["items"] start = res["next_start"] for item in items: print(item["id"], item["title"], item["price"], item["regular_price"], item["percent_off"])