Bienvenido a Place Analyzer

Bienvenido a la

API de Place Analyzer, tu plataforma de inteligencia inmobiliaria para Latinoamérica.

Nuestra API te permite integrar tasaciones automáticas y análisis de mercado geoespacial directamente en tus aplicaciones, usando algoritmos de machine learning para darte la información más precisa al instante.

¿Para quién es esta API? 🎯

Esta API está diseñada para equipos que necesitan datos inmobiliarios precisos y al momento:

• 🏢 Inmobiliarias y Proptechs: Para automatizar tasaciones, generar reportes de mercado para clientes e integrar tasaciones en sus plataformas web.
• 🏦 Entidades Financieras: Para agilizar la evaluación de propiedades para créditos hipotecarios y realizar análisis de riesgo inmobiliario.
• 🏗️ Desarrolladores Inmobiliarios: Para potenciar sus estudios de factibilidad y análisis de mercado para nuevos proyectos.
• 🖥️ Desarrolladores de Software: Para crear dashboards, aplicaciones móviles o cualquier herramienta que requiera inteligencia de ubicación.

¿Qué puedes hacer con la API?

Nuestra API te da acceso a tres familias principales de funcionalidades:

🔍 Avalúos individuales

El flujo principal. Envías los datos de una propiedad (coordenadas, características y configuración del reporte) y la API inicia un proceso asíncrono. Luego, puedes consultar el estado y obtener un resultado de tasación detallado.

Endpoints disponibles:

Método	Endpoint	Descripción
POST	/valuation-request	Crear una nueva solicitud de avalúo
GET	/valuation-request/{requestCode}	Consultar estado y detalles de la solicitud
GET	/valuation-request/{requestCode}/result	Obtener el resultado de la tasación

• Ideal para: Integrar un tasador en tu web o app.
• Ver la guía: Flujo básico de avalúo

📊 Análisis de zona y reportes

Obtén inteligencia de ubicación para cualquier coordenada. Estos endpoints devuelven datos listos para ser usados en gráficos y reportes (demografía, comercios cercanos, etc.).

• Ideal para: Generar reportes de mercado, análisis demográficos o entender el entorno comercial.
• Ver la guía: Guía de reportes y gráficos

📈 Procesamiento en lote (Batch)

Sube un archivo CSV con miles de propiedades y deja que nuestro sistema las procese de forma asíncrona. Puedes monitorear el estado del lote y descargar los resultados una vez completados.

• Ideal para: Tasaciones de portafolios, análisis masivos de riesgo crediticio.
• Documentación: Próximamente disponible.

Estructura de datos principal

Para crear un avalúo necesitas enviar la información de la propiedad en un formato estructurado:

{
  "latitude": -34.603722,
  "longitude": -58.381592,
  "property": {
    "propertyType": "Casa",
    "propertyAge": "Semi nuevo",
    "propertyCondition": "Bueno",
    "m2Land": 300,
    "m2Built": 200,
    "numberOfBedrooms": 3,
    "numberOfBathrooms": 2,
    "garageSpaces": 1
  }
}

Campos requeridos

Los campos obligatorios en todas las peticiones son: latitude, longitude, y dentro del objeto property el campo propertyType.

Para el resto de los atributos de la propiedad, la obligatoriedad depende directamente del tipo de inmueble seleccionado (propertyType):

Terreno

• Obligatorio: Superficie del terreno (m2Land).
• No se exigen: m2Built, m2Covered, m2SemiCovered, propertyAge, propertyCondition.

Departamento

• Obligatorios: Área cubierta (m2Covered), área semicubierta (m2SemiCovered) y antigüedad (propertyAge).
• No se exige: m2Built. Tampoco se exigen m2Land ni propertyCondition.

Demás tipos (Casa, Duplex, Deposito, Tinglado, Oficina, Local Comercial, Propiedad rural, Casa quinta, Edificio)

• Obligatorios: Superficie del terreno (m2Land), superficie construida (m2Built), antigüedad (propertyAge) y estado de conservación (propertyCondition).

Nota: Si un campo no exigido no aplica para el tipo de propiedad que estás enviando, puedes omitirlo del JSON o enviarlo como null. Consulta la matriz completa en Avalúos individuales.

Servicios disponibles

La API de Place Analyzer se divide en dos servicios principales, ambos operando en el entorno de producción.

🏠 Valuation API

• URL: https://api.placeanalyzer.com
• Propósito: Gestión de avalúos inmobiliarios (creación y consulta).

📊 Report API

• URL: https://reports.placeanalyzer.com
• Propósito: Análisis de mercado, datos estadísticos y propiedades cercanas.

🚀 ¡Comencemos! Tu primer avalúo

¿Listo para integrar? Esta es la ruta recomendada:

1. Regístrate en nuestro portal de desarrolladores (si aún no lo has hecho).
2. Obtén tu API Key desde tu dashboard.
3. Lee la guía de autenticación para aprender cómo enviar tu API Key de forma segura.
4. Sigue nuestra guía principal: Flujo básico de avalúo. Te llevará paso a paso para crear una solicitud, consultar su estado y obtener el resultado final.

¿Tienes dudas?

¡Estamos aquí para ayudarte! Si te quedas atascado o tienes preguntas, no dudes en contactarnos por email a [email protected] o únete a nuestra comunidad de Discord.