Spain Public Procurement Scraper — Contratación del Estado Tenders

Extract Spanish public procurement tender notices from the Plataforma de Contratación del Sector Público (contrataciondelestado.es), Spain's national public procurement platform run by the Ministerio de Hacienda. Filter by keyword, region, CPV code and notice status. Returns the buyer, estimated value, CPV codes, submission deadline, procedure type, and a direct link to the notice. No login, no API key.

How to scrape Spain public procurement data

This actor reads the platform's own official open-data feed instead of scraping HTML pages. contrataciondelestado.es publishes every notice it processes — tender announcements, prior notices, award decisions, resolutions — as a single public ATOM feed in the CODICE/UBL schema (the EU's standard procurement XML format). The actor downloads that feed, walks its pagination (rel="next") back through recent activity, and parses each entry into a flat, structured record. Because this is the platform's own syndicated data, every field this actor returns is exactly what the contracting authority submitted — no HTML layout to break, no anti-bot to defeat.

Leave the input empty and the actor returns notices currently open for submission — the highest-value dataset for finding new business. Add a keyword, a region, or a CPV prefix to narrow the search.

Who benefits from this data?

• Government contractors and system integrators — Monitor new Spanish public tenders in your sector (construction, IT, services, supplies) across every level of government: ministries, regional governments, city councils, public agencies.
• B2B sales and business development teams — Build a live list of Spanish public buyers procuring in your category, filtered by Autonomous Community or province.
• Bid consultancies and public-sector advisors — Feed new tender alerts into a client-facing monitoring tool without maintaining a scraper against a government portal.
• Market and competitive researchers — Track procurement volume, contract values and procedure types across Spain's public sector over time.
• Journalists and public-spending researchers — Investigate what Spanish public bodies are buying, from whom, for how much, and in which region.

Search by keyword

