TED Tenders Scraper

Search public procurement notices published on TED (Tenders Electronic Daily, ted.europa.eu), the official journal for EU public tenders. Filter by keyword, buyer country, CPV code, notice type and publication date. You get one record per notice: title, description, buyer with contact details, submission deadline, estimated value, winners and awarded value of contract award notices, lots, duration, and links to the notice as PDF and XML in every language. Use it for tender monitoring, bid pipelines, market research and sales leads from public buyers.

The data comes from the official, public TED Search API. No account or API key is needed.

What you get

One record per notice. Fields a notice does not publish are null.

Field	Type	Description
publication_number	string	TED publication number, unique per notice
notice_url	string	Notice page on ted.europa.eu
title	string	Notice title in the requested language
procedure_title	string or null	Title of the procurement as written by the buyer
description	string or null	Short description of the procurement
notice_type	string or null	TED notice type code, for example cn-standard or can-standard
form_type	string or null	planning, competition, result or cont-modif
procedure_type	string or null	Procedure type code, for example open
contract_nature	string or null	works, supplies or services
publication_date	string or null	Publication date (YYYY-MM-DD)
deadline	string or null	Deadline for submitting tenders. With several lots, the earliest one that has not passed
buyer_name, buyer_names	string, list	Name of the first buyer, and all buyer names
buyer_country, buyer_country_iso3	string	Buyer country as ISO alpha-2 and alpha-3 code
buyer_city, buyer_email, buyer_phone, buyer_website	string or null	Buyer contact details, where published
buyer_type	string or null	Legal type code of the buyer, for example la (local authority)
cpv_codes, main_cpv	list, string	CPV codes of the notice and the main code
place_of_performance	list or null	NUTS codes of the place of performance
place_of_performance_countries	list or null	Country codes (alpha-3) of the place of performance
estimated_value, estimated_value_currency	number, string	Estimated value of the procurement
awarded_value, awarded_value_currency	number, string	Awarded value (award notices)
winner_names, winner_countries	list or null	Winning organisations and their countries (award notices)
lots_count	integer or null	Number of lots
duration_value, duration_unit	number, string	Contract duration, for example 18 and MONTH
is_framework	boolean or null	True for framework agreements
eu_funded	boolean or null	True when EU funds are involved
languages, submission_languages	list	Official languages of the notice, and languages tenders may be submitted in
documents	object	Links as pdf, xml, html, html_direct, each keyed by language
pdf_url, xml_url	string or null	PDF in the requested language (else English) and the XML
search_query	string	The keyword that returned the notice, or the search condition when no keyword was given
scraped_at	string	UTC timestamp, ISO 8601

Fill rates in a test run of 159 notices from keyword, CPV and country searches (October 2026): title, buyer name, buyer country, CPV codes, publication date, notice type and document links were present on every row. The deadline was present on 87 percent of contract notices and on no award notice. The estimated value was present on 31 percent of contract notices, because many buyers do not publish one. Winner names were present on 92 percent of award notices and an awarded value on 77 percent. Buyer email and phone were present on every row, the buyer website on 83 percent.

Input

Field	Type	Default	Description
keywords	list of text	empty	Words or phrases searched in the notice text. Each keyword is a separate search; a phrase of several words is matched as a phrase. A comma separated text also works.
countries	list of text	empty	ISO codes of the buyer country, for example DE, FR, AT.
cpvCodes	list of text	empty	CPV codes, for example 72000000 (IT services). A code also matches the more specific codes below it.
noticeTypes	list of text	empty	contract, award, prior-information or modification. Empty means all types.
publishedFrom, publishedTo	text	empty	Publication date range, YYYY-MM-DD.
activeOnly	boolean	false	Only notices whose submission deadline has not passed. Notices without a deadline, such as award notices, are left out.
maxResults	integer	100	Maximum number of notices across all keywords. 0 means no limit (the source returns at most 15000 results per keyword). The limit is shared equally between keywords; a share that is not used goes to the later ones.
language	text	EN	Language of title and description. If a notice has no text in this language, its original language or another available language is used.
expertQuery	text	empty	Advanced: a condition in the TED expert search syntax, combined with the other filters using AND. A trailing SORT BY clause replaces the default order.

Results are returned newest first. Numbers may be given as text ("25"). An empty input {} runs a small sample search (keyword software, last 30 days, up to 10 notices) and the run status says so. If the input cannot be read, the actor runs that same sample and writes a warning to the log. A value that cannot be used, such as an unknown country code, stops the run with a message that names the value; nothing is charged. The same keyword given twice is searched once, and a notice that several searches find is delivered once.

Example input

{
  "keywords": ["software", "cleaning services"],
  "countries": ["DE", "FR"],
  "noticeTypes": ["contract"],
  "publishedFrom": "2026-10-01",
  "activeOnly": true,
  "maxResults": 100
}

IT services in Austria by CPV code:

{
  "cpvCodes": ["72000000"],
  "countries": ["AT"],
  "publishedFrom": "2026-09-01",
  "maxResults": 30
}

Example output

{
  "publication_number": "749064-2026",
  "notice_url": "https://ted.europa.eu/en/notice/-/detail/749064-2026",
  "title": "Germany – Construction-site supervision services – FBE A38 AS Lützen - AS Leipzig-Südost RF DD TA2, Los 1 - BOL/BÜ/Objektbetreuung (gem. §§ 45 ff. HOAI 2021)",
  "notice_type": "cn-standard",
  "form_type": "competition",
  "contract_nature": "services",
  "publication_date": "2026-10-28",
  "deadline": "2026-11-18T09:00:00+01:00",
  "buyer_name": "Die Autobahn GmbH des Bundes - NL Ost",
  "buyer_country": "DE",
  "estimated_value": 235541.34,
  "estimated_value_currency": "EUR",
  "search_query": "software"
}

The example shows a selection of fields. Every record contains all fields listed above.

Pricing

Pay per event. The actor-start event is charged once per run, together with the first delivered notice. The tender event is charged for each delivered notice row. Prices are shown on the Pricing tab of this Actor. A run that finds nothing is not charged. If you set a maximum cost per run, the run stops at that limit and the status message says how many tenders were delivered.

FAQ

Which notices are covered? Notices published on TED, the EU journal for public procurement, including notices of buyers in EU and EEA countries and others that publish there.

Why are some fields empty? TED notices differ by form and age. Older notices have fewer fields, award notices have no submission deadline, and many buyers do not publish an estimated value.

Which country code do I use? The country of the buying organisation, as a two-letter ISO code (DE, FR). EL and UK are accepted too.

What does a CPV code match? The code and the more specific codes below it, so 72000000 covers IT services as a whole.

How is the language chosen? title and description use the language you set. If the notice has no text in it, the original language of the notice is used, then any other available language.

Which deadline is shown for notices with several lots? The earliest deadline that has not passed, otherwise the latest one.

Where do I report a problem? Use the Issues tab of this Actor.

Limits

• The source returns at most 15000 results per search. Narrow the search with dates or filters for larger result sets.
• Only the public notice data is returned. Documents attached to a tender (tender files) are not downloaded.
• Values are as published by the buyer, in the currency of the notice.