Basque Country Tenders Scraper — Euskadi Public Contracts

Scrape Basque Country public tenders — licitaciones del País Vasco, contratación pública de Euskadi — from the official Open Data Euskadi catalogue, the open-data index of the Kontratazio Publikoen Plataforma (the Basque public procurement platform).

Extrae el índice de anuncios de contratación pública del País Vasco (Gobierno Vasco, diputaciones forales, ayuntamientos y demás entidades adheridas a la Kontratazio Publikoen Plataforma) desde el catálogo oficial Open Data Euskadi: solo los anuncios actualmente en plazo, o el volcado histórico completo de un año.

Basque Country Tenders Scraper: what it does / qué hace este actor

Basque Country Tenders Scraper builds a clean, one-item-per-announcement index of open procurement opportunities in Euskadi: who is contracting, what for, when the deadline is, what stage the file is at, and a link to the official record. Field names match the sibling Actors catalonia-tenders and aragon-tenders, so the three Spanish regional procurement sources can feed a single table.

Este actor entrega un ítem por anuncio de contratación, con el mismo esquema de campos que catalonia-tenders y aragon-tenders, para que las tres fuentes autonómicas se puedan volcar al mismo dataset y tratarse como una sola tabla. Es un índice de oportunidades de licitación: quién, qué, cuándo, en qué estado y enlace a la ficha oficial.

Basque tender data extracted / Qué datos extrae: anuncios de contratación

Campo / Field	Qué es / What it is
idExpediente	Número de expediente del órgano
titulo, objeto	Título y objeto del anuncio
administracion	Entidad (institución)
organoContratacion	Poder adjudicador
organoSuperior	Departamento
unidadTramitadora	Órgano de contratación concreto
estado	Estado de tramitación (Abierto / Plazo de presentación, Adjudicación provisional / definitiva…)
esContratoMenor	Booleano
fechaPublicacionAnuncio, fechaLimiteOfertas	Fechas, en ISO
enlaceFichaPublica	Ficha pública oficial del expediente

Euskadi tenders limitation, verified: no amounts or awardee / Sin importes ni adjudicatario

A diferencia de catalonia-tenders y aragon-tenders, este actor NO incluye presupuesto, importe de adjudicación ni datos del adjudicatario. No es una carencia de implementación: es una limitación real y verificada del origen de datos.

