Falabella Marketplace Scraper

Scrape products, prices and sellers from Falabella (falabella.com), Latin America's leading retail marketplace. One actor covers three country storefronts: Chile (falabella.com), Colombia (falabella.com.co) and Peru (falabella.com.pe). Each market is its own catalogue with its own currency, and the actor pins the connection exit to the market you select.

Why This Scraper?

• Three storefronts in one actor: Chile, Colombia and Peru, each with its local currency and catalogue.
• Full listing data on every row: price, was-price, discount, rating, review count, seller, installments and shipping flags.
• Optional detail reads add the description, specification table, category path, stock state, loyalty points and the seller's registered business details.
• Recurring updates mode labels every record NEW, UPDATED, REAPPEARED or EXPIRED, so a scheduled run returns only what changed.
• Resume support: continue an interrupted run from its run id without paying for the same rows twice.
• Paste your own links (products, categories, keyword collections, searches) or run keyword searches; forward pagination and de-duplication are automatic.
• A run that is refused everywhere fails loudly with a connection verdict; a genuinely empty search succeeds with zero rows and a visible note.

Data You Get

Field	Meaning
id	Marketplace product id
skuId	Variant (SKU) id
name	Listing title
brand	Brand
url	Product link
imageUrl	Main image
currency	Local currency of the market
price	Current price (number)
priceDisplay	Price exactly as the storefront shows it
oldPrice	Was-price when the product is discounted
discountPercent	Discount percentage from the storefront badge
ratingAverage	Customer rating
ratingCount	Number of reviews
sellerId	Marketplace seller id
sellerName	Marketplace seller name
market	Market country code (CL, CO, PE)
marketHost	Storefront the record came from
description	Short description (detail reads)
specifications	Specification table (detail reads)
categories	Category path (detail reads)
outOfStock	Stock state (detail reads)
sellerDetails	Seller business name, registration number, score (detail reads)
changeType	NEW, UPDATED, REAPPEARED or EXPIRED (recurring updates)
changedFields	Fields that changed since the last run (recurring updates)
firstSeenAt / lastSeenAt	First and most recent sighting (recurring updates)

Every row also carries the flags the card itself shows: verified and official seller, sponsored and best-seller placement, installment offers, delivery flags, plus the long description, per-variant stock counts, loyalty points, warranty code and extra images on detail reads.

How to Use

Pick Keyword search or My own links, choose the market, and run. The examples below are illustrative values, not from a live listing.

Minimal keyword search:

{
  "mode": "search",
  "market": "cl",
  "queries": ["poleron"],
  "maxItems": 20
}

Ordered search with detail reads:

{
  "mode": "search",
  "market": "co",
  "queries": ["zapatilla"],
  "sort": "price-asc",
  "fetchDetails": true,
  "maxItems": 50
}

Your own links, one market each:

{
  "mode": "urls",
  "urls": ["https://www.falabella.com/falabella-cl/product/100000001/producto-de-muestra"],
  "maxItems": 10
}

Daily price monitoring:

{
  "mode": "search",
  "market": "pe",
  "queries": ["polo"],
  "incrementalMode": true,
  "stateKey": "polo-daily",
  "maxItems": 200
}

Input Parameters

Parameter	What it does
mode	Keyword search on one storefront, or your own product and listing links.
market	Which country storefront: Chile, Colombia or Peru. Each is its own catalogue.
queries	Search terms, one entry per search; all searches share the record cap.
sort	Ordering per search: relevance (site default), lowest price or highest price.
urls	Product, category, keyword-collection or search links. Each is read on its own market.
fetchDetails	Read each product's page for description, specifications, stock and seller details (per-product surcharge).
maxItems	The single record cap for the whole run; 0 means no limit.
maxPages	Runaway guard per source; 0 means as deep as the storefront serves.
resumeFromRunId	Run id (or dataset id) of an interrupted run to continue.
incrementalMode	Return only what changed since the previous run of the same setup.
stateKey	Optional name for a monitoring campaign, keeping its memory stable.
emitUnchanged	Also return rows that did not change, labelled UNCHANGED (bills extra rows).
emitExpired	Also return rows that are gone, labelled EXPIRED (only after a complete scan).
mcpConnectors	Connector ids to export results into (optional delivery step).
notionParentPageUrl	Notion parent page for the Notion connector export.
maxNotifyListings	Cap on items written per connector; does not affect the dataset.
proxyConfiguration	Connection used for every request; defaults to the premium consumer tier pinned to the market.

Output Example

Illustrative values, not from a live listing:

{
  "recordType": "product",
  "id": "100000001",
  "skuId": "100000002",
  "name": "Producto de muestra 1",
  "brand": "MARCAMUESTRA",
  "url": "https://www.falabella.com/falabella-cl/product/100000001/producto-de-muestra",
  "imageUrl": "https://media.falabella.com/falabellaCL/100000002_01/public",
  "currency": "CLP",
  "price": 22390.0,
  "priceDisplay": "$ 22.390",
  "oldPrice": 27990.0,
  "discountPercent": 20,
  "ratingAverage": 4.5,
  "ratingCount": 10,
  "sellerId": "S0000",
  "sellerName": "Vendedor de muestra",
  "market": "CL",
  "marketHost": "www.falabella.com",
  "description": "Descripcion del producto de muestra.",
  "specifications": [{"name": "Color", "value": "Rojo"}],
  "changeType": "NEW"
}

Plan Requirement

The storefronts refuse ordinary datacenter connections, so the default connection is the premium consumer proxy tier pinned to the selected market's country. Running the actor needs a paid Apify plan that includes that tier, or your own proxy links pasted into the Connection section. If a serving window closes mid-run, the actor falls back to a result-unblocking tier so the run can finish.

Notes and limits

• Product ids and category ids are per-country: a Chilean product id does not exist on the Peruvian storefront.
• Max records is the only cap that stops a run; max pages is a runaway guard.
• Continue-a-previous-run and recurring updates are mutually exclusive: use one or the other.
• Keyword searches can be answered by a keyword collection or a category page; the actor follows the storefront's own redirect and walks that route.

Send results into your apps (MCP connectors)

Optionally pipe results into the apps you already use, via Model Context Protocol (MCP) connectors. Authorize a connector under Apify, Settings, API & Integrations, then fill in:

Input field	What it does
mcpConnectors	The connectors to export into. Notion gets a rich page-per-item export; other connectors get a best-effort write or a digest.
notionParentPageUrl	URL or id of the Notion page under which item pages are created. Required for the Notion connector, ignored by others.
maxNotifyListings	Cap on items written to each connector per run. Does not affect the dataset.

The export is a delivery step after the scrape. It never changes the dataset.

Support

Open an issue in the actor's support tab; include the run id and the input used.