🏛️ Spain BOE Auctions Scraper (Real Estate, Foreclosures & Vehicles)

Extracción automatizada e inteligencia de inversión para el Portal Oficial de Subastas Judiciales y Notariales del BOE (subastas.boe.es). Aísla la Referencia Catastral de 20 dígitos, clasifica el tipo de inmueble (vivienda, garaje, rústica, local), extrae la tasación oficial, el depósito obligatorio (5%), los tramos de puja y la deuda judicial reclamada en las 52 provincias de España.

---

🚀 Por qué este Actor es Superior

El portal oficial del BOE no ofrece una API pública moderna, requiere navegación manual entre múltiples pestañas por cada edicto y mezcla expedientes sin estructuración de datos. Este Actor transforma el portal en un flujo de datos limpio y listo para tomar decisiones de inversión.

Característica	Búsqueda Manual BOE	Scrapers Genéricos	Spain BOE Auctions Scraper
Referencia Catastral Aislada	❌ Oculta en texto libre	❌ No extraída	20 caracteres puros validados
Clasificación de Inmuebles	❌ Manual	❌ No categorizado	Auto: Vivienda, Garaje, Local, Finca...
Métricas Financieras Tipadas	❌ Texto con símbolos	⚠️ Cadenas string	float puro (€) para cálculos directos
Depósito (5%) y Tramos de Puja	❌ Requiere abrir ficha	❌ Incompleto	Extraído y normalizado
Cobertura Territorial	❌ 1 provincia por búsqueda	⚠️ Lenta	Nacional (ALL) o 52 provincias
Integración con Make / Zapier	❌ No disponible	⚠️ Difícil de mapear	Directa en 1 click vía Webhook / API

---

💼 Casos de Uso Empresariales

1. Inversores Inmobiliarios y Flipping: Identifica oportunidades de compra por debajo de mercado antes de que finalice la subasta, calculando el margen de rentabilidad contra el valor de tasación oficial.
2. Fondos de Inversión y Family Offices: Monitoriza diariamente carteras de activos inmobiliarios y deudas judicializadas en toda España de forma desatendida.
3. Despachos Jurídicos y Administradores Concursales: Auditoría y seguimiento de procedimientos judiciales, ejecuciones hipotecarias y subastas notariales.
4. Alertas en Tiempo Real: Configura un webhook con Make, Zapier o n8n para recibir avisos instantáneos en Telegram o Slack cuando se publique una vivienda en tu código postal objetivo.
5. Valoración Automatizada con Catastro: Cruza la referencia catastral extraída directamente con APIs de valoración inmobiliaria o el Registro de la Propiedad.

---

💰 Transparencia de Consumo y Coste

Este Actor está altamente optimizado para maximizar la velocidad de extracción reduciendo al mínimo el consumo de Compute Units (CUs).

Métrica	Estimación Promedio
Memoria Recomendada	1024 MB – 2048 MB
Tiempo de Ejecución (100 subastas)	~35 - 50 segundos
Consumo Estimado de CUs (1.000 subastas)	~0.6 – 0.9 CUs (~$2.40 en plan Apify)
Coste por Subasta Extraída	~$0.0024 USD

[!TIP] Si solo necesitas un listado preliminar sin entrar en las pestañas interiores de bienes y juzgados, desactiva enriquecer_detalle para acelerar la extracción un 400% y reducir el coste a menos de 0.2 CUs por 1.000 items.

---

⚙️ Guía de Parámetros de Entrada (Input)

El Actor se configura fácilmente mediante el formulario visual de Apify Console o enviando un JSON a la API.

Tabla de Parámetros

Campo	Tipo	Por Defecto	Descripción
provincia_codigo (requerido)	String	"ALL"	Código provincial ("ALL" para toda España, o de "01" a "52").
tipo_bien	String	"I"	"I" (Inmuebles), "V" (Vehículos), "" (Todos los bienes).
min_tasacion	Number	null	Valor de tasación mínimo en euros (€).
max_tasacion	Number	null	Valor de tasación máximo en euros (€).
palabras_clave	String	null	Filtro textual (ej: "ático", "chalet", "garaje", "local").
solo_activas	Boolean	true	Filtrar solo subastas en estado Celebrándose.
max_subastas	Integer	20	Número máximo de expedientes a extraer (1 a 1.000).
enriquecer_detalle	Boolean	true	Extrae referencia catastral, dirección, tramos, depósitos y autoridad judicial.
proxyConfiguration	Object	{"useApifyProxy": false}	Proxies de Apify para rotación de IP en extracciones masivas.

Payload JSON de Entrada (Mínimo)

{
  "provincia_codigo": "ALL",
  "tipo_bien": "I",
  "solo_activas": true,
  "max_subastas": 50
}

Payload JSON de Entrada (Filtrado Avanzado)

{
  "provincia_codigo": "28",
  "tipo_bien": "I",
  "min_tasacion": 80000,
  "max_tasacion": 350000,
  "palabras_clave": "piso",
  "solo_activas": true,
  "max_subastas": 100,
  "enriquecer_detalle": true
}

---

📊 Esquema y Ejemplo de Salida

Los datos se guardan en el Dataset por defecto del Actor y pueden exportarse inmediatamente en JSON, CSV, Excel (XLSX), XML o HTML.

Ejemplo de Item Extraído (JSON)

