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

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

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

"sizes": [
  {
    "availability": "out_of_stock",
    "id": 35,
    "name": "5",
    "price": "69.90",
    "priceInCents": 6990,
    "reference": "1333951085035-V2025",
    "sku": 416727195
  }
]

Images

High-quality product images:

"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

{
  "productUrl": "https://www.zara.com/us/en/sequin-mini-dress-p04772368.html?v1=447276703&v2=2491343"
}

With Custom Locale

{
  "productUrl": "https://www.zara.com/us/en/sequin-mini-dress-p04772368.html?v1=447276703&v2=2491343",
  "locale": "es_ES"
}

With European Locale

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

---