Tasarapp API Documentation

API B2B para tasaciones inmobiliarias automatizadas en tiempo real. Integre nuestro motor de valuación algorítmica directamente en su CRM, plataforma o flujo de trabajo.

Ver Endpoint POST /api/valuation Guía de Autenticación

1Autenticación (OAuth 2.0 Client Credentials)

La API utiliza el estándar OAuth 2.0 Client Credentials. Envíe su clientId y clientSecret para obtener un Access Token (JWT) con una validez de 1 hora (3600 segundos).

POST /api/auth/token

Payload Requerido

Campo

Tipo

Descripción

clientId

string

Identificador público de la organización (ej: b2b_tokko_123).

clientSecret

string

Clave privada de la organización (ej: sk_live_...).

Recomendación para integradores: Almacene en caché el access_token y reutilícelo durante sus 60 minutos de vida útil. Renueve el token automáticamente antes de su expiración para evitar latencia innecesaria en cada tasación.

cURL RequestPOST

curl -X POST https://tasarapp.com/api/auth/token \
  -H "Content-Type: application/json" \
  -d '{
    "clientId": "b2b_tokko_123",
    "clientSecret": "sk_live_9f8a7d2b4e1c..."
  }'

Response (200 OK)JSON

{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "token_type": "Bearer",
  "expires_in": 3600
}

2Entornos: Sandbox vs. Producción

Tasarapp provee credenciales separadas para desarrollo seguro y producción. Ambos entornos ejecutan la misma versión del motor estadístico para garantizar consistencia.

Sandbox (Test)

Entorno de Pruebas Ilimitado

Diseñado para desarrollo, integración de CI/CD y tests automatizados de software. Las tasaciones procesadas en este entorno no descuentan cuota de su plan contratado y retornan un encabezado X-Avaluar-Sandbox: true.

• Prefijo de token: sk_test_...

• Quota descontada: 0 créditos

• Header de respuesta: X-Avaluar-Sandbox: true

Producción (Live)

Entorno Productivo Oficial

Entorno de alta disponibilidad con SLA empresarial garantizado. Cada solicitud descuenta créditos de la cuota mensual de su organización y queda auditada de forma inmutable.

• Prefijo de token: sk_live_...

• SLA de respuesta: < 250ms (p95)

• Persistencia completa de auditoría e historial

3Endpoint Principal: Valuación Automatizada

El endpoint calcula el valor comercial estimado (valueUsd), el rango probabilístico, el valor implícito por metro cuadrado (usdM2) y la lista de comparables de mercado rigurosamente seleccionados.

POST /api/valuation

Parámetros Requeridos

Campo

Tipo

Descripción

propertyType

string

"departamento", "casa" o "ph".

surface

number

Superficie total en m² (15 a 800). En monoambientes suele coincidir con la superficie cubierta.

rooms

number

Cantidad de ambientes habitables (1 a 8). Por ej: estar-comedor + 2 dormitorios = 3 ambientes.

address / (lat, lng)

string / number

Al menos un método de localización en CABA: address (ej: "Av. Santa Fe 3200", validada contra USIG catastro oficial), neighborhoodId (ej: "palermo") o coordenadas geográficas lat y lng.

Parámetros Opcionales de Inmueble

Campo

Tipo

Default

Descripción

operationType

string

"venta"

"venta" o "alquiler".

coveredSurface

number (10 a 800)

surface

Superficie cubierta en m² (si se omite, se asume igual a la superficie total).

bedrooms

number (0 a 10)

rooms - 1

Cantidad de dormitorios privados (en monoambientes = 0).

bathrooms

number (1 a 8)

Cantidad de baños completos (mínimo 1).

garages

number (0 a 10)

Cantidad de cocheras fijas o cubiertas asignadas a la unidad.

floor

number (0 a 60)

Piso de la unidad (solo departamentos y PHs). 0 = Planta Baja.

ageYears

number (0 a 120)

Antigüedad del inmueble en años (0 = a estrenar).

disposition

string

null

Disposición en el edificio: "frente", "contrafrente", "interno" o "lateral".

orientation

string

null

Orientación cardinal principal (ej: "N", "NE", "E", "S", "O").

view

string

"ciudad"

