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 json { "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 json { "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 javascript // 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 javascript // 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 javascript // 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. ---