Lefties Product Info Actor ## Overview The Lefties Product Info Actor is a web scraping tool deployed on the Apify platform designed to extract comprehensive product information from Lefties.com, a popular fashion retailer. This actor processes multiple product URLs and returns detailed product data including pricing, descriptions, availability, images, and more. ## Features - Batch Processing: Handles multiple product URLs simultaneously - Comprehensive Data Extraction: Retrieves detailed product information including: - Product ID and basic information - Pricing and reference numbers - Product descriptions - Available colors and sizes - Stock status - Product images - Composition and care instructions - Rate Limiting: Built-in random delays to avoid overwhelming the target website - Error Handling: Robust error handling with detailed logging - Flexible Output: Stores results both individually and as a complete dataset ## Input Configuration ### Input Schema The actor accepts a JSON input with the following structure: json { "productUrls": [ { "url": "https://www.lefties.com/es/mujer/ropa/vestidos/vestido-denim-camisero-ligero-c1030267514p659617227.html?colorId=251&parentId=659620054" }, { "url": "https://www.lefties.com/es/en/woman/new-in/embroidered-shirt-c1030267503p690881349.html?colorId=250&style=01&parentId=702887908" } ] } ### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | productUrls | Array | Yes | Array of objects containing product URLs to scrape | | productUrls[].url | String | Yes | Complete Lefties product URL | ### Default Input The actor comes with pre-configured example URLs for testing: - Women's denim shirt dress - Embroidered women's shirt ## Output Format The actor returns an array of product objects with the following structure: ### Product Object Structure json { "productId": "string", "name": "string", "price": "string", "reference": "string", "description": "string", "colors": { "current": "string", "available": [ { "name": "string", "isActive": boolean } ], "colorImages": [] }, "sizes": { "available": [ { "size": "string", "inStock": boolean } ], "stockStatus": "string" }, "details": { "composition": ["string"], "careInstructions": ["string"] }, "images": ["string"], "productUrl": "string" } ### Output Fields Description | Field | Type | Description | |-------|------|-------------| | productId | String | Unique product identifier | | name | String | Product name/title | | price | String | Product price with currency | | reference | String | Product reference number | | description | String | Detailed product description | | colors.current | String | Currently selected color | | colors.available | Array | Available color options with active status | | colors.colorImages | Array | Color-specific product images | | sizes.available | Array | Available sizes with stock status | | sizes.stockStatus | String | Overall stock status (e.g., "Low stock") | | details.composition | Array | Material composition information | | details.careInstructions | Array | Care and washing instructions | | images | Array | Product image URLs | | productUrl | String | Original product URL | ## Usage Instructions ### Running the Actor 1. Via Apify Console: - Navigate to the actor in your Apify console - Configure the input with your desired product URLs - Click "Start" to run the actor 2. Via API: bash curl -X POST https://api.apify.com/v2/acts/THE_ACTOR_ID/runs \ -H "Authorization: Bearer YOUR_API_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "productUrls": [ {"url": "https://www.lefties.com/es/mujer/ropa/vestidos/vestido-denim-camisero-ligero-c1030267514p659617227.html?colorId=251&parentId=659620054"} ] }' ### Input Preparation 1. URL Format: Ensure URLs are complete Lefties product URLs 2. URL Parameters: Include all necessary parameters (colorId, parentId, etc.) 3. Language Support: The actor supports both Spanish (/es/) and English (/en/) product pages ### Best Practices - Rate Limiting: The actor includes built-in delays between requests to be respectful to the target website - Batch Size: For large batches, consider breaking them into smaller chunks to avoid timeouts - URL Validation: Verify that all URLs are accessible and properly formatted before running ## Technical Details ### Performance Characteristics - Rate Limiting: Random delays between 1-4 seconds between requests - Concurrent Processing: Sequential processing to avoid overwhelming the target site - Memory Usage: Optimized for handling multiple products efficiently - Error Recovery: Continues processing remaining URLs even if individual requests fail ### Dependencies - Apify SDK: Core framework for actor development - Custom Helpers: Internal productDescriptionByUrl function for data extraction ### Error Handling The actor includes comprehensive error handling: - Logs detailed error messages for debugging - Continues processing remaining URLs on individual failures - Provides clear error reporting in the console ## Output Access ### Data Storage The actor stores results in two ways: 1. Individual Records: Each product is stored as a separate dataset item 2. Complete Output: All results are stored as a single JSON file in the key-value store under the key output ### Accessing Results 1. Via Apify Console: Download results directly from the run detail page 2. Via API: Access the dataset or key-value store using Apify API 3. Webhooks: Set up webhooks to receive results automatically ## Troubleshooting ### Common Issues 1. Empty Results: Verify that the product URLs are accessible and properly formatted 2. Timeouts: Reduce batch size or increase timeout settings 3. Rate Limiting: The actor includes built-in delays, but external rate limiting may still occur ### Debug Information The actor provides detailed console logging: - Processing status for each URL - Error messages with stack traces - Success confirmations ## Example Usage ### Basic Example json { "productUrls": [ {"url": "https://www.lefties.com/es/mujer/ropa/vestidos/vestido-denim-camisero-ligero-c1030267514p659617227.html?colorId=251&parentId=659620054"} ] } ### Multiple Products Example json { "productUrls": [ {"url": "https://www.lefties.com/es/mujer/ropa/vestidos/vestido-denim-camisero-ligero-c1030267514p659617227.html?colorId=251&parentId=659620054"}, {"url": "https://www.lefties.com/es/en/woman/new-in/embroidered-shirt-c1030267503p690881349.html?colorId=250&style=01&parentId=702887908"}, {"url": "https://www.lefties.com/es/mujer/ropa/pantalones/pantalon-wide-leg-c1030267508p659617231.html?colorId=800&parentId=659620058"} ] } ## Limitations - Geographic Restrictions: May be subject to regional availability of Lefties.com - Website Changes: Functionality depends on the current structure of Lefties.com - Rate Limits: Built-in delays help avoid rate limiting, but external limits may still apply - Data Completeness: Some fields may be empty if not available on the product page ## Version Information - Schema Version: 1 - Actor Type: Web Scraper - Platform: Apify - Language: JavaScript (Node.js) --- ## 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. ---