Lefties Search Products Actor

Overview

The Lefties Search Products Actor is an Apify actor designed to scrape product information from Lefties, a fashion retail website. This actor allows you to search for products using various parameters and retrieve detailed product information including pricing, descriptions, images, and availability across different countries and languages.

Features

• Search products by query terms
• Support for multiple countries and languages
• Pagination support for large result sets
• Detailed product information extraction
• Comprehensive product data including images, pricing, and specifications
• Support for different regional Lefties websites

Input Parameters

Required Parameters

Parameter	Type	Description
query	string	Search term for items (e.g., 'jacket', 'dress', 'shoes')

Optional Parameters

Parameter	Type	Default	Description
page	integer	1	Page number for pagination (starting from 1)
perPage	string	"20"	Number of items to return per page
countryCode	string	"es"	Two-letter country code for Lefties regional site
languageCode	string	""	Language code for content localization

Supported Countries

The actor supports the following countries:

• EG - Egypt
• ES - Spain
• IC - Canary Islands
• IT - Italy
• MX - Mexico
• PT - Portugal
• RO - Romania
• SA - Saudi Arabia
• TN - Tunisia
• TR - Turkey
• AE - UAE
• AD - Andorra
• BH - Bahrain
• IL - Israel
• KW - Kuwait
• MA - Morocco
• OM - Oman
• QA - Qatar
• XE - Ceuta and Melilla
• JO - Jordan

Items Per Page Options

• 20 items
• 40 items
• 60 items
• 80 items
• 100 items
• 120 items

Input Schema Example

{
  "query": "ropa",
  "page": 1,
  "perPage": "20",
  "countryCode": "PT",
  "languageCode": "pt"
}

Output Structure

The actor returns comprehensive product data with the following structure:

Main Response Object

{
  "results": {
    "pagination": {
      "page": 1,
      "perPage": 20,
      "totalResults": 7411,
      "isLastPage": false
    },
    "products": [...]
  },
  "completedAt": "2025-06-11T10:28:49.123Z"
}

Product Object Structure

Each product in the results array contains:

Basic Information

• id - Unique product identifier
• name - Product name in local language
• nameEn - Product name in English
• price - Pricing information with currency
• state - Product availability status
• isBuyable - Whether the product can be purchased
• onSpecial - Whether the product is on special offer

Detailed Information

• detail.shortDescription - Brief product description
• detail.longDescription - Detailed product description with HTML formatting
• detail.reference - Product reference number
• detail.displayReference - Display reference number

Product Composition

• detail.composition - Material composition breakdown
• detail.compositionDetail - Detailed composition information
• Ingredient lists for fragrance products
• Care instructions

Images and Media

• variations[].image - Product images with timestamps and URLs
• detail.xmedia - Extended media information
• Multiple image formats and angles
• High-resolution product photos

Variants and Sizing

• variations - Different color/style variants
• sizes - Available sizes with SKU information
• bundleColors - Available color options
• Size system information

Categorization

• relatedCategories - Product category classifications
• familyInfo - Product family information
• subfamilyInfo - Product subfamily details
• tags - Product tags and attributes

Additional Data

• productUrl - Direct link to product page
• handle - URL-friendly product identifier
• availabilityDate - Product availability date
• attributes - Various product attributes
• relatedProducts - Related product suggestions

Usage Examples

Basic Search

{
  "query": "dress"
}

Advanced Search with Pagination

{
  "query": "jacket",
  "page": 2,
  "perPage": "40",
  "countryCode": "IT",
  "languageCode": "it"
}

Regional Search

{
  "query": "sapatos",
  "countryCode": "PT",
  "languageCode": "pt"
}

Error Handling

The actor includes comprehensive error handling:

• Validates required input parameters
• Provides detailed error messages for debugging
• Handles network timeouts and connection issues
• Logs progress and completion status

Output Storage

The actor stores results in two formats:

1. Dataset: Individual product records pushed to the default dataset
2. Key-Value Store: Complete results stored under the 'output' key with completion timestamp

Best Practices

1. Pagination: Use appropriate page sizes based on your needs
2. Country Selection: Choose the correct country code for accurate pricing and availability
3. Language Codes: Specify language codes for proper localization
4. Query Optimization: Use specific search terms for better results

Limitations

• Results are limited by Lefties' own search capabilities
• Some products may not be available in all regions
• Image URLs may have expiration timestamps
• Product availability can change frequently

Sample Output

The actor returns detailed product information as shown in the provided example, including:

• Product IDs and references
• Multilingual names and descriptions
• Comprehensive pricing information
• Detailed composition and care instructions
• High-resolution product images
• Size and color variations
• Category and classification data
• Direct product URLs

This makes the actor suitable for various use cases including price monitoring, inventory tracking, product research, and competitive analysis in the fashion retail sector.

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.

---