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, Non-signed PDF and XML.


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
  • xml: to download the notice as 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.