Subastas BOE API: datos, lotes y pujas de las subastas del BOE en JSON

Subastas BOE API es un servicio independiente que convierte las subastas de inmuebles del Portal de Subastas del BOE en JSON listo para usar en tu software: la ficha completa, el estado de las pujas, la puja final y un histórico de cada cambio con la hora en que se detectó. Está pensado para desarrolladores, proptech, asesorías y gestoras que hoy siguen las subastas a mano, pestaña a pestaña.

El problema: el Portal de Subastas no está hecho para integrarse

El Portal de Subastas está pensado para que una persona consulte una subasta, no para que un programa trabaje con miles. Cada subasta reparte su información en seis pestañas de HTML: información general, autoridad gestora, bienes, lotes, relacionados y pujas. Para tener la ficha completa hay que abrirlas todas.

A eso se suman tres limitaciones:

• No hay descarga. No existe un botón para exportar las subastas de una provincia ni un listado en formato abierto.
• No hay histórico. El portal muestra el estado actual. Si la fecha de cierre se prorroga o aparece la primera puja, el valor anterior desaparece sin dejar rastro.
• Los datos no llegan normalizados. Los importes, las fechas y los estados de las pujas están escritos para leerlos, no para filtrarlos ni agregarlos.

Para un equipo que sigue decenas de subastas cada semana, esto supone horas de revisión manual y decisiones tomadas con información incompleta.

Qué es Subastas BOE API y qué datos devuelve

Subastas BOE API registra las subastas de inmuebles del portal y las sirve por una API REST con respuestas en JSON. Desde noviembre de 2025 ha registrado más de 16.000 subastas de inmuebles en las 52 provincias y ciudades autónomas.

La ficha de cada subasta reúne en una sola respuesta lo que el portal reparte en pestañas:

• Información general: tipo de subasta, fechas, cantidad reclamada, anuncio del BOE, valor de subasta, tasación, puja mínima, tramos entre pujas y depósito.
• Autoridad gestora: código, descripción, dirección, teléfono y correo.
• Bienes: un elemento por bien, con descripción, superficie, dirección, código postal, localidad, provincia, referencia catastral, cargas y situación posesoria.
• Lotes: los datos de puja y de cada bien, en las subastas que se dividen en lotes.
• Relacionados: acreedores e intervinientes.
• Pujas: el estado normalizado en un conjunto cerrado de valores, como sin_pujas, oculta, puja_maxima_actual o puja_maxima_final.

Las fechas llevan su equivalente ISO, y cada ficha indica cuándo se creó, cuándo se actualizó y cuándo se revisaron las pujas por última vez. El detalle de cada campo está en la documentación de la API de subastas.

El histórico de cambios: primera puja, prórrogas y puja final

El histórico es lo que más diferencia una API de una consulta puntual al portal. Subastas BOE API revisa las subastas abiertas aproximadamente cada hora y, cuando un dato cambia, anota el valor anterior, el nuevo y la hora de detección. Hasta hoy lleva más de 5.000 cambios anotados.

Los campos con histórico son la fecha de conclusión, la puja mínima, los tramos entre pujas, el valor de subasta, la tasación, el importe del depósito y el estado y el importe de las pujas, también lote a lote. Con ellos puedes reconstruir la vida de una subasta:

1. La primera puja. Mientras la subasta está abierta, el portal no publica importes, pero sí deja ver si alguien ha pujado. El cambio de sin_pujas a otro estado marca el momento en que la subasta deja de estar desierta.
2. Las prórrogas del cierre. Una puja en los últimos minutos alarga la conclusión. Cada prórroga queda registrada con la hora anterior y la nueva. Está explicado a fondo en por qué una subasta del BOE no termina a la hora que dice.
3. La puja final. Cuando la subasta concluye y el importe se hace público, queda la puja máxima final.

La ruta de cambios admite filtrar por subastas y por campos, acotar fechas y paginar con cursor, así que basta con preguntar qué ha cambiado desde la última consulta.

