Zara Product Description Actor Documentation ## 📋 Overview The Zara Product Description Actor is a web scraping tool built with Apify that extracts detailed product information from Zara's e-commerce website. It takes product URLs as input and returns comprehensive product data including pricing, colors, sizes, descriptions, and images. ## 🎯 What This Actor Does This actor scrapes Zara product pages and extracts: - Product name and description - Pricing information (current price, discounts) - Available colors with hex codes - Size availability and pricing per size - Product images (multiple angles) - Material composition - Product categories and family information - Stock availability ## 🚀 Getting Started ### Prerequisites - An Apify account - Zara product URLs you want to scrape ### Quick Start 2. Provide product URLs in the input 3. Run the actor 4. Download the scraped data ## 🔧 Input Configuration ### Input Schema The actor accepts an input object with the following structure: json { "productUrls": [ { "url": "https://www.zara.com/us/en/product-url-here" }, { "url": "https://www.zara.com/us/en/another-product-url" } ] } ### Input Fields | Field | Type | Required | Description | |-------|------|----------|-------------| | productUrls | Array | Yes | Array of objects containing Zara product URLs | ### Example Input json { "productUrls": [ { "url": "https://www.zara.com/us/en/ruched-asymmetric-top-p01131347.html?v1=439186588&v2=2491343" }, { "url": "https://www.zara.com/us/en/sequin-mini-dress-p04772368.html?v1=447276703&v2=2491343" } ] } ## 📤 Output Data ### Output Structure The actor returns an array of product objects. Each product contains detailed information as shown in the example below: json { "id": 435322539, "type": "Product", "kind": "Wear", "state": "visible", "brand": { "brandId": 1, "brandGroupId": 1, "brandGroupCode": "zara" }, "name": "RUCHED ASYMMETRIC TOP", "reference": "01131347-V2025", "displayReference": "1131/347", "description": "Flowy top. Straight neckline with thin, twisted straps. Asymmetrical hem.", "pricing": { "value": "35.90", "currency": "USD" }, "colors": [...], "images": [...], "detailedComposition": {...}, "section": 1, "sectionName": "WOMAN", "familyId": 122, "familyName": "TOPS AND OTHERS" } ### Key Output Fields | Field | Description | |-------|-------------| | id | Unique product identifier | | name | Product name | | description | Product description | | pricing | Price information with currency | | colors | Array of available colors with hex codes, sizes, and images | | images | Array of product image URLs | | detailedComposition | Material composition breakdown | | sectionName | Product category (e.g., WOMAN, MAN) | | familyName | Product family (e.g., TOPS AND OTHERS) | ### Color Information Each color variant includes: - Color ID and name - Hex code for the color - Available sizes with stock status - Price per size - Specific images for that color variant ### Size Information For each size, you get: - Size name (S, M, L, etc.) - Availability status (in_stock, out_of_stock) - Individual pricing - SKU information - Demand level ## 🛠️ Technical Implementation ### Code Structure The actor consists of two main files: 1. main.js - The main entry point that: - Initializes the Apify Actor - Processes input URLs - Calls the scraping helper function - Stores results 2. helpers.js - Contains the productDescriptionByUrl function that: - Makes HTTP requests to Zara's API - Parses product data - Returns structured information ## 🔍 Understanding Zara URLs Zara URLs typically follow this pattern: https://www.zara.com/[country]/[language]/[product-name]-p[product-id].html?v1=[variant1]&v2=[variant2] Example breakdown: - us/en - US English version - ruched-asymmetric-top - Product slug - p01131347 - Product ID - v1=439186588 - Color variant - v2=2491343 - Additional variant parameter ## 🎨 Working with Color Variants The actor extracts detailed color information including: json { "id": "500", "hexCode": "#B8B86F", "name": "Green", "sizes": [ { "name": "S", "availability": "in_stock", "price": "35.90" } ], "images": ["image-url-1", "image-url-2"] } This allows you to: - Display accurate color representations using hex codes - Show size-specific availability - Access color-specific product images ## 📊 Material Composition The actor provides detailed material information: json { "detailedComposition": { "parts": [ { "description": "OUTER SHELL", "components": [ { "material": "polyester", "percentage": "96%" }, { "material": "elastane", "percentage": "4%" } ] } ] } } ## 🚨 Error Handling The actor includes comprehensive error handling: Common issues and solutions: - Invalid URLs: Ensure URLs are complete and properly formatted - Rate limiting: The actor handles API rate limits automatically - Product not found: Check if the product URL is still valid ## 📈 Best Practices ### Input Optimization - Provide valid, current Zara product URLs - Limit batch size to avoid rate limiting - Use specific product variant URLs when possible ### Data Usage - Process results as they're generated for better performance ### Monitoring - Check console logs for processing status - Monitor for any error messages - Verify output data completeness ## 🔄 Data Storage This dual approach allows for: - Real-time access to individual results - Complete dataset download at the end - Better error recovery if processing fails mid-run ## 🌐 Regional Considerations Zara operates in multiple regions with different: - Currencies (USD, EUR, GBP, etc.) - Product availability - Pricing structures - Language variants The actor preserves all regional-specific information in the output. ## 📝 Sample Use Cases ### E-commerce Price Monitoring Track price changes across Zara's product catalog for competitive analysis. ### Inventory Management Monitor stock levels and size availability for specific products. ### Product Catalog Creation Build comprehensive product databases with images and specifications. ### Market Research Analyze product descriptions, pricing strategies, and seasonal collections. --- ## Similar Actors - Zara Product Search - Zara product Search Autocomplete ## 📞 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. ---