Zara Products by Category - Actor Documentation ## Overview The Zara Products by Category actor is a web scraping tool that extracts product information from Zara's online store by category. It allows you to scrape products from any Zara category page across different countries and languages, with pagination support for large product catalogs. ## What Does This Actor Do? This actor helps you: - Extract product details from any Zara category page - Get product information in different languages and countries - Handle pagination to scrape multiple pages of products - Retrieve structured product data including prices, images, and descriptions ## Quick Start ### Basic Usage To use this actor, you only need to provide a Zara category URL. The actor will automatically extract all products from that category. Minimum required input: json { "categoryUrl": "https://www.zara.com/us/en/woman-best-sellers-jeans-l6130.html?v1=2491844" } ## Input Parameters ### Required Parameters | Parameter | Type | Description | Example | |-----------|------|-------------|---------| | categoryUrl | String | The Zara category page URL you want to scrape | "https://www.zara.com/us/en/woman-best-sellers-jeans-l6130.html?v1=2491844" | ### Optional Parameters | Parameter | Type | Default | Description | Range | |-----------|------|---------|-------------|-------| | locale | String | "en_US" | Language and country code for localization | See supported locales below | | page | Integer | 1 | Starting page number for pagination | Minimum: 1 | | perPage | Integer | 36 | Number of products to fetch per page | 1-70 | ## Supported Locales The actor supports over 100 different language and country combinations. Here are some popular ones: ### English Locales - en_US - English (United States) - en_GB - English (United Kingdom) - en_CA - English (Canada) - en_AU - English (Australia) ### Spanish Locales - es_ES - Spanish (Spain) - es_US - Spanish (United States) - es_MX - Spanish (Mexico) - es_AR - Spanish (Argentina) ### Other Popular Locales - fr_FR - French (France) - de_DE - German (Germany) - it_IT - Italian (Italy) - pt_BR - Portuguese (Brazil) - ja_JP - Japanese (Japan) - ko_KR - Korean (South Korea) - zh_CN - Chinese (China) For a complete list of supported locales, refer to the input schema. ## Input Examples ### Example 1: Basic Scraping json { "categoryUrl": "https://www.zara.com/us/en/woman-best-sellers-jeans-l6130.html?v1=2491844" } ### Example 2: Spanish Market with Pagination json { "categoryUrl": "https://www.zara.com/es/es/mujer-vaqueros-l1335.html", "locale": "es_ES", "page": 2, "perPage": 50 } ### Example 3: Large Batch Scraping json { "categoryUrl": "https://www.zara.com/de/de/damen-jeans-l1335.html", "locale": "de_DE", "page": 1, "perPage": 70 } ## Output Structure The actor returns a structured JSON object with the following format: ### Main Output Structure json { "results": { "data": [ // Array of product objects ], "pagination": { "current": 1, "totalAvailablePages": 5, "total": 150, "hasNext": true, "hasPrev": false } }, "completedAt": "2025-05-26T12:03:17.558Z" } ### Product Object Structure Each product in the data array contains: json { "id": 418199714, "type": "Product", "kind": "Wear", "name": "HIGH-WAISTED TRF MOM FIT JEANS", "reference": "02569047-V2025", "displayReference": "2569/047", "description": "", "pricing": { "value": 49.9, "currency": null }, "colors": [ { "id": "400", "name": "Blue", "price": "49.90", "priceInCents": 4990, "hexCode": null } ], "images": [ "https://static.zara.net/assets/public/73a7/37bb/301e4e63b2a0/f5c756c95488/08727047400-p/08727047400-p.jpg?ts=1740751065310" ], "section": 1, "sectionName": "WOMAN", "familyName": "PANTALON", "subfamilyName": "T.PANT.PAQUETER", "keyword": "high-waisted-trf-mom-fit-jeans", "url": "https://www.zara.com/us/en/high-waisted-trf-mom-fit-jeans-p02569047.html" } ### Key Fields Explained | Field | Description | |-------|-------------| | id | Unique product identifier | | name | Product name/title | | reference | Internal Zara product reference | | displayReference | Human-readable product reference | | pricing.value | Product price as a number | | colors | Array of available color variants | | images | Array of product image URLs | | sectionName | Product category (e.g., "WOMAN", "MAN", "KIDS") | | familyName | Product family (e.g., "PANTALON", "T-SHIRT") | | url | Direct link to the product page | ### Pagination Information | Field | Description | |-------|-------------| | current | Current page number | | totalAvailablePages | Total number of pages available | | total | Total number of products in the category | | hasNext | Boolean indicating if there are more pages | | hasPrev | Boolean indicating if there are previous pages | ## How to Find Category URLs To get a Zara category URL: 1. Go to zara.com 2. Navigate to your desired country/language 3. Browse to the category you want (e.g., Women > Jeans) 4. Copy the URL from your browser's address bar Example URLs: - Women's Jeans (US): https://www.zara.com/us/en/woman-jeans-l1119.html?v1=2419185 - Men's Shirts (UK): https://www.zara.com/gb/en/man-shirts-l707.html - Kids' Dresses (Spain): https://www.zara.com/es/es/ninos-nina-vestidos-l1176.html ## Common Use Cases ### 1. Price Monitoring Track price changes across different markets: json { "categoryUrl": "https://www.zara.com/us/en/woman-jeans-l1119.html?v1=2419185", "locale": "en_US" } ### 2. Market Research Compare product availability across different countries: json { "categoryUrl": "https://www.zara.com/de/en/woman-jeans-l1119.html?v1=2419185", "locale": "en_DE" } ### 3. Inventory Analysis Get complete product catalogs for analysis: json { "categoryUrl": "https://www.zara.com/es/es/mujer-camisas-l1217.html?v1=2420369", "locale": "es_ES", "perPage": 70 } ## Best Practices ### 1. Pagination Strategy - Start with page: 1 to understand the total number of products - Use the totalAvailablePages from the response to plan your pagination - Set perPage to maximum (70) for efficient scraping ### 2. Locale Selection - Always match the locale with the category URL's country - Use the actor's automatic locale validation - Check supported locales for your target market ### 3. Rate Limiting - Don't run multiple instances simultaneously on the same category - Add delays between runs if scraping multiple categories - Monitor for rate limiting responses ### 4. Data Processing - Use the reference field for unique product identification - The url field provides direct links to individual products - Images URLs can be used directly for downloading product photos ## Error Handling The actor includes built-in error handling for common issues: ### Invalid Category URL Error: categoryUrl is required Solution: Ensure you provide a valid Zara category URL ### Unsupported Locale Locale xx_XX not supported for country xx. Using first available: yy_YY Solution: Check the supported locales list and use a valid combination ### No Products Found The actor will return an empty products array but won't throw an error. ## Troubleshooting ### Common Issues 1. Empty Results - Check if the category URL is correct and accessible - Verify the locale matches the URL's country - Try reducing the perPage parameter 2. Locale Warnings - Use supported locale combinations - Match the locale with the category URL's country/language 3. Pagination Issues - Start with page 1 to get total page count - Don't exceed the totalAvailablePages value ### Getting Help If you encounter issues: 1. Verify your input parameters against this documentation 2. Check the actor's logs for specific error messages 3. Test with the provided example inputs first 4. Ensure your category URLs are from the current Zara website ## Data Storage The actor automatically stores results in two ways: 1. Dataset: All scraped products are pushed to the default dataset 2. Key-Value Store: A summary is saved under the key SUMMARY containing: - Complete results object - Completion timestamp - Pagination information You can access both through the Apify platform after the run completes. --- ## 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. ---