Macy's Product Data API - Search, Prices, Reviews, Store Pickup

Search Macy's (macys.com, US, prices in USD) by keyword, or browse a category by id or URL, a brand's page by its page id or URL, or one of Macy's sale sections (all Sales & Offers, Clearance & Closeout, Today Only, Last Act final-sale markdowns, Limited-Time Specials, Black Friday Deals), 60 organic products per page, sorted by featured, price, top rated, best sellers or newest, filtered by brand, color, special offer, any price range (not only the site's price buckets), items available for pickup at one store, or any other facet the response lists (gender, size, fit, discount range, customer rating...): product id, title, brand, URL, image, current price (and the top of the range when an item sells at a range), regular price, sale price, percent off, price label (Sale, Now, Only, Your Choice), on-sale flag, sale end date, deal label (Black Friday Deal, Clearance, LAST ACT, Limited-Time Special...), promotions, rating, review count, colors and a sponsored flag, plus the total, total pages, the facets with counts and the filters Macy's applied. Read one product by id or URL with its full title, brand page id, type, description, bullets, category path, the price block with the date the price is valid until, promotions, rating, review count, the written-review count, the star histogram, recommended counts, the fit slider, the AI review summary, the "N customers purchased" line, question and answer counts, images, every color with its own price, sizes, and every variant with UPC, color, size, availability, availability message, low-stock flag and ship days; or price up to 10 products in one call. Page Macy's own reviews up to 100 at a time, sorted or filtered to one star rating or a word. Find Macy's stores near a ZIP, a latitude/longitude or a city and state with today's and tomorrow's hours, curbside hours and the same-day pickup cut-off. Check which stores near you can hand a product over for pickup, or, at one store, which variants can be picked up and which are in the store. Pull the search box's autocomplete. All endpoints return structured JSON, 1 credit each.

See also: for Nordstrom (department-store fashion with per-size stock and units available to ship) use the nordstrom-product-data skill; for the cross-retailer price view use google-shopping-api.

When to trigger

Use this skill when the user asks to:

• Build a Macy's price tracker or sale alert: poll a list of products (up to 10 per /product call) and detect price drops, new sale prices or a deal label appearing
• Find clothing, shoes, handbags, beauty, home or any product at Macy's by keyword and compare prices, percent off, ratings and brands
• List Macy's clearance, Last Act, Today Only, Limited-Time Special or Black Friday deals, sorted by price or filtered by brand, size or discount range
• Browse a Macy's category or a brand's whole Macy's catalog (Calvin Klein, Levi's...) with prices and sale end dates
• Check whether a Macy's item can be picked up in store near a ZIP code or city, or which sizes and colors can be picked up at one store
• Read the UPC, sizes, colors and per-variant availability of a Macy's product for matching against other retailers
• Find Macy's stores near a ZIP code, a point or a city with today's and tomorrow's hours and the pickup cut-off
• Read what Macy's reviewers say, pull only the 1-star reviews, reviews with photos, or reviews that mention a word, and how a product fits
• Get Macy's search autocomplete suggestions for keyword research