Enter a keyword to match against the notice title, contracting authority and description (the description includes the tender's official summary line: expediente ID, buyer, amount and status). Leave searchQuery empty to skip the keyword filter entirely.

Filter by status

tenderStatus filters by the notice's official lifecycle stage, using the same status codes the platform itself uses:

• PUB (default) — En plazo: open for submission, currently accepting bids
• EV — Pendiente de adjudicación: bids received, under evaluation
• ADJ — Adjudicada: awarded
• RES — Resuelta: resolved / formalized
• PRE — Anuncio previo: prior information notice
• ANUL — Anulada: cancelled
• ALL — no status filter, return every notice type

Filter by region or CPV code

region matches against the buyer's Autonomous Community or province (Spanish names, e.g. Cataluña, Andalucía, Sevilla). cpvPrefix matches the first digits of any CPV (Common Procurement Vocabulary) code on the notice — use 45 for construction works, 72 for IT services, 71 for architecture and engineering, and so on.

Input parameters

Parameter	Type	Default	Description
searchQuery	String	— (no filter)	Keyword matched against title, buyer and description
tenderStatus	Enum	PUB	PUB, ALL, EV, ADJ, RES, PRE, ANUL — see above
region	String	— (no filter)	Autonomous Community or province, partial match
cpvPrefix	String	— (no filter)	CPV code prefix, e.g. 45
maxResults	Integer	50	Maximum number of notices to return (1–5,000)
maxPages	Integer	5	How many feed pages to walk back through (1–30) — see Limitations
proxyConfiguration	Object	Apify proxy	Apify proxy settings

What data does this scraper extract?

Field	Type	Description
itemTitle	String	Notice title
referenceNumber	String	Buyer's internal file number ("expediente")
organization	String	Contracting authority name
status	String	Official status label (En plazo, Adjudicada, Resuelta, etc.)
publicationDate	String	Earliest official publication date found on the notice
deadline	String	Bid submission deadline (ISO date, with time where published)
estimatedValue	String	Estimated contract value (overall, or tax-exclusive if that is all the notice publishes)
currency	String	Currency of estimatedValue, usually EUR
category	String	Contract type: Suministros (goods), Servicios (services), Obras (works), or a concession type
cpvCodes	Array	CPV codes on the notice, each with an approximate division-level description
region	String	Province and Autonomous Community, combined
autonomousCommunity	String	Autonomous Community, isolated (empty for central-government buyers)
province	String	Province or place of performance
procedureType	String	Procurement procedure: Abierto, Restringido, Negociado, Contrato menor, etc.
lots	Integer	Number of lots ("lotes") the contract is split into, 0 if not split
noticeTypes	Array	Which official notice types have been published for this file (e.g. contract notice, award notice)
itemDescription	String	The notice's official summary line
contactInfo	Object	Buyer phone, email and website where published
url	String	Direct link to the notice on contrataciondelestado.es
scrapedAt	String	ISO timestamp of when the data was scraped

Example output

{
    "itemTitle": "Suministro de diverso material de oficina, papel y material de imprenta para el Ayuntamiento de Palencia",
    "referenceNumber": "2025/13499",
    "organization": "Junta de Gobierno Local del Ayuntamiento de Palencia",
    "status": "En plazo (abierto a licitación)",
    "publicationDate": "2026-09-01",
    "deadline": "2026-09-30T23:59:00",
    "estimatedValue": "269701.45",
    "currency": "EUR",
    "category": "Suministros",
    "cpvCodes": [
        { "code": "30000000", "description": "Office and computing machinery and supplies" }
    ],
    "region": "Palencia, Castilla y León",
    "autonomousCommunity": "Castilla y León",
    "province": "Palencia",
    "procedureType": "Abierto",
    "lots": 3,
    "noticeTypes": ["DOC_PIN_RTL", "DOC_CD", "DOC_CN"],
    "itemDescription": "Id licitación: 2025/13499; Órgano de Contratación: Junta de Gobierno Local del Ayuntamiento de Palencia; Importe: 117261.5 EUR; Estado: PUB",
    "contactInfo": {
        "phone": "979718186",
        "email": "licitaciones@aytopalencia.es",
        "website": "http://www.aytopalencia.es"
    },
    "url": "https://contrataciondelestado.es/wps/poc?uri=deeplink:detalle_licitacion&idEvl=iby7ltxH1cIeIBJRHQiPkQ%3D%3D",
    "scrapedAt": "2026-09-03T14:16:44.736Z"
}

Tips for best results

• Daily monitoring: Schedule a run with the default tenderStatus: PUB and no keyword to catch every newly opened tender, then filter locally by CPV or region.
• Broad discovery first: Leave searchQuery and region empty on the first run to see the spread of currently open notices across Spain, then narrow once you know which terms and regions matter to you.
• Awards, not just open tenders: Set tenderStatus to ADJ or RES to see who won recent contracts and for how much, instead of what's currently open.
• CPV over keyword for precision: Spanish notice titles are free text and vary a lot between buyers; a CPV prefix (e.g. 45 for construction) is a more reliable filter than a keyword when you care about a specific sector.

How much does it cost to run?

The feed itself is free public data. Your only cost is Apify compute time and proxy usage. Each feed page is a single HTTP request covering 150–500 notices, so cost scales with how many pages the run needs to walk (governed by maxPages and how quickly your filters find matches), not with maxResults directly.

Search	Estimated time	Estimated cost	Cost per result
20 open notices, no filter	~15 seconds	~$0.01	~$0.0005 per result
50 notices, keyword filter	~30 seconds	~$0.02	~$0.0004 per result
500 notices, maxPages: 20	~2–4 minutes	~$0.10	~$0.0002 per result

Actual cost depends on your Apify plan and proxy usage; a run's final usage cost only settles after the run reports SUCCEEDED — reading the dataset mid-run will undercount it.

Use as an API

from apify_client import ApifyClient

client = ApifyClient("YOUR_API_TOKEN")

run = client.actor("studio-amba/contrataciondelestado-es-scraper").call(run_input={
    "searchQuery": "obras",
    "tenderStatus": "PUB",
    "region": "Cataluña",
    "maxResults": 50,
})

for tender in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(f"{tender['itemTitle']} | {tender['organization']} | {tender['estimatedValue']} {tender['currency']}")

Limitations

• Feed pagination goes back in time, not forward: the feed is a chronological activity log, most recent first. maxPages bounds how far back the actor walks looking for matches — narrow filters (a rare keyword, a small region) may need a higher maxPages to find enough results.
• CPV descriptions are division-level, not exact: cpvCodes[].description is derived from the CPV code's 2-digit division (e.g. all 30xxxxxx codes map to "Office and computing machinery and supplies"), not the full 8-digit official label. The code itself is always exact — look it up against the official CPV vocabulary if you need the precise wording.
• autonomousCommunity is empty for central-government buyers: ministries and other national-level bodies don't sit under a regional entry in the platform's own buyer hierarchy, so there is no region to extract — this is a property of the source data, not a scraper gap. province (place of performance) is populated for almost every notice.
• National platform only: contrataciondelestado.es is Spain's central platform, used by the central government, most autonomous communities, and most local councils. A small number of regions and large cities run separate regional e-procurement portals not covered by this feed.
• Deadline has no timezone marker: the feed publishes submission deadlines as local Spain time without an explicit UTC offset; this actor passes the date and time through as published.

Other European procurement scrapers

Check the Studio AMBA actor catalog for more European public procurement data, including e-Vergabe (Germany), ezamowienia.gov.pl (Poland), hankintailmoitukset.fi (Finland), udbud.dk (Denmark), and other national procurement platforms.

Maintained by Studio Amba

We run 700+ scrapers for European websites, and the priority is keeping every one of them working. Automated runs test this actor against the live source and verify the output is complete. When the source changes, the scraper usually gets repaired the same day, without you having to report anything. Questions and issues go straight to the people who built it, and most get an answer the same day.

Need this data on a schedule, or a custom version?

We run this scraper as a managed service for businesses: scheduled runs, deduplication, delta detection, and delivery to your inbox, Google Sheets, or API, maintenance included. We can also build a custom version with your exact fields and filters, or combine multiple sources into one feed.

See studioamba.dev/services or email hello@studioamba.dev for a free data sample.

Your feedback

Found a bug or want a feature? Open an issue on the Issues tab.