Casos de uso: de la alerta al cuadro de mando

Con la ficha y el histórico en JSON, el trabajo que hoy se hace a mano pasa a ser un proceso automático.

Alertas propias. Consulta el histórico cada hora y avisa a tu equipo cuando una subasta que seguís recibe la primera puja, se prorroga o cierra. La API no envía notificaciones: te da los cambios con su hora, y tú decides el canal (correo, Slack o tu propia aplicación).

Valoración. Más de la mitad de las subastas incluye referencia catastral. Con ella puedes cruzar cada bien con el valor de referencia, la superficie o el año de construcción a través de la API de CatastroAPI y comparar ese valor con el de subasta antes de estudiar una oportunidad.

Cuadros de mando. Con el histórico de pujas de las subastas concluidas puedes medir el mercado con datos propios. En el conjunto registrado, el 76 % de las subastas concluidas recibió al menos una puja y la puja final mediana es el 70 % del valor de subasta. Las cifras por provincia están en subastas del BOE en cifras, y el análisis completo en por cuánto se cierran las subastas del BOE respecto a su valor.

CRM de inversión. Si tu equipo gestiona clientes inversores, cada subasta puede entrar en el CRM como una oportunidad con su ficha, sus bienes y su autoridad gestora, y actualizar su estado sola a medida que llegan pujas y prórrogas.

Todas las funciones disponibles están en la página de funcionalidades de Subastas BOE API.

Subastas BOE API frente a scraping propio

Montar un scraper de las subastas del BOE parece sencillo: descargar las seis pestañas, extraer los campos y guardarlos. Lo difícil empieza después.

• Mantenimiento. Cada pestaña tiene su propio HTML, y los campos cambian según el tipo de subasta (judicial, de la Agencia Tributaria, notarial…) y según si hay lotes. Cubrir todos los casos lleva tiempo, y el código hay que mantenerlo.
• Cambios en el portal. Cuando el portal modifica una página, el scraper falla, a veces sin dar error: sigue guardando datos, pero vacíos o en el campo equivocado.
• Bloqueos. Revisar cada hora cientos de subastas abiertas genera mucho tráfico desde la misma IP, y eso aumenta el riesgo de que limiten o bloqueen el acceso.
• Histórico. Un scraper solo ve el presente. Para tener prórrogas y primeras pujas hay que comparar cada lectura con la anterior y guardar las diferencias. Y si empiezas hoy, no tienes los meses anteriores.

Con Subastas BOE API, ese trabajo ya está hecho: los estados de las pujas llegan normalizados, los cambios llegan con su hora y el registro se remonta a noviembre de 2025. Tu equipo se dedica a usar los datos en lugar de extraerlos.

Cómo empezar con Subastas BOE API

La API usa REST y JSON: cuatro rutas y un token, sin SDK.

1. Solicita acceso. Rellena el formulario de acceso anticipado indicando qué uso le vas a dar.
2. Recibe el token. Al darte de alta recibirás la URL base y tu token.
3. Haz la primera llamada. El token va en la cabecera Authorization:

curl "$BASE/api/auctions/SUB-JA-2026-000000" \
  -H "Authorization: $TOKEN" \
  -H "Accept: application/json"

Las cuatro rutas son:

Un detalle práctico: algunos bloques de la ficha llegan como texto JSON y hay que decodificarlos una segunda vez. Hay ejemplos en primeros pasos con la API de subastas del BOE.

Conclusión

El Portal de Subastas sirve para consultar subastas de una en una, pero no para trabajar con ellas a escala. Subastas BOE API reúne en una respuesta JSON lo que el portal reparte en seis pestañas, guarda el histórico que el portal no conserva y lo ofrece con cuatro rutas y un token. Si tu equipo revisa subastas a mano, monta alertas o necesita datos para valorar, puedes dejar de copiar fichas y empezar a usar los datos.

Solicita acceso anticipado a Subastas BOE API y haz tu primera llamada hoy.

Preguntas frecuentes