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 json { "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 json { "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 json { "query": "dress" } ### Advanced Search with Pagination json { "query": "jacket", "page": 2, "perPage": "40", "countryCode": "IT", "languageCode": "it" } ### Regional Search json { "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. ---