# Falabella Chile Product & CMR Price Scraper (`crawlyth-forge/falabella-chile-product-and-cmr-price-scraper`) Actor

Extract Falabella Chile products by keyword, category, or product ID: regular and CMR-card prices, discounts, ratings, seller details, images and specifications, with price, rating, brand and shipping filters.

- **URL**: https://apify.com/crawlyth-forge/falabella-chile-product-and-cmr-price-scraper.md
- **Developed by:** [crawlyth forge](https://apify.com/crawlyth-forge) (community)
- **Categories:** E-commerce, Automation, Developer tools
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.49 / 1,000 results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Falabella Chile Product & CMR Price Scraper

Falabella is Chile's largest department-store retailer, selling everything from electronics to footwear through its own catalog and third-party marketplace sellers. This actor pulls structured product data by keyword search, category ID, or a known product ID/URL — including the separate price Falabella shows to holders of its own "CMR" store card.

### What this actor does

- **Keyword search** across the full falabella.com catalog.
- **Category browsing** by category ID, so you can pull an entire department without typing search terms.
- **Direct product lookup** by product ID or product URL, returning full specifications and seller data.
- **Client-side filters**: price range, minimum rating, minimum discount, brand name, best-seller flag, free shipping, and new-condition only.
- Fields that Falabella doesn't actually provide for a listing (e.g. no rating yet, no discount) are left out of the record rather than filled with a placeholder.

### Output per product

Search and category modes return:

- `productId`, `skuId` — Falabella's internal product and SKU identifiers
- `title`, `brand`, `productType`
- `price` — the current price any shopper pays (never the CMR-exclusive price)
- `originalPrice` — pre-discount price, when the item is on sale
- `cmrPrice` — the special price available only to holders of Falabella's CMR store card, included only when it differs from `price`
- `currency` — always `CLP`
- `discountPercent`
- `interestFreeInstallments` — largest number of 0%-interest monthly installments offered
- `rating`, `totalReviews`
- `sellerId`, `sellerName`, `isVerifiedSeller`, `isBestSeller`, `isSponsored`
- `shippingTags` — delivery tags shown on the listing (e.g. same-day, express)
- `freeShipping`
- `productCondition` — present only when tagged refurbished/open-box
- `imageUrls`, `productUrl`, `categoryId`
- `recordType` — `product`
- `scrapedAt`

Product-detail lookups (mode=`productDetails`) return the same price/brand/image fields plus:

- `description`, `categoryPath`
- `specifications` — array of `{name, value}` pairs
- `sellerBusinessName`, `sellerRatingScore`, `sellerSkuId`
- `isOutOfStock`, `stockUnits`, `warrantyId`
- `recordType` — `productDetail`

### Input

| Field | Type | Default | Description |
|---|---|---|---|
| `mode` | string | `search` | `search`, `category`, or `productDetails` |
| `searchQuery` | string | `laptop` | Keyword to search (mode=`search`) |
| `categoryId` | string | `cat70057` | Falabella category ID, e.g. `cat70057` (mode=`category`) |
| `productIds` | array | `["152414961"]` | Product IDs to fetch (mode=`productDetails`) |
| `productUrls` | array | – | Full product URLs, alternative to `productIds` (mode=`productDetails`) |
| `sortBy` | string | `relevance` | `relevance`, `priceAsc`, `priceDesc`, or `rating` (mode=`search`/`category`) |
| `minPrice` | integer | – | Minimum price in CLP |
| `maxPrice` | integer | – | Maximum price in CLP |
| `minRating` | number | – | Minimum rating 0–5; products with no rating are always kept |
| `minDiscountPercent` | integer | – | Minimum discount %; products with no discount data are always kept |
| `brand` | string | – | Keep only products whose brand name contains this text |
| `onlyBestSeller` | boolean | `false` | Keep only Falabella-flagged best-sellers |
| `freeShippingOnly` | boolean | `false` | Keep only products tagged with free app shipping |
| `newOnly` | boolean | `false` | Drop refurbished/open-box listings |
| `maxItems` | integer | `50` | Maximum records to return (1–2000) |
| `maxPages` | integer | `30` | Maximum result pages to walk (48 products/page) |

#### Example: category sweep sorted by price

```json
{
  "mode": "category",
  "categoryId": "cat70057",
  "sortBy": "priceAsc",
  "maxItems": 200
}
```

#### Example: keyword search with discount and rating filters

```json
{
  "mode": "search",
  "searchQuery": "zapatillas running",
  "minDiscountPercent": 20,
  "minRating": 4,
  "maxItems": 60
}
```

#### Example: full detail for known product IDs

```json
{
  "mode": "productDetails",
  "productIds": ["152414961", "118240328"]
}
```

### Use cases

- **Price monitoring** — track `price`, `originalPrice` and `cmrPrice` for a product list over time.
- **Deal hunting** — filter a category for the highest discounts or best ratings in one run.
- **Brand audits** — pull every listing for a brand to check pricing consistency across sellers.
- **Marketplace research** — compare seller names, best-seller flags and shipping tags within a category.
- **Catalog enrichment** — fetch full specs, images and warranty IDs for a known set of product IDs.

### FAQ

**What's the difference between `price` and `cmrPrice`?**
`price` is what any shopper pays. `cmrPrice` is a discount only available to customers who pay with Falabella's own CMR store credit card; it's only included when it differs from `price`.

**Why do some products have no `rating` or `originalPrice`?**
Falabella doesn't publish rating or discount data for every listing. Rather than fake a value, the field is left out of that record entirely.

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

**Does this cover Falabella's Peru or Colombia storefronts?**
No, only the Chile storefront (`falabella.com`). Peru and Colombia run on separate domains and aren't covered.

**How do I find a category ID?**
Open any category page, e.g. `falabella.com/falabella-cl/category/cat70057/Notebooks` — the ID is the `cat...` segment in the URL (`cat70057` in this example).

**Do the filters remove products with missing data?**
No. Price, rating, discount and brand filters only drop a product when the field is present and fails the threshold; products Falabella simply didn't report that field for are always kept.

**My old task uses `query`, `category`, `priceRange` or `maxResults` — will it still run?**
Yes. Those legacy keys are accepted and mapped in code (`query` → `searchQuery`, `category` →
`categoryId`, `priceRange` → `minPrice`/`maxPrice`, `maxResults` → `maxItems`, and so on). They
are intentionally hidden from the input form so the form only shows fields the actor uses.

**Is this affiliated with Falabella?**
No. This is an independent, third-party actor reading Falabella's public storefront.

### Limitations

- **Chile only.** The actor reads the `falabella-cl` storefront. Falabella Peru and Colombia are
  separate sites with different currencies and are not covered.
- **Filters run after download.** Falabella's listing URL has no price/rating/brand parameters,
  so the actor collects pages and filters locally. A very narrow filter may need more pages; the
  actor stops on `maxPages` and reports how many rows it pushed rather than pretending it
  finished.
- **CMR is conditional.** `cmrPrice` appears only when Falabella is running a CMR-card offer for
  that product. It is omitted, never copied from `price`, when there is no card price.
- **Stock and condition are detail-only.** Listing rows do not publish stock; `isOutOfStock` and
  `stockUnits` are available in `productDetails` mode.
- **One row per product.** The storefront renders a default variant per product; the actor does
  not expand every colour/size variant into separate rows.
- **Detail pages can be challenged.** Falabella puts stronger bot checks on product pages than
  on listings. The actor retries direct and through the platform proxy, then skips an ID if every
  attempt is blocked and says so in the run status. Re-running usually clears it.

# Actor input Schema

## `mode` (type: `string`):

search = keyword search. category = browse a category listing page. productDetails = fetch full detail for specific product IDs/URLs.

## `searchQuery` (type: `string`):

Keyword to search for on Falabella.com, e.g. 'laptop' or 'zapatillas'.

## `categoryId` (type: `string`):

Falabella category ID or full category URL, e.g. 'cat70057' (Notebooks) or https://www.falabella.com/falabella-cl/category/cat70057/Notebooks.

## `productIds` (type: `array`):

Falabella numeric product IDs or full product URLs to fetch full detail for.

## `productUrls` (type: `array`):

Full Falabella product URLs to fetch full detail for (alternative to productIds).

## `sortBy` (type: `string`):

How results are ordered by Falabella before client-side filters are applied.

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

Only include products priced at or above this amount, in Chilean pesos (CLP).

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

Only include products priced at or below this amount, in Chilean pesos (CLP).

## `minRating` (type: `number`):

Only include products with a customer rating at or above this value (0-5). Products with no rating data are always included.

## `minDiscountPercent` (type: `integer`):

Only include products discounted by at least this percentage. Products with no discount data are always included.

## `brand` (type: `string`):

Only include products whose brand name contains this text (case-insensitive), e.g. 'samsung'.

## `onlyBestSeller` (type: `boolean`):

Only include products flagged as best-sellers by Falabella.

## `freeShippingOnly` (type: `boolean`):

Only include products tagged with free app shipping.

## `newOnly` (type: `boolean`):

Exclude listings tagged by Falabella as refurbished ('Reacondicionado') or open-box. Most listings have no condition tag at all, which means standard/new -- those are always included.

## `maxItems` (type: `integer`):

Maximum number of records to return.

## `maxPages` (type: `integer`):

Maximum number of result pages (48 products/page) to walk before stopping.

## Actor input object example

```json
{
  "mode": "search",
  "searchQuery": "laptop",
  "categoryId": "cat70057",
  "productIds": [
    "152414961"
  ],
  "sortBy": "relevance",
  "onlyBestSeller": false,
  "freeShippingOnly": false,
  "newOnly": false,
  "maxItems": 5,
  "maxPages": 30
}
```

# Actor output Schema

## `products` (type: `string`):

Dataset containing all scraped Falabella products.

# 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 = {
    "mode": "search",
    "searchQuery": "laptop",
    "categoryId": "cat70057",
    "productIds": [
        "152414961"
    ],
    "sortBy": "relevance",
    "onlyBestSeller": false,
    "freeShippingOnly": false,
    "newOnly": false,
    "maxItems": 5,
    "maxPages": 30
};

// Run the Actor and wait for it to finish
const run = await client.actor("crawlyth-forge/falabella-chile-product-and-cmr-price-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 = {
    "mode": "search",
    "searchQuery": "laptop",
    "categoryId": "cat70057",
    "productIds": ["152414961"],
    "sortBy": "relevance",
    "onlyBestSeller": False,
    "freeShippingOnly": False,
    "newOnly": False,
    "maxItems": 5,
    "maxPages": 30,
}

# Run the Actor and wait for it to finish
run = client.actor("crawlyth-forge/falabella-chile-product-and-cmr-price-scraper").call(run_input=run_input)

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

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

```

## CLI example

```bash
echo '{
  "mode": "search",
  "searchQuery": "laptop",
  "categoryId": "cat70057",
  "productIds": [
    "152414961"
  ],
  "sortBy": "relevance",
  "onlyBestSeller": false,
  "freeShippingOnly": false,
  "newOnly": false,
  "maxItems": 5,
  "maxPages": 30
}' |
apify call crawlyth-forge/falabella-chile-product-and-cmr-price-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,crawlyth-forge/falabella-chile-product-and-cmr-price-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

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