Zara Search Autocomplete Actor Documentation

Overview

The Zara Search Autocomplete Actor is a web scraping tool that fetches product search suggestions from Zara's website. It mimics the autocomplete functionality you see when typing in Zara's search box, allowing you to programmatically retrieve product suggestions for any search query.

What Does This Actor Do?

When you type something in Zara's search box (like "shoes" or "dress"), you see suggestions pop up before you finish typing. This actor captures those same suggestions.

Key Features:

• ✅ Get product search suggestions from Zara
• ✅ Support for multiple countries and languages
• ✅ Filter by different sections (HOME, WOMAN, MAN, KID)
• ✅ Automatic locale validation
• ✅ Error handling and logging

How to Use This Actor

Input Parameters

The actor accepts the following input parameters:

Parameter	Type	Required	Default	Description
query	String	✅ Yes	"shoes"	The search term you want suggestions for
locale	String	❌ No	"en_US"	Country and language code (format: language_COUNTRY)
section	String	❌ No	"HOME"	Zara section to search in

Locale Examples:

• en_US - English, United States
• es_ES - Spanish, Spain
• fr_FR - French, France
• de_DE - German, Germany
• it_IT - Italian, Italy

Section Options:

• HOME - General/Home section
• WOMAN - Women's clothing
• MAN - Men's clothing
• KID - Children's clothing

Example Input

{
  "query": "black dress",
  "locale": "en_US",
  "section": "WOMAN"
}

What You Get Back

The actor returns search suggestions in the following format:

{
  "results": [
    {
      "query": "shoes"
    },
    {
      "query": "women shoes"
    },
    {
      "query": "men shoes"
    },
    {
      "query": "white shoes"
    },
    {
      "query": "kids shoes"
    },
    {
      "query": "gold shoes"
    },
    {
      "query": "red shoes"
    },
    {
      "query": "black shoes"
    },
    {
      "query": "brown shoes"
    },
    {
      "query": "flat shoes"
    }
  ],
  "completedAt": "2025-05-26T08:13:15.448Z"
}

Error Handling

The actor includes comprehensive error handling:

Input Validation Errors

• Missing search query
• Invalid locale format

Network Errors

• Connection timeouts
• API rate limiting
• Server errors

Data Processing Errors

• Invalid response format
• Empty results

Best Practices

1. Query Optimization

• Use specific search terms for better results
• Avoid very generic terms like "clothes"
• Try different variations of your search term

2. Locale Selection

• Always use the correct format: language_COUNTRY
• Check if your target locale is supported
• Use English (en_US) as fallback

3. Section Filtering

• Use appropriate sections for targeted results
• WOMAN section for women's products
• MAN section for men's products
• KID section for children's products

4. Rate Limiting

• Don't make too many requests too quickly
• Add delays between runs if needed

Common Use Cases

1. Market Research

{
  "query": "sustainable fashion",
  "locale": "en_US", 
  "section": "WOMAN"
}

2. Product Discovery

{
  "query": "winter coats",
  "locale": "de_DE",
  "section": "MAN" 
}

3. Trend Analysis

{
  "query": "2024 trends",
  "locale": "fr_FR",
  "section": "HOME"
}

Troubleshooting

Problem: No results returned

Solution:

• Check if your query is too specific
• Try a different locale
• Verify the section parameter

Problem: Locale not supported error

Solution:

• Use a supported locale for that country
• Check the json_languages file for valid options
• Use en_US as default

Problem: Network errors

Solution:

• Check your internet connection
• Try running the actor again after a few minutes
• Verify Zara's website is accessible

Technical Requirements

Dependencies

• apify - Apify SDK for actor functionality
• axios - HTTP client for making requests
• Custom helper functions for locale and store ID handling

Environment

• Node.js environment
• Apify platform
• Internet connection

Example Complete Run

Here's what a complete run looks like:

Input:

{
  "query": "red shoes",
  "locale": "en_US",
  "section": "WOMAN"
}

Console Output:

Input: { query: 'red shoes', locale: 'en_US', section: 'WOMAN' }
Starting search for query: "red shoes" in locale: en_US
Found 8 suggestions
Search completed. Products found: 8

This actor is perfect for anyone looking to understand fashion trends, conduct market research, or build applications that need Zara product suggestions!

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.

---