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:

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

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

   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

{
  "productUrls": [
    {"url": "https://www.lefties.com/es/mujer/ropa/vestidos/vestido-denim-camisero-ligero-c1030267514p659617227.html?colorId=251&parentId=659620054"}
  ]
}

Multiple Products Example

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

---