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 json { "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 json { "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 json { "sortBy": "featuredItems", "page": 1, "perPage": 30 } ### Find Budget-Friendly Options json { "sortBy": "priceLowToHigh", "page": 1, "perPage": 50 } ### Discover New Arrivals json { "sortBy": "newItems", "page": 1, "perPage": 25 } ### Browse Best Sellers json { "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.