API Reference
Bienvenido a la documentación técnica de
Place Analyzer API. Aquí encontrarás toda la información necesaria para integrar nuestros servicios de tasación inmobiliaria y análisis de mercado.Inicio Rápido
# 1. Crear un avalúo
curl -X POST "https://api.placeanalyzer.com/valuation/valuation-request" \
-H "X-API-KEY: tu_api_key" \
-H "Content-Type: application/json" \
-d '{
"latitude": -25.284583,
"longitude": -57.562291,
"property": {
"propertyType": "Casa",
"m2Land": 360,
"m2Built": 120,
"propertyAge": "Semi nuevo",
"propertyCondition": "Bueno"
}
}'
# 2. Consultar estado (polling cada 5-10 segundos)
curl -X GET "https://api.placeanalyzer.com/valuation/valuation-request/{requestCode}" \
-H "X-API-KEY: tu_api_key"
# 3. Obtener resultado cuando status = READY
curl -X GET "https://api.placeanalyzer.com/valuation/valuation-request/{requestCode}/result" \
-H "X-API-KEY: tu_api_key"Características de la API
| Característica | Descripción |
|---|---|
| Protocolo | REST sobre HTTPS |
| Formato | JSON para requests y responses |
| Autenticación | API Key via header X-API-KEY |
| Procesamiento | Asíncrono para operaciones de tasación |
| Rate Limiting | Límites por plan (ver documentación) |
APIs Disponibles
🏠 API de Valuaciones
Gestiona el ciclo completo de tasaciones inmobiliarias automatizadas.
| Método | Endpoint | Descripción |
|---|---|---|
POST | /valuation-request | Crear solicitud de avalúo |
GET | /valuation-request/{requestCode} | Consultar estado del avalúo |
GET | /valuation-request/{requestCode}/result | Obtener resultado de tasación |
📊 API de Análisis Comercial
Analiza el entorno comercial de cualquier ubicación.
| Método | Endpoint | Descripción |
|---|---|---|
GET | /commerce-graphic | Datos para gráficos |
🏡 API de Propiedades Cercanas
Obtén propiedades comparables para análisis de mercado.
| Método | Endpoint | Descripción |
|---|---|---|
GET | /near-properties | Propiedades en venta/alquiler |
Autenticación
Todas las peticiones requieren una API Key válida:
curl -H "X-API-KEY: tu_api_key_aqui" \
"https://api.placeanalyzer.com/valuation/valuation-request/abc-123"Obtener tu API Key
Genera tu API Key siguiendo nuestra Guía de Autenticación.
Entornos Disponibles
| Servicio | URL Base | Descripción |
|---|---|---|
| 🏠 Valuation API | https://api.placeanalyzer.com/valuation/v1 | Creación y gestión de avalúos |
| 📊 Report API | https://api.placeanalyzer.com/report/v1 | Datos de mercado y análisis |
Entorno de Producción
La API opera únicamente en entorno de Producción, dividida en dos servicios principales: Valuation API y Report API.
Códigos de Respuesta HTTP
| Código | Significado | Acción recomendada |
|---|---|---|
200 | Éxito | Procesar respuesta |
400 | Datos inválidos | Revisar campos del request |
401 | No autorizado | Verificar API Key |
404 | No encontrado | Verificar requestCode |
429 | Rate limit | Esperar y reintentar con backoff |
500 | Error servidor | Reintentar con backoff exponencial |
Modelos de Datos Principales
Request de Valuación
{ "latitude": -25.284583, "longitude": -57.562291, "property": { "propertyType": "Casa", "propertyAge": "Semi nuevo", "propertyCondition": "Bueno", "m2Land": 300, "m2Built": 200 } }
Response de Resultado
{ "requestCode": "abc-123-xyz", "requestDate": "2026-01-01T12:00:00.000", "status": "READY", "mlModelCode": "V1", "currency": "USD", "priceLand": 150000.0, "priceBuild": 200000.0 }
Recursos Adicionales
| Recurso | Descripción |
|---|---|
| Guía de Autenticación | Cómo obtener y usar tu API Key |
| Flujo Básico de Avalúo | Tutorial paso a paso |
| Manejo de Errores | Códigos y soluciones |
| Rate Limiting | Límites y mejores prácticas |
| Glosario | Términos y estados |
Explora la API
REGISTRO
Regístrate y obtén credenciales para integrar nuestro ambiente de pruebas.
Regístrate en Sandbox