Pricing

Rating

Developer

Actor stats

Categories

Share

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

Available Sort Options

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.