post/public/v2/valuation/estimateAPI pública

Explica el rango estimado en lugar de entregar una cifra aislada.

Estimar un inmueble

Obtén bandas orientativas de venta, arriendo y renta corta con comparables y señales de confianza.

Es una referencia automatizada de mercado; no reemplaza un avalúo certificado.

AudienciaIntegradores y productos externos

AutenticaciónAPI key

EstabilidadContrato público versionado

Cuándo usarlo

Prevaloración

Calificación de oportunidades

Experiencias de captación

Comportamiento

Calcula una valoración orientativa de mercado a partir de ubicación, características del inmueble y comparables cercanos.

La respuesta incluye:

bandas de venta, arriendo tradicional y renta corta;
métricas por m² cuando hay datos suficientes;
avisos comparables ordenados por parecido (similarity_score);
desglose de parecido (match_breakdown) para entender por qué un comparable es relevante;
análisis estratégico en español con lectura de oportunidad, riesgos de datos y siguiente paso.

Campos recomendados para mejorar precisión: normalized_type, area_m2, rooms, bathrooms, garages, antiquity, estrato, country y coordenadas (latitude/longitude) o address_query.

Notas:

max_distance_km controla el radio de búsqueda de comparables.
distance_weight controla cuánto pesan los comparables más cercanos frente a los más lejanos.
min_comparables define la muestra mínima deseada antes de relajar algunos criterios.
garages y antiquity ayudan a seleccionar comparables más parecidos cuando esos datos están disponibles.
Es una orientación de mercado, no una tasación ni avalúo formal.

Autenticación (obligatoria)

X-Api-Key: <tu_api_key> o
Authorization: Bearer <tu_api_key>

Prefijo base: /public/v2/valuation.

API key requerida

Envía tu clave en X-Api-Key o Authorization: Bearer. No expongas la credencial en código cliente público.

Cuerpo de la solicitud

Envía JSON con la siguiente estructura.

{
  "address_query": "string",
  "amenities": [
    "string"
  ],
  "antiquity": 42,
  "area_m2": 42,
  "bathrooms": 42,
  "bbox_half_km": 18,
  "comparables_limit": 20,
  "country": "string",
  "distance_weight": "inverse",
  "estrato": 42,
  "garages": 42,
  "include_strategic_analysis": true,
  "is_stale": false,
  "latitude": 42,
  "longitude": 42,
  "max_distance_km": 2,
  "min_comparables": 10,
  "normalized_type": "string",
  "rooms": 42
}

Respuestas

Estados públicos del contrato y estructura de cada respuesta JSON.

200Successful Response

{
  "airbnb_gross_potential_30n": "⟨EstimateBand⟩",
  "airbnb_monthly": "⟨EstimateBand⟩",
  "airbnb_nightly": "⟨EstimateBand⟩",
  "airbnb_occupancy_pct": "⟨EstimateBand⟩",
  "disclaimer": "string",
  "location_resolved": {
    "estrato": "…",
    "estrato_source": "unavailable",
    "geocoded_from_address": false,
    "label": "…",
    "latitude": 42,
    "longitude": 42
  },
  "methodology": {
    "candidate_rows": "…",
    "confidence": "…",
    "data_sources": "…",
    "distance_weight": "…",
    "effective_samples": "…",
    "outliers_removed": "…",
    "pipeline_contract": "…",
    "relaxation_applied": "…",
    "search_radius_km": "…"
  },
  "ml_estimate_sale_cop": 42,
  "ml_model_version": "string",
  "rent": "⟨EstimateBand⟩",
  "rent_per_m2": "⟨EstimateBand⟩",
  "sale": {
    "median": "…",
    "n": 0,
    "p25": "…",
    "p75": "…",
    "unit": "string"
  },
  "sale_per_m2": "⟨EstimateBand⟩",
  "short_term_comparables": [
    {
      "avg_min_nights": {},
      "avg_night_price": {},
      "bedrooms": {},
      "beds": {},
      "calendar_unavailable_pct": {},
      "capacity": {},
      "city": {},
      "data_confidence": {},
      "days_since_last_scrape": {},
      "distance_km": {},
      "image_url": {},
      "is_superhost": {},
      "latitude": {},
      "locality": {},
      "longitude": {},
      "match_breakdown": {},
      "match_quality": {},
      "monthly_gross_potential_30n": {},
      "name": {},
      "neighborhood": {},
      "normalized_type": {},
      "observed_days": {},
      "property_id": {},
      "rating_overall": {},
      "review_count": {},
      "room_type": {},
      "similarity_score": {},
      "source_scraped_at": {},
      "title": {},
      "url": {}
    }
  ],
  "strategic_analysis": "string",
  "traditional_comparables": [
    {
      "antiquity": {},
      "area_m2": {},
      "bathrooms": {},
      "business_type": {},
      "distance_km": {},
      "estrato": {},
      "garages": {},
      "image_url": {},
      "latitude": {},
      "listing_id": {},
      "longitude": {},
      "match_breakdown": {},
      "match_quality": {},
      "neighborhood": {},
      "normalized_type": {},
      "property_id": {},
      "rent_price": {},
      "rent_price_per_m2": {},
      "rooms": {},
      "sale_price": {},
      "sale_price_per_m2": {},
      "similarity_score": {},
      "title": {},
      "url": {}
    }
  ],
  "warnings": [
    "string"
  ]
}

401Falta cabecera de API key o la clave no es válida.

422La solicitud no cumple el contrato esperado.

502No se pudo completar el análisis en este momento.

503El análisis estratégico no está disponible temporalmente.