• El índice público (el que usa este actor) no lleva esos campos — verificado con curl sobre el volcado JSON completo.
• El detalle de cada expediente (que sí los lleva) solo está disponible en dos rutas técnicas, ambas prohibidas por el robots.txt de contratacion.euskadi.eus: Disallow: /*/es_*/data/* (el JSON/XML de detalle) y Disallow: /*idxContent* (los metadatos indexados).
• La página HTML pública del expediente sí está permitida por robots, pero es una aplicación de página única que pinta el detalle en el navegador leyendo precisamente el recurso prohibido — verificado que el HTML crudo no contiene el adjudicatario.
• Existe un tercer recurso (trazabilidad) que sí está permitido por robots y sí contiene el adjudicatario, pero el identificador interno que necesita esa URL solo aparece dentro del propio recurso prohibido — callejón sin salida conforme con robots.txt.

Este actor nunca solicita las rutas prohibidas. El resultado es un índice de oportunidades de licitación, no un registro económico completo. Ver la evidencia curl completa en docs/fase5/socrata-ccaa.md.

In English: unlike catalonia-tenders/aragon-tenders, this Actor does not include budget, award amount or awardee identity. This is a real, verified platform limitation, not a shortcut: the only two endpoints that carry that detail are explicitly blocked by contratacion.euskadi.eus's robots.txt (Disallow: /*/es_*/data/* and Disallow: /*idxContent*), and the public HTML detail page (which robots.txt does allow) renders that data client-side from precisely those blocked endpoints — verified empty in the raw HTML. This Actor never requests the disallowed paths.

Open Data Euskadi input / Parámetros de entrada y filtrado en cliente

Parámetro / Parameter	Tipo / Type	Por defecto / Default	Descripción / Notes
fuente	abiertos|anio	abiertos	abiertos = solo anuncios actualmente en plazo (rápido, ~500 filas). anio = volcado histórico completo de un año
anio	entero / integer	2025	Solo si fuente: anio. Disponible desde 2005
keywords	lista de textos / string list	[]	Busca en título+objeto, EN CLIENTE
soloContratoMenor	booleano / boolean	false	Filtro en cliente
fechaDesde / fechaHasta	fecha ISO / ISO date	—	Filtro en cliente sobre la fecha de publicación
maxItems	entero / integer	200	Tope de ítems

El filtrado ocurre en CLIENTE, no en servidor. A diferencia de Cataluña (Socrata) y Aragón (CKAN), esta plataforma no ofrece ningún parámetro de consulta (?q=, ?filters=…) — verificado con curl. El actor descarga el volcado JSON completo del periodo elegido (fuente) y aplica keywords/fechaDesde/fechaHasta/soloContratoMenor en memoria, documentado en cada log de ejecución. · This platform exposes no query parameters at all (verified with curl) — the Actor downloads the full JSON dump for the chosen period and filters in memory.

Ejemplo de input / example input:

{
  "fuente": "abiertos",
  "keywords": ["obras", "reforma"],
  "maxItems": 200
}

Basque tenders output example / Ejemplo de output real

Dos ítems reales de una ejecución del actor con { "fuente": "abiertos", "maxItems": 50 } (23-ago-2026), elegidos para mostrar dos tipos de entidad: una diputación foral y un ayuntamiento. · Two real items from a run with { "fuente": "abiertos", "maxItems": 50 }.

{
  "idExpediente": "2026/0009/072/07",
  "idIntern": null,
  "titulo": "Suministro de vestuario con destino al personal del Servicio de Prevención, Extinción de Incendios y Salvamento de la Diputación Foral de Bizkaia",
  "objeto": "Suministro de vestuario con destino al personal del Servicio de Prevención, Extinción de Incendios y Salvamento de la Diputación Foral de Bizkaia",
  "administracion": "Diputación Foral de Bizkaia",
  "organoContratacion": "Diputación Foral de Bizkaia",
  "organoSuperior": "Departamento de Administración Pública y Relaciones Institucionales",
  "unidadTramitadora": "Diputado Foral de Administración Pública y Relaciones Institucionales",
  "codigoDir3": null,
  "tipoContrato": null,
  "procedimiento": null,
  "tramitacion": null,
  "estado": "Abierto / Plazo de presentación",
  "resultado": null,
  "esAgregada": false,
  "presupuestoLicitacionSinIva": null,
  "presupuestoLicitacionConIva": null,
  "valorEstimadoContrato": null,
  "importeAdjudicacionSinIva": null,
  "importeAdjudicacionConIva": null,
  "moneda": "EUR",
  "ofertasRecibidas": null,
  "adjudicatario": null,
  "codigosCpv": [],
  "lugarEjecucion": null,
  "codigoNuts": null,
  "duracionContrato": null,
  "numeroLote": null,
  "descripcionLote": null,
  "fechaPublicacionAnuncio": "2026-07-23",
  "fechaLimiteOfertas": "2026-08-24T12:00:00Z",
  "fechaPublicacionAdjudicacion": null,
  "fechaPublicacionFormalizacion": null,
  "fechaAdjudicacionContrato": null,
  "fechaFormalizacionContrato": null,
  "enlaceFichaPublica": "https://www.contratacion.euskadi.eus/anuncio_contratacion/suministro-vestuario-destino-al-personal-del-servicio-prevencion-extincion-incendios-y-salvamento-diputacion-foral-bizkaia/expgebizkaia3530294/webkpe00-kpesimpc/es/",
  "enlacesJson": null,
  "esContratoMenor": false,
  "fuente": "Open Data Euskadi — índice de anuncios de contratación pública (Kontratazio Publikoen Plataforma)",
  "extraidoEn": "2026-08-23T17:45:08.975Z"
}

{
  "idExpediente": "B026-2026-00002",
  "idIntern": null,
  "titulo": "Contratación de las obras de reforma de la Biblioteca Municipal de Dima",
  "objeto": "Contratación de las obras de reforma de la Biblioteca Municipal de Dima",
  "administracion": "Ayuntamiento de Dima",
  "organoContratacion": "Ayuntamiento de Dima",
  "organoSuperior": "Ayuntamiento de Dima",
  "unidadTramitadora": "Alcaldía",
  "codigoDir3": null,
  "tipoContrato": null,
  "procedimiento": null,
  "tramitacion": null,
  "estado": "Abierto / Plazo de presentación",
  "resultado": null,
  "esAgregada": false,
  "presupuestoLicitacionSinIva": null,
  "presupuestoLicitacionConIva": null,
  "valorEstimadoContrato": null,
  "importeAdjudicacionSinIva": null,
  "importeAdjudicacionConIva": null,
  "moneda": "EUR",
  "ofertasRecibidas": null,
  "adjudicatario": null,
  "codigosCpv": [],
  "lugarEjecucion": null,
  "codigoNuts": null,
  "duracionContrato": null,
  "numeroLote": null,
  "descripcionLote": null,
  "fechaPublicacionAnuncio": "2026-07-23",
  "fechaLimiteOfertas": "2026-09-11T23:59:00Z",
  "fechaPublicacionAdjudicacion": null,
  "fechaPublicacionFormalizacion": null,
  "fechaAdjudicacionContrato": null,
  "fechaFormalizacionContrato": null,
  "enlaceFichaPublica": "https://www.contratacion.euskadi.eus/anuncio_contratacion/contratacion-obras-reforma-biblioteca-municipal-dima/webkpe00-kpesimpc/es/",
  "enlacesJson": null,
  "esContratoMenor": false,
  "fuente": "Open Data Euskadi — índice de anuncios de contratación pública (Kontratazio Publikoen Plataforma)",
  "extraidoEn": "2026-08-23T17:45:09.005Z"
}

Euskadi public procurement use cases / Casos de uso

Empresas licitadoras — anuncios de licitación en plazo, cada día

Con fuente: "abiertos" obtienes solo lo que todavía admite oferta, con su fechaLimiteOfertas. Programado en un Schedule diario y filtrado por keywords de tu sector, es una lista de oportunidades vivas del País Vasco. · Only announcements still open for bids, with their deadline.

Consultoras y analistas — volcado histórico anual del País Vasco

Con fuente: "anio" y anio desde 2005 puedes reconstruir la serie histórica de anuncios de contratación de Euskadi: qué entidades convocan más, con qué estacionalidad y en qué materias. · Full yearly dumps back to 2005 for historical analysis.

Ayuntamientos y diputaciones — seguimiento de una administración concreta

Filtra por keywords con el nombre de la entidad (Bizkaia, Dima, Garbiker…) para seguir solo los anuncios de una administración: diputaciones forales, ayuntamientos o empresas públicas. · Track a single contracting authority.

Periodismo de datos y transparencia — contratación pública Euskadi

El volcado anual 2025 son casi cien mil filas de anuncios de contratación pública vasca, base suficiente para analizar volumen y reparto por institución. · Data journalism on Basque public procurement.

Basque tenders data source, coverage and limits / Fuente oficial, cobertura y límites

• Fuente oficial: Open Data Euskadi, catálogo del Gobierno Vasco — https://opendata.euskadi.eus/contenidos/ds_contrataciones/. Volcado "anuncios en plazo abierto" verificado el 23-ago-2026 (501 filas, ~1,3 MB, actualización diaria); volcado anual 2025 verificado el mismo día (96.829 filas, ~229 MB).
• Cobertura: Gobierno Vasco, diputaciones forales, ayuntamientos y demás entidades adheridas a la Kontratazio Publikoen Plataforma. Histórico anual disponible desde 2005.
• Qué NO trae: presupuesto, importe de adjudicación y adjudicatario — ver la sección de limitación verificada, más arriba. Tampoco hay filtrado en servidor: los volcados anuales grandes se descargan enteros antes de filtrar.
• Este actor respeta estrictamente el robots.txt de contratacion.euskadi.eus (no solicita dataXML ni metadataXML). · This Actor strictly honours contratacion.euskadi.eus's robots.txt.

Related Spanish public-data Actors / Actores relacionados

Actor	Qué extrae / What it scrapes
catalonia-tenders	Licitaciones y adjudicaciones públicas de Cataluña (PSCP), con importes
aragon-tenders	Registro de contratos públicos de Aragón, mayores y menores (CKAN)
spain-boe-monitor	Boletín Oficial del Estado (BOE) por palabra clave, sección y NIF
spain-bocm-gazette	Boletín Oficial de la Comunidad de Madrid (BOCM), modo delta
spain-boja-gazette	Boletín Oficial de la Junta de Andalucía (BOJA), modo delta
spain-borme-companies	Actos societarios del BORME: constituciones, cargos, concursos
spain-grants-bdns	Subvenciones y ayudas públicas de España (BDNS/SNPSAP)
spain-de-minimis-aid	Ayudas de minimis y ayudas de Estado por NIF de beneficiario
spain-grants-registries	Grandes beneficiarios, sanciones por fraude y ayudas a partidos
spain-cadastre-bulk	Enriquecimiento catastral masivo (Catastro OVC)

Is it legal to scrape Basque Country tenders? / Protección de datos y aviso legal

• Este actor solo lee datos públicos, sin login, sin cookies y sin saltarse ninguna medida técnica. · This Actor only reads public data, with no login, no cookies and without circumventing any technical measure.
• No es un producto oficial ni está afiliado, respaldado ni verificado por el Gobierno Vasco / Eusko Jaurlaritza. · This Actor is not an official product and is not affiliated with or endorsed by the Gobierno Vasco / Eusko Jaurlaritza.
• Datos personales / GDPR: el índice de anuncios no contiene adjudicatarios, así que no expone identificación nominal de autónomos adjudicatarios, a diferencia de las fuentes de Cataluña y Aragón. Los campos publicados identifican órganos y unidades administrativas, no personas físicas concretas. Su tratamiento posterior sigue siendo responsabilidad tuya conforme al RGPD y la LOPDGDD. · The announcements index carries no awardee identity, so no natural person is named; onward processing remains your responsibility under GDPR.
• Los datos son dinámicos y pueden corregirse tras la extracción: para decisiones con efectos jurídicos, consulta siempre enlaceFichaPublica.

FAQ — Basque Country public tenders / Preguntas frecuentes

¿Por qué no trae el importe ni el adjudicatario? / Why no amounts or awardee?

Porque las dos únicas rutas que publican ese detalle están prohibidas por el robots.txt de contratacion.euskadi.eus y este actor las respeta. Está explicado y verificado con curl en la sección de limitación, más arriba.

¿Puedo descargar el histórico completo de un año? / Can I get a full year's history?

Sí: fuente: "anio" con el año que quieras desde 2005. Ten en cuenta el tamaño — el volcado de 2025 son 96.829 filas y ~229 MB, que se descargan enteras antes de filtrar.

¿Puedo recibir solo las licitaciones abiertas? / Can I get only open calls?

Sí, es el modo por defecto: fuente: "abiertos" devuelve únicamente los anuncios en plazo de presentación (~500 filas, actualización diaria).

¿Cubre ayuntamientos y diputaciones, o solo el Gobierno Vasco? / Which bodies are covered?

Cubre Gobierno Vasco, diputaciones forales, ayuntamientos y demás entidades adheridas a la Kontratazio Publikoen Plataforma, como se ve en los ejemplos de output.

¿Necesito una API key o credenciales? / Do I need an API key?

No. Todo sale del catálogo público Open Data Euskadi, sin login ni cookies.

¿Puedo unir este dataset con los de Cataluña y Aragón? / Can I merge it with the other regions?

Sí. Los tres actores comparten nombres de campo, así que puedes volcarlos al mismo dataset. Ten en cuenta que los campos de importe y adjudicatario llegarán vacíos en las filas de Euskadi.

Support & feedback / Soporte

¿Falta un campo, quieres otro modo de descarga o una versión a medida para tu flujo? Abre una incidencia desde la pestaña Issues de la ficha del actor en Apify: se leen todas. · Missing a field or need a custom version? Open an issue from the Issues tab of this Actor's page.

Palabras clave / Keywords: licitaciones País Vasco, Basque Country public tenders, contratación pública Euskadi, Open Data Euskadi scraper, Kontratazio Publikoen Plataforma, Euskadi procurement API, anuncios de licitación en plazo, Spain regional tenders, Gobierno Vasco contratos, diputaciones forales licitaciones, tender index scraper, concursos públicos Euskadi.