Macy's Product Scraper

What does Macy's Product Scraper do?

Macy's Product Scraper extracts product data from Macys.com - keyword search results and full product detail pages - anonymously, no login, no Macy's account, no API key. Two operations live in one actor: search for products by keyword, or look up full detail for one or many product IDs.

Macy's server-renders its site as a Nuxt 3 app and embeds the exact structured data (price, rating, stock, images, breadcrumbs) that powers its own product cards as JSON in every page. This Actor reads that embedded JSON directly instead of scraping visible text, so extraction stays accurate even as visual page markup changes.

Why use this Actor?

• Price tracking - schedule productDetails on a cron and diff consecutive runs to catch sales and restocks.
• Market research / assortment mapping - search gives you ranked results for any keyword, with price, rating, review count, and sale/discount info.
• Batch, one start fee - pass a list of keywords or product IDs and one run covers all of them.

How to use it

1. Pick an Operation: Product Search or Product Details.
2. Fill the matching field:
   • Search → query (e.g. shoes) or queries for a batch.
   • Product Details → productId (e.g. 25155177) or a full product URL, or productIds for a batch.
3. Optionally set sortBy.
4. Click Start.

There is no page cap on search - it always follows a query through to Macy's own last reported page (read directly from the site's own pagination metadata, not estimated). Batch a lot of keywords and this can produce a very large run; that's intentional, not a bug.

Batch fields (queries/productIds) win over their singular counterparts when filled; duplicates and blanks are dropped automatically.

Input

Field	Type	Description
operation	string (required)	One of: search, productDetails.
query / queries	string / array	Search keyword(s). Required by search.
productId / productIds	string / array	A Macy's numeric product ID (e.g. 25155177) or a full product URL. Used by productDetails.
sortBy	string	ORIGINAL (default), PRICE_LOW_TO_HIGH, PRICE_HIGH_TO_LOW, TOP_RATED, BEST_SELLERS, NEW_ITEMS. Applies to search.
proxyConfiguration	object	A residential proxy is strongly recommended for sustained volume.

Why no ZIP code / session priming?

Unlike some large retailers, a plain, cookie-less request to Macy's search and product pages already returns real prices and stock status - live-verified 2026-08-24 on multiple categories (shoes, blenders) with no cookies set at all. So this Actor skips the session-priming step some other retail scrapers need.

Product ID lookup

Macy's product URLs look like /shop/product/{cosmetic-slug}?ID={id} - only the numeric ID matters. A request with any slug and a real ID 301-redirects to the canonical URL for that ID (live-verified 2026-08-24: a nonsense slug + a real ID still landed on the correct product). So productId/productIds accepts either a bare ID or a full URL; the slug in a pasted URL doesn't need to be exact.

Output

One flat row per item. Search rows carry search-result fields; product-detail rows carry the full page (description, bullet points, available colors/sizes, category breadcrumb). Every row has _operation (which mode produced it) and status (success or error) so you can split/filter a mixed export.

Search row example:

{
    "_operation": "search",
    "productId": "25155177",
    "title": "Women's Mavis High Top Wedge Sneakers",
    "brand": "Steve Madden",
    "price": 159,
    "listPrice": null,
    "onSale": false,
    "percentOff": null,
    "currency": "USD",
    "rating": 4.6,
    "reviewCount": 176,
    "available": true,
    "colorCount": 8,
    "image": "https://slimages.macysassets.com/is/image/MCY/products/8/optimized/35037348_fpx.tif?qlt=80",
    "productUrl": "https://www.macys.com/shop/product/steve-madden-womens-mavis-high-top-lace-up-wedge-sneakers?ID=25155177",
    "query": "shoes",
    "status": "success"
}

Product detail row example:

{
    "_operation": "productDetails",
    "productId": "25155177",
    "title": "Women's Mavis High Top Wedge Sneakers",
    "brand": "Steve Madden",
    "description": "...",
    "bulletText": ["Wedge heel: 1\"", "Round toe", "Hook-and-loop closure"],
    "price": 159,
    "listPrice": 179,
    "onSale": false,
    "currency": "USD",
    "rating": 4.6,
    "reviewCount": 176,
    "ratingBreakdown": [{ "rating": 5, "count": 136, "percentage": 77.27 }],
    "available": true,
    "colors": ["Taupe Suede", "Black Suede", "White Suede Multi"],
    "sizes": ["5M", "5.5M", "6M"],
    "images": ["https://slimages.macysassets.com/..."],
    "categories": ["Women's Fashion, Shoes & Accessories", "Athletic & Sneakers"],
    "productUrl": "https://www.macys.com/shop/product/steve-madden-womens-mavis-high-top-lace-up-wedge-sneakers?ID=25155177",
    "status": "success"
}

Pricing

This Actor uses pay-per-event pricing - one small run-start charge, then a per-row charge for each search result or product-detail lookup. See the Pricing tab for current rates. Failed lookups land as status: "error" rows and are never charged. There is no page cap - search always runs to Macy's own last reported page for each keyword, so keep your batch size (number of keywords/IDs) in mind to bound spend on a given run.

Limitations

• Only the numbers/text Macy's shows to an anonymous, logged-out visitor are available - no member-only pricing.
• Customer reviews are not part of this Actor - see the companion Macy's Review Scraper.
• minPrice/maxPrice and category-ID filtering are not exposed as inputs: Macy's price-range facet path (/shop/search/Price/{min}|{max}) did not reliably narrow results in live testing (2026-08-24), and category browsing uses a different URL scheme per department that wasn't independently verified end-to-end this session. Keyword search plus sortBy cover the differentially-verified path.
• US site (macys.com) only in this version.
• Macy's page markup/JSON structure can change over time; extraction reads the site's own embedded Nuxt hydration payload (the same data structure that renders the visible page), which is more stable than CSS selectors but not immune to a backend redesign.

FAQ

Does Macy's have a public API? Not one that's open to general scraping/reseller use. This Actor gets you search and product data anonymously, no approval process.

Do I need a Macy's account or API key? No - it runs entirely against Macy's public, logged-out web pages.

A run returns 0 results with no error - why? An unusually narrow keyword can legitimately return nothing, or a run mid-way through a large batch can occasionally hit a rate-limited session - a residential proxy handles this automatically in most cases.

Disclaimer

This Actor is an independent tool, not affiliated with or endorsed by Macy's, Inc. It only accesses data Macy's serves publicly to anonymous visitors. Use it in compliance with Macy's Terms of Use and applicable law in your jurisdiction. Found a bug or have a feature request? Use the Issues tab on this Actor's page.