Macy's Scraper

Scrape Macy's — search products by keyword, browse a department/category listing, or fetch full product detail (variants, prices, sizes, colors, images, ratings) by product ID. No login, cookies, proxy, or API key required.

What this actor does

• Three modes: search (keyword), category (department/category browse), product (full detail by ID)
• Sort orders: Featured, Price Low→High, Price High→Low, Top Rated, Best Sellers, New Arrivals
• Filters: min/max price, min rating, on-sale-only, brand contains, exclude sponsored/featured listings
• Full product detail: every color/size/SKU variant with its own price and stock status, description, category, images, aggregate rating
• Empty fields are omitted — every field in the output is real data, never null or placeholders

Output per product (search / category mode)

• productId — Macy's numeric product ID
• title, brand
• url — canonical product page URL
• imageUrl
• price, currency, originalPrice, discountPercent (when on sale)
• ratingValue, reviewCount
• badge — promotional tag shown on the listing tile (e.g. Clearance, Limited-Time Special, Today Only), when present
• promoBadge — loyalty/rewards promo text shown on the listing tile (e.g. $10 Star Money per $50), when present
• isSponsored — true if this is a paid-placement tile Macy's inserts into the listing grid out of the requested sort order
• sourceMode, sourceQuery — which mode/query produced this record
• sourceUrl — the listing page URL this record was found on
• recordType: "product", scrapedAt

Output per product (product mode — full detail)

• productId, title, brand, category, description
• breadcrumbs[] — full category navigation trail (e.g. ["Women's Fashion, Shoes & Accessories", "Flats"]), more granular than category
• features[] — bulleted product detail specs from the page (material, closure type, fit, care instructions, style number), when present
• images[], imageUrl (first image)
• variants[] — each with sku, color, size, price, inStock
• colors[], sizes[] — unique lists across all variants
• minPrice, maxPrice, price (= minPrice), currency
• originalPrice, discountPercent — pre-sale price and markdown %, when the product is discounted
• inStock — true if any variant is in stock
• ratingValue, reviewCount
• ratingDistribution[] — per-star review-count breakdown, each {stars, count} (5-star down to 1-star), when reviews exist
• fitInsights[] — crowd-sourced fit ratings, each {aspect, rating} (e.g. {"aspect": "Runs narrow/runs wide", "rating": "Neutral"}), when enough reviews carry fit data (mostly footwear/apparel)
• reviews[] — (only when includeReviews=true) each with author, date, title, text, ratingValue, bestRating
• url, sourceUrl — canonical product page URL
• recordType: "productDetail", scrapedAt

Input

Field	Type	Default	Description
mode	select	search	search / category / product
searchQuery	string	womens dresses	Free-text keyword (mode=search)
categoryPath	select/text	–	Department/category path (mode=category), e.g. womens-clothing, mens/shoes?id=55822, or paste any Macy's category URL
productIds	array	–	Numeric product IDs or product page URLs (mode=product)
sortBy	select	ORIGINAL	Sort order for search/category listings
minPrice / maxPrice	integer	–	Price range filter (USD)
minRating	integer	–	Minimum review rating (0–5)
onSaleOnly	boolean	false	Only emit discounted products
excludeSponsored	boolean	false	Drop paid-placement/"featured" tiles that ignore the requested sort order
brand	string	–	Case-insensitive brand substring filter
includeReviews	boolean	false	Include a reviews[] array (mode=product)
maxItems	integer	50	Hard cap (1–1000)

Example: search for running shoes under $100, top rated

{
  "mode": "search",
  "searchQuery": "running shoes",
  "sortBy": "TOP_RATED",
  "maxPrice": 100,
  "maxItems": 50
}

Example: browse men's shoes on sale

{
  "mode": "category",
  "categoryPath": "mens/shoes?id=55822",
  "onSaleOnly": true,
  "maxItems": 60
}

Example: full product detail lookup

{
  "mode": "product",
  "productIds": ["20663500", "https://www.macys.com/shop/product/easy-street-womens-fresh-slip-on-sneakers?ID=11081206"],
  "includeReviews": true
}

Use cases

• Price monitoring — track sale prices and discount percentages over time
• Assortment research — pull a full department listing to analyze brand mix and pricing
• Product data enrichment — resolve a list of product IDs into full variant/SKU-level catalog data
• Competitive intelligence — compare pricing and availability across brands and categories
• Size/color availability tracking — monitor stock status per SKU for a watched product

FAQ

Do I need to log in or provide cookies? No — every mode works against Macy's public, unauthenticated pages.

What's the difference between search and category mode? search runs a free-text keyword query (like the site's search bar). category browses a fixed department/category listing (like clicking through the site's navigation menu).

Can I use a category URL that isn't in the dropdown? Yes — the dropdown lists common departments for convenience, but categoryPath accepts any macys.com/shop/... category path or full URL.

Why does product mode return more fields than search/category? Listing pages only expose a summary card. Product-detail mode fetches the individual product page, which contains the full JSON-LD dataset — every color/size variant, SKU, stock status, and description.

Are prices real-time? Yes — every run fetches Macy's live pages; prices, discounts, and stock status reflect what's on the site at scrape time.

What currency are prices in? USD — Macy's is a US retailer.

Is there a rate limit? The actor paces its requests to Macy's public pages so it stays reliable without needing a proxy.