🏠 Real Estate Lead Generator & Market Analysis V1.0 - Zonaprop Professional / Generador de Leads Inmobiliarios y Análisis de Mercado

LICENSE

Professional real estate lead generation and market analysis tool for Argentina's property market. Specialized in extracting qualified leads, contact information, and comprehensive market intelligence from Zonaprop / Herramienta profesional de generación de leads inmobiliarios y análisis de mercado para Argentina. Especializada en extraer leads calificados, información de contacto e inteligencia de mercado de Zonaprop

---

📋 Description / Descripción

🇺🇸 English:
Professional lead generation and market analysis tool for Argentina's real estate sector. Features 3 specialized operation modes designed for qualified lead extraction, contact information gathering, and comprehensive market intelligence. Includes premium contact extraction (phones, WhatsApp, emails) with advanced anti-detection technology. Generates over 33 data points per property lead with superior data quality for business intelligence and sales automation.

🇪🇸 Español:
Herramienta profesional de generación de leads y análisis de mercado para el sector inmobiliario argentino. Incluye 3 modos de operación especializados diseñados para extracción de leads calificados, recopilación de información de contacto e inteligencia de mercado integral. Incluye extracción premium de contactos (teléfonos, WhatsApp, emails) con tecnología anti-detección avanzada. Genera más de 33 puntos de datos por lead inmobiliario con calidad superior para inteligencia de negocios y automatización de ventas.

---

🎯 Operation Modes / Modos de Operación

🔗 1. Extract URLs / Extraer URLs (scrape-urls)

English: Gets property URLs from search pages using geographic filters.

Español: Obtiene URLs de propiedades desde páginas de búsqueda usando filtros geográficos.

📌 Use Cases / Casos de Uso:

• Build URL database for later processing / Construir base de datos de URLs para procesamiento posterior
• Market analysis by specific location / Análisis de mercado por ubicación específica
• Preparation for mass scraping with N8N / Preparación para scraping masivo con N8N

🏠 2. Single Scrape / Scrape Individual (scrape-single)

English: Extracts basic data from a single URL without contact information.

Español: Extrae datos básicos de una sola URL sin información de contacto.

📌 Use Cases / Casos de Uso:

• Fast individual processing / Procesamiento rápido individual
• Existing database updates / Actualización de bases de datos existentes
• Price and features analysis / Análisis de precios y características

📞 3. Extract Contact / Extraer Contacto (extract-contact) ⭐ PREMIUM

English: Extracts complete data + contact information from a single URL.

Español: Extrae datos completos + información de contacto de una sola URL.

📌 Unique Features / Características Únicas:

• ✅ Phone numbers / Teléfonos
• ✅ WhatsApp with Argentine format / WhatsApp con formato argentino
• ✅ Seller emails / Emails del vendedor
• ✅ Extraction method / Método de extracción
• ✅ 33+ fields per property / 33+ campos por propiedad

---

📍 Location System / Sistema de Ubicaciones

📌 Hierarchical Structure / Estructura Jerárquica

English: The system uses a hierarchical structure: Province → City → Locality

Español: El sistema utiliza una estructura jerárquica organizada: Provincia → Ciudad → Localidad

📋 Standard Mapping Example / Ejemplo de Mapeo Estándar:

English:

User selects: "Castelar (Localidad - GBA Oeste, Buenos Aires)"
System uses: "castelar-moron"
Generated URL: "/departamentos-alquiler-castelar-moron.html"

Español:

Usuario selecciona: "Castelar (Localidad - GBA Oeste, Buenos Aires)"
Sistema usa: "castelar-moron"
URL generada: "/departamentos-alquiler-castelar-moron.html"

🗺️ Custom Mapping Example / Ejemplo de Mapeo Personalizado:

English:

Custom field: "canning-ezeiza"
Generated URL: "/canning-ezeiza.html"
Or with type: "/departamentos-alquiler-canning-ezeiza.html"

