API REST · datos en JSON
Nueve fuentes oficiales, cada una con su formato. La API te entrega todas sus subastas en una sola ficha JSON, limpia y enriquecida, lista para tu aplicación, tu base de datos o tus modelos de análisis.
/api/v1/bienes/{id}{
"bien": {
"TIPO_BIEN": "vivienda",
"MUNICIPIO": "Sabadell",
"VALOR": 185432.18,
"DEPOSITO": 9271.61,
"PUJA": {
"estado": "importe",
"importe": 101500
}
},
"subasta": {
"CLASE_SUBASTA": {
"codigo": 2,
"nombre": "BOE judiciales"
}
}
}Cómo funciona
Desde tu cuenta, en el apartado API, con un plan de API activo. Se envía en cada petición con el header Authorization: Bearer.
POST /api/v1/bienes/search combina texto libre con provincia, municipio, tipo de bien, origen, estado, importes, fechas o un radio en metros. Devuelve los IDs de hasta 100 bienes por página.
GET /api/v1/bienes/{id} devuelve el bien con su lote y su subasta. Las provincias, municipios y valores de cada filtro están en endpoints que no gastan cuota.
curl https://alertasubastas.com/api/v1/bienes/search \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"filtros": {
"provincia": "madrid",
"tipo_bien": "vivienda",
"estado": "activas",
"clase_subasta": 2
},
"orden": "fecha_celebracion_asc"
}'{
"total": 214,
"page": 1,
"per_page": 100,
"ids": ["0x33E17A2F...", "0x91B2C4D8..."],
"cuota_busquedas": { "usadas": 12, "cuota": 500 }
}Datos
Cada bien llega con los datos de su lote y de su subasta, con los mismos valores normalizados que ves en AlertaSubastas: un dato que la fuente no informa llega como null, nunca como texto suelto.
Cubre las subastas judiciales, notariales y administrativas generales del BOE, las de Hacienda y las agencias tributarias autonómicas, las de la Seguridad Social y las de diputaciones, ayuntamientos y consejos comarcales.
Valor de subasta, tasación, puja actual, depósito y tramos.
VALORTASACIONPUJADEPOSITO
Estado actual del bien y del lote, con la fecha de conclusión y la del último cambio.
FECHA_FIN_CELEB
Cargas y situación posesoria como estados cerrados, sin parsear texto.
CARGASSITUACION_POSESORIA
Dirección, referencia catastral, IDUFIR y coordenadas con su nivel de precisión.
REF_CATASTRALGEO
Marca, modelo, matrícula y bastidor.
Casos de uso
Las subastas públicas se publican en portales distintos, cada uno con su formato. La API te las da en un solo formato, con los datos ya limpios y enriquecidos, para que te centres en tu producto.
Alimenta tus modelos de valoración y rentabilidad con valor de subasta, puja, depósito, cargas, situación posesoria y coordenadas, como datos estructurados y no como texto.
Localiza las subastas que afectan a tus clientes por referencia catastral o registral, matrícula o texto libre, y sigue su estado y su puja hasta la conclusión.
Sincroniza tu base de datos, tu hoja de cálculo o tu herramienta de BI con fecha_insercion.desde, y estudia con el histórico de subastas finalizadas cómo terminan por zona y tipo de bien.
Ejemplos
Todos los filtros, órdenes, campos y errores están documentados, con ejemplos de petición y respuesta.
import requests
API = "https://alertasubastas.com/api/v1"
headers = {"Authorization": f"Bearer {API_KEY}"}
r = requests.post(f"{API}/bienes/search", headers=headers, json={
"q": "garaje",
"filtros": {"provincia": "barcelona", "clase_subasta": 12,
"estado": "activas"},
"orden": "valoracion_asc",
})
for bien_id in r.json()["ids"][:10]:
ficha = requests.get(f"{API}/bienes/{bien_id}",
headers=headers).json()
print(ficha["bien"]["TITULO"], ficha["bien"]["VALOR"],
ficha["subasta"]["URL"]){
"ID": "0x33E17A2F...",
"bien": {
"TITULO": "Vivienda en Sabadell",
"TIPO_BIEN": "vivienda",
"VALOR": 185000, "DEPOSITO": 9250,
"PUJA": { "estado": "importe", "importe": 92500 },
"CARGAS": { "estado": "ver_descripcion", "importe": null },
"SITUACION_POSESORIA": { "estado": "sin_ocupantes" },
"REF_CATASTRAL": "...",
"GEO": { "lat": 41.54, "lng": 2.10, "nivel": "portal" }
},
"lote": { "NUMERO": 1, "TASACION": 185000 },
"subasta": {
"IDSUBASTA": "SUB-JA-2026-1234",
"URL": "https://subastas.boe.es/...",
"FECHA_FIN_CELEB": "2026-11-10T18:00:00+01:00"
}
}Preguntas frecuentes
Es una API REST que da acceso en JSON a las subastas públicas de España que AlertaSubastas recoge desde 2016: BOE (judiciales, notariales y administrativas), Hacienda, Seguridad Social y administraciones locales. Buscas con filtros (provincia, municipio, tipo de bien, estado, importes, fechas o radio geográfico) y descargas la ficha completa de cada bien.
Incluye las subastas judiciales, notariales y administrativas generales del BOE, las de Hacienda (AEAT) y las agencias tributarias autonómicas, las de la Seguridad Social y las de diputaciones, ayuntamientos y consejos comarcales. Eliges el origen con el filtro clase_subasta.
No. AlertaSubastas no es un portal oficial: recoge, normaliza y enriquece los anuncios publicados (referencia catastral verificada, geolocalización, estado y pujas al día). La puja se hace siempre en el portal oficial de cada subasta, y su enlace viene en la ficha.
Sí. Cada filtro, orden, campo, código de estado y error está documentado, con ejemplos de petición y respuesta. La documentación también está en markdown, útil para tus herramientas de desarrollo.
Filtra por fecha_insercion.desde con la fecha de tu última ejecución para traer solo las subastas nuevas, y guarda las fichas que descargas: volver a pedir una ficha ya consultada no gasta cuota. Las provincias, municipios y valores de cada filtro están en endpoints que tampoco la gastan.
La API entrega los datos de las subastas en JSON para que los integres en tus programas, tu web o tus análisis. El MCP conectará tu asistente de IA con AlertaSubastas para que le preguntes por las subastas en lenguaje natural (próximamente). Lo tienes explicado en MCP de subastas.
Es una cuota total, no un periodo de prueba: incluye 100 búsquedas y la consulta de 50 subastas activas, sin fecha de caducidad. Pedir más páginas de la misma búsqueda en los 60 minutos siguientes no gasta búsquedas, y volver a consultar una subasta que ya consultaste tampoco. En las subastas con varios lotes, cada bien cuenta como una consulta. Lo estamos preparando y todavía no está activo.
La API responde con un error que indica qué cuota se ha agotado (search_quota_exceeded o bien_quota_exceeded). Tu API key sigue siendo válida y las subastas que ya consultaste se pueden volver a descargar. En los planes de pago la cuota se renueva el día 1 de cada mes.
Las subastas nuevas se incorporan cada día, y los estados y las pujas de las subastas en curso se revisan varias veces cada hora. El buscador de la API se sincroniza cada minuto con nuestra base de datos.
Sí. La API key se genera desde tu cuenta, en el apartado API, y hoy requiere un plan de API activo: escríbenos para solicitarlo. Se muestra una sola vez al crearla y puedes regenerarla cuando quieras: la anterior deja de funcionar al momento.
No. La API y los planes de alertas son productos independientes. Si lo que buscas es recibir cada día por email las subastas nuevas de tu zona, consulta Planes y precios.
Cuéntanos qué necesitas y te ayudamos a encajar la API en tu proyecto.
Utilizamos cookies propias y de terceros para analítica y publicidad. Puedes aceptarlas todas, rechazarlas o configurar tus preferencias. Más información en nuestra política de cookies.
Elige qué categorías de cookies quieres permitir. Tu elección se guarda durante 12 meses.
Sesión, seguridad, anti-spam (reCAPTCHA) y la propia cookie de consentimiento.
Google Analytics y conteo de visitantes únicos. Nos ayuda a entender qué funciona.
Google Ads y remarketing.
Personalización ligera de la interfaz (por ejemplo, variantes de prueba del banner).