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:

{
  "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

{
  "categoryUrl": "https://www.zara.com/us/en/woman-best-sellers-jeans-l6130.html?v1=2491844"
}

Example 2: Spanish Market with Pagination

{
  "categoryUrl": "https://www.zara.com/es/es/mujer-vaqueros-l1335.html",
  "locale": "es_ES",
  "page": 2,
  "perPage": 50
}

Example 3: Large Batch Scraping

{
  "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

{
  "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:

{
  "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:

{
  "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:

{
  "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:

{
  "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.

---