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

{
  "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:

{
  "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

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.