🏠 FincarRaiz Property Scraper

Extractor automático de propiedades inmobiliarias de FincarRaiz.com.co

Este Actor te permite extraer información detallada de propiedades inmobiliarias desde FincarRaiz, el portal inmobiliario líder en Colombia. Obtén datos estructurados de casas, apartamentos, oficinas y más, filtrados por ubicación, precio, tipo de propiedad y tipo de negocio.

🎯 ¿Para qué sirve?

• Análisis de mercado inmobiliario: Obtén datos masivos para estudiar tendencias de precios
• Investigación de inversiones: Encuentra oportunidades de inversión basadas en criterios específicos
• Comparación de precios: Analiza rangos de precios por zona y tipo de propiedad
• Automatización de búsquedas: Evita buscar manualmente propiedad por propiedad
• Datos para aplicaciones: Alimenta tus aplicaciones con datos inmobiliarios actualizados

🚀 Cómo usar este Actor

1. Configuración básica

Simplemente selecciona tus criterios de búsqueda y ejecuta el Actor. No necesitas conocimientos técnicos.

2. Parámetros de entrada

Configura los siguientes campos según tu búsqueda:

📋 Importante: Los valores de texto deben escribirse en minúsculas y sin acentos. El sistema normaliza automáticamente las entradas.

Campos Obligatorios

Campo	Descripción	Formato	Ejemplo	Requerido
Tipo de Negocio	Venta o Arriendo	Minúsculas	"venta" o "arriendo"	✅ Sí
Ciudad	Ciudad donde buscar propiedades	Minúsculas, sin acentos	"bogota", "medellin"	✅ Sí

Campos Opcionales

Campo	Descripción	Tipo	Formato	Ejemplo
Tipos de Propiedad	Casa, Apartamento, Oficina, etc.	Array	Minúsculas, plural	["apartamentos", "casas"]
Precio Mínimo	Precio mínimo en pesos colombianos	Número	-	200000000
Precio Máximo	Precio máximo en pesos colombianos	Número	-	500000000
Habitaciones	Número de habitaciones	Array	Strings numéricos	["3"] para al menos 3, ["2", "3", "4"] para exacto
Baños	Número de baños	Array	Strings numéricos	["2"] para al menos 2, ["1", "2"] para exacto
Parqueaderos	Número de espacios de parqueadero	Array	Strings numéricos	["1", "2"] o ["4"] para 4+
Estratos	Estratos socioeconómicos	Array	Strings numéricos	["3", "4", "5"]
Área Mínima	Área mínima en metros cuadrados	Número	-	80
Área Máxima	Área máxima en metros cuadrados	Número	-	150
Tipo de Área	Área total o edificada	Select	Minúsculas	"edificados" o "totales"
Condición del Inmueble	Estado de construcción	Select	Minúsculas, con guiones	"nuevos", "usados", "en-construccion"
Antigüedad	Tiempo de construcción	Select	Minúsculas, con guiones	"de-1-a-8-anios", "menor-a-1-anio"
Solo Proyectos Nuevos	Buscar únicamente proyectos nuevos	Checkbox	-	true
Máximo de Páginas	Número de páginas a procesar (máx. 10)	Número	-	3

📝 Ejemplos de Uso

Ejemplo 1: Casas en venta en Bogotá con filtros específicos

{
  "operation": "venta",
  "city": "bogota",
  "property_types": ["casas"],
  "bedrooms": ["3", "4"],
  "bathrooms": ["2", "3"],
  "garage": ["1", "2"],
  "stratum": ["4", "5", "6"],
  "precio_min": 200000000,
  "precio_max": 800000000,
  "m2_min": 120,
  "m2_max": 300,
  "max_pages": 3
}

📋 Nota: Este ejemplo usa modo exacto - buscará casas con exactamente 3 O exactamente 4 habitaciones, y exactamente 2 O exactamente 3 baños.

Ejemplo 2: Apartamentos en arriendo en Medellín con filtros avanzados

