Spain Public Procurement Tenders & BOE Auctions Scraper (v2.0 Deep Architecture)

Professional intelligence scraper for official Spanish government tenders, won public contracts (with winning company NIFs), and judicial / public auctions (with cadastral references, valuations, debts, and deposits) directly from the Official State Gazette (Boletín Oficial del Estado - BOE) and subastas.boe.es.

[!NOTE] 100% Real Data Guarantee (Zero Synthetic Fallbacks): All records are extracted in real-time from official open government endpoints, including Section 4 (Judicial Auctions), Section 5A (Public Procurement), and Section 5B (Patrimonial Auctions: TGSS, AEAT, Adif, and Municipalities).

---

3 High-Value Business Use Cases

1. Real Estate & Distressed Asset Investors (Subasteros & Fondos Inmobiliarios)

• Live Spanish Cadastre API Enrichment (ovc.catastro.meh.es): Automatically resolves 20-digit Cadastral References (referencia_catastral) against the official Cadastre to append built surface area (catastro_superficie_construida_m2), construction year (catastro_ano_construccion), primary use (catastro_uso_principal), and direct link (url_sede_catastro).
• Automated Open Market Value & Discount Benchmark: Cross-references cadastral surface area with official MITMA/INE benchmark values per province to calculate:
  • valor_mercado_estimado_eur (Estimated Open Market Price).
  • descuento_vs_mercado_pct (Discount % compared to open market).
  • margen_bruto_potencial_eur (Gross potential margin).
  • roi_estimado_pct (Estimated net ROI considering regional acquisition taxes).
• Automated Cost of Acquisition Calculator: Pre-computes regional property transfer tax (itp_autonomico_pct and itp_estimado_eur, e.g. 6% in Madrid vs 10% in Catalonia/Valencia), mandatory 5% bidding deposit (deposito_obligatorio_5pct_eur), and estimated notary/registry fees.
• High-Equity Opportunity Filters: Filter specifically for auctions with verified Cadastral References (onlyWithCadastralRef: true), minimum discount threshold (minDiscountPct: 40), and low debt-to-valuation ratios (maxDebtToValuePct: 70).
• Court & Physical Details: Managing judicial authority, contact email, phone, physical address, occupancy status (situacion_posesoria), and primary residence flags (vivienda_habitual).

2. Public Contractors & Bidders (Licitadores y Proveedores del Estado)

• Direct Pliegos Links (url_pliegos): Direct URLs to download administrative and technical specifications without navigating complex state portals.
• Criteria Breakdown: Ponderation between price and qualitative technical criteria (e.g., Precio: 75% | Extensión de garantía: 10%).
• CPV & Solvency Details: Official CPV classifications and exact financial and technical solvency thresholds required.
• Tight Deadlines: Normalized fecha_limite_ofertas for automated alert triggers.

3. B2B Sales Prospecting & Subcontracting (RGPD-Compliant Corporate NIFs)

• Winning Company Corporate Name & Tax ID (adjudicatario_nif): Instantly know who won every state, regional, or municipal contract (including multi-lot awards).
• Built-in RGPD / LOPD Compliance (maskPersonalNif): Automatically classifies winners into PERSONA_JURIDICA_EMPRESA (Corporate CIFs: S.L., S.A., UTE) vs PERSONA_FISICA_AUTONOMO and masks personal DNIs/NIEs by default.
• Subcontractor & Supplier Prospecting: Reach out to winning corporate contractors with specialized supply, machinery, surety bonds (avales), and staffing services the moment they win.

---

Input Parameters

Parameter	Type	Default	Description
recordTypes	Array<String>	["TENDERS", "AWARDS", "AUCTIONS"]	Select one or more record types to extract.
dateFrom	String	null	Start date (YYYY-MM-DD). Defaults to the latest available BOE publication issue.
dateTo	String	null	Optional end date (YYYY-MM-DD) for historical range extraction.
provinces	Array<String>	[]	Filter by province or autonomous community (e.g. Madrid, Barcelona, Valencia, Sevilla, Asturias, Cadiz). Accent-insensitive.
searchKeywords	Array<String>	[]	Free-text keywords or CPV codes (e.g. software, ciberseguridad, vivienda, 72000000). If empty ([]), returns all records.
minAmountEur	Integer	0	Minimum contract budget or auction valuation in Euros (€).
maxAmountEur	Integer	0	Maximum contract budget or auction valuation in Euros (€) (0 for unlimited).
maxResults	Integer	50	Maximum number of records to return. Scraper terminates immediately upon reaching this limit.