Calidad visual exterior: "panoramica", "abierta", "verde" o "ciudad". Pondera el modelo hedónico.

condition

number (0.0 a 1.0)

0.5

Conservación (0 = a refaccionar, 0.5 = estándar bueno, 1 = reciclado a nuevo / a estrenar).

finishes

number (0.0 a 1.0)

0.5

Calidad de materiales y terminaciones (0 = económico/básico, 0.5 = estándar, 1 = lujo / premium).

naturalLight

number (0.0 a 1.0)

0.5

Nivel de iluminación natural y asoleamiento directo (0.8 = muy luminoso). Alias: luminosidad.

hoaFee

number (0 a 3M)

Monto mensual de expensas en pesos argentinos (ARS). Alias: expensas, hoa_fee.

lat / lng

number

null

Coordenadas geográficas WGS84 para anclar la búsqueda espacial a un punto satelital exacto.

recalcOf

string (UUID)

null

ID de una tasación previa en el sistema. Asocia el cálculo como un recálculo/revisión para auditoría histórica.

amenities

object

{}

Diccionario booleano de comodidades (ver detalle de claves reconocidas abajo).

Claves Soportadas en el Objeto amenities

El motor y el adaptador en inglés reconocen automáticamente las siguientes comodidades booleanas (tanto en formato estándar en inglés como en sus alias en español):

garage/ parking / cocheraCochera fija o cubierta

balcony/ balconBalcón o terraza privada

pool/ swimmingPool / piletaPiscina o pileta en edificio

security/ seguridadVigilancia 24hs / tótem

gym/ gimnasioGimnasio equipado

grill/ bbq / parrillaParrilla individual o quincho

clubhouse/ multipurposeRoom / sumSalón de Usos Múltiples (SUM)

heating/ calefaccionCalefacción central o losa

airConditioning/ aireAcondicionadoAire acondicionado instalado

Criterio de Calidad vs. Volumen

El motor prioriza la afinidad sobre la cantidad bruta: es preferible retornar menos comparables de alta similitud que completar un cupo con inmuebles distantes o dispares. Mediante min_similarity (o minSimilarity) y max_comparables (o maxComparables) podés calibrar ese balance con precisión para tu interfaz o CRM.

Parámetro

Tipo

Default

Descripción

maxComparables

number (1 a 50)

Tope superior de comparables a retornar en comparables. Permite a los CRMs adaptar el tamaño según su interfaz (ej: 3 para WhatsApp, 8 para dossier PDF).

minSimilarity

number (0.0 a 1.0)

0.75

Umbral estricto de similitud multidimensional. La API no devuelve ningún comparable que no alcance este score, evitando propiedades dispares.

includeContext

boolean

false

Si se envía true, añade el campo contextComparables con todos los avisos del radio para dibujar nubes de dispersión o mapas interactivos en el CRM.

Warnings Estructurados

filtered_by_similarity_threshold
Se emite cuando el cliente solicitó más comparables (ej. max_comparables=10) de los que superaron el umbral. La API devuelve solo esos con este warning transparente.
similarity_threshold_relaxed_fallback
En microzonas con baja densidad donde ninguno supera el umbral, el motor relaja defensivamente el corte para devolver los 2 mejores disponibles.

Objeto meta en la Respuesta

Cada respuesta incluye telemetría completa sobre la búsqueda espacial para auditoría técnica:

"meta": {
  "maxComparablesRequested": 6,
  "minSimilarityRequested": 0.80,
  "comparablesReturned": 6,
  "totalComparablesInRadius": 418,
  "searchRadiusM": 300,
  "filteredBySimilarity": false
}

Ejemplo de Solicitud (cURL Request)

cURL RequestPOST /api/valuation

curl -X POST https://tasarapp.com/api/valuation \
  -H "Authorization: Bearer eyJhbG..." \
  -H "Content-Type: application/json" \
  -d '{
    "address": "Av. Santa Fe 3200",
    "neighborhoodId": "palermo",
    "propertyType": "departamento",
    "surface": 52,
    "coveredSurface": 48,
    "rooms": 2,
    "bedrooms": 1,
    "bathrooms": 1,
    "garages": 1,
    "floor": 4,
    "ageYears": 8,
    "disposition": "frente",
    "orientation": "NE",
    "view": "abierta",
    "condition": 0.8,
    "finishes": 0.8,
    "naturalLight": 0.85,
    "hoaFee": 85000,
    "maxComparables": 6,
    "minSimilarity": 0.80,
    "includeContext": false,
    "amenities": {
      "balcony": true,
      "garage": true,
      "security": true,
      "pool": true,
      "airConditioning": true
    }
  }'

