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

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

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

{
  "results": {
    "recommendations": [/* similar products array */]
  },
  "completedAt": "2025-06-12T10:04:33.599Z"
}

Usage Instructions

1. Basic Usage

To run the actor with minimal configuration:

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

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

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

---