Macy's

Macy's Store Availability API

Can a macys.com product be picked up in store? Near a ZIP, a point or a city: every Macy's store with whether it can hand the product over and how many of the product's items it has available. At one store (store_id): the store's hours, pickup cut-off and pickup options, and for every variant (UPC, color, size) whether it can be picked up and whether it is in the store. Macy's publishes no unit quantities. Costs 1 credit per request.

POST/api/v1/macys/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

product_idinteger

Macy's product id. Pass product_id or url.

Example: 25822310

urlstring

A macys.com product URL (its ID= is used).

store_idinteger

One store, for per-variant pickup and in-store flags: a store_id from /api/v1/macys/stores (4592 is State Street, Chicago). Instead of a location.

Example: 4592

zipstring

US ZIP code to search around.

Example: 10001

latnumber

Latitude, with lng, instead of zip.

Example: 37.7879

lngnumber

Longitude, with lat.

Example: -122.4075

citystring

US city, with state, instead of zip.

Example: Atlanta

statestring

2-letter US state code, with city.

Example: GA

radiusinteger

Search radius in miles, 1-100. Defaults to 100.

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

# Per variant at one store
res = client.macys.store_availability(product_id=25822310, store_id=4592)["data"]

print(res["store"]["name"], res["pickup_available_count"], "of", res["variant_count"], "variants for pickup")
for v in res["variants"]:
    if v["pickup_available"]:
        print(v["upc"], v["color"], v["size"])

Response

"requested_id": 25822310,

"product_id": 25822310,

"title": "Men's Standard Straight Fit Stretch Denim Jeans",

"brand": "Calvin Klein",

"url": "https://www.macys.com/shop/product/calvin-klein-mens-straight-fit-stretch-denim-jeans?ID=25822310",

"variant_count": 60,

"pickup_available_count": 31,

"in_store_available_count": 43,

"response_time": 4368

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") # Per variant at one store res = client.macys.store_availability(product_id=25822310, store_id=4592)["data"] print(res["store"]["name"], res["pickup_available_count"], "of", res["variant_count"], "variants for pickup") for v in res["variants"]: if v["pickup_available"]: print(v["upc"], v["color"], v["size"])