EU Procurement Notice Finder by CPV & Country avatar

EU Procurement Notice Finder by CPV & Country

Pricing

from $0.49 / 1,000 results

Go to Apify Store
EU Procurement Notice Finder by CPV & Country

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

vexaloom-labs

Maintained by Community

Actor stats

0

Bookmarked

2

Total users

1

Monthly active users

13 hours ago

Last modified

Features

Limited permissions

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

FieldDescription
publicationNumberTED publication number, e.g. 463590-2022
titleNotice title
buyerName, buyerIdentifier, buyerLegalTypeContracting authority name, registration identifier and legal form code
buyerCountry, buyerCountryName, buyerCityBuyer country and city
buyerEmail, buyerContactPoint, buyerWebsiteBuyer contact details when published
placeOfPerformanceNUTS and country codes where the contract is performed
cpvCodes, cpvMainAll CPV classification codes on the notice, and the primary one
noticeType, noticeSubtype, noticeVersion, formTypeNotice classification and version
procedureType, contractNatureProcedure and nature (works, supplies, services)
publicationDate, ojsNumberPublication date and Official Journal issue
deadlineEarliest tender submission deadline, when published
value, valueCurrencyTotal contract value and its currency, when published
estimatedValue, estimatedValueCurrency, estimatedValueLotsEstimated value for the procedure and per lot
awardValue, awardValueCurrencyAwarded value on award notices
winnerName, winnerNames, winnerIdentifiers, winnerCountries, winnerEmailsWinning supplier(s), with identifiers, countries and contact emails
winnerSizes, winnerSelectionStatusesWinner size class and selection status codes
contractConclusionDate, winnerDecisionDateContract signature and award decision dates
contractTitleContract or lot title when published
durationValue, durationUnitContract duration and unit
frameworkAgreement, subcontractingFramework-agreement and subcontracting codes
htmlUrl, xmlUrl, pdfUrl, sourceUrlOfficial notice formats and canonical page
recordTypeAlways notice
scrapedAtUTC 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:

FieldDescription
recordTypeAlways error
errorShort code, e.g. query_error, request_failed, missing_input
messageHuman-readable explanation
inputThe query or input value that triggered the error, when applicable
sourceUrlThe TED endpoint that was called
scrapedAtUTC timestamp of the scrape

Input

FieldTypeDefaultDescription
modestringsearchsearch (filter-based) or getNotice (by publication number).
cpvCategorystring– (any)CPV top-level division, e.g. 45 for construction, 72 for IT services. Matches the division and all its sub-codes.
cpvCodestring–One or more CPV codes, separated by commas or spaces, e.g. 45233140, 48000000. Each matches the code and its sub-codes.
noticeTypestring– (any)Contract notice, contract award notice, prior information notice, modification, and the other TED notice types.
procedureTypestring– (any)Open, restricted, competitive dialogue, negotiated, innovation partnership, and other procedure types.
contractNaturestring– (any)works, supplies, or services.
countrystring– (all)Buyer country as an ISO-3166 alpha-3 code (alpha-2 is also accepted).
keywordstring–Full-text keyword matched anywhere in the notice.
buyerNamestring–Text that must appear in the contracting authority name.
publicationDateFrom, publicationDateTostring–Publication-date range, YYYY-MM-DD.
deadlineFrom, deadlineTostring–Tender submission deadline range, YYYY-MM-DD.
minValue, maxValueinteger–Total contract-value range, in the notice's own currency.
scopestringACTIVEACTIVE (open for submission), LATEST (latest version of each notice), or ALL (full archive).
sortBystringnewestnewest, oldest, deadlineSoonest, or valueHighest.
publicationNumberstring–One or more TED publication numbers or notice URLs, used in getNotice mode.
maxItemsinteger50Maximum 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.