Saks Fifth Avenue

Saks Fifth Avenue Search API

Search saksfifthavenue.com (US) by keyword: 24 grid positions per page, sorted featured, best sellers, newest, by price, sale first or designer A-Z, and filtered by designer, color, size, any price range, on sale, new arrivals or any other 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, limited-inventory flag, promotions and colors. Also returns total, total_pages, start and next_start, the facets with a count per value and the site's price buckets. A keyword the site sends to a designer or category page comes back as redirected_to. Costs 2 credits per request.

POST/api/v1/saks/search

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

querystringrequired

Search keywords, 1-200 characters.

Example: coat

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")

res = client.saks.search(query="coat", on_sale=True, size="Medium", sort="sale_first")["data"]

print(res["total"], "items over", res["total_pages"], "pages")
for item in res["items"]:
    print(item["id"], item["brand"], item["title"], item["price"], item["regular_price"], item["percent_off"])

Response

"query": "coat",

"redirected_to": null,

"total": 2328,

"page": 1,

"total_pages": 97,

"per_page": 24,

"start": 0,

"next_start": 24,

"sort": "featured",

"count": 24,

"applied_filters": {},

"currency": "USD"

"response_time": 4946

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") res = client.saks.search(query="coat", on_sale=True, size="Medium", sort="sale_first")["data"] print(res["total"], "items over", res["total_pages"], "pages") for item in res["items"]: print(item["id"], item["brand"], item["title"], item["price"], item["regular_price"], item["percent_off"])