An official website of the European Union

Developers' corner for Reusers

General

The TED website provides several web application programming interfaces (APIs).

These APIs let you:

  • Search and retrieve data published on the TED portal (TED search API)
  • Download notices in various formats using direct links
  • Download XML notices in bulk
  • Download the release calendar


The TED website also provides RSS feeds


Since 14 November 2022, the notices available on the TED website use both eForms and TED schema forms:


Information for both eForms and TED schema forms is available in TED Developer Docs

Search and retrieve data published on the TED portal (TED search API)

The TED search API can be accessed anonymously, so you can use the website’s search engine to find specific procurement notices.
The documentation of TED search API is available on https://ted.europa.eu/api/documentation/index.html

Download notices in various formats using direct links

You can download a notice using a direct link, in any EU official languages and in the following formats: HTML, HTML download, Signed PDF and Non-signed PDF.


The format of the URLs of the direct link is as follows:


https://ted.europa.eu/{lang}/notice/{publication-number}/{format}


where:

  • {lang} is the language (e.g. en, de)
  • {publication-number} is the publication number (e.g. 1-2024, 87654321-2024 )
  • {format} can be :
  • html: to display the HTML download file
  • pdf: to download the notice as PDF
  • pdfs: to download the notice as signed PDF

 

Furthermore, you can download notices using a direct link in XML format.

The format of the URL of the direct link is as follows:

https://ted.europa.eu/en/notice/{publication-number}/xml

Download XML notices in bulk

You can download XML notices in bulk from the TED portal via the page XML bulk download in the TED website.


A single archive (XML package) contains all the notices for the chosen day or for the chosen month.


The XML packages contain XML files numbered in two ways:

  • for eForms notices the XML files have 8 digits followed by the year (e.g. 00654321_2022.xml)
  • for TED schema notices the XML files have 6 digits followed by the year (e.g. 123456_2022.xml)


The Format of the URLs to download packages are as follows:

  • URL format for daily packages:

https://ted.europa.eu/packages/notice/daily/{yyyynnnnn}

where {yyyynnnnn} is the OJ S number.


Example - Download the daily package of the OJ S 1 / 2024:  https://ted.europa.eu/packages/daily/202400001

  • URL format for monthly packages:

https://ted.europa.eu/packages/notice/monthly/{yyyy-n}

where {yyyy-n} is the year and the month.

Example - Download the monthly package of January 2024:  https://ted.europa.eu/packages/monthly/2024-1

Download the release calendar

You can download the list of the OJ S releases per year via the page Release calendar on the TED website.


The format of the URLs to download the release calendar is as follows:

https://ted.europa.eu/{lang}/release-calendar/-/download/file/{format}/{year}

where:

  • {lang} is the language (e.g. en, de)
  • {format} can be: XLS, PDF, CSV
  • {year} is the year (e.g. 2023, 2024)


Example: https://ted.europa.eu/en/release-calendar/-/download/file/XLS/2024

TED subsets in CSV format

A subset of TED data covering the most important fields from contract notices and contract award notices in comma separated value (CSV) format is available at data.europa.eu/data/datasets/ted-csv?locale=en.

Fair usage policy on TED

Operation Limits
Visualize or download notices from a single IP 600 visualizations or downloads in less than 6 minutes
HTTP requests 700 requests in the last minute
Download daily or monthly packages HTTPS service 3 concurrent downloads

 

The architecture of the TED portal has been designed as follows:

- The Web pages are fully powered by a CMS enabling a better and tailored user experience. This CMS is efficient within a specific range of loads.

- A dedicated public API to search notices and direct link to download their contents which is efficient and scalable.

On this basis, the Publications Office strongly recommends that technical users use the public API to benefit from its performance and scalability and to leave CMS resources available for common users.