{
  "operation": "arriendo",
  "city": "medellin",
  "property_types": ["apartamentos"],
  "bedrooms": ["2", "3"],
  "bathrooms": ["2"],
  "garage": ["1"],
  "stratum": ["3", "4", "5"],
  "precio_min": 1000000,
  "precio_max": 5000000,
  "m2_min": 60,
  "m2_max": 120,
  "m2_type": "edificados",
  "condition": "nuevos",
  "antiquity": "de-1-a-8-anios",
  "max_pages": 5
}

Ejemplo 3: Búsqueda amplia en múltiples tipos

{
  "operation": "venta",
  "city": "cali",
  "property_types": ["apartamentos", "casas"],
  "bedrooms": ["2", "3", "4"],
  "bathrooms": ["1", "2", "3"],
  "precio_min": 150000000,
  "precio_max": 1000000000,
  "max_pages": 2
}

Ejemplo 4: Oficinas comerciales con características específicas

{
  "operation": "arriendo",
  "city": "bogota",
  "property_types": ["oficinas"],
  "m2_min": 50,
  "m2_max": 200,
  "m2_type": "totales",
  "condition": "usados",
  "max_pages": 4
}

Ejemplo 5: Solo proyectos nuevos en construcción

{
  "operation": "venta", 
  "city": "cartagena",
  "property_types": ["apartamentos"],
  "condition": "en-construccion",
  "projects": true,
  "stratum": ["4", "5", "6"],
  "precio_min": 300000000,
  "precio_max": 800000000,
  "max_pages": 3
}

Ejemplo 6: Búsqueda básica (solo campos obligatorios)

{
  "operation": "venta",
  "city": "barranquilla",
  "max_pages": 1
}

Ejemplo 7: Búsqueda mínima (al menos 3 habitaciones y 2 baños)

{
  "operation": "venta",
  "city": "bogota",
  "property_types": ["apartamentos"],
  "bedrooms": ["3"],
  "bathrooms": ["2"],
  "stratum": ["4", "5"],
  "precio_min": 300000000,
  "precio_max": 600000000,
  "max_pages": 2
}

Ejemplo 8: Búsqueda exacta (2, 3 o 4 habitaciones únicamente)

{
  "operation": "arriendo",
  "city": "medellin",
  "property_types": ["casas"],
  "bedrooms": ["2", "3", "4"],
  "bathrooms": ["1", "2"],
  "garage": ["1"],
  "precio_min": 1500000,
  "precio_max": 4000000,
  "max_pages": 3
}

📋 Nota: Buscará casas que tengan exactamente 2 O exactamente 3 O exactamente 4 habitaciones (no incluye 4+ habitaciones).

Ejemplo 9: Propiedades con múltiples parqueaderos (4 o más)

{
  "operation": "venta",
  "city": "bogota",
  "property_types": ["casas", "apartamentos"],
  "garage": ["4"],
  "stratum": ["5", "6"],
  "precio_min": 500000000,
  "precio_max": 2000000000,
  "max_pages": 2
}

📋 Nota: Buscará propiedades con 4 o más parqueaderos.

📊 Resultados de Salida

El Actor almacena los datos en el Dataset de Apify, donde puedes descargarlos en CSV, JSON, Excel o acceder vía API. No necesitas configurar el formato - Apify te permite elegir al momento de la descarga.

📌 Nota importante: Los datos se extraen en formato crudo sin decoraciones. Los precios son enteros puros (ej: 450000000 en lugar de "$450.000.000"), las áreas son decimales (ej: 85.0), y los textos son strings directos.

Campos de datos extraídos:

Campo	Descripción	Tipo	Ejemplo
Titulo	Título de la propiedad	String	"Hermoso apartamento en Chapinero"
Precio	Precio de la propiedad	Integer	450000000
Area Construida	Área en metros cuadrados	Float	120.5
Habitaciones	Número de habitaciones	String	"3" o "-"
Banos	Número de baños	Integer	2
Garages	Espacios de parqueadero	Integer	1
Estrato	Estrato socioeconómico	Integer	4
Direccion	Dirección de la propiedad	String	"Carrera 13 # 45-67"
Ubicacion Principal	Barrio principal	String	"Chapinero"
Ciudad	Ciudad de la propiedad	String	"Bogotá D.C."
Descripcion	Descripción de la propiedad	String	"Hermoso apartamento con vista..."
Link Propiedad	URL directa a la propiedad	String	"https://fincaraiz.com.co/..."
Tipo Propiedad	Tipo de propiedad	String	"Apartamento"
Tipo Operacion	Venta o Arriendo	String	"Venta"
Fecha Actualizacion	Última actualización	String	"2025-08-25T10:30:00"
Publicado por	Inmobiliaria o particular	String	"Inmobiliaria XYZ"
Precio_m2	Precio por metro cuadrado	Integer	3750000
Antiguedad	Antigüedad del inmueble	String	"5" o "-"
Estado Construccion	Estado de construcción	String	"Nuevo" o "-"
ID Propiedad	Identificador único	String	"12345678"
Link Google Maps	URL de ubicación en maps	String	"https://maps.google.com/?q=4.6097,-74.0817"
Piso N	Número de piso	String	"3" o "-"
Estado	Departamento/Estado	String	"Cundinamarca"
Localidad	Localidad específica	String	"Usaquén" o " "
Comuna	Comuna de la propiedad	String	"Comuna 2"
Zona	Zona específica	String	"Zona Norte" o " "
Region	Región geográfica	String	"Región Central" o " "
Barrios	Barrios asociados	String	"Chapinero Norte"
Link Vendedor	URL del vendedor	String	"https://fincaraiz.com.co/vendedor/..."

Ejemplo de resultado:

{
  "Titulo": "Moderno apartamento en excelente ubicación",
  "Precio": 380000000,
  "Area Construida": 85.0,
  "Habitaciones": "2",
  "Banos": 2,
  "Garages": 1,
  "Estrato": 5,
  "Direccion": "Carrera 11 # 93-45",
  "Ubicacion Principal": "Zona Rosa",
  "Ciudad": "Bogotá D.C.",
  "Descripcion": "Hermoso apartamento completamente remodelado con excelente vista...",
  "Link Propiedad": "https://fincaraiz.com.co/apartamento-en-venta-zona-rosa-bogota",
  "Tipo Propiedad": "Apartamento",
  "Tipo Operacion": "Venta",
  "Fecha Actualizacion": "2025-08-25T10:30:00Z",
  "Publicado por": "Inmobiliaria Premium",
  "Precio_m2": 4470588,
  "Antiguedad": "3",
  "Estado Construccion": "Usado",
  "ID Propiedad": "87654321",
  "Link Google Maps": "https://maps.google.com/?q=4.6701,-74.0584",
  "Piso N": "8",
  "Estado": "Cundinamarca",
  "Localidad": "Chapinero",
  "Comuna": "Comuna 2",
  "Zona": "Zona Norte",
  "Region": "Región Central",
  "Barrios": "Zona Rosa",
  "Link Vendedor": "https://fincaraiz.com.co/inmobiliaria/premium-properties"
}

💾 Acceso a los Datos

Después de ejecutar el Actor:

1. Interfaz Web de Apify:

   • Ve a la pestaña "Dataset"
   • Haz clic en "Export"
   • Elige tu formato: CSV, JSON, Excel, RSS, XML
   • Descarga directamente

2. API de Apify:

   • Accede programáticamente vía REST API
   • Obtén datos en tiempo real para aplicaciones
   • Ideal para integraciones automatizadas

3. Formatos Disponibles:

   • CSV: Para Excel, Google Sheets, análisis de datos
   • JSON: Para aplicaciones web, APIs, procesamiento
   • Excel: Para análisis business directo
   • RSS/XML: Para feeds automáticos

💡 Tip: No necesitas configurar el formato de salida - Apify te permite elegir al momento de descargar o acceder vía API.

⚡ Rendimiento

• Velocidad: Procesa hasta 200 propiedades por página
• Eficiencia: Extracción completa en segundos
• Confiabilidad: Manejo robusto de errores y reintentos automáticos
• Datos actualizados: Información directa desde FincarRaiz en tiempo real
• Formato de datos: Valores numéricos sin formato (precios como enteros, áreas como decimales)
• Eliminación de duplicados: Automática basada en URL de propiedad

🎛️ Opciones Avanzadas

Máximo de páginas recomendado:

