🎨 Color Palette Fashion Finder

Find clothing items that match your color palette from top fashion retailers. Upload an image or specify colors, and this Actor will search Zara, H&M, ASOS, and Shein for matching products using advanced color similarity algorithms.

Features

• Color Extraction: Automatically extract dominant colors from images using Vibrant.js
• Smart Color Matching: Uses Delta E 2000 algorithm for perceptually accurate color comparison
• Multi-Retailer Scraping: Searches Zara, H&M, ASOS, and Shein simultaneously
• Flexible Filtering: Filter by category, price range, and color match threshold
• Deduplication: Automatically removes duplicate products
• Detailed Results: Returns product name, price, images, URLs, and color match scores

Use Cases

• Fashion Discovery: "I loved this color in a sunset photo, where can I buy clothing in that shade?"
• Interior Design Match: Find clothing that matches your room's color scheme
• Brand Consistency: Find products matching your brand colors
• Mood Board to Wardrobe: Convert Pinterest inspiration to actual shopping
• Color Trend Analysis: Research what products are available in trending colors

Input Parameters

Required (one of these):

• colorPalette (array of strings): Array of hex color codes (e.g., ["#FF6B6B", "#4ECDC4"])
• imageUrl (string): URL of an image to extract colors from

Optional:

• targetWebsites (array): Fashion retailers to scrape. Options: "zara", "hm", "asos", "shein". Default: ["zara", "hm", "asos"]
• category (string): Product category to search. Options: "all", "tops", "bottoms", "dresses", "outerwear", "accessories", "shoes". Default: "all"
• priceRange (object): Price filter with min and max in USD. Default: {"min": 0, "max": 1000}
• maxResults (integer): Maximum number of matching products to return (1-500). Default: 50
• colorMatchThreshold (integer): Minimum color similarity score (0-100). Higher values return only close matches. Default: 70
• includeOutOfStock (boolean): Whether to include out-of-stock items. Default: false
• maxConcurrency (integer): Number of pages to scrape concurrently (1-20). Default: 5

Input Example

{
  "colorPalette": ["#FF6B6B", "#4ECDC4", "#45B7D1"],
  "targetWebsites": ["zara", "hm", "asos"],
  "category": "dresses",
  "priceRange": {
    "min": 20,
    "max": 100
  },
  "maxResults": 30,
  "colorMatchThreshold": 75
}

Image Color Extraction Example

{
  "imageUrl": "https://example.com/sunset.jpg",
  "targetWebsites": ["zara", "shein"],
  "category": "all",
  "maxResults": 50
}

Output Schema

Each product in the dataset includes:

{
  "productName": "Floral Summer Dress",
  "price": "$49.99",
  "currency": "USD",
  "imageUrl": "https://...",
  "productUrl": "https://...",
  "availableColors": ["#FF6B6B", "#FFB6B6"],
  "colorMatchScore": 85,
  "matchedColors": [
    {
      "productColor": "#FF6B6B",
      "paletteColor": "#FF6B6B",
      "similarity": 98
    }
  ],
  "sourceSite": "Zara",
  "targetPalette": ["#FF6B6B", "#4ECDC4", "#45B7D1"],
  "scrapedAt": "2025-11-09T19:00:00.000Z"
}

Output Fields

• productName: Name of the product
• price: Price as displayed on website (may include currency symbol)
• currency: Currency code (default: "USD")
• imageUrl: URL of the product's main image
• productUrl: Direct link to the product page
• availableColors: Array of color hex codes available for this product
• colorMatchScore: Overall similarity score (0-100, higher is better)
• matchedColors: Details of which product colors matched which palette colors
• sourceSite: Name of the retailer (Zara, H&M, ASOS, or Shein)
• targetPalette: The color palette that was searched for
• scrapedAt: ISO timestamp of when the product was scraped

How Color Matching Works

This Actor uses the Delta E 2000 (CIEDE2000) algorithm, the industry standard for perceptually accurate color comparison. The process:

1. Color Space Conversion: Colors are converted from RGB to LAB color space, which better represents human perception
2. Similarity Calculation: Delta E values represent "just noticeable difference" (JND):
   • 0-2: Not perceptible by human eyes
   • 2-10: Perceptible through close observation
   • 10-50: More different but same hue
   • 50+: Different colors
3. Score Normalization: Delta E is converted to a 0-100 similarity score (higher = more similar)
4. Threshold Filtering: Only products meeting the colorMatchThreshold are returned

Performance & Pricing

• Runtime: Typically 2-5 minutes for 50 results across 3 retailers
• Memory: 512 MB - 1 GB recommended
• Compute Units: ~0.05-0.15 CU per run (depends on maxResults and retailers)

Optimization Tips:

• Start with fewer retailers and increase if needed
• Use higher colorMatchThreshold (80+) for faster, more precise results
• Reduce maxResults if you only need a few options
• Set category to narrow the search space

Limitations

• Dynamic Websites: Some retailers use JavaScript-heavy sites that may require PlaywrightCrawler (future update)
• Color Availability: Not all retailers expose product colors in their HTML. The Actor extracts what's available.
• Rate Limiting: Retailers may block requests if scraping too aggressively. Use maxConcurrency: 3-5 for stability.
• Price Accuracy: Prices may change or be location-specific. Always verify on the retailer's website.
• Image Color Extraction: Works best with images that have clear, distinct colors. Very complex images may yield less useful palettes.

Example Use Cases

1. Match a Photo's Color Palette

{
  "imageUrl": "https://images.unsplash.com/photo-1506905925346-21bda4d32df4",
  "targetWebsites": ["zara", "hm"],
  "maxResults": 20,
  "colorMatchThreshold": 80
}

2. Find Specific Colors in Tops

{
  "colorPalette": ["#FF6B6B", "#4ECDC4"],
  "category": "tops",
  "priceRange": {"min": 15, "max": 50},
  "targetWebsites": ["shein", "hm"],
  "maxResults": 40
}

3. Budget-Friendly Color Match

{
  "colorPalette": ["#2C3E50", "#E74C3C", "#ECF0F1"],
  "priceRange": {"min": 0, "max": 30},
  "targetWebsites": ["shein"],
  "category": "all",
  "maxResults": 100,
  "colorMatchThreshold": 65
}

API Access

Use this Actor via Apify API:

curl "https://api.apify.com/v2/acts/YOUR_ACTOR_ID/runs" \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{
    "colorPalette": ["#FF6B6B", "#4ECDC4"],
    "targetWebsites": ["zara", "hm"]
  }'

Integration Ideas

• Fashion Apps: Integrate color-based product search into your app
• Interior Design Tools: Match decor to available clothing
• Trend Analysis: Track which colors are available across retailers
• Affiliate Marketing: Build a color-based fashion discovery tool
• Personal Stylists: Find items matching client preferences

Support & Issues

For bugs, feature requests, or questions:

• GitHub Issues: Report an issue
• Apify Forum: Get community help
• Email: support@apify.com

Technical Details

Built With:

• Apify SDK 3.0: Actor platform and dataset storage
• Crawlee 3.0: Web scraping framework (CheerioCrawler)
• node-vibrant: Image color extraction
• Sharp: Image processing
• color-difference: Delta E 2000 algorithm implementation

Architecture:

• Modular scraper design (easy to add new retailers)
• Retailer-specific parsing utilities
• Centralized color matching logic
• Error handling and retry mechanisms
• Deduplication by product name and retailer

License

Apache 2.0