Zara Similar Products Actor ## Overview The Zara Similar Products Actor finds and extracts similar products from Zara's website based on a given product URL. It retrieves comprehensive product information including pricing, availability, colors, sizes, and images for products similar to your target item. ## Features - Extract similar products from any Zara product page - Support for multiple locales and languages across 80+ countries - Comprehensive product data including pricing, availability, and variants - Automatic locale validation and fallback - Structured output with detailed product information ## Input Parameters ### Required Parameters #### productUrl (string, required) The full Zara product URL you want to find similar products for. Example: https://www.zara.com/us/en/sequin-mini-dress-p04772368.html?v1=447276703&v2=2491343 ### Optional Parameters #### locale (string, optional, default: "en_US") The language and country locale for the search results. Affects the language of product names, descriptions, and regional pricing. Format: language_COUNTRY Supported Locales: - North America: en_US, es_US, en_CA, fr_CA, es_MX, en_MX - Europe: en_GB, es_ES, fr_FR, de_DE, it_IT, pt_PT, nl_NL - Asia Pacific: ja_JP, en_JP, ko_KR, zh_CN, en_AU, th_TH, vi_VN - Middle East: ar_SA, en_SA, ar_AE, en_AE, tr_TR, he_IL - And many more... ## Output Structure The actor returns an array of product objects with the following structure: ### Main Product Object json { "id": 416734763, "type": "Product", "kind": "Other", "name": "VINYL WEDGE SANDALS", "reference": "13339510-V2025", "displayReference": "3339/510", "description": "", "pricing": { "value": 69.9, "currency": null }, "section": 1, "sectionName": "WOMAN", "familyId": 1228, "familyName": "WEDGE", "subfamilyId": 8623, "subfamilyName": "Z1T:HEEL SANDAL", "keyword": "vinyl-wedge-sandals", "url": "https://www.zara.com/us/en/vinyl-wedge-sandals-p13339510.html" } ### Color Variants Each product includes detailed color information: json "colors": [ { "id": "850", "name": "white", "reference": "C13339510850000-V2025", "price": "69.90", "priceInCents": 6990, "oldPrice": null, "discountPercentage": null, "sizes": [...] } ] ### Size Information Detailed size availability and pricing: json "sizes": [ { "availability": "out_of_stock", "id": 35, "name": "5", "price": "69.90", "priceInCents": 6990, "reference": "1333951085035-V2025", "sku": 416727195 } ] ### Images High-quality product images: json "images": [ "https://static.zara.net/assets/public/a1e5/03df/9d3346b6a996/a965dce032e6/13339510850-e1/13339510850-e1.jpg", "https://static.zara.net/assets/public/4c12/1210/21474ca289ac/5f63c41ff84b/13339510850-p/13339510850-p.jpg" ] ## Usage Examples ### Basic Example json { "productUrl": "https://www.zara.com/us/en/sequin-mini-dress-p04772368.html?v1=447276703&v2=2491343" } ### With Custom Locale json { "productUrl": "https://www.zara.com/us/en/sequin-mini-dress-p04772368.html?v1=447276703&v2=2491343", "locale": "es_ES" } ### With European Locale json { "productUrl": "https://www.zara.com/de/de/pailletten-minikleid-p04772368.html", "locale": "de_DE" } ## Output Storage The actor stores results in two ways: 1. Dataset: Each similar product is pushed as a separate item to the default dataset 2. Key-Value Store: A summary is saved under the key similar containing: - Input parameters used - Total number of products found - Timestamp of the search - Complete array of all products ## Error Handling The actor includes comprehensive error handling: - Validates required productUrl parameter - Warns about unsupported locales and suggests alternatives - Handles network errors and timeouts gracefully - Provides detailed error messages for debugging ## Performance Notes - Typical run time: 10-30 seconds depending on the number of similar products - Memory usage: Low to moderate - Rate limiting: Respects Zara's server limits with appropriate delays ## Common Use Cases 1. E-commerce Competitor Analysis: Track similar products and pricing 2. Fashion Trend Monitoring: Discover related items and styles 3. Price Comparison: Monitor pricing across different regions 4. Inventory Tracking: Check availability across sizes and colors 5. Market Research: Analyze product categories and variations ## Limitations - Only works with Zara product URLs - Results depend on Zara's internal similarity algorithm - Some regions may have limited product availability - Pricing may vary based on regional settings ## Support If you have any questions or encounter any issues, please consult the Apify documentation or reach out to us through one of the following channels: * Telegram: @pintoflow * Email: pintoflowpt@gmail.com * Apify Platform: You can also contact us directly through this platform. ---