Falabella API & Scraper
The Falabella API turns falabella.com (Chile), falabella.com.co (Colombia) and falabella.com.pe (Peru) into clean JSON in five actions: search, category, product/detail, product/reviews and search/suggest, with a country parameter that sets the storefront and the currency (CLP, COP or PEN).
🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.
Falabella shows up to four prices for one product and the API keeps each in its own field: price is what anyone pays online, with price_type saying whether it is the internet price or a time-limited event price; cmr_price is the lower price only for holders of Falabella's CMR card; list_price is the struck normal price, and discount_pct and cmr_discount_pct measure both against it (a notebook on 2026-09-16: price 1399990, CMR 1379990, list 1739990 CLP). seller says whether Falabella itself, a group store such as Sodimac, Homecenter or Tottus, or a marketplace seller sells the item; product/detail adds the seller's business name, verification and store rating, stock per delivery option, home delivery and store pickup, CMR points, every variant with its own prices and stock, specifications, images, the category breadcrumb and the rating with its star distribution, counted the way the product page counts it. Keywords Falabella answers with a collection, category, brand or product page are followed and reported in redirected_to, sponsored rows are removed and counted, and unrelated filler for a keyword with no match is removed. Verification on 2026-09-16: 23 of 23 searches and 30 of 30 product reads across the three countries succeeded, all 47 checks passed, and on 7 of 7 products title, price, CMR price, list price, seller, rating and review count matched Falabella's own product page. No Falabella account needed - one ReefAPI key and the standard { ok, data, meta, error } envelope.
Falabella shows up to four prices for one product - the API returns each in its own field
The big number on a Falabella card can be an event price, the red one with a card icon is only for CMR card holders, and the struck price sits below. Storing the wrong one is the most common Falabella price error. Values measured on 2026-09-16.
| Falabella product | price | cmr_price | list_price | What else the record says |
|---|---|---|---|---|
| Notebook Gamer OMEN 16 (Chile, sold by Falabella) | 1399990 CLP (internet) | 1379990 CLP | 1739990 CLP | discount_pct 20, cmr_discount_pct 21 - the site's -21% badge refers to the CMR price; 9199 CMR points |
| LG 50" NANO UHD NU800 (Chile) | 329990 CLP | 319990 CLP | 369990 CLP | rating 4.64 from 11 reviews |
| Samsung Galaxy A07 (Colombia, marketplace seller STAR) | 374900 COP | 359900 COP | 700000 COP | rating 5.0 from 1 review |
| Nevera No Frost 267 L (Colombia, sold by Homecenter) | 1629900 COP | null | 1849900 COP | seller kind falabella_group |
| Zapatillas Urbanas Mujer Diadora (Peru) | 129.9 PEN | 99.9 PEN | null | rating 4.71 from 614 reviews; PEN keeps decimals |
On 7 of 7 products compared with Falabella's own product page on 2026-09-16, price, CMR price and list price matched. A CMR price is never the price a buyer without the card pays.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/falabella/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"query": "televisor"
}
}{
"ok": true,
"meta": {
"api": "falabella",
"endpoint": "search",
"mode": "live",
"latency_ms": 1608.9,
"record_count": 49,
"bytes": 145665,
"cache_hit": false,
"country": "cl",
"requests": 1,
"pagination": {
"page": 1,
"page_size": 48,
"has_more": true,
"total": 415
}
},
"data": {
"results": [
{
"product_id": "152164052",
"sku_id": "152164053",
"title": "SMART TV 50 Hi QLED FHD 50Q4SV",
"brand": "HISENSE",
"url": "https://www.falabella.com/falabella-cl/product/152164052/televisor-qled-50-50q4sv-fhd-smart-tv",
"image": "https://media.falabella.com/falabellaCL/152164053_01/public",
"images": [
"https://media.falabella.com/falabellaCL/152164053_01/public",
"https://media.falabella.com/falabellaCL/152164053_02/public",
"https://media.falabella.com/falabellaCL/152164053_03/public"
],
"price": 259990,
"price_max": null,
"price_type": "event",
"cmr_price": null,
"list_price": 349990,
"discount_pct": 26,
"cmr_discount_pct": null,
"cmr_saving": null,
"other_prices": null,
"currency": "CLP",
"discount_badge_pct": 26,
"seller": {
"id": "SC69BDF",
"name": "Hisense",
"kind": "marketplace",
"is_falabella": false,
"verified": true
},
"marketplace": true,
"search_index_rating": 4.9,
"search_index_review_count": 152,
"rating_scale": 5,
"badges": null,
"delivery_badges": [
{
"type": "[trimmed-depth]",
"label": "[trimmed-depth]"
}
],
"installments": [
{
"count": "[trimmed-depth]",
"interest_free": "[trimmed-depth]",
"payment_methods": "[trimmed-depth]"
}
],
"top_specifications": null,
"best_seller": false,
"product_type": "REGULAR",
"variants": null,
"sponsored": false
},
{
"product_id": "152111167",
"sku_id": "152111168",
"title": "Smart TV Led 43\" Google TV Full HD Bluetooth MGG43FFK5 Master-G",
"brand": "MASTER G",
"url": "https://www.falabella.com/falabella-cl/product/152111167/smart-tv-led-43-google-tv-full-hd-bluetooth-mgg43ffk5-master-g",
"image": "https://media.falabella.com/falabellaCL/152111168_01/public",
"images": [
"https://media.falabella.com/falabellaCL/152111168_01/public",
"https://media.falabella.com/falabellaCL/152111168_02/public",
"https://media.falabella.com/falabellaCL/152111168_03/public"
],
"price": 199990,
"price_max": null,
"price_type": "event",
"cmr_price": null,
"list_price": 299990,
"discount_pct": 33,
"cmr_discount_pct": null,
"cmr_saving": null,
"other_prices": null,
"currency": "CLP",
"discount_badge_pct": 33,
"seller": {
"id": "SC6D857",
"name": "Gasei",
"kind": "marketplace",
"is_falabella": false,
"verified": true
},
"marketplace": true,
"search_index_rating": 4.71,
"search_index_review_count": 42,
"rating_scale": 5,
"badges": null,
"delivery_badges": [
{
"type": "[trimmed-depth]",
"label": "[trimmed-depth]"
}
],
"installments": null,
"top_specifications": null,
"best_seller": false,
"product_type": "REGULAR",
"variants": null,
"sponsored": false
},
{
"product_id": "80746061",
"sku_id": "80746061",
"title": "LED Smart Tv 58\" PUD7019 4K UHD",
"brand": "PHILIPS",
"url": "https://www.falabella.com/falabella-cl/product/80746061/led-smart-tv-58-pud7019-4k-uhd-philips",
"image": "https://media.falabella.com/falabellaCL/80746061_1/public",
"images": [
"https://media.falabella.com/falabellaCL/80746061_1/public",
"https://media.falabella.com/falabellaCL/80746061_2/public",
"https://media.falabella.com/falabellaCL/80746061_3/public"
],
"price": 399990,
"price_max": null,
"price_type": "internet",
"cmr_price": null,
"list_price": 429990,
"discount_pct": 7,
"cmr_discount_pct": null,
"cmr_saving": null,
"other_prices": null,
"currency": "CLP",
"discount_badge_pct": null,
"seller": {
"id": "FALABELLA_CHILE",
"name": "Falabella",
"kind": "falabella",
"is_falabella": true
},
"marketplace": false,
"search_index_rating": 4.37,
"search_index_review_count": 38,
"rating_scale": 5,
"badges": null,
"delivery_badges": [
{
"type": "[trimmed-depth]",
"label": "[trimmed-depth]"
},
{
"type": "[trimmed-depth]",
"label": "[trimmed-depth]"
}
],
"installments": null,
"top_specifications": null,
"best_seller": false,
"product_type": "REGULAR",
"variants": null,
"sponsored": false
}
],
"count": 49,
"sponsored_dropped": 8,
"sponsored_included": 0,
"total_results": 415,
"total_pages": 9,
"page": 1,
"page_size": 48,
"has_more": true,
"page_notice": null,
"filters_available": [
{
"name": "Categoría",
"type": "SINGLE_SELECT_AS_LINK",
"values": [
{
"label": "[trimmed-depth]",
"count": "[trimmed-depth]",
"filter": "[trimmed-depth]",
"selected": "[trimmed-depth]"
}
]
},
{
"name": "Envío gratis App",
"type": "SINGLE_SELECT_BOOLEAN",
"values": [
{
"label": "[trimmed-depth]",
"count": "[trimmed-depth]",
"filter": "[trimmed-depth]",
"selected": "[trimmed-depth]"
}
]
},
{
"name": "Mejores marcas",
"type": "SINGLE_SELECT_STATIC",
"values": [
{
"label": "[trimmed-depth]",
"count": "[trimmed-depth]",
"filter": "[trimmed-depth]",
"selected": "[trimmed-depth]"
}
]
}
],
"site_applied_filters": null,
"breadcrumb": null,
"keyword_matches_on_page": 11,
"site_semantic_fallback": false,
"fallback_results_dropped": 0,
"fallback_total": null,
"query": "televisor",
"matched_query": null,
"redirected_to": null,
"sort": "relevance",
"applied_filters": null,
"country": "cl",
"currency": "CLP"
}
}What the Falabella API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | Search Falabella by keyword in Chile, Colombia or Peru. Each product comes with the price anyone pays online (internet or event price), the CMR card price and the struck normal price in separate fields, the discount, the seller (Falabella, a Falabella group store such as Sodimac or Tottus, or a marketplace seller), delivery badges, interest-free installments, variants and Falabella's search rating. Sort by price or rating; filter by brand, rating, discount or any filter Falabella lists. Keywords Falabella sends to a collection, category or product are followed; sponsored rows are removed and counted. | Pricing teams call search to search Falabella by keyword in Chile, Colombia or Peru. | query, country, page, sort, brand, ... |
| category | Every product in a Falabella category or collection (by id or URL), paged, with the same rows, sorts and filters as search, plus the category breadcrumb. | Marketplace operators call category to get every product in a Falabella category or collection (by id or URL), paged, with the same rows…. | category, country, page, sort, brand, ... |
| product/detail | The full Falabella product record by id or URL: title, brand, model, internet or event price, CMR card price, struck normal price with discounts and validity dates, CMR points, the seller with its rating and verification, availability with stock per delivery option, home delivery and store pickup, interest-free installments, rating with star distribution, description, specifications, images and videos, every variant with its own prices and stock, and the category breadcrumb. | Catalog enrichment teams call product/detail to get the full Falabella product record by id or URL. | product_id, variant_id, country, max_rotations |
| product/reviews | Customer reviews of a Falabella product, paged and sorted (newest, oldest, highest or lowest rating, most helpful) and filterable by star rating: rating, title, text, date, reviewer nickname, recommendation, helpful votes, detailed ratings (comfort, size…), photos and seller responses, plus the average rating, review count and star distribution. Reviews and figures are the Spanish-language ones the product page counts; the all-languages totals are returned separately. | Retail analysts call product/reviews to get customer reviews of a Falabella product, paged and sorted (newest, oldest, highest or lowest…. | product_id, country, page, page_size, sort, ... |
| search/suggest | Falabella's search-box suggestions for what a shopper has typed, each with the categories Falabella proposes for it. | Pricing teams call search/suggest to get falabella's search-box suggestions for what a shopper has typed, each with the categories Fal…. | query, country, max_rotations |
Call search from your stack
curl -X POST https://api.reefapi.com/falabella/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"televisor"}'import requests
r = requests.post(
"https://api.reefapi.com/falabella/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "televisor"
},
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/falabella/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"query": "televisor"
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.falabella.search with {"query":"televisor"}.Who uses this API and why
- Price monitors in Chile, Colombia and Peru track Falabella's internet, event, CMR card and struck prices separately.
- Brands see which marketplace sellers list their products on Falabella, at what price, with what store rating.
- Retail analysts compare the same category across the three countries in local currency.
- Review and product teams pull ratings, star distributions and review text counted the way the product page counts them.
Questions developers ask before integrating
Which Falabella price should I store?
price is what anyone pays online; price_type is internet or event (an event price replaces the internet price while it runs, and price_valid_until carries its end date when Falabella publishes one). cmr_price applies only to Falabella's CMR card and is null when there is none (8 of 30 sampled products had one). list_price is the struck normal price, null when Falabella shows none. discount_pct compares price with list_price, cmr_discount_pct compares the CMR price with it, and discount_badge_pct is the number on Falabella's own badge, which follows the CMR price when there is one.
Is it sold by Falabella or by a marketplace seller?
seller.kind is falabella for Falabella's own stock, falabella_group for the group stores (Sodimac, Homecenter, Tottus) and marketplace for everyone else, and marketplace is true only for the last. product/detail adds the seller's registered business name, whether Falabella verified it and its store rating on a 5 scale for on-time delivery, cancellations and customer service - XIAOMI TECHNOLOGY CHILE SPA read 5 of 5 on all four.
Does it work for Chile, Colombia and Peru?
Yes, set country to cl, co or pe; a product or category URL sets the country by itself. Prices come in that country's currency as numbers: CLP and COP as whole numbers (Falabella writes 1.379.990 with dots as thousands separators), PEN with decimals (129.9). Every action was verified live in all three countries on 2026-09-16.
How reliable are stock and ratings?
availability is in_stock or out_of_stock when Falabella publishes it, and stock_quantity is capped: Falabella never shows more than 10 units, so stock_quantity_cap says 10. Ratings in product/detail and product/reviews count the Spanish-language reviews the product page shows; rating_all_locales and review_count_all_locales add reviews in other languages (an LG TV: 34 reviews and 4.35 on the page, 40 and 4.2 in all languages). Search rows carry Falabella's search-index rating, which can differ slightly from the product page.
What happens when a keyword opens a brand or collection page instead of results?
The API follows it and says so in redirected_to: iphone opens a collection of 449 products, samsung the Samsung brand page with 1942, televisor in Peru a TV category, and a product number opens that product. When a keyword opens an editorial page, the products for the other form of the word are returned (parrilla returns the products for parrillas) and page_notice explains it. Unrelated filler for a keyword with no match is removed and counted in fallback_results_dropped: 10 of 10 nonsense keywords returned no rows and 32 of 32 real keywords, including misspellings, returned products.
Do the filters and sorts really apply?
Yes, measured on 2026-09-16: televisor in Chile has 418 results; brand samsung cut it to 131, min_rating 4 to 271, min_discount_pct 30 to 113, and a price bucket from filters_available to 10 rows, all inside the bucket. price_asc and price_desc were fully ordered. filters_available lists every filter Falabella offers for the result (price buckets, seller type, category, size, colour) and filters accepts those values exactly as listed; an invented filter returns INVALID_PARAM.
What does Falabella NOT publish here?
No EAN or barcode, no exact stock above 10 units, no multi-seller offer table (each variant had one seller in every sampled product), and no delivery quote for an address - delivery badges and stock are for each country's default location. Price ranges are Falabella's own buckets, not arbitrary numbers. Paging by relevance can repeat a product at the end of one page and the start of the next (2 of 48 in one measurement), so de-duplicate by product_id when collecting several pages.
What is the Falabella API?
Falabella API is a ReefAPI endpoint group for falabella in chile, colombia and peru: internet, event, cmr card and struck prices kept apart, marketplace sellers, stock and reviews. It returns live JSON through POST requests under /falabella/v1.
Is the Falabella API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. Falabella calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Falabella login or account?
No login to Falabella is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the Falabella data?
The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the Falabella API use?
Falabella actions currently cost 1-2 credits per successful call. Failed or blocked calls are free, and all APIs draw from one credit pool.
Can I call Falabella from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call falabella actions with the same key, credit pool and JSON envelope used by normal REST requests.
Is the Falabella API a Falabella scraper?
It is the managed alternative to a DIY Falabella scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same falabella in chile, colombia and peru: internet, event, cmr card and struck prices kept apart, marketplace sellers, stock and reviews back as clean JSON.