Español:

Campo personalizado: "canning-ezeiza"  
URL generada: "/canning-ezeiza.html"
O con tipo: "/departamentos-alquiler-canning-ezeiza.html"

🌎 Cobertura Geográfica / Geographic Coverage

Organized Hierarchical Structure / Estructura Jerárquica Organizada

🏛️ Provinces / Provincias (23 Argentine provinces / 23 provincias argentinas):

• Buenos Aires, Catamarca, Chaco, Chubut, Córdoba, Corrientes, Entre Ríos, Formosa, Jujuy, La Pampa, La Rioja, Mendoza, Misiones, Neuquén, Río Negro, Salta, San Juan, San Luis, Santa Cruz, Santa Fe, Santiago del Estero, Tierra del Fuego, Tucumán

🏙️ Cities / Ciudades (provincial capitals and main cities / capitales provinciales y ciudades principales):

• Buenos Aires: CABA, GBA Norte/Sur/Oeste, La Plata, Mar del Plata, Bahía Blanca
• Córdoba: Córdoba Capital, Villa Carlos Paz, Río Cuarto, Villa María
• Santa Fe: Rosario, Santa Fe Capital
• Mendoza: Mendoza Capital, San Rafael
• Otras Capitales: Resistencia (Chaco), Posadas (Misiones), Bariloche, Ushuaia, etc.

🏘️ Localities / Localidades (neighborhoods and specific localities / barrios y localidades específicas):

• CABA: Palermo, Recoleta, Belgrano, Puerto Madero, Villa Crespo, Caballito, Barrio Norte, Retiro, Microcentro, Villa Urquiza, Núñez, Flores, Almagro, etc.
• GBA: San Isidro, Vicente López, Tigre, Escobar, Pilar, Avellaneda, Lanús, Quilmes, Morón, Ituzaingó, etc.
• Provinciales: Nueva Córdoba, Pichincha (Rosario), Godoy Cruz (Mendoza), etc.

🗺️ Custom Location / Ubicación Personalizada

English: If your desired location is not in the list, you can use "Scrape URLs - Custom Location" with direct Zonaprop mapping. ⚠️ Fallback Recommendation: If a standard location fails to work properly, try using the "Custom Location" option with the location's direct Zonaprop URL identifier.

Español: Si tu ubicación deseada no está en la lista, puedes usar "Scrape URLs - Ubicación Personalizada" con el mapeo directo de Zonaprop. ⚠️ Recomendación de Respaldo: Si una ubicación estándar falla, intenta usar la opción "Ubicación Personalizada" con el identificador directo de URL de Zonaprop.

---

⚙️ Technical Configuration / Configuración Técnica

🌐 Proxy Configuration / Configuración de Proxies

🟢 Recommended for Production / Recomendado para Producción:

{
  "proxySettings": {
    "enableProxies": true,
    "proxyType": "DATACENTER"
  }
}

⚠️ Testing Only / Solo para Testing:

{
  "proxySettings": {
    "enableProxies": false,
    "proxyType": "none"
  }
}

📌 When to Use Proxies / Cuándo Usar Proxies:

English:

• ✅ Production environments
• ✅ High volume operations (>50 properties)
• ✅ Contact extraction
• ✅ Optimal success rates
• ❌ Basic testing only

Español:

• ✅ Entornos de producción
• ✅ Operaciones de alto volumen (>50 propiedades)
• ✅ Extracción de contactos
• ✅ Tasas de éxito óptimas
• ❌ Solo testing básico

📌 Proxy Types / Tipos de Proxy:

English:

• DATACENTER: Cost-effective and reliable (recommended)
• none: Direct connection for testing

Español:

• DATACENTER: Económico y efectivo (recomendado)
• none: Conexión directa para testing

👻 Headless Browser

📋 Production Configuration / Configuración de Producción:

{
  "headless": true
}