---

Example Output Records

1. Judicial Real Estate Auction (AUCTION)

{
  "record_type": "AUCTION",
  "tender_id": "SUB-JA-2026-267446",
  "subasta_id": "SUB-JA-2026-267446",
  "boe_id": "BOE-B-2026-34803",
  "publication_date": "2026-10-26",
  "category": "SUBASTA_JUDICIAL",
  "status": "SUBASTA_ACTIVA",
  "title": "Subasta Judicial Inmobiliaria en AVILES: FINCA REGISTRAL Nº 5547, INSCRITA EN EL REGISTRO DE LA PROPIEDAD Nº2 DE AVILÉS",
  "amount_eur": 73404.93,
  "valor_subasta_eur": 73404.93,
  "tasacion_eur": 0.0,
  "deuda_reclamada_eur": 82946.52,
  "deposito_eur": 3670.25,
  "ratio_deuda_valor_pct": 113.0,
  "referencia_catastral": "4361001TP6246S0014PX",
  "direccion": "C/ COVADONGA, Nº2, 6º, DERECHA",
  "codigo_postal": "33402",
  "localidad": "AVILES",
  "provincia": "Asturias",
  "vivienda_habitual": "No",
  "situacion_posesoria": "No consta",
  "contracting_body": "Sección Civil e Instruc TI Avilés. Plz.n 3",
  "autoridad_gestora": "Sección Civil e Instruc TI Avilés. Plz.n 3",
  "email_organo": "scejaviles.hipotecarios@asturias.org",
  "telefono_organo": "985127821",
  "url": "https://subastas.boe.es/detalleSubasta.php?idSub=SUB-JA-2026-267446"
}

2. Open Public Procurement Tender (TENDER)

{
  "record_type": "TENDER",
  "tender_id": "BOE-B-2026-34880",
  "boe_id": "BOE-B-2026-34880",
  "publication_date": "2026-10-26",
  "category": "SUMINISTROS",
  "status": "PLAZO_ABIERTO",
  "title": "Anuncio de licitación de: Jefatura de la Sección de Asuntos Económicos de la Unidad Militar de Emergencias. Objeto: Adquisición de siete (7) máquinas automotrices teleoperadas de intervención para la UME.",
  "contracting_body": "Jefatura de la Sección de Asuntos Económicos de la Unidad Militar de Emergencias",
  "nif_organo": "S2800475B",
  "localidad": "Torrejón de Ardoz, Madrid",
  "provincia": "Madrid",
  "materias_cpv": "42000000 Maquinaria industrial",
  "amount_eur": 1735531.0,
  "valor_estimado_eur": 1735531.0,
  "criterios_adjudicacion": "18.1) Ampliación de garantía (40%) | 18.2) Precio (60%)",
  "fecha_limite_ofertas": "Hasta las 18:59 horas del 19 de noviembre de 2026",
  "url_pliegos": "https://contrataciondelestado.es/wps/poc?uri=deeplink:detalle_licitacion&idEvl=tO3LdF7oHwU2wEhQbcAqug%3D%3D"
}

3. Contract Award & Winner Intelligence (AWARD)

{
  "record_type": "AWARD",
  "tender_id": "BOE-B-2026-34859",
  "boe_id": "BOE-B-2026-34859",
  "publication_date": "2026-10-26",
  "category": "SUMINISTROS",
  "status": "ADJUDICADO",
  "title": "Anuncio de formalización de contratos de: Junta de Contratación de la Secretaría de Estado de Justicia. Objeto: Suministro de consumibles para el equipo Hamilton.",
  "contracting_body": "Junta de Contratación de la Secretaría de Estado de Justicia",
  "nif_organo": "S2813610I",
  "amount_eur": 86607.4,
  "importe_adjudicacion_eur": 86607.4,
  "adjudicatario_nombre": "HAMILTON IBERIA S.L.U",
  "adjudicatario_nif": "B66809013",
  "adjudicatario_localidad": "hospitalet del llobregat",
  "es_pyme": true,
  "num_ofertas_recibidas": 2,
  "url": "https://www.boe.es/buscar/doc.php?id=BOE-B-2026-34859"
}

---

Integration & Automation

You can connect this Actor directly to:

• Telegram / Discord Bots: Receive real-time push alerts when high-value tenders or auctions appear in your target provinces.
• Make / Zapier / n8n: Sync winning companies directly into HubSpot, Salesforce, or Google Sheets for immediate B2B sales outreach.
• Webhook endpoints: Feed internal CRM pipelines via the live Apify dataset API.