🎨 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 json { "colorPalette": ["#FF6B6B", "#4ECDC4", "#45B7D1"], "targetWebsites": ["zara", "hm", "asos"], "category": "dresses", "priceRange": { "min": 20, "max": 100 }, "maxResults": 30, "colorMatchThreshold": 75 } ### Image Color Extraction Example json { "imageUrl": "https://example.com/sunset.jpg", "targetWebsites": ["zara", "shein"], "category": "all", "maxResults": 50 } ## Output Schema Each product in the dataset includes: json { "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 json { "imageUrl": "https://images.unsplash.com/photo-1506905925346-21bda4d32df4", "targetWebsites": ["zara", "hm"], "maxResults": 20, "colorMatchThreshold": 80 } ### 2. Find Specific Colors in Tops json { "colorPalette": ["#FF6B6B", "#4ECDC4"], "category": "tops", "priceRange": {"min": 15, "max": 50}, "targetWebsites": ["shein", "hm"], "maxResults": 40 } ### 3. Budget-Friendly Color Match json { "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: bash 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