🔧 Development Configuration / Configuración de Desarrollo:

{
  "headless": false
}

📌 Configuration Options / Opciones de Configuración:

English:

• Headless = true: Faster performance, production ready
• Headless = false: Visible interface for debugging

Español:

• Headless = true: Rendimiento más rápido, listo para producción
• Headless = false: Interfaz visible para debugging

---

📊 Extracted Fields / Campos Extraídos

🏠 Basic Information / Información Básica

• titulo - Título de la propiedad
• precio - Precio en moneda local
• moneda - Moneda (ARS/USD)
• direccion - Dirección completa
• barrio - Barrio/zona
• ciudad - Ciudad

📐 Features / Características

• ambientes - Número de ambientes
• dormitorios - Dormitorios
• banos - Baños
• m2_tot - Metros cuadrados totales
• m2_cub - Metros cuadrados cubiertos
• expensas - Gastos de expensas

🏗️ Property Details / Detalles de Propiedad

• antiguedad - Antigüedad del inmueble
• orientacion - Orientación
• luminosidad - Nivel de luminosidad
• cochera - Información de cochera
• fotos_count - Cantidad de fotos
• visualizaciones - Número de visualizaciones

📞 Contact (Extract Contact Only) / Contacto (Solo Extract Contact)

• telefono - Teléfono del vendedor
• whatsapp - WhatsApp con formato +54
• vendedor_email - Email del vendedor
• vendedor - Nombre del vendedor
• vendedor_tipo - Tipo (inmobiliaria/particular)
• contact_method - Método de extracción usado

📋 Additional Features / Características Adicionales

• caracteristicas_generales - Características generales (JSON)
• caracteristicas_ambientes - Características de ambientes (JSON)
• caracteristicas_extras - Características extras (JSON)
• servicios - Servicios disponibles (JSON)
• comodidades - Comodidades (JSON)

---

🚀 Usage Examples / Ejemplos de Uso

📝 1. Basic Setup - Extract URLs / Configuración Básica - Extraer URLs

{
  "scrapeUrl": {
    "ubicacion": "palermo",
    "operacion": "alquiler",
    "tipo": "departamentos",
    "maxPages": 3
  },
  "proxySettings": {
    "enableProxies": true,
    "proxyType": "DATACENTER"
  }
}

🗺️ 1b. Custom Location Setup / Configuración con Ubicación Personalizada

{
  "scrapeUrlCustom": {
    "ubicacionPersonalizada": "canning-ezeiza",
    "operacion": "venta",
    "tipo": "casas",
    "maxPages": 2
  },
  "proxySettings": {
    "enableProxies": true,
    "proxyType": "DATACENTER"
  }
}

Note: Only use ubicacionPersonalizada if the location is not available in the main list. / Nota: Solo usar ubicacionPersonalizada si la ubicación no está disponible en la lista principal.

📞 2. Premium Contact Extraction / Extracción Premium de Contactos

{
  "scrapePropiedades": {
    "mode": "extract-contact",
    "url": "https://www.zonaprop.com.ar/propiedades/clasificado/ejemplo"
  },
  "proxySettings": {
    "enableProxies": true,
    "proxyType": "DATACENTER"
  },
  "configuraciones": {
    "headless": true
  }
}

🏠 3. Single Scrape / Scrape Individual

{
  "scrapePropiedades": {
    "mode": "scrape-single",
    "url": "https://www.zonaprop.com.ar/propiedades/clasificado/ejemplo"
  },
  "proxySettings": {
    "enableProxies": false,
    "proxyType": "none"
  },
  "configuraciones": {
    "headless": false
  }
}

---

🔗 N8N Integration / Integración con N8N

🚀 Apify Node Setup / Configuración del Nodo Apify

English: Add Apify node to your workflow
Español: Agregar nodo Apify al workflow

Node Configuration:

Actor ID: YOUR_ACTOR_ID_HERE
Credentials: Apify API (with your token)

