Macys Products ByCategory - Apify Actor Documentation

Overview

The Macys Products ByCategory actor is a powerful web scraping tool that extracts product information from Macy's e-commerce website by category. This actor enables you to efficiently collect product data including prices, descriptions, ratings, and availability across different product categories from one of America's largest department store chains.

Key Features

• Category-based scraping: Extract products from any Macy's product category
• Flexible sorting options: Sort results by price, ratings, popularity, and more
• Multi-region support: Support for different regions and currencies
• Pagination control: Specify page numbers and items per page
• Real-time data: Get up-to-date product information directly from Macy's
• Rate limiting: Built-in delays to ensure respectful scraping

Input Parameters

Required Parameters

Parameter	Type	Description	Default
categoryUrl	String	Full URL of the Macy's category page to scrape	https://www.macys.com/shop/womens/clothing?id=188851
sortBy	String	Sorting method for products (see available options below)	featuredItems

Optional Parameters

Parameter	Type	Description	Default
page	Number	Page number to scrape (for pagination)	1
perPage	Number	Number of products per page	60
regionCode	String	Region code for localized results	US
currencyCode	String	Currency code for pricing	USD

Available Sorting Options

Option Key	Description
featuredItems	Macy's featured/recommended products
priceLowToHigh	Sort by price ascending
priceHighToLow	Sort by price descending
topRated	Sort by customer ratings
bestSellers	Most popular products
newItems	Recently added products

How to Use

1. Basic Usage

{
  "categoryUrl": "https://www.macys.com/shop/womens/dresses?id=5449",
  "sortBy": "featuredItems"
}

2. Advanced Configuration

{
  "categoryUrl": "https://www.macys.com/shop/mens/shoes?id=55637",
  "page": 2,
  "perPage": 40,
  "regionCode": "US",
  "currencyCode": "USD",
  "sortBy": "priceLowToHigh"
}

3. Multiple Pages Scraping

To scrape multiple pages, run the actor multiple times with different page numbers, or modify the input programmatically through Apify's API.

Popular Macy's Categories

Here are some popular category URLs you can use:

• Women's Clothing: https://www.macys.com/shop/womens/clothing?id=188851
• Men's Clothing: https://www.macys.com/shop/mens-clothing?id=1
• Shoes: https://www.macys.com/shop/shoes?id=13616
• Handbags: https://www.macys.com/shop/handbags?id=26846
• Jewelry: https://www.macys.com/shop/jewelry?id=3536
• Home Decor: https://www.macys.com/shop/bed-bath?id=7498
• Beauty: https://www.macys.com/shop/makeup-and-perfume?id=669

Use Cases

1. E-commerce Price Monitoring

• Competitive Analysis: Monitor competitor pricing and product availability
• Price Tracking: Track price changes over time for specific product categories
• Market Research: Analyze pricing trends across different product segments

2. Inventory Management

• Stock Monitoring: Track product availability and stock levels
• New Product Discovery: Identify newly added products in your categories of interest
• Seasonal Analysis: Monitor seasonal product availability and pricing changes

3. Marketing & Business Intelligence

• Product Catalog Creation: Build comprehensive product databases for comparison sites
• Market Gap Analysis: Identify underserved product categories or price ranges
• Customer Behavior Insights: Analyze popular products and trending categories

4. Data Analytics & Research

• Fashion Trend Analysis: Track trending clothing and accessory categories
• Economic Research: Study consumer pricing and product availability patterns
• Academic Research: Gather data for retail and e-commerce studies

5. Automation & Integration

• Dropshipping: Identify products for dropshipping businesses
• API Integration: Feed product data into your own applications or databases
• Report Generation: Create automated reports on product categories and pricing

Output Format

The actor returns structured JSON data containing:

{
  "products": [
    {
      "name": "Product Name",
      "price": "$XX.XX",
      "originalPrice": "$XX.XX",
      "discount": "XX%",
      "rating": "X.X",
      "reviewCount": "XXX",
      "imageUrl": "https://...",
      "productUrl": "https://...",
      "brand": "Brand Name",
      "availability": "In Stock",
      "category": "Category Name"
    }
  ],
  "pagination": {
    "currentPage": 1,
    "totalPages": "XX",
    "totalProducts": "XXXX"
  }
}

Error Handling

The actor includes robust error handling for:

• Invalid category URLs
• Unsupported sorting options
• Network timeouts and connection issues

Performance Tips

1. Optimize Page Size: Use smaller perPage values for faster execution
2. Batch Processing: Process multiple categories in separate actor runs
3. Rate Limiting: The built-in delays prevent blocking, but consider spacing out large scraping jobs
4. URL Validation: Ensure category URLs are valid Macy's product category pages

Technical Specifications

• Platform: Apify Platform
• Language: Node.js
• Memory Requirements: 512MB minimum recommended
• Execution Time: 30-120 seconds depending on page size and network conditions
• Rate Limiting: Built-in random delays (0-500ms) between requests

Support & Licensing

This actor is available for rental on the Apify Store. For technical support, custom modifications, or bulk usage inquiries, please contact us through the Apify platform.

SEO Keywords

Macy's scraper, product data extraction, e-commerce scraping, retail price monitoring, product catalog scraper, Macy's API alternative, fashion data scraping, department store scraper, product information extraction, automated product research, retail analytics tool, price comparison data, inventory tracking scraper, Apify actor marketplace

For additional support, refer to the Apify documentation or contact us.