API REST · Subastas de inmuebles · España
Las subastas del BOE, en una API.
El Portal de Subastas publica cada inmueble repartido en seis pestañas de HTML. Aquí llega como JSON: la ficha completa, si ha recibido pujas, por cuánto se cerró y cada cambio que sufre mientras está abierta.
Tablón de cambios
Lo último que ha detectado el sistema en subastas abiertas. Son datos reales.
| Detectado | Subasta | Qué cambió | Antes | Ahora |
|---|---|---|---|---|
| SUB-JA-2026-265980 | Estado de las pujas | Sin pujas | Con puja, importe no público | |
| SUB-AT-2026-26R4786001114 | Estado de las pujas | Sin pujas | Con puja, importe no público | |
| SUB-AT-2026-26R4786001110 | Estado de las pujas | Sin pujas | Con puja, importe no público | |
| SUB-JA-2026-263846 | Estado de las pujas | Sin pujas | Cancelada | |
| SUB-AT-2026-26R4786001018 | Estado de las pujas | Sin pujas | Con puja, importe no público | |
| SUB-AT-2026-26R4686001185 | Estado de las pujas | Sin pujas | Con puja, importe no público | |
| SUB-RC-2026-0026I20260091 | Estado de las pujas | Sin pujas | Con puja, importe no público | |
| SUB-RC-2026-007120260901 | Puja del lote 26 | Sin puja | Con puja |
01La ficha
Seis pestañas del portal, una sola respuesta
Cada subasta se recorre pestaña a pestaña y se entrega con la misma estructura, venga de un juzgado, de la Agencia Tributaria o de una notaría.
- Información general
general_informationTipo de subasta, fechas, valor, tasación, puja mínima, tramos y depósito.
- Autoridad gestora
managing_authoritiesEl juzgado, la delegación o la notaría que tramita la subasta, con sus datos de contacto.
- Bienes
propertiesDescripción, dirección, referencia catastral, cargas y situación posesoria de cada bien. Se añade la superficie en m².
- Lotes
lotsCuando la subasta va por lotes: cada lote con sus importes y sus bienes.
- Relacionados
relatedAcreedores y demás intervinientes, tal como los publica el portal.
- Pujas
bidsSi ha recibido pujas, si el importe es público y, al concluir, la puja máxima.
{
"auction_number": "SUB-JA-2026-000000",
"category": "Vivienda",
"concludes_at": "2026-10-19T18:00:00Z",
"general_information": [
{ "Tipo de subasta": "JUDICIAL EN VÍA DE APREMIO" },
{ "Valor subasta": "199.407,52 €" },
{ "Tramos entre pujas": "3.988,15 €" },
{ "Importe del depósito": "9.970,38 €" }
/* …y el resto de la pestaña */
],
"managing_authorities": [ /* juzgado o unidad que la gestiona */ ],
"properties": [
{
"title": "Bien 1 - Inmueble (Vivienda)",
"superficie": 89.43,
"property": [ /* dirección, referencia catastral, cargas… */ ]
}
],
"bids": { "tipo": "sin_pujas", "importe": null, "lotes": [] },
"bids_refreshed_at": "2026-09-30T13:20:04Z"
}02El histórico
Una subasta no es una foto: cambia durante veinte días
Llega la primera puja, la hora de cierre se prorroga, al final aparece el importe. El portal enseña solo el estado del momento; la API anota cada paso con la hora en que lo detectó.
Entra en celebración
Se incorpora a la API con toda su ficha.
bids.tipo = sin_pujas
Recibe la primera puja
El portal avisa de que hay puja, pero no publica el importe.
bids.tipo:
sin_pujas→ ocultaSe prorroga el cierre
Hay pujas en la última hora y la conclusión se desplaza.
fecha_conclusion:
18:00:00→ 18:41:07Concluye
El portal hace pública la puja máxima.
bids.tipo:
oculta→ puja_maxima_final
bids.importe = 142.500,00 €
Secuencia de ejemplo. Los estados y los campos son los que devuelve la API.
78 % de las 7.618 subastas sin lotes ya concluidas recibió al menos una puja. El resto quedó desierta.
70 % del valor de subasta: esa es la puja final mediana en las 5.744 que se cerraron con importe público.
03Los endpoints
Cuatro rutas y un token
REST, JSON y una cabecera de autorización. Sin SDK que instalar.
| Ruta | Qué devuelve |
|---|---|
| GET/api/auctions | Listado paginado de subastas con toda su ficha, 500 por página. |
| GET/api/auctions/{id} | Una subasta por su identificador del portal, por ejemplo SUB-JA-2026-… |
| GET/api/auctions/{id}/bids | Estado de las pujas, importe si es público y hora del último refresco. |
| GET/api/changes | Histórico de cambios, filtrable por subasta, campo y fechas, con cursor. |
04Las cifras
Lo que ya hay dentro
Subastas de inmuebles incorporadas cada mes de 2026 y su reparto por tipo de procedimiento.
Subastas incorporadas por mes, 2026
- 1.105ene
- 1.482feb
- 1.385mar
- 1.455abr
- 1.594may
- 1.687jun
- 831jul
- 602ago
- 1.509sep
| JAJudicial en vía de apremio | 9.926 | 64,4 % |
|---|---|---|
| ATAgencia Tributaria | 3.922 | 25,4 % |
| RCRecaudación tributaria | 768 | 5,0 % |
| JVJudicial voluntaria | 448 | 2,9 % |
| JCJudicial concursal | 200 | 1,3 % |
| NHNotarial hipotecaria | 75 | 0,5 % |
| NNOtras subastas notariales | 64 | 0,4 % |
| GAAdministrativa general | 19 | 0,1 % |
05Para quién
Para quien hoy mira el portal a mano o mantiene su propio scraper
Inversores
Filtra con tus criterios y entérate de la primera puja y de las prórrogas sin refrescar el navegador.
Portales y proptech
Incorpora subastas públicas a tu catálogo sin construir ni mantener la extracción.
Despachos y gestorías
Sigue los expedientes que te interesan y recibe los cambios de fecha e importe.
Analistas
Series estructuradas para estudiar valores de salida, pujas finales y subastas desiertas por zona.
06El acceso
Pide un token de prueba
El servicio está en acceso anticipado. Cuéntanos qué necesitas y te escribimos con un token y las condiciones.
- Token de prueba para evaluar los datos con casos reales.
- Sin compromiso: las condiciones se acuerdan según el uso.
- Lo que pidan los primeros usuarios decide qué se construye después.
07Preguntas
Lo que conviene saber antes de pedir acceso
¿De dónde salen los datos?
Del Portal de Subastas de la Agencia Estatal Boletín Oficial del Estado (subastas.boe.es), que es información pública. La API la recoge, la estructura y la mantiene al día.
¿Qué subastas cubre?
Subastas de bienes inmuebles desde que entran en celebración. Vehículos, otros bienes muebles y subastas en próxima apertura no están incluidos todavía.
¿Puedo ver el importe de las pujas mientras la subasta está abierta?
No, y no es una limitación de la API: el portal solo indica si la subasta ha recibido alguna puja; el importe queda reservado a los usuarios registrados. Cuando la subasta concluye, el portal publica la puja máxima y la API la recoge.
¿Incluye quién puja y cuándo?
No. La identidad de los postores y el detalle de cada puja no son públicos. La API ofrece el estado de las pujas, la puja máxima final y la hora en la que detectó cada cambio.
¿Cada cuánto se actualiza?
El portal se rastrea cada cinco minutos en busca de subastas nuevas. En las que están abiertas, el estado de las pujas se comprueba aproximadamente cada hora y la ficha general varias veces al día.
¿Cuánto cuesta?
El servicio está en acceso anticipado y las condiciones se acuerdan con cada cliente según el volumen y el uso. Escríbenos desde el formulario y te respondemos.
¿Es un servicio oficial del BOE?
No. Es un servicio independiente que reutiliza información pública. Para cualquier actuación con efectos legales, la fuente válida es siempre el propio portal.