• 1-2 páginas: Para búsquedas rápidas y específicas
• 3-5 páginas: Para análisis moderados (600-1000 propiedades)
• 6-10 páginas: Para análisis exhaustivos (1200-2000 propiedades)

Ciudades disponibles:

• Arauca
• Armenia
• Barranquilla
• Bello
• Bogotá D.C.
• Bucaramanga
• Cali
• Cartagena
• Cúcuta
• Dosquebradas
• Envigado
• Floridablanca
• Ibagué
• Leticia
• Manizales
• Medellín
• Montería
• Neiva
• Pasto
• Pereira
• Popayán
• Santa Marta
• Soacha
• Valledupar
• Villavicencio

Opciones de filtrado avanzado:

• Habitaciones: Mínimo (["3"] = al menos 3) o exacto (["2", "3", "4"] = solo esos)
• Baños: Mínimo (["2"] = al menos 2) o exacto (["1", "2"] = solo esos)
• Parqueaderos: 0 (sin parqueadero), 1, 2, 3, 4 (4 o más)
• Estratos: 1, 2, 3, 4, 5, 6
• Área: Rango personalizable en m²

� Formatos de Entrada Requeridos

⚠️ Importante: Para que el Actor funcione correctamente, los valores de texto deben usar el formato exacto especificado.

Reglas generales:

• Ciudades: Minúsculas y sin acentos (ej: "bogota", "medellin", "cucuta")
• Tipos de propiedad: Minúsculas y en singular (ej: "apartamento", "casa", "oficina")
• Operaciones: Solo "venta" o "arriendo" (minúsculas)
• Condiciones: Exactamente como se listan (ej: "nuevos", "usados", "en-construccion")
• Antigüedad: Con guiones y formato específico (ej: "de-1-a-8-anios")
• Tipo de área: Solo "totales" o "edificados"
• Números: Habitaciones, baños, parqueaderos y estratos como strings (ej: ["2", "3"])

🎯 Modos de Búsqueda para Habitaciones y Baños:

El Actor soporta dos modos diferentes para buscar por habitaciones y baños:

Modo Mínimo (un solo valor):

• Uso: Cuando quieres propiedades con al menos ese número
• Formato: Array con un solo elemento ["3"]
• Ejemplo: "bedrooms": ["3"] → Propiedades con al menos 3 habitaciones (incluye 3, 4+)

Modo Exacto/Múltiple (múltiples valores):

• Uso: Cuando quieres propiedades que tengan exactamente cualquiera de esos números (O lógico)
• Formato: Array con múltiples elementos ["2", "3", "4"]
• Ejemplo: "bedrooms": ["2", "3", "4"] → Propiedades con exactamente 2 O exactamente 3 O exactamente 4 habitaciones

Ejemplos prácticos:

{
  "bedrooms": ["3"],        // MÍNIMO: Al menos 3 habitaciones (3, 4+)
  "bathrooms": ["2"]        // MÍNIMO: Al menos 2 baños (2, 3, 4+)
}

{
  "bedrooms": ["2", "3", "4"],  // EXACTO: 2 O 3 O 4 habitaciones únicamente
  "bathrooms": ["1", "2"]       // EXACTO: 1 O 2 baños únicamente
}

🅿️ Parqueaderos:

Los parqueaderos se manejan de forma simple con valores numéricos:

• "garage": ["0"] → Sin parqueadero
• "garage": ["1"] → Exactamente 1 parqueadero
• "garage": ["2"] → Exactamente 2 parqueaderos
• "garage": ["3"] → Exactamente 3 parqueaderos
• "garage": ["4"] → 4 o más parqueaderos
• "garage": ["1", "2", "3"] → 1 O 2 O 3 parqueaderos

Para 4 o más parqueaderos:

{
  "garage": ["4"]  // 4 o más parqueaderos
}

Valores exactos permitidos:

Ciudades disponibles (minúsculas, sin acentos):

"arauca", "armenia", "barranquilla", "bello", "bogota", "bucaramanga", 
"cali", "cartagena", "cucuta", "dosquebradas", "envigado", "floridablanca", 
"ibague", "leticia", "manizales", "medellin", "monteria", "neiva", 
"pasto", "pereira", "popayan", "santa-marta", "soacha", "valledupar", 
"villavicencio"

