Falabella prices as JSON, with the internet, event, CMR and struck price never mixed up
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).
5 active endpoints, on 1 and 2 credit tiers.
- POST/falabella/v1/search
- POST/falabella/v1/category
- POST/falabella/v1/product/detail
- POST/falabella/v1/product/reviews
- POST/falabella/v1/search/suggest
What Falabella endpoints does ReefAPI ship?
5 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.
Falabella API
3 of 5 endpoints, ready to run
Falabella products for a keyword in Chile, Colombia or Peru: price and price type, CMR card price, struck price and discounts, Falabella or marketplace seller, delivery badges, variants and Falabella's search rating.
{ "ok": true, "meta": { "api": "falabella", "endpoint": "search", "mode": "live", "latency_ms": 1914.9, "record_count": 49, "cache_hit": false }, "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": "same_day", "label": "Llega hoy" } ], "installments": [ { "count": 10, "interest_free": true, "payment_methods": [ "CMR_CREDIT_CARD", "EXTERNAL_CREDIT_CARD" ] } ], "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": "same_day", "label": "Llega hoy" } ], "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": "next_day", "label": "Llega mañana" }, { "type": "cc_same_day", "label": "Retira hoy" } ], "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": "Tecnología", "count": 415, "filter": "f.product.L0_category_paths=cat7090034||Tecnología", "selected": null } ] }, { "name": "Envío gratis App", "type": "SINGLE_SELECT_BOOLEAN", "values": [ { "label": "Envío gratis", "count": 50, "filter": "f.derived.variant.freeShipping=true", "selected": false } ] }, { "name": "Mejores marcas", "type": "SINGLE_SELECT_STATIC", "values": [ { "label": "Mejores marcas", "count": null, "filter": "f.static.popularBrands=lg::samsung::hisense::philips::xiaomi::sony", "selected": false } ] } ], "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" } }
How the Falabella API works
Falabella is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.
No OAuth app, no request signing, no per-site account. One key covers all 252 engines.
Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.
Credits, not seats. Failed and blocked calls are never charged, and cache hits cost nothing.
One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.
See what one product really costs on Falabella, with and without the CMR card, and what buyers say
The price on a Falabella card is not the price every buyer pays, and the badge does not say which price it discounts. Two calls give the full picture for one product.
{"product_id": "17482526"}1399990 CLP for everyone, 1379990 with the CMR card, 1739990 struck; discount 20% on the price and 21% with the card, which is the badge Falabella shows; 9199 CMR points, sold by Falabella, in stock.
{"product_id": "17482526", "sort": "lowest_rating"}The critical reviews first, with the average rating and the star distribution counted the way the product page counts them.
One product priced for both kinds of buyer, with its seller, stock and the reviews that matter - for two calls.
curl -X POST https://api.reefapi.com/falabella/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"televisor"}'{
"ok": true,
"data": { … },
"meta": {
"api": "falabella",
"endpoint": "search",
"mode": "live",
"latency_ms": …,
"record_count": …
},
"error": null
}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.
Which price, which seller, which country, and what Falabella does not publish
Chile, Colombia and Peru, each in its own currency. Measured on 2026-09-16 across 30 products in 20 category groups in the three countries, 23 searches, 12 review lists, 47 controlled checks and a comparison of 7 products with Falabella's own product page. Four of these lines go against us.
price with price_type (internet or event), cmr_price (CMR card only), list_price (struck) with discount_pct and cmr_discount_pct. On 7 of 7 products all of them matched Falabella's product page; list price was filled on 25 of 30 sampled products, CMR price on 8 of 30.
seller.kind is falabella, falabella_group (Sodimac, Homecenter, Tottus) or marketplace; product/detail adds business name, verification and store rating on a 5 scale. Seller filled on 30 of 30 sampled products.
country cl, co or pe; CLP and COP as whole numbers, PEN with decimals. Every action verified live in all three countries; a URL sets the country by itself.
rating, review_count and the star distribution count the Spanish-language reviews the page shows (27 of 30 sampled products had some); reviews in other languages are counted separately in rating_all_locales and review_count_all_locales.
Every variant with its own prices and stock, specifications, images and category breadcrumb were filled on 30 of 30 sampled products; model on 24 of 30, description on 23 of 30.
Keywords that open a collection, category, brand or product page are followed and named in redirected_to; spelling corrections appear in matched_query; sponsored rows (8 per page) and filler for a keyword with no match are removed and counted. 32 of 32 real keywords returned products, 10 of 10 nonsense keywords none.
Falabella never shows more than 10 units, so stock_quantity comes with stock_quantity_cap 10; availability is null when Falabella publishes nothing for a variant.
No barcode is published, and every sampled variant had a single seller, so there is no offer comparison per product.
Delivery badges and stock are for each country's default location; there is no delivery quote by address or comuna. Price filters are Falabella's own buckets, not arbitrary ranges.
Paging by relevance can show a product at the end of one page and again at the start of the next (2 of 48 in one measurement, 0 in others), so de-duplicate by product_id when collecting several pages.
What people build with Falabella
The jobs this data is most often used for.
endpoints
credits per call
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.
What Falabella data costs
The cheapest call here is 1 credit, so $15/mo (Pro) buys 10,000 of them — $1.50 per 1,000 credits. Credits roll over and never expire, and failed or blocked calls are not charged.
Full pricing →- 1,000 free credits on signup, no card
- One key, all 252 APIs, one credit pool
- Failed and blocked calls are never charged
- Credits roll over and never expire
Call it in two lines
Sign up, get 1,000 credits and one key that works on every engine. Then this is the whole protocol.
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"])Have a question? We got answers.
The questions people actually ask before wiring up Falabella.
Get a free key →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.
91 E-commerce & Marketplaces APIs on the same key
One key, one credit pool, one response envelope. If you are pulling Falabella, you are one call away from the rest of the category — no second contract, no second integration.
Need something this API does not do?
Name the endpoint, the field, or a source we do not carry yet. We ship new APIs every week and you would be first to get the key. Real people read every message and reply the same day.
Try it on your own data before you pay anything
The call above is the real endpoint, not a recording. A free key gives you 1,000 credits, the other 251 APIs, and the same envelope everywhere.
Endpoints, parameters and credit costs on this page are read from the live catalog and cannot drift from what the API accepts. Field notes were captured on 2026-09-16.