---

📋 Input JSON Examples / Ejemplos JSON de Input

Extract URLs / Extraer URLs

{
  "ubicacion": "palermo",
  "operacion": "alquiler", 
  "tipo": "departamentos",
  "maxPages": 3,
  "enableProxies": true,
  "proxyType": "DATACENTER"
}

Single Property / Propiedad Individual

{
  "mode": "scrape-single",
  "url": "https://www.zonaprop.com.ar/propiedades/...",
  "enableProxies": true
}

Extract Contact / Extraer Contacto

{
  "mode": "extract-contact", 
  "url": "https://www.zonaprop.com.ar/propiedades/...",
  "enableProxies": true
}

📊 Output Structure / Estructura de Salida

URLs Output

{
  "success": true,
  "mode": "scrape-urls",
  "urls": ["url1", "url2", ...],
  "totalProcessed": 150
}

Property Output

{
  "success": true,
  "property": {
    "titulo": "Departamento 2 ambientes",
    "precio": 180000,
    "moneda": "ARS",
    "ambientes": 2,
    "direccion": "Av. Santa Fe 3500",
    "telefono": "+54 11 1234-5678",
    "vendedor_email": "contact@example.com"
  }
}

---

📚 Correct inputSchema Usage Guide / Guía de Uso Correcto del inputSchema

✅ Correct Configurations / Configuraciones Correctas:

🔗 For Extracting URLs from Searches / Para Extraer URLs de Búsquedas:

English:

• ✅ Use "Scrape URL" folder with predefined locations
• ✅ Or use "Scrape URL Custom Location" for unmapped locations
• ✅ Custom format: lowercase, hyphens (e.g.: "canning-ezeiza", "villa-gesell")
• ❌ DO NOT use: both configurations at the same time

Español:

• ✅ Usar carpeta "Scrape URL" con ubicaciones predefinidas
• ✅ O usar "Scrape URL Ubicación Personalizada" para ubicaciones no mapeadas
• ✅ Formato personalizado: lowercase, guiones (ej: "canning-ezeiza", "villa-gesell")
• ❌ NO usar: ambas configuraciones a la vez

🏠 For Individual Property Scraping / Para Scrape de Propiedades Individuales:

English:

• ✅ Use "Scrape Properties" folder
• ✅ Choose mode: Basic Data or Data + Contact (complete)
• ✅ Paste valid Zonaprop URL
• ❌ DO NOT use: together with URL configuration

Español:

• ✅ Usar carpeta "Scrape Propiedades"
• ✅ Elegir modo: Datos Básicos o Datos + Contacto (completo)
• ✅ Pegar URL de Zonaprop válida
• ❌ NO usar: junto con configuración de URLs

🌐 About Proxies / Sobre Proxies:

English:

• ✅ Recommended for optimal success rates
• ✅ Datacenter - Cost-effective and reliable
• ✅ System works perfectly without proxies
• ✅ Without proxies - Direct connection for testing

Español:

• ✅ Recomendados para tasas de éxito óptimas
• ✅ Datacenter - Económicos y efectivos
• ✅ Sistema funciona perfectamente sin proxies
• ✅ Sin proxies - Conexión directa para testing

⚙️ Technical Configuration / Configuración Técnica:

English:

• ✅ Headless = true - Recommended for production
• ✅ Headless = false - Development/debugging only

Español:

• ✅ Headless = true - Recomendado para producción
• ✅ Headless = false - Solo para desarrollo/debugging

❌ What NOT to do / Qué NO hacer:

English:

• ❌ Don't mix configurations (e.g.: URLs + individual properties)
• ❌ Don't use custom location if it's in the main list
• ❌ Don't leave empty configurations without filling required fields

Español:

• ❌ No mezclar configuraciones (ej: URLs + propiedades individuales)
• ❌ No usar ubicación personalizada si está en la lista principal
• ❌ No dejar configuraciones vacías sin llenar campos requeridos