Payload JSON de Respuesta

Response (200 OK)JSON

{
  "id": "8d1937b0-1b36-4e20-b778-45b6d223ad6c",
  "address": "Av. Santa Fe 3200, Palermo, CABA",
  "operationType": "venta",
  "valueUsd": 170447,
  "low": 110497,
  "high": 230397,
  "usdM2": 3788,
  "baseUsdM2": 3839,
  "baseSource": "spatial_hedonic",
  "confidence": "media",
  "confidenceScore": 56,
  "dispersion": 0.656,
  "closingAdjustmentPct": 8,
  "estimatedClosingUsd": 156812,
  "sampleSize": 236,
  "searchRadiusM": 1200,
  "neighborhoodId": "palermo",
  "neighborhoodName": "Palermo",
  "neighborhoodUsdM2": 3839,
  "engineId": "tasarapp-engine",
  "modelVersion": "ave-hedonic-ar-v0.4.0",
  "computedMs": 150.6,
  "isSandbox": true,
  "warning": "SANDBOX VALUATION - NOT VALID FOR LEGAL OR COMMERCIAL APPRAISAL",
  "explanation": [
    {
      "feature": "location",
      "label": "Ubicación (barrio)",
      "impactPct": 42.4,
      "direction": "up"
    },
    {
      "feature": "surface",
      "label": "Superficie",
      "impactPct": -16.9,
      "direction": "down"
    },
    {
      "feature": "bathrooms",
      "label": "Baños",
      "impactPct": -4.3,
      "direction": "down"
    },
    {
      "feature": "rooms",
      "label": "Ambientes",
      "impactPct": 2.9,
      "direction": "up"
    },
    {
      "feature": "ageYears",
      "label": "Antigüedad",
      "impactPct": 2.8,
      "direction": "up"
    }
  ],
  "trend": [
    { "month": "2025-07", "usdM2": 3493 },
    { "month": "2025-08", "usdM2": 3530 },
    { "month": "2025-09", "usdM2": 3582 },
    { "month": "2025-10", "usdM2": 3587 },
    { "month": "2025-11", "usdM2": 3588 },
    { "month": "2025-12", "usdM2": 3639 },
    { "month": "2026-01", "usdM2": 3681 },
    { "month": "2026-02", "usdM2": 3676 },
    { "month": "2026-03", "usdM2": 3692 },
    { "month": "2026-04", "usdM2": 3751 },
    { "month": "2026-05", "usdM2": 3777 },
    { "month": "2026-06", "usdM2": 3769 }
  ],
  "market": {
    "medianUsdM2": 3244,
    "lowUsdM2": 2103,
    "highUsdM2": 5292,
    "dispersion": 0.983,
    "propertyUsdM2": 3788,
    "deltaPct": 16.8,
    "percentile": 60,
    "sampleSize": 5
  },
  "zone": {
    "investment": {
      "capRatePct": 3.8,
      "rentUsdM2": 12,
      "appreciationYoy": 8.6,
      "liquidityDays": 41
    },
    "neighborhood": [
      {
        "key": "seguridad",
        "label": "Seguridad",
        "score": 76,
        "tone": "good",
        "value": "819 delitos/km²"
      },
      {
        "key": "verdes",
        "label": "Espacios verdes",
        "score": 71,
        "tone": "good",
        "value": "9.8 m²/hab"
      },
      {
        "key": "transporte",
        "label": "Transporte",
        "score": 96,
        "tone": "good",
        "value": "subte a 164 m"
      },
      {
        "key": "caminabilidad",
        "label": "Caminabilidad",
        "score": 67,
        "tone": "mid",
        "value": "caminable",
        "estimated": true
      }
    ],
    "tier": {
      "label": "Top premium",
      "percentile": 94
    },
    "pros": [
      "Bien conectado",
      "Zona segura",
      "Espacios verdes cerca"
    ],
    "cons": [],
    "similarBarrios": [
      { "id": "belgrano", "name": "Belgrano", "usdM2": 2910 },
      { "id": "recoleta", "name": "Recoleta", "usdM2": 3080 },
      { "id": "nunez", "name": "Núñez", "usdM2": 2760 }
    ],
    "connectivity": [
      { "key": "subte", "label": "Subte", "detail": "estación a 164 m", "available": true },
      { "key": "metrobus", "label": "Colectivos", "detail": "amplia cobertura", "available": true }
    ]
  },
  "spatialIntelligence": {
    "h3_index": "8ac2e3118577fff",
    "crimes_300m": 5,
    "dist_bicisenda_m": 416.23,
    "dist_subte_m": 201.35,
    "pluvial_risk": 0
  },
  "rental": {
    "monthlyUsd": 601,
    "low": 469,
    "high": 734,
    "usdM2": 13.37,
    "yieldPct": 4.2,
    "confidence": "baja",
    "confidenceScore": 42
  },
  "levers": [
    {
      "key": "cochera",
      "label": "Cochera",
      "deltaUsd": 8522,
      "deltaPct": 5.0,
      "present": true
    },
    {
      "key": "balcon",
      "label": "Balcón / Terraza",
      "deltaUsd": 3068,
      "deltaPct": 1.8,
      "present": true
    },
    {
      "key": "estado",
      "label": "Puesta a punto (estado impecable)",
      "deltaUsd": 7632,
      "deltaPct": 4.5,
      "present": false
    },
    {
      "key": "pileta",
      "label": "Pileta",
      "deltaUsd": 5966,
      "deltaPct": 3.5,
      "present": false
    },
    {
      "key": "apto_credito",
      "label": "Apto crédito",
      "deltaUsd": 5113,
      "deltaPct": 3.0,
      "present": false
    },
    {
      "key": "ascensor",
      "label": "Ascensor",
      "deltaUsd": 4261,
      "deltaPct": 2.5,
      "present": false
    }
  ],
  "warnings": [
    "filtered_by_similarity_threshold"
  ],
  "meta": {
    "maxComparablesRequested": 6,
    "minSimilarityRequested": 0.8,
    "comparablesReturned": 2,
    "totalComparablesInRadius": 184,
    "searchRadiusM": 600,
    "filteredBySimilarity": true
  },
  "comparables": [
    {
      "id": "cmp_sample_01",
      "source": "market",
      "propertyType": "departamento",
      "surface": 50,
      "rooms": 2,
      "bathrooms": 1,
      "ageYears": 10,
      "floor": 3,
      "priceUsd": 175000,
      "usdM2": 3500.0,
      "lat": -34.5862,
      "lng": -58.4115,
      "address": "Av. Santa Fe 3100, Palermo",
      "url": "https://example.com/listings/cmp_sample_01",
      "distanceM": 140,
      "similarity": 0.91,
      "neighborhoodId": "palermo"
    },
    {
      "id": "cmp_sample_02",
      "source": "market",
      "propertyType": "departamento",
      "surface": 54,
      "rooms": 2,
      "bathrooms": 1,
      "ageYears": 7,
      "floor": 5,
      "priceUsd": 182000,
      "usdM2": 3370.37,
      "lat": -34.5875,
      "lng": -58.4098,
      "address": "Av. Coronel Díaz 2400, Palermo",
      "url": "https://example.com/listings/cmp_sample_02",
      "distanceM": 290,
      "similarity": 0.88,
      "neighborhoodId": "palermo"
    }
  ],
  "contextComparables": [
    {
      "id": "cmp_sample_03",
      "source": "market",
      "propertyType": "departamento",
      "surface": 48,
      "rooms": 2,
      "bathrooms": 1,
      "ageYears": 12,
      "floor": 2,
      "priceUsd": 165000,
      "usdM2": 3437.5,
      "lat": -34.5849,
      "lng": -58.4132,
      "address": "Mansilla 3300, Palermo",
      "url": "https://example.com/listings/cmp_sample_03",
      "distanceM": 410,
      "similarity": 0.84,
      "neighborhoodId": "palermo"
    }
  ]
}

