Saks Fifth Avenue

Saks Fifth Avenue Product API

One saksfifthavenue.com (US) product by id or URL: title, brand, type (master or variant), UPC for a variant, the price block (current, list and sale price, percent off, on-sale flag), new, sale, clearance and final-sale flags, badge, returnable, promotions, description, style code, images, every color and size with its availability, every SKU with its online warehouse unit count, in-stock and available counts, availability (units available to sell, message, restock date), available in store, marketplace, drop ship, preorder, merchandising attributes, the average star rating and review count. Add color + size, or pass a variant sku, for one variant. Costs 2 credits per request.

POST/api/v1/saks/product

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

product_idstring | integer

A Saks product id (6-14 digits): a search result's id, the number at the end of a product URL, or a variant sku. product_id or url is required.

Example: 0400019127312

urlstring

A saksfifthavenue.com product URL. Its trailing id is used, and a color or size the link selects is kept. Alternative to product_id.

Example: https://www.saksfifthavenue.com/product/kay-unger-mariah-jacquard-textured-gown-0400019127312.html

colorstring

Pick one color, a colors[].value. A value the product does not have is a 400 that lists its colors.

Example: BLUE OPAL

sizestring

Pick one size, a sizes[].value. With color, the answer is that variant: its sku is id, with its UPC and stock.

Example: 4

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

p = client.saks.product(product_id="0400019127312")["data"]
print(p["brand"], p["title"], p["price"], p["regular_price"], p["on_sale"], p["is_final_sale"])
print(p["in_stock_count"], "of", p["variant_count"], "SKUs in stock")
for v in p["variants"]:
    print(v["sku"], v["warehouse_units"])

# One variant: its sku is the id, ready for store-availability.
v = client.saks.product(product_id="0400019127312", color="BLUE OPAL", size="4")["data"]
print(v["id"], v["upc"], v["availability"])

Response

"requested_id": "0400019127312",

"id": "0400019127312",

"master_id": "0400019127312",

"type": "master",

"title": "Mariah Jacquard Textured Gown",

"brand": "Kay Unger",

"upc": null,

"url": "https://www.saksfifthavenue.com/product/kay-unger-mariah-jacquard-textured-gown-0400019127312.html",

"price": 348,

"price_max": null,

"regular_price": 348,

"regular_price_max": null,

"sale_price": null,

"on_sale": false,

"percent_off": null,

"currency": "USD",

"is_new": false,

"is_sale": false,

"is_clearance": false,

"is_final_sale": false,

"badge": "BEST SELLER",

"returnable": true,

"description": "Kay Unger's Mariah gown spotlights a tonal textured jacquard design and pleated A-line skirt. This sleeveless style is finished with a banded waist and side pockets. V-neck Sleeveless Banded waist Side-seam pockets Back zip closure 80% polyester/20% nylon Lining: 100% polyester Dry clean Imported SIZE & FIT About 60" from shoulder to hem Model measurements: 5'10" tall Model is wearing a US size 4",

"style_code": "0400019127312",

"options": [],

"variant_count": 60,

"in_stock_count": 39,

"available_count": 44,

"available": true,

"ready_to_order": false,

"available_in_store": true,

"marketplace": false,

"drop_ship": true,

"preorder": false,

"purchase_limit": null,

"rating": 5,

"review_count": 1

"response_time": 1067

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") p = client.saks.product(product_id="0400019127312")["data"] print(p["brand"], p["title"], p["price"], p["regular_price"], p["on_sale"], p["is_final_sale"]) print(p["in_stock_count"], "of", p["variant_count"], "SKUs in stock") for v in p["variants"]: print(v["sku"], v["warehouse_units"]) # One variant: its sku is the id, ready for store-availability. v = client.saks.product(product_id="0400019127312", color="BLUE OPAL", size="4")["data"] print(v["id"], v["upc"], v["availability"])