Saks Fifth Avenue

Saks Fifth Avenue Search Suggestions API

The saksfifthavenue.com search-box suggestions for a partial query: the result count, matching designers, suggested categories (name, parent and a path the category endpoint takes), up to 5 featured products (id, title, brand, URL, image) and the site's popular searches. Costs 2 credits per request.

POST/api/v1/saks/suggestions

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

What the shopper has typed so far, 1-100 characters.

Example: gucci

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

res = client.saks.suggestions(query="gucci")["data"]

print(res["result_count"], res["designers"], res["popular_searches"])
for p in res["products"]:
    print(p["id"], p["title"])

Response

"query": "gucci",

"result_count": 682,

"categories": [],

"response_time": 1057

}