Lefties Similar Products Actor Documentation ## Overview The Lefties Similar Products Actor is an Apify actor designed to extract similar product recommendations from Lefties.com based on a given product URL. This actor helps users discover related products by analyzing a specific product page and returning a list of similar items available on the Lefties website. ## Features - Extract similar products from any Lefties product page - Support for multiple countries and regions where Lefties operates - Configurable result limits (20-120 items) - Multi-language support with automatic fallback to default country language - Structured JSON output with detailed product information ## Input Parameters ### Required Parameters #### productUrl (string, required) - Description: The complete URL of the Lefties product page you want to find similar products for - Example: https://www.lefties.com/es/en/woman/shoes/new-in/high-heel-sandals-with-metallic-detail-c1030272265p694195974.html?colorId=102&style=01&parentId=702888584 - Format: Must be a valid Lefties.com product URL ### Optional Parameters #### limit (string, optional) - Description: Number of similar products to return - Default: "20" - Available options: - "20" - 20 items - "40" - 40 items - "60" - 60 items - "80" - 80 items - "100" - 100 items - "120" - 120 items #### countryCode (string, optional) - Description: Two-letter ISO country code to specify the Lefties regional site - Default: "ES" (Spain) - Supported 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 #### languageCode (string, optional) - Description: Language code for retrieving information in a specific language - Default: Empty string (uses default language for selected country) - Format: Standard language codes (e.g., "en", "es", "pt") - Note: If not provided or null, the actor will use the default language for the selected country ## Input Schema Example json { "productUrl": "https://www.lefties.com/es/en/woman/shoes/new-in/high-heel-sandals-with-metallic-detail-c1030272265p694195974.html?colorId=102&style=01&parentId=702888584", "limit": "40", "countryCode": "PT", "languageCode": "en" } ## Output Format The actor returns a structured JSON object containing the similar products and metadata. ### Output Structure json { "results": { "recommendations": [ // Array of similar product objects // Each product contains detailed information such as: // - Product name and description // - Price information // - Image URLs // - Product URLs // - Availability status // - Color and size options ] }, "completedAt": "2025-06-12T10:04:33.599Z" } ### Key-Value Store Output The actor also saves a summary to the key-value store under the key 'output' with the following structure: json { "results": { "recommendations": [/* similar products array */] }, "completedAt": "2025-06-12T10:04:33.599Z" } ## Usage Instructions ### 1. Basic Usage To run the actor with minimal configuration: json { "productUrl": "https://www.lefties.com/es/en/woman/shoes/new-in/high-heel-sandals-with-metallic-detail-c1030272265p694195974.html?colorId=102&style=01&parentId=702888584" } ### 2. Custom Configuration For specific requirements: json { "productUrl": "https://www.lefties.com/pt/en/woman/dresses/midi-dress-with-floral-print-c1030272013p694187002.html", "limit": "60", "countryCode": "PT", "languageCode": "pt" } ### 3. Maximum Results To get the maximum number of similar products: json { "productUrl": "https://www.lefties.com/it/en/man/t-shirts/basic-t-shirt-c1030272503p694199001.html", "limit": "120", "countryCode": "IT", "languageCode": "it" } ## Error Handling The actor includes comprehensive error handling: - Missing Product URL: Throws an error if productUrl is not provided - Invalid URLs: Validates that the provided URL is accessible - Network Issues: Handles connection timeouts and retries - Empty Results: Returns structured empty results when no similar products are found ## Logging and Monitoring The actor provides detailed console logging: - Start of search process with query and location information - Number of products found vs. requested limit - Completion status and timing - Error details for debugging ## Performance Considerations - Response Time: Typically completes within 30-60 seconds depending on the number of requested products - Rate Limiting: Respects Lefties.com rate limits to ensure reliable operation - Memory Usage: Optimized for efficient memory usage even with large result sets ## Best Practices 1. URL Validation: Ensure the product URL is valid and accessible before running the actor 2. Reasonable Limits: Start with smaller limits (20-40) for testing, increase as needed 3. Country Matching: Use the country code that matches your target product URL for best results 4. Language Consistency: Match the language code with the product URL language when possible ## Troubleshooting ### Common Issues 1. No Results Found - Verify the product URL is correct and accessible - Check if the product is still available on the website - Try with a different country code 2. Incomplete Results - The website might have fewer similar products than requested - Try reducing the limit parameter - Check if the product category has limited similar items 3. Language Issues - If language code is not supported, the actor will fall back to the default country language - Verify the language code format (e.g., "en", "es", "pt") ## Support and Limitations ### Supported Features - All Lefties regional sites - Multiple product categories (clothing, shoes, accessories) - Various product types (new arrivals, sales items, regular products) ### Current Limitations - Only works with Lefties.com product URLs - Limited to publicly available products - Dependent on Lefties website structure and availability ## 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 * Apify Platform: You can also contact us directly through this platform. ---