Diccionario de Campos y Recomendaciones

Cada propiedad devuelta por /api/valuation responde a una función técnica y de negocio precisa. Hacé clic en cada categoría para expandir su definición, tipos y recomendaciones prácticas de implementación:

Valuación Central y Rango Probabilístico

valueUsd, low, high, usdM2, baseUsdM2, baseSource, operationType

valueUsdnumber•Valor de Mercado Central

Precio de mercado recomendado en dólares estadounidenses (USD billete). Representa el valor central de publicación óptimo calculado mediante ensamble estadístico y comparables directos.

Mostrar como el valor principal destacado en fichas, tasaciones PDF y pantallas de cotización de su CRM.

lownumber•highnumber•Banda de Liquidez

Límites inferior y superior del intervalo de confianza empírico. low marca el valor de venta rápida/oportunidad con absorción inmediata; high representa el techo técnico sin sobredimensionar el tiempo en cartera.

Ideal para dibujar sliders de negociación con el cliente propietario o bandas de tolerancia en aprobaciones de créditos hipotecarios.

usdM2number•baseUsdM2number•baseSourcestring

usdM2 es el valor por metro cuadrado estimado de la unidad tasada. baseUsdM2 es la mediana base de referencia geoespacial según baseSource ("spatial_hedonic", "barrio" o "caba").