Tipos de propiedad disponibles (minúsculas, plural):

"casas", "apartamentos", "lotes", "locales", "oficinas", "fincas", 
"parqueaderos", "consultorios", "edificios", "apartaestudios", "bodegas",
"cabañas", "casas-campestres", "casas-lotes", "habitaciones"

Condiciones del inmueble:

"usados", "nuevos", "en-construccion"

Opciones de antigüedad:

"menor-a-1-anio", "de-1-a-8-anios", "de-9-a-15-anios", 
"de-16-a-30-anios", "mas-de-30-anios"

Tipos de área:

"totales", "edificados"

Parqueaderos disponibles:

["0"] - Sin parqueaderos
["1"] - 1 parqueadero exacto
["2"] - 2 parqueaderos exactos  
["3"] - 3 parqueaderos exactos
["4"] - 4 o más parqueaderos
["1", "2"] - 1 O 2 parqueaderos
["1", "2", "3"] - 1 O 2 O 3 parqueaderos

�💡 Consejos de Uso

1. Usa el formato exacto especificado para valores de texto (minúsculas, sin acentos)
2. Elige el modo correcto para habitaciones/baños: mínimo ["3"] (al menos 3) vs exacto ["2", "3", "4"] (solo esos)
3. Empieza con búsquedas específicas para probar el Actor
4. Usa rangos de precio realistas para obtener mejores resultados
5. Combina filtros de habitaciones y baños para búsquedas precisas
6. Utiliza estratos para filtrar por nivel socioeconómico en ciudades principales
7. Aplica filtros de área (m²) para propiedades de tamaño específico
8. Selecciona el tipo de área (totales vs edificados) según tus necesidades
9. Filtra por condición (nuevos, usados, en-construccion) para estado específico
10. Usa filtros de antigüedad para propiedades de cierta edad
11. Activa "Solo Proyectos" para encontrar desarrollos inmobiliarios nuevos
12. Limita las páginas inicialmente para evaluar la calidad de datos
13. Combina múltiples ejecuciones para diferentes criterios
14. Descarga los resultados desde el Dataset de Apify en tu formato preferido (CSV, JSON, Excel)

📈 Casos de Uso Reales

Para Inversionistas:

• Identificar oportunidades de inversión por zona
• Analizar rentabilidad potencial por m²
• Comparar precios entre diferentes barrios

Para Inmobiliarias:

• Estudios de mercado para avalúos
• Análisis de competencia
• Identificación de propiedades subvaloradas

Para Desarrolladores:

• Alimentar aplicaciones inmobiliarias
• Crear herramientas de comparación
• Integrar con sistemas CRM

Para Analistas:

• Investigación de mercado inmobiliario
• Informes de tendencias de precios
• Análisis geoespacial de propiedades

🔧 Especificaciones Técnicas

• Fuente de datos: FincarRaiz.com.co (oficial)
• Almacenamiento: Dataset de Apify (descargable en CSV, JSON, Excel)
• Estructura de datos: 29 campos detallados por propiedad
• Tipos de datos: Enteros para precios, flotantes para áreas, strings para texto
• Límite de resultados: Hasta 2000 propiedades por ejecución
• Tiempo de ejecución: 5-60 segundos dependiendo del volumen
• Precisión: 100% de los datos disponibles públicamente
• Deduplicación: Automática por URL de propiedad
• Acceso a datos: Interfaz web de Apify o API REST

⚠️ Limitaciones y Consideraciones

• Los datos extraídos son solo los disponibles públicamente en FincarRaiz
• El Actor respeta los términos de uso del sitio web
• Algunos campos pueden estar vacíos si no están disponibles en la fuente
• Se recomienda no ejecutar búsquedas excesivamente amplias simultáneamente

🆘 Soporte

Si tienes preguntas o necesitas ayuda:

1. Revisa los ejemplos de configuración
2. Verifica que los parámetros estén correctamente configurados
3. Contacta al desarrollador para soporte técnico

---

¡Comienza a extraer datos inmobiliarios ahora mismo! 🚀

Este Actor está optimizado para análisis profesional de mercado inmobiliario colombiano.