Macy's Trending Products - Apify Actor Documentation

Overview

The Macy's Trending Products actor extracts trending and popular products from Macy's online store. It provides access to various product sorting options including featured items, price ranges, top-rated products, best sellers, and new arrivals.

Features

• ✅ Multiple sorting options (featured, price, ratings, popularity)
• ✅ Pagination support for large datasets
• ✅ Regional customization (US market)
• ✅ Currency selection (USD)
• ✅ Built-in rate limiting to respect website policies
• ✅ Comprehensive product data extraction

Input Parameters

Parameter	Type	Required	Default	Description
page	Integer	No	1	Page number for pagination
perPage	Integer	No	60	Number of products per page (max 60)
regionCode	String	No	'US'	Region code for localized results
currencyCode	String	No	'USD'	Currency code for pricing
sortBy	String	Yes	'featuredItems'	Sort order for products

Available Sort Options

Key	Value	Description
featuredItems	ORIGINAL	Default featured products
priceLowToHigh	PRICE_LOW_TO_HIGH	Sort by price ascending
priceHighToLow	PRICE_HIGH_TO_LOW	Sort by price descending
topRated	TOP_RATED	Highest rated products first
bestSellers	BEST_SELLERS	Best selling products
newItems	NEW_ITEMS	Newest arrivals

Input Example

{
  "page": 1,
  "perPage": 50,
  "regionCode": "US",
  "currencyCode": "USD",
  "sortBy": "bestSellers"
}

Output Structure

The actor returns detailed product information including:

Product Details

• Basic Info: ID, name, brand, type
• Pricing: Regular price, sale price, discounts, promotional offers
• Availability: Stock status, active status
• Reviews: Average rating, review count
• Images: Primary and additional product images
• Colors: Available color variations with swatches
• URLs: Direct product page links

Example Output

{
    "products": [
      {
        "id": 11318480,
        "detail": {
          "name": "Men's Modern-Fit Bi-Stretch Suit",
          "brand": "Nautica",
          "reviewStatistics": {
            "aggregate": {
              "rating": 3.9,
              "count": 2491
            }
          }
        },
        "pricing": {
          "price": {
            "tieredPrice": [
              {
                "label": "[PRICE]",
                "values": [{"value": 395, "formattedValue": "$395.00"}]
              },
              {
                "label": "Sale [PRICE]",
                "values": [{"value": 99.99, "formattedValue": "$99.99", "percentOff": [75]}]
              }
            ]
          }
        },
        "traits": {
          "colors": {
            "colorMap": [
              {"name": "Blue plaid", "normalName": "Blue"},
              {"name": "Light Blue", "normalName": "Blue"},
              {"name": "Charcoal solid", "normalName": "Black"}
            ]
          }
        },
        "url": "https://www.macys.com/shop/product/nautica-mens-modern-fit-bi-stretch-suit?ID=11318480"
      }
    ],
    "pagination": {
      "page": 1,
      "perPage": 61,
      "totalAvailable": 187815,
      "totalPages": 3079,
      "hasNext": true
    }
  }

Usage Examples

Get Featured Items

{
  "sortBy": "featuredItems",
  "page": 1,
  "perPage": 30
}

Find Budget-Friendly Options

{
  "sortBy": "priceLowToHigh",
  "page": 1,
  "perPage": 50
}

Discover New Arrivals

{
  "sortBy": "newItems",
  "page": 1,
  "perPage": 25
}

Browse Best Sellers

{
  "sortBy": "bestSellers",
  "page": 2,
  "perPage": 60
}

Rate Limiting

The actor implements built-in rate limiting with random delays (0-900ms) between requests to ensure respectful data extraction and avoid overwhelming Macy's servers.

Error Handling

Common Errors

• Missing sortBy: Actor will throw an error if no sortBy parameter is provided
• Invalid sortBy: Actor validates against available options and provides helpful error messages
• Network Issues: Built-in retry mechanisms handle temporary connection problems

Error Response Example

Error: Invalid sortBy option: 'invalidOption'. Available options are: featuredItems, priceLowToHigh, priceHighToLow, topRated, bestSellers, newItems

Data Storage

• Results are automatically pushed to the default dataset
• Complete results are stored in the output key-value store
• Each successful run generates structured JSON output

Best Practices

1. Start Small: Begin with smaller perPage values to test your workflow
2. Respect Rate Limits: The actor includes delays, but avoid running multiple instances simultaneously
3. Monitor Pagination: Use hasNext field to determine if more pages are available
4. Handle Large Datasets: For large scraping jobs, implement proper pagination loops
5. Data Validation: Always validate the output structure matches your needs

Technical Requirements

• Platform: Apify
• Node.js: Compatible with Apify's runtime environment
• Dependencies: Uses Apify SDK and custom product extraction modules
• Memory: Recommended minimum 1GB for optimal performance

Support & Troubleshooting

If you encounter issues:

1. Verify your input parameters match the required format
2. Check that sortBy uses one of the valid options
3. Ensure pagination parameters are within reasonable limits
4. Monitor actor logs for detailed error messages

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