Permite ilustrar gráficamente si la propiedad cotiza con premio o descuento respecto al promedio de su microzona.

operationTypestring ("venta" | "alquiler")

Modalidad operativa de la tasación solicitada. Define si la cifra protagonista del informe responde a venta o alquiler tradicional.

Útil para tipificar automáticamente fichas de inventario y clasificar operaciones dentro del pipeline comercial.

Métricas de Confianza y Calibración de Cierre

confidence, confidenceScore, dispersion, closingAdjustmentPct, estimatedClosingUsd

confidencestring ("alta" | "media" | "baja")•confidenceScorenumber (0 a 100)

Puntaje cuantitativo derivado de la densidad de comparables idénticos en el radio geográfico, la cercanía temporal de las muestras y la baja varianza estadística residual.

Si confidenceScore > 80, el informe puede aprobarse automáticamente sin intervención humana. Si es menor a 60, activar flujo de revisión por un tasador senior.

dispersionnumber (0.0 a 1.0)

Heterogeneidad relativa de precios entre comparables zonales calculada como (p90 - p10) / p50. Valores menores a 0.3 denotan un mercado altamente uniforme; valores superiores a 0.5 advierten disparidad constructiva en la zona.

Utilizar para ajustar el ancho visual del semáforo de riesgo en reportes crediticios o de adquisición inmobiliaria.

closingAdjustmentPctnumber•estimatedClosingUsdnumber

Ajuste por negociación real (brecha entre precio de publicación y precio billete de escrituración). estimatedClosingUsd simula el valor neto en mano que recibirá el vendedor tras el cierre.

Fundamental para cálculos de rentabilidad neta para inversores y comisiones de intermediación inmobiliaria reales.

Inteligencia y Posicionamiento de Mercado (market)

medianUsdM2, lowUsdM2, highUsdM2, dispersion, propertyUsdM2, deltaPct, percentile, sampleSize

marketMarketReference

Referencia empírica que ubica el valor del metro cuadrado de la unidad dentro de la nube real de propiedades en venta en el radio geográfico:

medianUsdM2

Mediana de USD/m² de la oferta activa

lowUsdM2 / highUsdM2

Extremos p10 y p90 de la competencia

propertyUsdM2

USD/m² tasado de la propiedad

deltaPct

Desvío % respecto a la mediana zonal

percentile

Percentil 0–100 en la nube zonal

dispersion

Dispersión de precios de los comparables

sampleSize

Cantidad de inmuebles que sustentan el análisis

Utilice percentile y deltaPct para renderizar termómetros de competitividad de precio frente al cliente propietario: permite evidenciar si el inmueble entra al mercado a precio competitivo o con prima de exclusividad.

Serie Temporal y Tendencia Histórica (trend)

trend, month, usdM2

trend[]Array<TrendPoint>

Serie de tiempo con los últimos 12 meses de evolución del valor del metro cuadrado en la microzona geográfica. Cada elemento contiene:

month: período en formato ISO "YYYY-MM" (ej: "2025-07")

