Falabella Chile Product Search Scraper 🛒

Overview

This scraper extracts product information from Falabella Chile's search results. You can provide search keywords to get comprehensive product data including pricing, specifications, images, availability, and more from Chile's largest retail store.

Now featuring advanced native filtering: easily filter by Falabella's native price ranges, discount percentages, or apply custom min/max price bounds—all processed with lightning-fast concurrent requests.

Why choose this scraper? 🌟

• Advanced Native Filtering: Natively filter results by specific price ranges or discount percentages directly through Falabella's API.
• Custom Price Post-Filtering: Discard products outside your exact budget with custom min_price and max_price limits.
• Comprehensive Product Data: Extract detailed product information including pricing, specifications, images, and availability.
• High-Performance: Uses concurrent requests with rate limiting for optimal and fast performance.
• Easy Integration: Simple keyword-based input for quick product data extraction.
• Reliable Performance: Built with robust error handling and retry mechanisms.
• Chilean Market Focus: Specifically designed for Falabella Chile's website structure.
• Complete Product Details: Access to specifications, dimensions, features, and more.

Use Cases

• E-commerce Analytics: Analyze product pricing and availability in the Chilean market
• Competitive Intelligence: Monitor Falabella's product offerings and pricing strategies
• Market Research: Gather comprehensive product data for Chilean market analysis
• Inventory Management: Track product availability and stock levels
• Price Monitoring: Monitor price changes and promotions on Falabella Chile
• Product Cataloging: Build comprehensive product databases for the Chilean market

Key Features 🚀

• Advanced Price & Discount Filters: Use Falabella's native "Price Range" and "Discount" filters to reduce noise, or set your own custom min/max price bounds.
• Product Information: Name, SKU, brand, product type, description
• Pricing Data: Price, currency (CLP), price variants, discounts
• Availability: Stock status, seller information, sponsored products
• Product Details: Measurements, specifications, features
• Customer Reviews: Rating, total reviews count
• Product Images: Photo URLs and multimedia content
• Categories: Product categorization and type
• Seller Information: Seller ID, seller name, product badges
• Concurrent Processing: Fast data extraction with controlled concurrency

How It Works

1. Input: Provide search keywords for products you want to find on Falabella Chile
2. Processing: The scraper searches across multiple pages with concurrent requests
3. Output: Receive structured JSON data with detailed product information

Input Parameters

Field	Type	Description	Default	Example
keywords	array	Search keywords for products on Falabella Chile	Required	"accesorios de niños"
max_pages	integer	Maximum number of pages to search per keyword	25	10
min_price	integer	Custom minimum price to filter products post-extraction	-1 (no limit)	10000
max_price	integer	Custom maximum price to filter products post-extraction	-1 (no limit)	50000
price_ranges	array	Falabella's native price ranges (e.g. "$20.000 - $40.000")	[]	["$10.000 - $20.000"]
discount	string	Native discount filter (e.g. "30% dcto y más")	""	"20% dcto y más"

NOTE: Each page returns a maximum of 48 products.

Output Schema

The scraper returns detailed product information in the following structure:

{
  "id": "product-123456",
  "sku": "SKU123456",
  "name": "Product Name",
  "brand": "Brand Name",
  "product_type": "Electronics",
  "url": "https://www.falabella.com/falabella-cl/product/product-name",
  "price": 99990.0,
  "price_variants": [
    {
      "price": 99990.0,
      "currency": "CLP"
    }
  ],
  "currency": "CLP",
  "photos": [
    "https://images.falabella.com/product-image-1.jpg",
    "https://images.falabella.com/product-image-2.jpg"
  ],
  "measurements": {
    "weight": "1.5 kg",
    "dimensions": "20x15x10 cm"
  },
  "discounts": {
    "percentage": 15,
    "original_price": 117990.0
  },
  "badges": [
    "Envío gratis",
    "Oferta"
  ],
  "multipurpose_badges": [
    "Nuevo",
    "Destacado"
  ],
  "seller_id": "seller123",
  "seller_name": "Falabella",
  "is_sponsored": false,
  "is_best_seller": true,
  "category_id": "cat123",
  "rating": 4.5,
  "total_reviews": 125,
  "variants": [
    {
      "color": "Rojo",
      "size": "M"
    }
  ]
}

Output Fields Explained

Basic Product Information

• id: Unique product identifier
• sku: Stock Keeping Unit
• name: Product name/title
• brand: Brand or manufacturer name
• product_type: Type/category of product
• url: Product page URL on Falabella Chile

Pricing Information

• price: Current selling price in CLP
• price_variants: Array of different price options
• currency: Price currency (CLP - Chilean Peso)
• discounts: Discount information and original prices

Availability & Seller Information

• seller_id: Unique seller identifier
• seller_name: Name of the seller/vendor
• is_sponsored: Whether the product is sponsored
• is_best_seller: Whether the product is a best seller

Product Media

• photos: Array of product image URLs
• multipurpose_badges: Additional product badges and labels

Product Specifications

• measurements: Product dimensions and measurements
• variants: Product variations (color, size, etc.)
• category_id: Product category identifier

Customer Feedback

• rating: Average customer rating
• total_reviews: Number of customer reviews

Product Badges

• badges: Array of promotional badges (free shipping, offers, etc.)

Performance Features

Concurrent Processing

• Semaphore-based Rate Limiting: Controls concurrent requests to prevent server overload
• Configurable Concurrency: Adjustable maximum concurrent requests (default: 5)
• Error Handling: Robust error handling for individual page requests
• Progress Tracking: Real-time progress updates during scraping

Sequential vs Concurrent Modes

• Sequential Mode: Traditional page-by-page processing
• Concurrent Mode: Fast parallel processing with rate limiting

Rate Limiting

The scraper includes built-in rate limiting to respect Falabella Chile's server capabilities:

• Default: 5 concurrent requests
• Automatic retry mechanism for failed requests

Data Types

The scraper uses structured data types for consistent output:

@dataclass
class Product:
    id: str
    sku: str = ""
    name: str = ""
    brand: str = ""
    product_type: str = ""
    url: str = ""
    price: float = 0
    price_variants: List[Any] = field(default_factory=list)
    currency: str = "CLP"
    photos: List[Any] = field(default_factory=list)
    measurements: dict = field(default_factory=dict)
    discounts: dict = field(default_factory=dict)
    badges: List[Any] = field(default_factory=list)
    multipurpose_badges: List[Any] = field(default_factory=list)
    seller_id: str = ""
    seller_name: str = ""
    is_sponsored: bool = False
    is_best_seller: bool = False
    category_id: str = ""
    rating: float = 0.0
    total_reviews: int = 0
    variants: List[Any] = field(default_factory=list)

Limitations

• Rate Limiting: Respects Falabella Chile's rate limits and terms of service
• Page Limits: Maximum pages configurable but subject to available results
• Language: Optimized for Spanish language content
• Geographic: Designed for Chilean market (CLP currency, Chilean shipping)

Legal Disclaimer

This scraper is intended for public data extraction only. Ensure your usage complies with Falabella Chile's terms of service and applicable Chilean data protection regulations.

Support

For technical support or questions about this scraper, please refer to the project documentation or contact the development team.

---

Note: This scraper is designed for legitimate business use cases and market research in the Chilean market. Please ensure compliance with all applicable laws and website terms of service.