Macy's Search Scraper

Scrapes product listings from Macy's.com using a search URL. It handles pagination automatically and extracts detailed product data.

Overview

This actor is designed for scraping product listings from Macy's search results or category pages. You provide a URL, and it navigates through all pages, collecting product information into a structured dataset. It's useful for building product catalogs, monitoring prices, or conducting market research.

Key Features

• URL-Based Scraping: Starts from a complete Macy's search or category URL.
• Automatic Pagination: Clicks through pages and "Load More" buttons until it reaches the end of results or your item limit.
• Comprehensive Data Extraction: Captures a wide range of product details for each item.
• Smart Deduplication: Automatically filters out duplicate products based on their unique URLs.

How to Use

1. Get a Search URL: Go to Macy's.com, perform a search or browse a category, apply any desired filters (price, brand, etc.), and copy the full URL from your browser.
2. Configure the Actor: Provide the copied URL to the searchUrl input. Optionally, set a maxItems limit.
3. Run the Actor: Execute it. It will scrape the listing pages and output the product data.

Example Search URLs:

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

Input

Configure the actor using these input parameters:

Output

The actor outputs a dataset where each item is a JSON object representing a product. Data is saved incrementally during the run.

Output Fields:
* searchUrl: The original URL you provided.
* url: Direct link to the product's detail page.
* title: Full product name.
* brand: Brand name.
* badge: Promotional badge text (e.g., "Sale", "Black Friday Deal").
* image: URL of the main product image.
* price: Current selling price (as a numeric string).
* priceOrigin: Original price before discount (numeric string).
* priceDiscount: Discount percentage (e.g., "60%").
* rating: Customer rating score out of 5 (numeric).
* reviewsCount: Total number of customer reviews (integer).
* colors: Array of available color names (optional field).
* scrapedAt: ISO 8601 timestamp of when the item was scraped.

Example Output Item:

{
  "searchUrl": "https://www.macys.com/shop/featured/coat?ss=true",
  "url": "https://www.macys.com/shop/product/example-coat",
  "title": "Women's Single-Breasted Belted Coat",
  "brand": "CeCe",
  "badge": "Black Friday Deal",
  "image": "https://slimages.macysassets.com/is/image/...",
  "price": "941.28",
  "priceOrigin": "2,353.38",
  "priceDiscount": "60%",
  "rating": 4.6,
  "reviewsCount": 7,
  "scrapedAt": "2025-11-12T07:47:58.049Z"
}

Notes & Limitations

• Data Scope: It scrapes data available on listing pages (search results, category pages). It does not navigate into individual product detail pages for additional information.
• Field Availability: Some products may lack data for optional fields like rating, reviewsCount, or colors.
• Performance: The actor handles network delays gracefully. However, rate limiting may affect very large scraping jobs.
• Requirements: A valid, filterable Macy's search URL is required to start the scrape.