usdM2: valor mediano en USD por metro cuadrado en dicho mes

Permite dibujar curvas de evolución interanual o mini-gráficos sparklines en sus fichas para argumentar si los precios zonales están en fase de aceleración, meseta o reacomodamiento.

Diagnóstico Urbano, Inversión y Entorno (zone)

investment, neighborhood, tier, pros, cons, similarBarrios, connectivity

zone.investmentInvestmentMetrics

Métricas financieras consolidadas para inversores inmobiliarios:

capRatePct: rentabilidad bruta anual (%)

rentUsdM2: alquiler mensual USD/m²

appreciationYoy: apreciación interanual (%)

liquidityDays: días promedio de venta

zone.neighborhood[]Array<ZoneIndex>

Índices urbanos calificados (score de 0 a 100, tono "good" | "mid" | "bad" y valor descriptivo):

seguridad: tasa delictiva por km²

verdes: metros cuadrados verdes por habitante

transporte: distancia y cobertura de red masiva

caminabilidad: walkability y cercanía comercial

zone.tier / pros / cons / similarBarrios / connectivity

Análisis cualitativo y relacional del entorno urbano:

tier: clasificación socio-inmobiliaria (label: "Top premium", percentile: 94 dentro de CABA).
pros[] / cons[]: fortalezas y puntos de atención generados algorítmicamente para la zona.
similarBarrios[]: barrios alternativos con USD/m² equivalente para ofrecer al comprador indeciso.
connectivity[]: accesos de transporte con detalle geográfico (subte, metrobús, autopistas).

Inteligencia Geoespacial Micro-Local (spatialIntelligence)

h3_index, crimes_300m, dist_subte_m, dist_bicisenda_m, pluvial_risk

spatialIntelligenceSpatialIntelligence

Variables geoespaciales precisas calculadas a partir del sistema de celdas hexagonales Uber H3 y capas cartográficas del GCBA:

h3_index

Identificador espacial hexagonal H3 único

crimes_300m

Índice de seguridad e incidentes en radio urbano (300m)

dist_subte_m

Metros a boca de transporte subterráneo más cercana

dist_bicisenda_m

Metros a red protegida de movilidad sustentable

pluvial_risk

Índice de riesgo pluvial e hídrico local (0 = sin riesgo)

Invaluable para suscripción de riesgos hipotecarios, cotización de seguros y scoring automático de ubicación geográfica.

Palancas de Valorización y Reformas (levers)

levers, key, label, deltaUsd, deltaPct, present

levers[]Array<ValueLever>

Análisis de sensibilidad hedónica que cuantifica de forma transparente cuánto sumaría o restaría cada atributo al valor de la propiedad:

key: clave interna ("cochera", "balcon", "estado", "pileta", etc.)

label: etiqueta humana descriptiva de la mejora

deltaUsd: ganancia estimada en dólares (USD)

deltaPct: impacto relativo en porcentaje sobre el precio

present: true si el inmueble ya lo posee; false si es una mejora potencial realizable

Presente estas palancas en reuniones con propietarios para ilustrar qué obras o refacciones maximizan el retorno antes de publicar la propiedad ("Home Staging" y puesta a punto).

Proyección de Renta y Retorno Anual (rental)

monthlyUsd, low, high, usdM2, yieldPct, confidence, confidenceScore

rentalRentalEstimate

Estimación de alquiler mensual tradicional en dólares (USD) derivado del valor de venta y retorno bruto anual proyectado:

monthlyUsd

Canon mensual estimado en USD billete

low / high

Banda de negociación contractual mensual

usdM2

Alquiler mensual por metro cuadrado

yieldPct

Cap Rate / rentabilidad bruta anual (%)

confidence / confidenceScore

Fiabilidad estadística de la proyección locativa

Permite a inversores inmobiliarios evaluar de inmediato el rendimiento financiero del activo y la relación precio-alquiler (PER) de la unidad.

Inteligencia Explicativa e Impacto de Atributos (SHAP)

explanation, feature, label, impactPct, direction

explanation[]Array<ExplanationItem>

Desglose transparente de los factores que suben o bajan el precio respecto al promedio zonal:

feature: clave interna ("surface", "ageYears", "bathrooms", etc.)