🔧 Optimization Tips / Consejos de Optimización:

English:

• For custom locations: Use real slug from Zonaprop URL
• For location format: Use lowercase + hyphens format
• For contact extraction: Enable proxies and verify URL validity

Español:

• Para ubicaciones personalizadas: Usar slug real del URL de Zonaprop
• Para formato de ubicación: Usar formato lowercase + guiones
• Para extracción contacto: Habilitar proxies y verificar validez de URL

---

⚡ Best Practices / Mejores Prácticas

🎯 For Maximum Performance / Para Máximo Rendimiento

✅ Do / Hacer:

English:

• Use datacenter proxies in production
• Keep headless=true in production
• Use N8N loops for mass processing
• Verify URLs before processing

Español:

• Usar proxies datacenter en producción
• Mantener headless=true en producción
• Usar loops N8N para procesamiento masivo
• Verificar URLs antes de procesar

⚡ Optimization / Optimización:

English:

• Enable proxies for high volumes
• Use compatible configurations
• Prefer predefined locations when available

Español:

• Habilitar proxies para volúmenes altos
• Usar configuraciones compatibles
• Preferir ubicaciones predefinidas cuando estén disponibles

🛡️ Anti-Detection / Anti-Detección

Recommended Setup / Configuración Recomendada:

{
  "proxySettings": {
    "enableProxies": true,
    "proxyType": "DATACENTER"
  },
  "configuraciones": {
    "headless": true
  }
}

📊 Quality Scoring System / Sistema de Puntuación de Calidad

English: The Actor includes intelligent data quality scoring (data_quality) for optimal performance tracking:

• >0.9: Excellent - Complete field extraction achieved
• 0.7-0.9: Good - High quality data extraction
• 0.5-0.7: Standard - Core fields successfully extracted
• Advanced optimization - Continuous quality enhancement

Español: El Actor incluye puntuación inteligente de calidad de datos (data_quality) para seguimiento óptimo del rendimiento:

• >0.9: Excelente - Extracción completa de campos lograda
• 0.7-0.9: Bueno - Extracción de datos de alta calidad
• 0.5-0.7: Estándar - Campos principales extraídos exitosamente
• Optimización avanzada - Mejora continua de la calidad

---

🎯 System Specifications / Especificaciones del Sistema

🏗️ Technical Architecture / Arquitectura Técnica

English:

• Precision Processing: Focused single-URL processing for maximum accuracy
• Zonaprop Specialist: Optimized specifically for Zonaprop.com.ar platform
• Adaptive Design: Intelligent adaptation to website structure changes

Español:

• Procesamiento de Precisión: Procesamiento enfocado de URL individual para máxima precisión
• Especialista Zonaprop: Optimizado específicamente para la plataforma Zonaprop.com.ar
• Diseño Adaptativo: Adaptación inteligente a cambios en la estructura del sitio web

🌎 Geographic Specialization / Especialización Geográfica

English:

• Complete Argentina Coverage: All provinces and major cities included
• Zonaprop Integration: Native integration with Argentina's leading real estate platform
• Local Format Support: Argentine phone numbers and address formats

Español:

• Cobertura Completa de Argentina: Todas las provincias y ciudades principales incluidas
• Integración Zonaprop: Integración nativa con la plataforma inmobiliaria líder de Argentina
• Soporte de Formato Local: Números telefónicos argentinos y formatos de direcciones

📞 Contact Extraction Excellence / Excelencia en Extracción de Contactos

English:

• Advanced Contact Discovery: Intelligent contact extraction with multiple methods
• Enhanced Success Rates: Optimal results with proxy configuration
• Precision-Focused: Single URL processing for detailed contact extraction

Español:

