Saks Fifth Avenue

Saks Fifth Avenue Category API

Browse one saksfifthavenue.com (US) category by its /c/ path or URL (women's dresses, men's sweaters, beauty...): 24 grid positions per page with the search sorts and filters (designer, color, size, any price range, on sale, new arrivals, 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 the category's name, path, URL and breadcrumbs, total, total_pages, next_start and the facets with counts. Costs 2 credits per request.

POST/api/v1/saks/category

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

pathstring

A Saks category path (/c/...): from a category URL, a suggestions categories[].path or a breadcrumb. path or url is required.

Example: /c/women-s-apparel/dresses

urlstring

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

Example: https://www.saksfifthavenue.com/c/women-s-apparel/dresses

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: {"refMaterial": "Silk"}

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

res = client.saks.category(path="/c/women-s-apparel/dresses", on_sale=True, size="X-Small, 2", sort="price_low_to_high")["data"]

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

Response

"total": 11341,

"page": 1,

"total_pages": 473,

"per_page": 24,

"start": 0,

"next_start": 22,

"sort": "featured",

"count": 22,

"applied_filters": {},

"currency": "USD"

"response_time": 8022

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") res = client.saks.category(path="/c/women-s-apparel/dresses", on_sale=True, size="X-Small, 2", sort="price_low_to_high")["data"] print(res["category"]["name"], res["total"]) for item in res["items"]: print(item["brand"], item["title"], item["price"], item["regular_price"], item["percent_off"])