label: etiqueta humana en español

impactPct: porcentaje de impacto (+42.4% o -16.9%)

direction: "up" o "down"

Renderice barras de impacto visuales (verdes y rojas) en sus dossiers para justificar frente al cliente por qué la propiedad vale más o menos que las del edificio vecino.

Comparables de Mercado Homogéneos y Entorno

comparables, similarity, distanceM, source, bathrooms, contextComparables

comparables[]Array<Comparable>

Lista curada de propiedades activas del mercado que sustentan el cálculo. Cada comparable incluye:

source: market / portal inmobiliario

priceUsd: precio publicado

usdM2: precio por m²

similarity: score de 0.0 a 1.0

distanceM: distancia física en metros

lat / lng: coordenadas del aviso

neighborhoodId: barrio normalizado

surface / rooms / bathrooms

url: enlace de referencia del aviso

Presente estos inmuebles en su informe final o en su interfaz para brindarle respaldo probatorio inmediato al martillero o cliente.

contextComparables[]Array<Comparable>

Solo se devuelve si en la solicitud se envió includeContext: true. Contiene el conjunto extendido de avisos del radio sin filtro estricto de similitud.

Útil para alimentar nubes de dispersión (Scatter Plots) o mapas coropléticos interactivos en el CRM.

Auditoría, Muestreo, Telemetría y Sandbox

id, address, sampleSize, searchRadiusM, computedMs, isSandbox, warning, warnings, meta, neighborhood, engine

idstring (UUID)•addressstring

id es el identificador único persistido de la tasación en la base de datos (utilizado como clave foránea en informes y webhooks de feedback). address es la dirección normalizada oficial validada contra el catastro de CABA.

sampleSizenumber•searchRadiusMnumber (metros)•computedMsnumber (ms)

Telemetría de ejecución: cantidad de avisos procesados en el radio geográfico, radio efectivo aplicado (ej. 1200m) y tiempo total de procesamiento del motor AVE en milisegundos.

isSandboxboolean•warningstring

Identifica si la solicitud fue emitida en entorno de pruebas/sandbox y el texto de limitación legal aplicable para evitar su uso en operaciones comerciales reales sin créditos activos.

neighborhoodIdstring•neighborhoodNamestring•neighborhoodUsdM2number

Datos del barrio canónico (slug e idioma español) y mediana de valor por metro cuadrado del barrio consolidado.

warningsArray<string>

Lista de advertencias estructuradas sobre la resolución de la tasación (ej: "filtered_by_similarity_threshold", "similarity_threshold_relaxed_fallback").

metaobject

Métricas de auditoría sobre la consulta: totalComparablesInRadius, searchRadiusM, comparablesReturned y filteredBySimilarity.

engineIdstring•modelVersionstring

Identificadores del motor de valuación y versión del modelo estadístico hedónico utilizado para auditoría técnica y contable.

4Webhook: Feedback Loop (Precio de Cierre)

En el mercado inmobiliario argentino existe una histórica brecha de negociación entre el Asking Price de los portales y el precio real de transacción (precio billete). Al reportar el valor de cierre real de una operación concretada, el algoritmo calibra el factor de negociación por microzona para su organización.

POST /api/valuation/:id/feedback

Utilice el :id obtenido en la tasación original para asentar el cierre de la operación.

Campo

Tipo

Descripción

realClosingPriceUsd

number

Precio billete final de venta en dólares (USD).

daysOnMarket

number

Días transcurridos hasta el cierre (opcional).

comments

string

Observaciones del martillero (opcional).

cURL RequestPOST

curl -X POST https://tasarapp.com/api/valuation/val_9f8a7d/feedback \
  -H "Authorization: Bearer eyJhbG..." \
  -H "Content-Type: application/json" \
  -d '{
    "realClosingPriceUsd": 158000,
    "daysOnMarket": 38,
    "comments": "Cierre rápido en efectivo con 3.7% de negociación."
  }'

Response (200 OK)JSON

{
  "success": true,
  "message": "Feedback de cierre registrado exitosamente"
}

Acceso Cerrado

Solicitar Acceso a la API

Actualmente nuestra API B2B se encuentra en acceso cerrado. Déjanos tu correo y te enviaremos credenciales para el Sandbox.