API v1JSON · Bearer token · 10 peticiones/minuto

Lleva El método Manolo a tus herramientas

Envía los datos que tu script o agente de IA haya extraído de un anuncio y recibe el precio máximo recomendado, la rentabilidad al precio publicado y una decisión inequívoca.

Endpoint

POSThttps://www.metodomanolo.es/api/v1/evaluar

Autenticación

Todas las peticiones deben incluir una clave en la cabeceraAuthorization. Para solicitar acceso, escribe a info@metodomanolo.es.

Authorization: Bearer TU_CLAVE

Primera petición

La API evalúa datos ya extraídos. No descarga el anuncio ni completa información ausente con valores por defecto.

curl -X POST https://www.metodomanolo.es/api/v1/evaluar \
  -H "Authorization: Bearer TU_CLAVE" \
  -H "Content-Type: application/json" \
  -d '{
    "referencia": "https://portal.test/anuncio/123",
    "capital": "SI",
    "planta": "3",
    "ascensor": "NO",
    "habitaciones": "2",
    "reforma": "MEDIA",
    "toxicidad": "NEUTRAL",
    "metrosCuadrados": 74,
    "precioPedido": 95000,
    "alquilerMensual": 700,
    "gastosAnuales": 900,
    "itpPct": 10,
    "gastosNotariaInmobiliariaPct": 3,
    "costeReforma": 12000
  }'

Campos de entrada

Los porcentajes se envían como números normales: utiliza10para representar un 10 %, no 0,10.

Campo	Tipo	Obligatorio	Descripción
referencia	string	No	URL, dirección o identificador del anuncio. Máximo 200 caracteres.
capital	enum	Sí	SI \| NO
planta	enum	Sí	1 \| 2 \| 3 \| 4+
ascensor	enum	Sí	SI \| NO
habitaciones	enum	Sí	1 \| 2 \| 3 \| 4+
reforma	enum	Sí	NINGUNA \| MINIMA \| MEDIA \| MUCHA
toxicidad	enum	Sí	BUENA_OPORTUNIDAD \| NEUTRAL \| MEDIA \| GRAVE \| MUY_GRAVE
metrosCuadrados	number	No	Superficie positiva. Solo aporta contexto y valores por m².
precioPedido	number	Sí	Precio positivo al vendedor, sin impuestos ni reforma.
alquilerMensual	number	Sí	Alquiler mensual probable en euros.
gastosAnuales	number	Sí	IBI, comunidad y reparaciones a cargo del propietario.
itpPct	number	Sí	Porcentaje aplicable, entre 0 y 100.
gastosNotariaInmobiliariaPct	number	Sí	Notaría e inmobiliaria como porcentaje del precio de compra.
costeReforma	number	Sí	Euros estimados. Debe ser 0 si reforma es NINGUNA.

Cómo leer la respuesta

La decisión

evaluacion.cumplePrecioObjetivo

true indica que el precio anunciado no supera el máximo recomendado.

La distancia

diferenciaPrecioPedidoVsObjetivo

Un valor positivo es sobreprecio; un valor negativo indica margen bajo el objetivo.

El precio correcto

precioObjetivo.precioMaximoVendedor

Importe máximo a pagar al vendedor antes de impuestos, gastos y reforma.

La rentabilidad real

rentabilidadNetaAlPrecioPedidoPct

Rentabilidad sobre el coste completo de comprar al precio anunciado.

Respuesta abreviada para facilitar la lectura; los valores del servicio se entregan con precisión completa.

{
  "apiVersion": "1",
  "referencia": "https://portal.test/anuncio/123",
  "inmueble": {
    "metrosCuadrados": 74,
    "precioPedido": 95000,
    "precioPedidoM2": 1283.78
  },
  "tasaRiesgo": {
    "tasaBaseDamodaranPct": 5.78,
    "ajustesPct": [
      { "label": "Capital de provincia", "deltaPct": 0 },
      { "label": "Planta + ascensor", "deltaPct": 1.5 },
      { "label": "Nº de habitaciones", "deltaPct": 1 },
      { "label": "Necesidad de reforma", "deltaPct": 1 },
      { "label": "Toxicidad", "deltaPct": 0 }
    ],
    "tasaExigidaPct": 9.28
  },
  "precioObjetivo": {
    "ingresosNetosAnuales": 7500,
    "costeTotalMaximo": 80818.97,
    "precioMaximoVendedor": 60901.74,
    "precioMaximoVendedorM2": 823
  },
  "evaluacion": {
    "cumplePrecioObjetivo": false,
    "costeTotalAlPrecioPedido": 119350,
    "rentabilidadNetaAlPrecioPedidoPct": 6.28,
    "diferenciaPrecioPedidoVsObjetivo": 34098.26,
    "desviacionPrecioPedidoVsObjetivoPct": 55.99
  }
}

Errores y límites

400JSON inválido o cuerpo que no es un objeto.

401Clave Bearer ausente o incorrecta.

422Faltan datos o alguno no tiene un valor admitido.

429Se han superado las 10 solicitudes por minuto.

503La API no tiene configurada una clave en el servidor.

Límite de 10 peticiones por minuto

Cada respuesta informa de la cuota medianteRateLimit-Limit,RateLimit-Remaining yRateLimit-Reset. Si recibes un 429, espera los segundos indicados enRetry-After antes de reintentar.