Macys Similar Products Actor Extract product recommendations and similar items from Macy's product pages The Macys Similar Products Actor is a powerful web scraping tool that retrieves similar product recommendations from Macy's e-commerce platform. Input any Macy's product URL and get detailed information about recommended similar products including pricing, availability, sizes, colors, and images. ## Key Features - Product Recommendations: Get similar products suggested by Macy's algorithm - Detailed Product Info: Extract comprehensive product details including pricing, colors, sizes, and availability - Multi-Region Support: Configure region and currency codes for localized results - High-Quality Images: Access to product images and color swatches - Review Data: Product ratings and review counts - Real-time Availability: Current stock status and shipping information ## Input Configuration ### Required Parameters | Parameter | Type | Description | Example | |-----------|------|-------------|---------| | productUrl | string | Full Macy's product URL with product ID | https://www.macys.com/shop/product/nike-mens-air-max-90-casual-sneakers-from-finish-line?ID=17395592 | ### Optional Parameters | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | regionCode | string | US | Region code for localization | | currencyCode | string | USD | Currency code for pricing | ### Input Example json { "productUrl": "https://www.macys.com/shop/product/nike-mens-air-max-90-casual-sneakers-from-finish-line?ID=17395592", "regionCode": "US", "currencyCode": "USD" } ## Output Data Structure The actor returns detailed information about similar products with the following structure: json { "productId": "17395592", "similarProducts": [ { "id": 11836963, "detail": { "name": "Men's Grayson Lace-Up Sneakers, Created for Macy's", "brand": "Alfani", "brandURL": "/shop/featured/alfani", "reviewStatistics": { "aggregate": { "rating": 4.3, "count": 600 } }, "maxQuantity": 6, "typeName": "SHOE" }, "pricing": { "price": { "tieredPrice": [ { "values": [ { "value": 59.99, "formattedValue": "$59.99", "type": "regular" } ] } ] } }, "availability": { "active": true, "available": true, "shipDays": 2, "message": "In Stock: Usually ships within 2 business days." }, "traits": { "colors": { "colorMap": [ { "name": "Black w/ White", "normalName": "Black" }, { "name": "White", "normalName": "White" } ] }, "sizes": { "sizeMap": [ {"name": "7", "displayName": "7"}, {"name": "8", "displayName": "8"} ] } }, "imagery": { "primaryImage": { "filePath": "5/optimized/18335085_fpx.tif" }, "additionalImageSource": [...] }, "url": "https://www.macys.com/shop/product/alfani-mens-grayson-lace-up-sneakers-created-for-macys?ID=11836963" } ] } ## Use Cases ### E-commerce & Retail - Competitor Analysis: Monitor similar products and pricing strategies - Market Research: Analyze product recommendations and consumer preferences - Price Monitoring: Track pricing changes across similar product categories - Inventory Planning: Understand product availability and stock levels ### Business Intelligence - Product Discovery: Find alternative products for business sourcing - Trend Analysis: Identify popular products and emerging trends - Customer Behavior: Analyze recommendation patterns and product relationships - Brand Monitoring: Track brand presence in product recommendations ### Marketing & Advertising - Ad Campaign Research: Discover products for targeted advertising - Content Creation: Generate product comparison content - SEO Research: Find related products for content optimization - Affiliate Marketing: Identify products for affiliate programs ### Data Science & Analytics - Recommendation System Training: Gather data for ML model training - Product Clustering: Analyze product similarity and categorization - Market Basket Analysis: Study product relationships and cross-selling opportunities - Pricing Intelligence: Build pricing models and strategies ## Getting Started 1. Set up the Actor: Add the actor to your Apify account 2. Configure Input: Provide a valid Macy's product URL 3. Run the Actor: Execute and wait for results 4. Access Data: Download results via API or Apify Console ### Sample Implementation javascript const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' }); const run = await client.actor('your-username/macys-similar-products').call({ productUrl: 'https://www.macys.com/shop/product/nike-mens-air-max-90-casual-sneakers-from-finish-line?ID=17395592', regionCode: 'US', currencyCode: 'USD' }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); ## Important Notes - URL Format: Ensure the product URL includes the ID parameter (e.g., ?ID=17395592) - Rate Limiting: The actor includes built-in delays to respect Macy's servers - Data Freshness: Results reflect real-time product information and availability - Regional Variations: Use appropriate region and currency codes for accurate localization ## Technical Specifications - Runtime: Node.js - Memory: 1GB recommended - Timeout: 300 seconds default - Output Format: JSON - Data Storage: Apify Dataset ## Support & Documentation For technical support, feature requests, or bug reports, please contact the actor developer through the Apify platform. For additional support, refer to the Apify documentation or contact us.