Macy's

Macy's Product API

One macys.com (US) product by id or URL, or up to 10 by product_ids in one call: title, brand with its brand page id, type, description, bullets, category path, the price block (current, regular and sale price, percent off, price label, on-sale flag, sale end date, deal label), promotions, rating, review count and written-review count, star histogram, recommended counts, fit slider, AI review summary, purchased message, question and answer counts, images, colors with each color's price, sizes and every variant with UPC, color, size, availability message, low-stock flag and ship days. Costs 1 credit per request, whatever the number of ids.

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

Macy's product id: a search result's id, or the ID= number in a macys.com product URL.

Example: 25822310

urlstring

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

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

product_idsinteger[] | string

Up to 10 product ids in one call, as an array or a comma-separated string, instead of product_id or url. Returns Macy's summary view of each.

Example: [25822310, 719388, 19206874]

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

p = client.macys.product(product_id=25822310)["data"]

print(p["full_title"], p["price"], "reg", p["regular_price"], p["price_label"], "until", p["sale_ends"])
print(p["review_count"], "ratings,", p["text_review_count"], "written", p["rating_distribution"])
for v in p["variants"]:
    print(v["upc"], v["color"], v["size"], v["availability_message"])

Response

"requested_id": 25822310,

"id": 25822310,

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

"full_title": "Calvin Klein Men's Standard Straight Fit Stretch Denim Jeans",

"brand": "Calvin Klein",

"brand_page_id": 337747,

"brand_url": "https://www.macys.com/shop/brands/calvin-klein?id=337747",

"type": "JEANS",

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

"description": "Crafted from comfort-stretch denim, these Calvin Klein straight-fit jeans offer lasting flexibility and all-day comfort. Featuring a timeless straight-leg silhouette and signature logo details, they bring together classic style and iconic brand appeal.",

"price": 59.4,

"price_max": 71.4,

"regular_price": 99,

"regular_price_max": 119,

"sale_price": 59.4,

"percent_off": 40,

"percent_off_max": null,

"price_label": "Sale",

"set_value": null,

"on_sale": true,

"sale_ends": "2026-11-12",

"deal_label": null,

"currency": "USD",

"price_valid_until": "2026-11-12",

"promotions": [],

"rating": 4.5,

"review_count": 55,

"text_review_count": 32,

"recommended_count": 14,

"not_recommended_count": 2,

"review_summary": "* Customers frequently praise the comfortable feel of the denim. * Many reviewers find the fit to be accurate and true to size. * The jeans are noted for their high-quality material and durable construction. * Customers appreciate the versatile style for various occasions.",

"purchased_message": "859 customers purchased",

"questions_count": 0,

"answers_count": 0,

"available": true,

"size_label": "Waist",

"variant_count": 60,

"response_time": 8156

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") p = client.macys.product(product_id=25822310)["data"] print(p["full_title"], p["price"], "reg", p["regular_price"], p["price_label"], "until", p["sale_ends"]) print(p["review_count"], "ratings,", p["text_review_count"], "written", p["rating_distribution"]) for v in p["variants"]: print(v["upc"], v["color"], v["size"], v["availability_message"])