EU Procurement Notice Finder by CPV & Country
Pricing
from $0.49 / 1,000 results
EU Procurement Notice Finder by CPV & Country
Search EU TED procurement notices by CPV category, buyer country, publication date, and keyword, or fetch specific notices by publication number, with buyer, deadline, and contract value per notice.
Pricing
from $0.49 / 1,000 results
Rating
0.0
(0)
Developer
vexaloom-labs
Maintained by CommunityActor stats
0
Bookmarked
2
Total users
1
Monthly active users
13 hours ago
Last modified
Categories
Features
Share
TED (Tenders Electronic Daily) is the EU's official journal for public procurement. It publishes contract notices, award results, prior information notices and modifications from thousands of public buyers across Europe. This actor queries TED's open Search API directly and returns clean notice records — no account, API key, cookie, or proxy is needed.
What this actor does
- Searches notices by CPV category (one of 45 divisions) and optional exact/partial CPV codes, buyer country, publication-date range, tender-deadline range, contract-value range, notice type, procedure type, contract nature, buyer name and full-text keyword.
- Fetches specific notices by publication number — one, several, or a pasted TED URL.
- Scopes a search to notices still open for submission (
ACTIVE), the latest version of each notice (LATEST), or the complete archive (ALL). - Sorts results newest first, oldest first, by soonest submission deadline, or by highest contract value.
- Pages through results with a stable server cursor, up to 10,000 notices per run, with no duplicates.
- Returns buyer identity and contact details, CPV codes, dates, deadlines, contract and award values, winning suppliers with their identifiers, and links to the HTML, XML and PDF versions of every notice.
- Leaves a field out of a record when TED does not publish it for that notice, instead of sending an empty value.
Output per notice
| Field | Description |
|---|---|
publicationNumber | TED publication number, e.g. 463590-2022 |
title | Notice title |
buyerName, buyerIdentifier, buyerLegalType | Contracting authority name, registration identifier and legal form code |
buyerCountry, buyerCountryName, buyerCity | Buyer country and city |
buyerEmail, buyerContactPoint, buyerWebsite | Buyer contact details when published |
placeOfPerformance | NUTS and country codes where the contract is performed |
cpvCodes, cpvMain | All CPV classification codes on the notice, and the primary one |
noticeType, noticeSubtype, noticeVersion, formType | Notice classification and version |
procedureType, contractNature | Procedure and nature (works, supplies, services) |
publicationDate, ojsNumber | Publication date and Official Journal issue |
deadline | Earliest tender submission deadline, when published |
value, valueCurrency | Total contract value and its currency, when published |
estimatedValue, estimatedValueCurrency, estimatedValueLots | Estimated value for the procedure and per lot |
awardValue, awardValueCurrency | Awarded value on award notices |
winnerName, winnerNames, winnerIdentifiers, winnerCountries, winnerEmails | Winning supplier(s), with identifiers, countries and contact emails |
winnerSizes, winnerSelectionStatuses | Winner size class and selection status codes |
contractConclusionDate, winnerDecisionDate | Contract signature and award decision dates |
contractTitle | Contract or lot title when published |
durationValue, durationUnit | Contract duration and unit |
frameworkAgreement, subcontracting | Framework-agreement and subcontracting codes |
htmlUrl, xmlUrl, pdfUrl, sourceUrl | Official notice formats and canonical page |
recordType | Always notice |
scrapedAt | UTC timestamp of the scrape |
Output when a request fails
If TED rejects a query, a request fails after retries, or getNotice is called without a valid publication number, the actor pushes an error record instead of silently returning nothing:
| Field | Description |
|---|---|
recordType | Always error |
error | Short code, e.g. query_error, request_failed, missing_input |
message | Human-readable explanation |
input | The query or input value that triggered the error, when applicable |
sourceUrl | The TED endpoint that was called |
scrapedAt | UTC timestamp of the scrape |
Input
| Field | Type | Default | Description |
|---|---|---|---|
mode | string | search | search (filter-based) or getNotice (by publication number). |
cpvCategory | string | – (any) | CPV top-level division, e.g. 45 for construction, 72 for IT services. Matches the division and all its sub-codes. |
cpvCode | string | – | One or more CPV codes, separated by commas or spaces, e.g. 45233140, 48000000. Each matches the code and its sub-codes. |
noticeType | string | – (any) | Contract notice, contract award notice, prior information notice, modification, and the other TED notice types. |
procedureType | string | – (any) | Open, restricted, competitive dialogue, negotiated, innovation partnership, and other procedure types. |
contractNature | string | – (any) | works, supplies, or services. |
country | string | – (all) | Buyer country as an ISO-3166 alpha-3 code (alpha-2 is also accepted). |
keyword | string | – | Full-text keyword matched anywhere in the notice. |
buyerName | string | – | Text that must appear in the contracting authority name. |
publicationDateFrom, publicationDateTo | string | – | Publication-date range, YYYY-MM-DD. |
deadlineFrom, deadlineTo | string | – | Tender submission deadline range, YYYY-MM-DD. |
minValue, maxValue | integer | – | Total contract-value range, in the notice's own currency. |
scope | string | ACTIVE | ACTIVE (open for submission), LATEST (latest version of each notice), or ALL (full archive). |
sortBy | string | newest | newest, oldest, deadlineSoonest, or valueHighest. |
publicationNumber | string | – | One or more TED publication numbers or notice URLs, used in getNotice mode. |
maxItems | integer | 50 | Maximum notice records to return, 1–10,000. |
Example: open German construction tenders above EUR 1 million
{"mode": "search","cpvCategory": "45","country": "DEU","noticeType": "cn-standard","procedureType": "open","contractNature": "works","minValue": 1000000,"scope": "ACTIVE","sortBy": "deadlineSoonest","maxItems": 50}
Example: recent IT awards, highest value first
{"mode": "search","cpvCategory": "72","noticeType": "can-standard","publicationDateFrom": "2026-01-01","sortBy": "valueHighest","maxItems": 100}
Example: notices for one buyer in a date window
{"mode": "search","buyerName": "comune di milano","publicationDateFrom": "2026-01-01","publicationDateTo": "2026-03-31","maxItems": 200}
Example: fetch specific notices
{"mode": "getNotice","publicationNumber": "463590-2022, 4-2026"}
Use cases
- Bid discovery — find open tenders in your sector and country before the submission deadline.
- Market intelligence — track which buyers are procuring what, where, and at what value.
- Competitor monitoring — watch award notices, winners and contract values by CPV category.
- Procurement research — build datasets of public spending across Europe by category and time period.
- Lead generation — surface contracting authorities active in a specific sector, with contact details.
FAQ
Do I need an account, API key, or proxy? No. TED's published-notice Search API is anonymous and cookieless, and the actor calls it directly.
What is a CPV code?
CPV (Common Procurement Vocabulary) is the EU's classification for public contracts. cpvCategory matches one top-level division and all of its sub-codes; cpvCode adds specific codes and matches them hierarchically (a code also returns its sub-codes). When both are set, a notice matching either is returned.
Which countries are covered? EU member states, EEA/EFTA countries (Iceland, Liechtenstein, Norway, Switzerland), the United Kingdom, and other European countries that publish on TED.
What do the three scopes mean?
ACTIVE returns notices still open for submission. LATEST returns the newest version of each matching notice. ALL returns every notice and every version in the archive, including amendments.
What is the difference between value, estimatedValue and awardValue?
value is the notice's total contract value. estimatedValue is the buyer's estimate for the procedure or lots. awardValue is the value actually awarded on an award notice. Not every notice publishes all three.
Why are some fields missing from a notice?
TED only publishes them for certain notice types. For example, winner and award fields exist on award notices, while deadlines exist on notices that invite tenders. Missing values are omitted, never sent as null.
Why is buyerEmail or buyerContactPoint missing?
Contact details are optional in eForms and many buyers omit them. The actor returns them whenever TED publishes them, but never invents them. Phone numbers are not exposed by the Search API at all.
How many notices can one run return?
Up to maxItems, capped at 10,000. The actor uses TED's stable iteration cursor, so it does not duplicate rows or hit the 15,000-row page-number window.
How fresh is the data? Each run queries TED live, so results reflect what is published when the run starts.
What happens if my query is invalid or a request fails?
The actor retries transient failures with backoff and pushes a single descriptive error record (recordType: "error") rather than failing silently.
Is this affiliated with TED or the EU? No. This actor reads TED's public data and is not affiliated with, endorsed by, or connected to the Publications Office of the European Union.
Limitations
- Winner and award fields are only present on award notices; tender notices have no winners yet.
- Contract values are reported in the notice's own currency, not converted to EUR.
- Buyer phone numbers are not part of TED's Search API response.
- Sorting is available for publication date, submission deadline and total value; TED does not expose a relevance score through this API.
- A single run is capped at 10,000 notices. For larger exports, partition by publication date, country or CPV division.
- Contract descriptions are not included to keep records compact; every notice links to its official HTML, XML and PDF versions.