Saks Fifth Avenue

Saks Fifth Avenue Store Availability API

Can one Saks Fifth Avenue variant be picked up near a ZIP code or a point? For each pickup store within the radius: the site's availability message (In Stock, Limited Inventory, Not Available), in_stock and limited flags, units_at_store when the site gives a count (it does for stores that have the item, otherwise null), and the store's address, distance and today's hours. Needs a variant sku from the product endpoint. Costs 2 credits per request.

POST/api/v1/saks/store-availability

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

skustring | integerrequired

A variant sku: a product's variants[].sku, or a product's id after picking color + size. A master product id returns no availability.

Example: 10781654

zipstring

US ZIP code to search around. zip or lat + lng is required.

Example: 10022

latnumber

Latitude, with lng, instead of zip.

Example: 40.758

lngnumber

Longitude, with lat.

Example: -73.9855

radiusinteger

Search radius in miles: 15, 30, 50, 100 or 300. Defaults to 50.

Example: 50

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

# 1. Resolve the variant: color + size gives its sku as id.
v = client.saks.product(product_id="0400019127312", color="BLUE OPAL", size="4")["data"]

# 2. Ask the pickup stores near a ZIP.
res = client.saks.store_availability(sku=v["id"], zip="10022")["data"]
for s in res["stores"]:
    print(s["name"], s["availability_message"], s["in_stock"], s["units_at_store"])

Response

"sku": "10781654",

"radius_miles": 50,

"count": 2,

"in_stock_count": 2,

"response_time": 3067

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") # 1. Resolve the variant: color + size gives its sku as id. v = client.saks.product(product_id="0400019127312", color="BLUE OPAL", size="4")["data"] # 2. Ask the pickup stores near a ZIP. res = client.saks.store_availability(sku=v["id"], zip="10022")["data"] for s in res["stores"]: print(s["name"], s["availability_message"], s["in_stock"], s["units_at_store"])