🛍️ Macy's Search Scraper

This actor allows you to scrape products from Macy's.com by providing a search URL. It automatically handles pagination and extracts comprehensive product information including images, prices, brand details, ratings, reviews, and promotional badges.

Features

• URL-based Scraping: Extract products by providing a complete Macy's search URL
• Automatic Pagination: Automatically clicks through pages and loads more products until reaching the end or max items limit
• Comprehensive Product Data: Extract detailed information about each product including:
  • Product URLs and titles
  • Brand names
  • Product images
  • Current prices, original prices, and discount percentages
  • Customer ratings and review counts
  • Promotional badges (Black Friday Deal, Sale, etc.)
  • Available color options
• Smart Deduplication: Automatically removes duplicate products based on product URLs

Input Parameters

Field	Type	Required	Description
searchUrl	string	Yes	Complete Macy's search URL to scrape
maxItems	integer	No	Maximum number of products to fetch (default: unlimited)
proxyConfiguration	object	No	Proxy settings for the actor (optional)

How to Get Search URL

1. Go to Macy's.com
2. Use the search bar or browse categories to find products
3. Apply any filters you want (price range, brand, size, color, etc.)
4. Copy the complete URL from your browser's address bar
5. Paste it into the searchUrl field

Example search URLs:

https://www.macys.com/shop/featured/coat?ss=true
https://www.macys.com/shop/product/womens-dresses
https://www.macys.com/shop/search?keyword=handbag

Output

The output is a dataset of product objects, each containing:

• searchUrl: The original search URL used
• url: Direct link to the product detail page
• title: Full product name
• brand: Brand name
• badge: Promotional badge text (e.g., "Black Friday Deal", "Sale")
• image: URL of the product image
• price: Current price (numeric value)
• priceOrigin: Original price before discount (numeric value)
• priceDiscount: Discount percentage (e.g., "60%")
• rating: Customer rating out of 5 (numeric)
• reviewsCount: Number of customer reviews (integer)
• colors: Array of available color options (optional)
• scrapedAt: Timestamp of when the product was scraped

Example output:

[
  {
    "searchUrl": "https://www.macys.com/shop/featured/coat?ss=true",
    "url": "https://www.macys.com/shop/product/cece-womens-single-breasted-belted-coat?ID=21998689",
    "title": "Women's Single-Breasted Belted Coat",
    "brand": "CeCe",
    "badge": "Black Friday Deal",
    "image": "https://slimages.macysassets.com/is/image/MCY/products/2/optimized/32431162_fpx.tif?qlt=80,0&resMode=sharp2&op_usm=1.75,0.3,2,0&fmt=jpeg&wid=342&hei=417",
    "price": "941.28",
    "priceOrigin": "2,353.38",
    "priceDiscount": "60%",
    "rating": 4.6,
    "reviewsCount": 7,
    "scrapedAt": "2025-11-12T07:47:58.049Z"
  },
  ...
]

Use Cases

• Price monitoring and comparison
• Product catalog building
• Market research and trend analysis
• Competitor analysis for retail brands
• Inventory tracking
• Review and rating analysis
• Promotional offer tracking
• Product availability monitoring

Notes

• Results are saved incrementally as they are found
• All timestamps are in ISO 8601 format
• Price values are extracted as numeric strings
• Ratings are on a scale of 1-5
• The actor handles network delays and timeouts gracefully
• Some products may not have all fields populated (e.g., ratings, colors)

Limitations

• Requires a valid Macy's search URL with proper filters
• Cannot scrape product details from detail pages (only listing data)
• Rate limiting may apply if scraping very large datasets
• Some dynamic content may require additional wait time
• Product availability and stock information is not captured

---

Start scraping products from Macy's today!