• Descubrimiento Avanzado de Contactos: Extracción inteligente de contactos con múltiples métodos
• Tasas de Éxito Mejoradas: Resultados óptimos con configuración de proxies
• Enfoque de Precisión: Procesamiento de URL única para extracción detallada de contactos

---

📈 Use Cases / Casos de Uso

🏢 Real Estate Agencies / Inmobiliarias

English:

• Competition and price monitoring
• Lead generation with contacts
• Market analysis by area
• Automation with N8N

Español:

• Monitoreo de competencia y precios
• Lead generation con contactos
• Análisis de mercado por zona
• Automatización con N8N

📊 Market Analysis / Análisis de Mercado

English:

• Price studies by neighborhood
• Real estate market trends
• Detailed geographic reports
• Area comparisons

Español:

• Estudios de precios por barrio
• Tendencias del mercado inmobiliario
• Reportes geográficos detallados
• Comparativas entre zonas

🤖 Automation / Automatización

English:

• CRM integration
• Automated workflows in N8N
• Database synchronization
• New property alerts

Español:

• Integración con CRMs
• Workflows automáticos en N8N
• Sincronización con bases de datos
• Alertas de nuevas propiedades

💼 Investors / Inversores

English:

• Opportunity search
• ROI analysis by area
• Historical price monitoring
• Trend evaluation

Español:

• Búsqueda de oportunidades
• Análisis de ROI por zona
• Monitoreo de precios históricos
• Evaluación de tendencias

---

🛠️ Technical Support / Soporte Técnico

📧 Contact / Contacto

• Creator / Creador: Expandí tu Marca
• Email: expanditumarca@gmail.com
• Support / Soporte: Technical and commercial inquiries

🐛 Report Issues / Reportar Problemas

English: When reporting issues, include:

• JSON configuration used
• Specific URLs that need attention
• Complete error messages
• Screenshots if relevant

Español: Al reportar problemas, incluye:

• Configuración JSON utilizada
• URLs específicas que necesitan atención
• Mensajes de error completos
• Screenshots si es relevante

💡 Feature Requests / Solicitudes de Funcionalidad

English: We are open to improvements and new features. Contact us with your ideas.

Español: Estamos abiertos a mejoras y nuevas funcionalidades. Contáctanos con tus ideas.

---

📋 Changelog / Registro de Cambios

V1.0 - Primera Versión Pública

• ✅ 3 modos de operación especializados
• ✅ Estructura de carpetas intuitiva en inputSchema
• ✅ Extracción premium de contactos optimizada
• ✅ 33+ campos por propiedad con alta precisión
• ✅ Anti-detección avanzada con proxies datacenter
• ✅ Configuración bilingüe (ES/EN)
• ✅ Integración optimizada para N8N

---

📜 License / Licencia

Commercial License / Licencia Comercial
This Actor is for commercial use. For specific terms and licensing, contact the creator.
Este Actor es de uso comercial. Para términos específicos y licenciamiento, contacta al creador.

---

🎯 Conclusion / Conclusión

🇺🇸 English:
Zonaprop Scraper V1.0 is the most complete solution for real estate data extraction in Argentina. With its unique contact extraction functionality, intuitive folder structure, and over 33 fields per property, it's ideal for both real estate agencies and professional market analysis. Optimized system with superior performance and perfect N8N integration.

🇪🇸 Español:
Zonaprop Scraper V1.0 es la solución más completa para extracción de datos inmobiliarios de Argentina. Con su funcionalidad única de extracción de contactos, estructura intuitiva de carpetas, y más de 33 campos por propiedad, es ideal tanto para inmobiliarias como para análisis de mercado profesional. Sistema optimizado con performance superior y integración perfecta con N8N.

---

⭐ Was this helpful? / ¿Te resultó útil?
Contact us for support, commercial inquiries, or custom feature requests.
Contáctanos para soporte, consultas comerciales o solicitudes de funcionalidades personalizadas.

📧 expanditumarca@gmail.com | 🏢 Expandí tu Marca