Lefties Products By Category Actor

A powerful Apify actor designed to scrape product data from Lefties category pages across multiple countries and languages.

Overview

The Lefties Products By Category Actor extracts product information from Lefties.com category pages, supporting multiple regions and languages. It provides paginated results with comprehensive product data and metadata.

Features

• Multi-region Support: Works with 20+ countries including Spain, Portugal, Italy, Mexico, UAE, and more
• Language Flexibility: Supports custom language codes or defaults to country-specific languages
• Pagination: Handles large product catalogs with configurable page sizes
• Error Handling: Robust error management with detailed logging
• Data Export: Results saved to Apify dataset and key-value store

Input Parameters

Required Parameters

Parameter	Type	Description
categoryUrl	string	The Lefties category URL to scrape products from

Optional Parameters

Parameter	Type	Default	Description
page	integer	1	Page number for pagination (starting from 1)
perPage	string	"20"	Number of items per page (20, 40, 60, 80, 100, 120)
countryCode	string	"ES"	Two-letter country code for regional site
languageCode	string	""	Language code (if empty, uses country default)

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

Input Example

{
  "categoryUrl": "https://www.lefties.com/es/en/woman/shoes/new-in-c1030272265.html",
  "page": 1,
  "perPage": "40",
  "countryCode": "PT",
  "languageCode": "en"
}

Output Format

The actor returns structured data containing pagination information and product arrays.

Output Structure

{
  "results": {
    "pagination": {
      "page": 1,
      "perPage": 20,
      "totalItems": 23,
      "totalPages": 2,
      "hasNext": true,
      "hasPrev": false
    },
    "products": [
      // Array of product objects
    ]
  },
  "completedAt": "2025-06-12T08:05:23.412Z"
}

Pagination Object

Field	Type	Description
page	integer	Current page number
perPage	integer	Items per page
totalItems	integer	Total number of products found
totalPages	integer	Total number of pages available
hasNext	boolean	Whether there are more pages
hasPrev	boolean	Whether there are previous pages

Usage Examples

Basic Usage

// Scrape first page of women's shoes from Spanish site
{
  "categoryUrl": "https://www.lefties.com/es/en/woman/shoes/new-in-c1030272265.html"
}

Advanced Usage

// Scrape page 2 with 60 items from Portuguese site in English
{
  "categoryUrl": "https://www.lefties.com/pt/en/woman/dresses-c1030272243.html",
  "page": 2,
  "perPage": "60",
  "countryCode": "PT",
  "languageCode": "en"
}

Multi-page Scraping

// For scraping multiple pages, run the actor multiple times with different page numbers
// Page 1
{
  "categoryUrl": "https://www.lefties.com/es/en/man/shirts-c1030272271.html",
  "page": 1,
  "perPage": "100"
}

// Page 2
{
  "categoryUrl": "https://www.lefties.com/es/en/man/shirts-c1030272271.html",
  "page": 2,
  "perPage": "100"
}

Error Handling

The actor includes comprehensive error handling:

• Missing Category URL: Throws error if categoryUrl is not provided
• Invalid URLs: Validates category URL format
• Network Issues: Retries failed requests with exponential backoff
• Country/Language Mismatches: Falls back to default language for country

Data Storage

Results are stored in two locations:

1. Apify Dataset: Contains the main results for easy access and export
2. Key-Value Store: Stores output with timestamp under the key output

Performance Considerations

• Rate Limiting: Built-in delays to respect Lefties.com servers
• Memory Optimization: Processes products in batches to handle large catalogs
• Concurrent Requests: Limited concurrent requests to prevent blocking

Monitoring and Logging

The actor provides detailed logging:

• Search initiation with parameters
• Products found per page
• Completion status and timing
• Error details and stack traces

Best Practices

1. Start Small: Begin with smaller page sizes (20-40) to test
2. Monitor Pagination: Check totalPages to plan multi-page scraping
3. Country-Specific URLs: Use appropriate country URLs for better results
4. Language Consistency: Ensure language codes match the category URL
5. Error Recovery: Implement retry logic for failed runs

Troubleshooting

Common Issues

No Products Found

• Verify the category URL is correct and accessible
• Check if the country code matches the URL region
• Ensure the category has products in stock

Pagination Issues

• Verify page number is within valid range
• Check totalPages in previous results
• Ensure perPage value is supported

Country/Language Errors

• Use supported country codes only
• Leave languageCode empty for default language
• Verify language is available for the selected country

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.

---