Macy's

Macy's Deals API

Macy's sale listings as JSON: all Sales & Offers, Clearance & Closeout, Today Only, Last Act (final-sale markdowns), Limited-Time Specials or Black Friday Deals, 60 organic items per page with the same sorts and filters as search (brand, color, price range, store pickup, any facet). Each item has id, title, brand, URL, image, current, regular and sale price, percent off, price label, on-sale flag, sale end date when Macy's states one, deal label, promotions, rating, review count, colors and a sponsored flag. Also returns total, total_pages and the facets with counts, including the Discount Range facet. Costs 1 credit per request.

POST/api/v1/macys/deals

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

typestring

sale (all Sales & Offers, default), clearance, today_only, last_act (final-sale markdowns), limited_time_special or black_friday.

Example: clearance

pageinteger

Results page, 1-based, up to 1000. Defaults to 1. 60 organic items per page.

Example: 1

sortstring

featured (default), price_low_to_high, price_high_to_low, top_rated, best_sellers or newest. The total can differ between sorts, as it does on macys.com.

brandstring | string[]

Only these brands, spelled as the BRAND facet lists them (Levi's, Calvin Klein). A list of up to 20 matches any of them.

Example: Levi's

colorstring | string[]

Only these colors, as the COLOR_NORMAL facet lists them (Black, Blue, Red...). A list matches any of them.

Example: Blue

min_pricenumber

Lowest price in US dollars. Any bound works, not only the site's price buckets; an item sold at a price range matches when its range overlaps.

Example: 50

max_pricenumber

Highest price in US dollars. Either bound can be sent alone.

Example: 100

pickup_store_idinteger

Only items available for pickup at this store: a store_id from /api/v1/macys/stores (4592 is State Street, Chicago).

Example: 4592

filtersobject

Any other facet from a previous response's facets list: its name to one value or a list, up to 10 facets and 20 values each, e.g. {"GENDER": "Women", "CUSTRATINGS": "4 stars & up"}.

Example: {"GENDER": "Women"}

include_sponsoredboolean

Keep the ad-only sponsored tiles, flagged is_sponsored. Defaults to false: they are dropped and counted in sponsored_dropped. Organic items that also hold a paid slot are always kept, flagged is_sponsored.

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

res = client.macys.deals(type="clearance", filters={"PRICE_DISCOUNT_RANGE": "70_PERCENT_ off & more"}, sort="best_sellers")["data"]

print(res["label"], res["total"], "items at 70% off or more")
for item in res["items"]:
    print(item["id"], item["brand"], item["title"], item["price"], item["regular_price"], item["percent_off"])

Response

"type": "clearance",

"label": "Clearance & Closeout",

"total": 23124,

"page": 1,

"total_pages": 386,

"per_page": 60,

"sort": "featured",

"count": 60,

"sponsored_dropped": 4,

"applied_filters": [],

"currency": "USD"

"response_time": 4314

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") res = client.macys.deals(type="clearance", filters={"PRICE_DISCOUNT_RANGE": "70_PERCENT_ off & more"}, sort="best_sellers")["data"] print(res["label"], res["total"], "items at 70% off or more") for item in res["items"]: print(item["id"], item["brand"], item["title"], item["price"], item["regular_price"], item["percent_off"])