Falabella Scraper

Scrape product data from Falabella.com (Chile) -- one of Latin America's largest online retailers. Get product titles, prices, discounts, ratings, seller information, images, and full specifications from keyword search, category browsing, or specific product pages.

What does this scraper do?

• Search by keyword -- find products matching any search term (e.g. "laptop", "zapatillas", "smart tv").
• Browse a category -- pull every product listed under a Falabella category ID.
• Get product details -- fetch full specifications, seller info, and pricing for exact product IDs or URLs.
• Filter results -- by price range, minimum rating, minimum discount percentage, brand, best-seller flag, and free-shipping availability.
• Sort results -- by relevance, price (low-to-high or high-to-low), or customer rating.

No login, cookies, or paid proxy required.

Output

Each result is a JSON record. Search/category results include:

Field	Description
productId	Falabella's internal product ID
skuId	Falabella's internal SKU ID
title	Product name
brand	Brand name
productType	Falabella's own listing type, e.g. REGULAR or a marketplace-specific code
price	Current sale price (CLP) that any shopper pays -- never the CMR-card-exclusive price
originalPrice	Original price before discount (CLP), if applicable
cmrPrice	Special lower price available only to holders of Falabella's own "CMR" store credit card, if different from price
currency	Always CLP (Chilean peso)
discountPercent	Discount percentage, if any
interestFreeInstallments	Largest number of interest-free monthly installments offered, if any
rating	Average customer rating (0-5)
totalReviews	Number of customer reviews
sellerId / sellerName	Marketplace seller
isVerifiedSeller	Whether the seller is Falabella-verified
isBestSeller	Best-seller flag
isSponsored	Whether the listing is a paid/sponsored placement
shippingTags	Delivery-related tags Falabella shows on the listing, e.g. same_day, envio_plus
freeShipping	Whether free app shipping applies
productCondition	Listing condition tag when present, e.g. Reacondicionado (refurbished) or Open box -- omitted for standard/new listings
imageUrls	Product image URLs
productUrl	Link to the product page
categoryId	Falabella catalog category ID
recordType	product
scrapedAt	UTC timestamp of when the record was scraped

productDetails mode additionally returns description, categoryPath, specifications (name/value pairs), sellerBusinessName, sellerRatingScore, isOutOfStock, stockUnits, and warrantyId.

Only fields that Falabella actually provides for a given product are included -- no blank or placeholder values.

Input options

Field	Mode	Description
mode	all	search, category, or productDetails
searchQuery	search	Keyword to search for
categoryId	category	Falabella category ID (e.g. cat70057)
productIds / productUrls	productDetails	Exact product IDs or full product URLs
sortBy	search/category	relevance, priceAsc, priceDesc, rating
minPrice / maxPrice	search/category	Price range filter in CLP
minRating	search/category	Minimum customer rating (0-5)
minDiscountPercent	search/category	Minimum discount percentage
brand	search/category	Filter to brand names containing this text
onlyBestSeller	search/category	Only include best-sellers
freeShippingOnly	search/category	Only include free-shipping products
newOnly	search/category	Exclude refurbished/open-box listings
maxItems	all	Maximum number of records to return
maxPages	search/category	Maximum result pages to scan

Finding a category ID

Open any category page on Falabella, e.g. https://www.falabella.com/falabella-cl/category/cat70057/Notebooks -- the category ID is cat70057.

Example use cases

• Price monitoring -- track prices and discounts for specific products or categories over time.
• Market research -- analyze brand presence, ratings, and pricing across a product category.
• Deal hunting -- filter for the highest discounts or best-rated products in a category.
• Catalog enrichment -- pull full specifications and images for a list of known product IDs.

FAQ

Does this scraper require login or cookies? No. All data is scraped from Falabella's own publicly rendered pages.

What currency are prices in? Chilean pesos (CLP), Falabella's home market currency.

Does it support other Falabella country sites (Peru, Colombia)? This actor currently supports Falabella's Chile storefront (falabella.com), which is the group's primary and most complete catalog.

What is cmrPrice and why is it different from price? Falabella offers an extra discount to shoppers who pay with its own store credit card ("CMR"). The price field always reflects the price any shopper can pay; cmrPrice is only included when a lower CMR-exclusive price also exists, so you can see both.

Why do some products lack a rating or originalPrice field? Falabella only returns rating/discount data for products that actually have it. Fields are omitted rather than filled with placeholder values, in line with real-data accuracy.

How many products can I scrape per run? Up to maxItems (default 50, max 2000) per run for search/category modes.

Limitations

• Falabella's individual product pages are protected against automated access. This actor reliably fetches productDetails for the vast majority of runs; productUrl values in the output always resolve to the real product page when opened in a browser (a manual non-browser request may show a challenge page instead, which is expected and not a broken link). Search/category mode is unaffected. On rare occasions a specific product ID may fail to load even after retries -- the run continues and reports which IDs could not be fetched rather than failing the whole run. Image URLs (imageUrls) are always directly accessible from any client regardless of mode.
• Only Falabella's Chile storefront (falabella.com) is supported. Falabella's Peru and Colombia storefronts use separate domains with different anti-bot protection and are out of scope for this version.