# Falabella Scraper - Products, Prices & Seller Leads (`scrapesage/falabella-scraper`) Actor

Scrape Falabella (Chile, Peru, Colombia) — products by keyword, category or URL with live prices, discounts, ratings, specs, variants, images & stock, plus buyer reviews and marketplace seller leads. Keyless, no browser. Monitor price drops & restocks.

- **URL**: https://apify.com/scrapesage/falabella-scraper.md
- **Developed by:** [Scrape Sage](https://apify.com/scrapesage) (community)
- **Categories:** E-commerce, Lead generation, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $4.00 / 1,000 products

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## Falabella Scraper — Products, Prices, Discounts & Seller Leads (Chile, Peru & Colombia)

Extract **complete Falabella marketplace product data** across **Chile, Peru and Colombia** — live selling prices, original prices & exact discounts, CMR card prices, ratings and review counts, brand, key specs, all product images, delivery options, category, and the seller behind each listing. Turn the marketplace's third‑party sellers into **seller leads** with catalog intelligence, and watch price drops across scheduled runs with monitor mode.

No login, no cookies, no browser — fast JSON extraction straight from Falabella's own page data.

### Why this Falabella scraper?

Falabella is the biggest department‑store **marketplace** in the Andean region (falabella.com / .com.pe / .com.co), with thousands of third‑party sellers alongside Falabella, Sodimac and Tottus. Most existing scrapers return only a single country and a bare list of titles. This actor ships the **richest product feed in the category** plus the only seller‑lead wedge and price monitor.

| Data | Typical scrapers | This actor |
|---|---|---|
| Current price + original price + discount % | partial | ✅ all, parsed numerically |
| CMR card price | ❌ | ✅ when present |
| Rating + review count | partial | ✅ |
| Brand, key specs, delivery options, category | partial | ✅ |
| Seller name + first‑party vs marketplace | ❌ | ✅ |
| Marketplace **seller leads** (catalog stats + score) | ❌ | ✅ opt-in |
| Chile + Peru + Colombia in one actor | usually 1 country | ✅ |
| Price-drop **monitor** (only new / changed) | ❌ | ✅ |
| All product image URLs | partial | ✅ |

### Use cases

- **Price & promotion monitoring** — track selling prices, discounts and CMR prices across CL/PE/CO; get only price drops with monitor mode.
- **Product & market research** — pull catalog data (price, brand, rating, key specs, images) by keyword or category for any vertical: tech, home, fashion, beauty, appliances.
- **Competitor & assortment intelligence** — see which brands and sellers list what, at what price, and how they're rated.
- **Marketplace seller prospecting** — turn third‑party sellers into leads: who they are, how many listings they run, which brands/categories they cover, their price range and rating.
- **Repricing & MAP compliance** — feed live competitor pricing into your repricing or brand‑protection workflows.

### How to use

1. [Sign up for Apify](https://console.apify.com/sign-up) — the free plan is enough to try this actor.
2. Open the **Falabella Scraper**, pick a **market** (Chile / Peru / Colombia), enter search queries or paste category URLs, and click **Start**.
3. Watch results stream into the dataset table.
4. **Export** as JSON, CSV, Excel, XML, or RSS — or pull results programmatically via the [Apify API](https://docs.apify.com/api/v2).

### Input

```json
{
    "market": "cl",
    "searchQueries": ["laptop", "smart tv"],
    "sort": "relevance",
    "minPrice": 100000,
    "onlyDiscounted": true,
    "outputSellerLeads": true,
    "maxResults": 200,
    "monitorMode": false
}
```

- **market** — `cl` (Chile / CLP), `pe` (Peru / PEN) or `co` (Colombia / COP). Prices and currency are localized.
- **searchQueries** — keywords; each is paginated up to `maxResults`.
- **categoryUrls** — full Falabella category page URLs (e.g. `…/category/cat70057/Notebooks`).
- **startUrls** — paste any Falabella **search or category** URL; the type and market are auto‑detected.
- **sort** — `relevance`, `priceLowToHigh`, `priceHighToLow`, `topRated`, `discount`.
- **minPrice / maxPrice / onlyDiscounted** — result filters.
- **outputSellerLeads** *(default false)* — emit one deduped marketplace‑seller lead per unique seller.
- **monitorMode / monitorKey** — only output new/price‑changed products across scheduled runs (see below).

### Output

One record per product (`type: "product"`), plus optional `sellerLead` records:

```json
{
    "type": "product",
    "productId": "142507703",
    "name": "Mouse Inalámbrico Logitech Lightspeed G304 Gamer",
    "brand": "LOGITECH",
    "url": "https://www.falabella.com/falabella-cl/product/142507703/...",
    "market": "cl",
    "currency": "CLP",
    "price": 39490,
    "originalPrice": 59988,
    "discountPercent": 34,
    "cmrPrice": null,
    "rating": 4.85,
    "reviewsCount": 13,
    "sellerId": "SCFFFFA",
    "sellerName": "Water. CL",
    "sellerType": "marketplace",
    "isMarketplaceSeller": true,
    "deliveryOptions": ["Llega mañana", "Envío gratis app"],
    "categoryId": "G19020404",
    "images": ["https://media.falabella.com/falabellaCL/153591461_01/public"],
    "scrapedAt": "2026-06-18T12:00:00.000Z"
}
```

Seller lead record (`type: "sellerLead"`):

```json
{
    "type": "sellerLead",
    "sellerName": "Water. CL",
    "sellerType": "marketplace",
    "isMarketplaceSeller": true,
    "market": "cl",
    "productCount": 3,
    "brands": ["LOGITECH", "RAZER"],
    "brandsCount": 2,
    "avgRating": 4.63,
    "totalReviews": 52,
    "priceMin": 39490,
    "priceMax": 58990,
    "leadScore": 65
}
```

### Monitor mode (only new / changed)

Turn on **monitorMode** to remember what previous runs saw (in a named key‑value store) and output **only** new products, price drops and price rises — each tagged with a `monitorReason`. Use a distinct **monitorKey** per saved search.

This is **orthogonal to [Apify Schedules](https://docs.apify.com/platform/schedules)**: monitor mode decides *what* is emitted (only changes), while Schedules decide *when* the actor runs. Combine them for hands‑off price‑watch alerts.

### Automate & schedule

Run this actor on autopilot and pull results into your own stack:

- **[Apify API](https://docs.apify.com/api/v2)** — start runs, fetch datasets, manage schedules over REST.
- **[apify-client for JavaScript](https://docs.apify.com/api/client/js/)** and **[Python](https://docs.apify.com/api/client/python/)** — official SDKs.
- **[Schedules](https://docs.apify.com/platform/schedules)** — run it hourly/daily to watch prices and discounts for a search or category.
- **[Webhooks](https://docs.apify.com/platform/integrations/webhooks)** — trigger CRM imports, Slack alerts or repricing the moment a run finishes.

```js
import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'MY_APIFY_TOKEN' });

const run = await client.actor('scrapesage/falabella-scraper').call({
    market: 'cl',
    searchQueries: ['smart tv'],
    outputSellerLeads: true,
    maxResults: 200,
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(`Got ${items.length} Falabella records`);
```

### Integrate with any app

Connect the dataset to 5,000+ apps — no code required:

- **[Make](https://docs.apify.com/platform/integrations/make)** — multi-step automation scenarios.
- **[Zapier](https://docs.apify.com/platform/integrations/zapier)** — push products or seller leads straight into your CRM/sheet.
- **[Slack](https://docs.apify.com/platform/integrations/slack)** — get notified when a monitored search finds a price drop.
- **[Google Drive / Sheets](https://docs.apify.com/platform/integrations/drive)** — auto-export every run to a spreadsheet.
- **[Airbyte](https://docs.apify.com/platform/integrations/airbyte)** — pipe results into your data warehouse.
- **[GitHub](https://docs.apify.com/platform/integrations/github)** — trigger runs from commits or releases.

### Use with AI assistants (MCP)

The output is clean, LLM-ready JSON. Call this actor from Claude, ChatGPT or any agent framework through the **[Apify MCP server](https://docs.apify.com/platform/integrations/mcp)** — ask your assistant to "find the cheapest 4K TVs on Falabella Chile and list the sellers" and let it run this scraper.

### Agent-ready: autonomous payments (x402 & Skyfire)

This actor is **agent-ready** — AI agents can discover it, run it, and **pay for it autonomously**, with no Apify account and no human in the loop. It uses [pay-per-event](https://docs.apify.com/platform/actors/publishing/monetize/pay-per-event) pricing and [limited permissions](https://docs.apify.com/platform/actors/development/permissions), so it qualifies for Apify's agentic-payment standards:

- **[x402](https://docs.apify.com/platform/integrations/x402)** — an open, HTTP-native payment protocol. Agents pay per run in USDC on the Base network directly through the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp) — no account, no API key.
- **[Skyfire](https://docs.apify.com/platform/integrations/skyfire)** — agent-to-service payments for fully autonomous AI-agent workflows.

Building an AI agent, MCP tool, or autonomous data pipeline? This scraper is ready to plug in and pay as it goes.

### More scrapers from scrapesage

Build a complete **e-commerce & marketplace intelligence stack**:

- **[Amazon Scraper](https://apify.com/scrapesage/amazon-scraper)** — products, prices, reviews & sellers across 20 marketplaces.
- **[AliExpress Scraper](https://apify.com/scrapesage/aliexpress-scraper)** — products, variants, reviews & supplier leads.
- **[Alibaba Scraper](https://apify.com/scrapesage/alibaba-scraper)** — B2B wholesale products, tiered prices & supplier leads.
- **[Flipkart Scraper](https://apify.com/scrapesage/flipkart-scraper)** — India's #1 marketplace: products, prices & reviews.
- **[Banggood Scraper](https://apify.com/scrapesage/banggood-scraper)** — cross-border / dropshipping products & reviews.
- **[OLX Brazil Scraper](https://apify.com/scrapesage/olx-brazil-scraper)** — Brazil's #1 classifieds: cars, real estate & listings.
- **[Vinted Scraper](https://apify.com/scrapesage/vinted-scraper)** — Europe's #1 secondhand fashion marketplace.
- **[Website Contact Scraper](https://apify.com/scrapesage/website-contact-scraper)** — emails, phones & socials from any domain list.

### Tips

- **Proxies**: keep the default **residential** group. Falabella serves correct localized prices for each market regardless of proxy country, so the global residential pool is the most reliable choice.
- **Big catalogs**: raise `maxResults` and narrow with `categoryUrls` or `searchQueries` + `sort`.
- **Recurring monitoring**: combine [Schedules](https://docs.apify.com/platform/schedules) with `monitorMode` to get only price drops.
- **Filters**: `minPrice`/`maxPrice`/`onlyDiscounted` and `topRated`/`discount` sorting are applied to the collected results — raise `maxResults` when filtering hard so enough candidates are gathered.

### FAQ

**Which countries are supported?** Chile (`cl`), Peru (`pe`) and Colombia (`co`) — the three markets that share Falabella's unified marketplace platform.

**Do I need an API key or login?** No. The actor reads Falabella's own public page data — no key, cookies or browser.

**Can I export to Google Sheets, CSV, or Excel?** Yes — one click in the dataset view, or automatically on every run via the [Google Drive integration](https://docs.apify.com/platform/integrations/drive).

**How do I monitor price drops automatically?** Turn on `monitorMode`, create a [Schedule](https://docs.apify.com/platform/schedules), and optionally add a [webhook](https://docs.apify.com/platform/integrations/webhooks) to push changes into your tools.

**Do seller leads include emails or phone numbers?** Falabella does not publish seller contact details, so seller leads provide *catalog intelligence* — seller name & ID, first‑party vs third‑party type, listing count, brands & categories, price range, rating and a lead score — to identify and prioritise marketplace sellers.

**A field is null — why?** Some products genuinely don't publish a discount, CMR price or rating. Fields are `null` only when the data doesn't exist, not because the scraper skipped them.

**Is scraping Falabella legal?** This actor collects publicly available data only. You are responsible for using the data in compliance with applicable laws (e.g. local data‑protection rules) and Falabella's terms.

### Need help?

Open an issue on the actor's **Issues** tab, or visit the [Apify help center](https://help.apify.com/). Feature requests are welcome — this actor is actively maintained.

# Actor input Schema

## `market` (type: `string`):

Which Falabella marketplace to scrape. cl = Chile (falabella.com), pe = Peru (falabella.com.pe), co = Colombia (falabella.com.co). Prices and currency are localized per market.

## `searchQueries` (type: `array`):

Keywords to search, e.g. "laptop", "zapatillas running", "smart tv". Each query is paginated up to Max results. Leave empty if you use Category URLs or Start URLs instead.

## `categoryUrls` (type: `array`):

Full Falabella category page URLs to browse, e.g. https://www.falabella.com/falabella-cl/category/cat70057/Notebooks . Every product on the category (paginated) is collected.

## `startUrls` (type: `array`):

Paste any Falabella search or category URL. The page type and the market are auto-detected from the URL (.com / .com.pe / .com.co).

## `sort` (type: `string`):

Result ordering. relevance = Falabella's default ranking. priceLowToHigh / priceHighToLow are applied by Falabella; topRated and discount are applied to the collected results.

## `minPrice` (type: `integer`):

Only keep products whose current price is at or above this value (in the market's currency). Leave empty for no minimum.

## `maxPrice` (type: `integer`):

Only keep products whose current price is at or below this value (in the market's currency). Leave empty for no maximum.

## `onlyDiscounted` (type: `boolean`):

Keep only products that currently have a discount (a crossed-out original price or a discount badge).

## `outputSellerLeads` (type: `boolean`):

Emit one deduped marketplace-seller lead per unique seller found (seller name & ID, first-party vs third-party, listing count, brands & categories sold, price range, average rating, 0-100 lead score). Great for competitor monitoring and marketplace seller prospecting.

## `maxResults` (type: `integer`):

Overall cap on the number of products collected for this run. Seller leads are emitted in addition to this cap.

## `monitorMode` (type: `boolean`):

Remember what was emitted in previous runs (in a named key-value store) and output only NEW products and PRICE changes (drops & rises). Perfect for scheduled price-watch alerts. Each record carries a monitorReason field. Works alongside Apify Schedules (this controls WHAT is emitted; Schedules control WHEN the actor runs).

## `monitorKey` (type: `string`):

Namespace for monitor memory. Use a distinct key per saved search so separate watch lists don't share state.

## `maxConcurrency` (type: `integer`):

Parallel requests. The actor rotates a fresh proxy IP per request; lower this if you hit throttling.

## `proxyConfiguration` (type: `object`):

Proxy settings. Residential proxies are recommended (and enabled by default) for Falabella. Falabella serves correct localized prices for each market regardless of proxy country, so the default global residential pool is the most reliable choice.

## Actor input object example

```json
{
  "market": "cl",
  "searchQueries": [
    "laptop"
  ],
  "sort": "relevance",
  "onlyDiscounted": false,
  "outputSellerLeads": false,
  "maxResults": 100,
  "monitorMode": false,
  "monitorKey": "default",
  "maxConcurrency": 6,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

# Actor output Schema

## `results` (type: `string`):

All scraped product and seller-lead records as JSON items in the default dataset.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "searchQueries": [
        "laptop"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("scrapesage/falabella-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "searchQueries": ["laptop"] }

# Run the Actor and wait for it to finish
run = client.actor("scrapesage/falabella-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "searchQueries": [
    "laptop"
  ]
}' |
apify call scrapesage/falabella-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=scrapesage/falabella-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/HBuoL0qgHBMVvXj7g/builds/QQpuv1FdTZCAF1rJw/openapi.json