Falabella API: productos y precios en JSON
El programa oficial de Falabella es el Seller Center, pensado para vendedores y su propio catálogo. Esta API responde a la pregunta del mercado: qué se vende, a qué precio y qué opinan los compradores. Un detalle que marca la diferencia al comparar: Falabella publica varios precios para el mismo producto, y aquí vienen separados.
Endpoints
| endpoint | Qué devuelve | Obligatorios |
|---|---|---|
| search | Búsqueda por palabra clave en Chile, Colombia o Perú, con los precios tal y como los muestra el sitio. | query |
| category | Todos los productos de una categoría o colección, por id o URL, paginados. | category |
| product/detail | La ficha completa por id o URL: título, marca, modelo, precio internet o precio evento e imágenes. | product_id |
| product/reviews | Las reseñas de clientes, paginadas y ordenables por fecha o puntuación. | product_id |
| search/suggest | Las sugerencias del buscador para lo que el comprador está escribiendo, cada una con su categoría. | query |
Cada llamada se cobra en créditos. Las llamadas fallidas y bloqueadas son gratuitas.
Ejemplo que funciona
Precio internet y precio evento no son lo mismo y conviven en la misma ficha. Un comparador que recoja 'el precio' sin distinguirlos produce una base que parece correcta y mezcla dos cosas distintas.
curl -X POST https://api.reefapi.com/falabella/v1/search \
-H "x-api-key: TU_CLAVE" \
-H "content-type: application/json" \
-d '{"query": "refrigerador", "country": "cl"}'{
"ok": true,
"data": {
"results": [
{
"product_id": "...",
"title": "...",
"brand": "...",
"internet_price": 399990,
"event_price": 349990,
"currency": "CLP"
}
]
},
"meta": { "record_count": 24, "cache_hit": false, "mode": "live" }
}En lugar de tu propio scraper de Falabella
Un scraper propio de Falabella funciona el primer día. Lo complicado llega después: cuando cambia la estructura de las fichas el parser devuelve una lista vacía en vez de un error, y en recorridos largos la protección anti-bot corta a mitad.
Hay además una trampa concreta: Falabella muestra precio internet y precio evento a la vez. Un scraper que tome el primer número que encuentre mezclará ambos sin que nada falle visiblemente.
Para una extracción puntual tu script sale más barato y lo decimos sin rodeos. Para un seguimiento diario, lo caro no es el código sino las averías que nadie ve.
Límites y notas honestas
- No es la API oficial de Falabella ni el Seller Center, y no tenemos acuerdo con Falabella.
- Cada país es una tienda independiente con su moneda. Sin indicar país obtienes el valor por defecto.
- Si un producto no tiene precio evento, ese campo viene vacío; no repetimos el precio internet en su lugar.
- Sin caché: cada llamada refleja el estado en ese momento.