FincaRaiz Colombia Scraper — Delta Mode & Estrato Filter

99%+ success rate · Maintained weekly · Delta mode (NEW/UPDATED/REMOVED)

Extract property listings from fincaraiz.com.co with price-per-m² calculated, stratum filter (1-6), agent WhatsApp flag, and incremental delta monitoring to detect new listings and price changes between runs.

---

FincaRaiz Colombia Scraper — Modo Delta y Filtro de Estrato

Extrae propiedades de fincaraiz.com.co con precio/m² calculado, filtro por estrato socioeconómico (1-6), flag de WhatsApp del agente, y modo delta incremental para detectar propiedades nuevas y cambios de precio entre corridas.

---

Modos de operación

searchAndScrape (default)

Busca con los filtros del input y extrae propiedades. Ideal para datasets estáticos, análisis de mercado, o alimentar un CRM con propiedades recientes.

monitorDelta

Compara el inventario actual con la corrida anterior y emite solo las propiedades que cambiaron: NEW, UPDATED (precio o fecha de actualización cambió), REMOVED.

El estado se persiste en un Named Key-Value Store de Apify entre corridas. La primera corrida es la línea de base: todas las propiedades se clasifican como NEW.

Casos de uso del modo delta:

• Alertas de bajada de precio en propiedades monitoreadas
• Feed de propiedades nuevas hacia un CRM (HubSpot, Salesforce) vía webhook
• Tracking semanal de inventario por ciudad y estrato
• Monitoreo de competencia: qué agencias publican más propiedades nuevas

scrapeUrls

Recibe una lista de URLs directas de propiedades o páginas de búsqueda de FincaRaiz. Útil para re-scraping de listas específicas o integración con otras herramientas.

---

Campos del output

Siempre disponibles (~30 campos)

Campo	Tipo	Descripción
listingId	string	ID numérico interno de FincaRaiz
listingUrl	string	URL canónica de la propiedad
operationType	string	sale / rent / project
propertyType	string	apartment / house / lot / etc.
price	number	Precio en COP
priceUsd	number	Precio en USD (conversión de FincaRaiz)
pricePerSqm	number	Precio por m² en COP (calculado)
pricePerSqmUsd	number	Precio por m² en USD (calculado)
areaSqm	number	Área en m²
bedrooms	number	Habitaciones
bathrooms	number	Baños
latitude	number	Latitud GPS
longitude	number	Longitud GPS
address	string	Dirección
neighborhood	string	Barrio
city	string	Ciudad
department	string	Departamento
agentName	string	Nombre del anunciante
thumbnail	string	URL de imagen principal
listingViews	number	Visitas al listing
listingInquiries	number	Consultas recibidas
scrapedAt	string	Timestamp UTC de extracción

Con includeDetails: true (120+ campos adicionales)

Campo	Descripción
stratum	Estrato socioeconómico (1-6)
adminFee	Cuota de administración mensual en COP
adminFeeUsd	Cuota de administración en USD
totalMonthlyUsd	Costo mensual total en USD (solo arriendo)
garages	Número de garajes
floor	Piso de la unidad
floorsCount	Total de pisos del edificio
constructionYear	Año de construcción
constructionState	new / off_plan / under_construction / used
amenities	Lista de amenidades con grupo y nombre
amenityNames	Array de nombres de amenidades
images	URLs de todas las imágenes
imageCount	Número total de imágenes
agentType	inmobiliaria / particular / constructora
agentPhone	Teléfono enmascarado del anunciante
agentHasWhatsapp	Si el anunciante tiene WhatsApp registrado
hasVideo	Si tiene video disponible
hasTour3d	Si tiene tour 3D
financingAvailable	Si ofrece financiación
barterAvailable	Si acepta permuta

Solo en modo monitorDelta

Campo	Descripción
deltaStatus	NEW / UPDATED / REMOVED / UNCHANGED
deltaChanges	Array de {field, previousValue, currentValue} para UPDATED
deltaDetectedAt	Timestamp del cambio detectado

---

Precios (Pay per Event)

Escenario	Costo
100 resultados básicos	~$0.06
100 resultados con detalle	~$0.18
1,000 resultados básicos	~$0.60
Run de monitoreo delta	$0.0005 + cambios×$0.0006

El precio por resultado básico ($0.0006) es hasta 88% más bajo que otros actores de FincaRaiz.

---

Configuración del proxy

FincaRaiz no requiere proxy para volúmenes bajos (<5,000 requests/día). Para runs masivos, activar Apify Proxy con grupos residenciales colombianos:

{
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"],
    "apifyProxyCountry": "CO"
  }
}

---

Modo delta — Primera corrida

La primera corrida de monitorDelta no tiene snapshot previo. Todas las propiedades se clasifican como NEW y se guarda el snapshot como línea de base. La corrida siguiente ya puede detectar cambios.

---

Advertencias de uso

• Los datos de contacto del agente (teléfono, WhatsApp) son públicos en el sitio. El uso de esos datos es responsabilidad del usuario final.
• El modo delta sin filtros de ciudad puede generar snapshots de >5 MB. Se recomienda filtrar por ciudad y/o tipo de propiedad.
• El __NEXT_DATA__ de Next.js puede cambiar su estructura con deploys del sitio. Si ocurre, el actor retorna los campos básicos de la Capa A con un warning en el log, sin crashear. Un test de regresión horario detecta cambios de estructura.