{
  "id_subasta": "SUB-JA-2026-264285",
  "estado": "Celebrándose",
  "tipo_bien": "Inmueble",
  "categoria_estimada": "Vivienda",
  "descripcion_completa": "URBANA.- PISO OCTAVO IZQUIERDA SITO EN CALLE VETUSTA 27...",
  "direccion_finca": "CALLE VETUSTA Nº 27 8º IZDA",
  "municipio_real": "Oviedo",
  "codigo_postal": "33008",
  "provincia_real": "Asturias",
  "referencia_catastral": "0651201TP7005S0016QH",
  "finca_registral": "8853",
  "valor_tasacion_eur": 63880.0,
  "puja_minima_eur": null,
  "importe_deposito_eur": 3194.0,
  "tramos_entre_pujas_eur": 1277.6,
  "cantidad_reclamada_eur": 32244.1,
  "situacion_posesoria": "No consta",
  "visitable": "No consta",
  "es_multilote": false,
  "num_lotes": 1,
  "fecha_conclusion": "23-08-2026 19:08:19 CET",
  "juzgado_autoridad": "Sección Civil TI Oviedo",
  "enlace_subasta_boe": "https://subastas.boe.es/detalleSubasta.php?idSub=SUB-JA-2026-264285",
  "scraped_at": "2026-08-23T10:15:30.124580"
}

Campos Clave del Dataset

• referencia_catastral: Código oficial alfanumérico de 20 posiciones listo para consultar en la Sede Electrónica del Catastro.
• valor_tasacion_eur: Tipo numérico (float) sin símbolos para ordenar o filtrar en hojas de cálculo.
• importe_deposito_eur: Capital exacto exigido por el BOE para poder realizar pujas (5%).
• categoria_estimada: Inferencia inteligente (Vivienda, Garaje/Aparcamiento, Rústica/Terreno, Local/Nave, Otros).

---

🔗 Automatización e Integraciones

Ejecución con Python (apify-client)

from apify_client import ApifyClient

client = ApifyClient("TU_API_TOKEN_DE_APIFY")

run_input = {
    "provincia_codigo": "ALL",
    "tipo_bien": "I",
    "solo_activas": True,
    "max_subastas": 50,
    "enriquecer_detalle": True
}

run = client.actor("TU_USUARIO/spain-boe-auctions-master-scraper").call(run_input=run_input)

# Iterar sobre los resultados del dataset
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(f"[{item['categoria_estimada']}] {item['municipio_real']} - Tasación: {item['valor_tasacion_eur']} € | Ref Catastral: {item['referencia_catastral']}")

Integraciones No-Code

• Make.com & Zapier: Conecta el módulo Apify - Watch Actor Runs para enviar cada nueva subasta detectada a Google Sheets, Notion, Airtable o alertas por Telegram.
• Webhooks: Configura un Webhook en la pestaña Integrations del Actor para recibir el JSON procesado en tu propio servidor o backend REST.

---

❓ Preguntas Frecuentes (FAQ) y Legalidad

¿Es legal extraer datos del Portal de Subastas del BOE?

Sí. El portal de subastas del BOE es una fuente pública y oficial del Estado Español de libre acceso destinada a dar publicidad a las subastas judiciales y administrativas. Este Actor recopila exclusivamente la información pública de los edictos respetando la normativa de acceso.

¿Por qué algunas subastas no tienen Referencia Catastral?

En algunos edictos judiciales antiguos o ejecuciones hipotecarias específicas, el juzgado no incluye la referencia catastral en la descripción oficial y únicamente indica la Finca Registral o la dirección física. El Actor siempre intenta aislar la referencia catastral mediante patrones de 20 caracteres validados.

¿Es necesario usar Proxies?

Para ejecuciones estándar de hasta 100 subastas no es estrictamente necesario. Para ejecuciones intensivas o monitorizaciones recurrentes cada pocos minutos, se recomienda activar proxyConfiguration con Apify Residential o Datacenter Proxies.

---

🌐 English Documentation: Spain BOE Auctions Scraper

Institutional-grade data extraction & intelligence tool for the Spanish Official State Gazette Auction Portal (subastas.boe.es).

🌟 Key Highlights

• Official 20-digit Cadastral Reference: Extracted & isolated for instant valuation on Catastro and property databases.
• Automated Property Categorization: Residential (Vivienda), Parking (Garaje), Land (Rústica), Commercial (Local/Nave), and Others.
• Pure Financial Metrics: Official appraisal values, 5% mandatory deposits, minimum bidding increments, and total claimed debts formatted as clean float numbers.
• 52 Provinces Coverage: Query nationwide (ALL) or target specific provinces (28 for Madrid, 08 for Barcelona, 46 for Valencia, etc.).
• Turnkey Automation: Connect to Make, Zapier, n8n, Google Sheets, or your internal CRM via Apify Webhooks and REST API.

Quick Start (Node.js)

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' });

const input = {
    provincia_codigo: 'ALL',
    tipo_bien: 'I',
    solo_activas: true,
    max_subastas: 25,
    enriquecer_detalle: true
};

const run = await client.actor('YOUR_USER/spain-boe-auctions-master-scraper').call(input);
const { items } = await client.dataset(run.defaultDatasetId).listItems();

console.log(`Fetched ${items.length} BOE auctions.`);