API de Valuación Inmobiliaria

Cómo empezar

1. 1

   Llena el formulario

   Cuéntanos tu caso de uso y volumen estimado (sección de abajo). Sin tarjeta ni compromiso para el plan Starter.

2. 2

   Nuestro equipo la revisa

   En 24–48 horas hábiles te contactamos por correo para confirmar tu plan y resolver dudas técnicas si las hay.

3. 3

   Recibes tu API key

   Te llega en texto plano una sola vez — guárdala en tu backend, nunca en código de cliente/frontend.

4. 4

   Integra y valúa

   Con los ejemplos de request/response de esta página tienes lo necesario para tu primera llamada en minutos.

Planes y precios

Todos los planes usan el mismo motor y los mismos endpoints. La diferencia es cuota mensual, precio y soporte.

Referencia: un avalúo tradicional en México cuesta entre $3,500 y $8,000 MXN. Incluso en Growth, el costo por valuación vía API es una fracción de eso.

Autenticación

Todas las llamadas requieren tu API key en el header Authorization. La key se emite después de revisar tu solicitud de acceso (arriba) — no hay autoservicio todavía, cada key la emite nuestro equipo manualmente para poder acompañar tu integración.

Authorization: Bearer valuum_XXXXXXXXXXXXXXXX

POST/api/v1/valuate

Valúa una propiedad. Consume 1 de tu cuota mensual.

Request

curl -X POST https://valuum.app/api/v1/valuate \
  -H "Authorization: Bearer valuum_XXXX" \
  -H "Content-Type: application/json" \
  -d '{
    "property_type": "departamento",
    "lat": 21.1416,
    "lng": -86.8258,
    "built_area_m2": 95,
    "bedrooms": 2,
    "parking_spots": 1
  }'

Campos

Response 200

{
  "valuation_id": "8b2f6c1e-…",
  "estimated_value": 3434000,
  "value_range": { "low": 3125000, "high": 3743000 },
  "price_per_m2": 36147,
  "confidence": { "score": 88, "grade": "B" },
  "comparables_count": 7,
  "estimated_rent": 21500,
  "cap_rate": 7.5,
  "land_value": 890000,
  "construction_value": 2544000,
  "methodology": "factors-v2-comps",
  "estrato_inferido": null,
  "created_at": "2026-07-02T22:14:03.512Z",
  "powered_by": "VALUUM AVM API v1"
}

methodology: factors-v2-comps indica que el valor quedó anclado a comparables reales de la zona; estimated_rent y cap_rate son null si no hay suficientes comparables de renta cerca.

estrato_inferido viene null si enviaste estrato en el request. Si lo omitiste, trae el valor que se infirió junto con confidence (alta · media · baja) y source. Con solo lat/lng (sin dirección), la inferencia v1 cae siempre en el tier más grueso — confidence: "baja" — así que trátalo como una estimación aproximada, no como un estrato verificado.

land_value y construction_value solo vienen poblados para property_type: "casa" y "terreno" — para el resto (departamento, local_comercial, oficina, bodega) ambos son null, porque no existe un dato real de cuánto terreno le corresponde a una unidad individual en un condominio.

POST/api/v1/valuate/batch

Hasta 10 propiedades por request (ideal para valuar carteras o inventarios de CRM). Cada item consume 1 de la cuota; la cuota se verifica por el total antes de procesar. Un item inválido no aborta el batch — su posición regresa con error.

curl -X POST https://valuum.app/api/v1/valuate/batch \
  -H "Authorization: Bearer valuum_XXXX" \
  -H "Content-Type: application/json" \
  -d '{ "items": [
    { "property_type": "casa", "lat": 19.4326, "lng": -99.1332,
      "built_area_m2": 220, "estrato": "residencial" },
    { "property_type": "departamento", "lat": 21.1619, "lng": -86.8515,
      "built_area_m2": 80 }
  ]}'

// → { "count": 2, "succeeded": 2, "results": [ { "index": 0, … }, { "index": 1, … } ] }