EU public tender search (TED)
Public procurement notices published in TED, the EU's official tenders journal (EU, EEA and other countries' buyers): search full text and filter by buyer country, CPV code (a shorter code matches the whole branch), notice type, contract nature, procedure type, buyer name, publication dates and tender deadline, sorted by newest, oldest or deadline. Each notice has publication number, title, notice and form type, publication date, buyer with country and city, CPV codes, contract nature, procedure, place of performance, tender deadline, estimated and total values, winners, description (in the chosen language when the notice has it) and links. Pass next_page back as page; null on the last page (up to 15,000 matches).
Every response includes credits_used: the credits this call cost.
Parameters
| name | type | description |
|---|---|---|
q | string | Full-text search words. Example: software |
country | string | Comma-separated buyer countries, 2-letter codes (DE, FR, IT, ES, PL, NO, CH, GB...). Example: DE |
cpv | string | Comma-separated CPV codes; fewer than 8 digits match every code that starts with them. Example: 48 |
notice_type | string | Comma-separated notice types, e.g. cn-standard (contract notice), can-standard (award), pin-only (prior information), veat, corr. |
contract_nature | services | supplies | works | combined | Contract nature. |
procedure_type | open | restricted | neg-w-call | neg-wo-call | comp-dial | innovation | oth-single | oth-mult | Procedure type. |
buyer | string | Words in the buyer's name. |
from | string | Published on or after (YYYY-MM-DD). |
to | string | Published on or before (YYYY-MM-DD). |
deadline_from | string | Tender deadline on or after (YYYY-MM-DD). |
deadline_to | string | Tender deadline on or before (YYYY-MM-DD). |
sort | newest | oldest | deadline | newest (default), oldest or deadline. |
lang | string | Language for titles and descriptions when the notice has it (en, de, fr, es, it, nl, pl, pt and the other EU languages). Example: en |
limit | integer | Notices per page, 1-100. Example: 20 |
page | integer | Page number, starting at 1. Pass next_page back as page; it is null on the last page. Example: 1 |
Every endpoint also takes fresh, raw, fields (see lean responses and caching).
Example
curl "https://api.api.sh/ted/v1/search?q=software" \
-H "x-api-key: $APISH_KEY" import os, requests
res = requests.get(
"https://api.api.sh/ted/v1/search",
params={"q": "software"},
headers={"x-api-key": os.environ["APISH_KEY"]},
timeout=120,
)
res.raise_for_status()
data = res.json() const url = new URL("https://api.api.sh/ted/v1/search");
url.searchParams.set("q", "software");
const res = await fetch(url, { headers: { "x-api-key": process.env.APISH_KEY } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json(); Response
A JSON object with the fields described above, plus raw (the source's own data), cached, fetched_at and credits_used. Errors return {"success": false, "error": "…"} with the HTTP status (see errors). A lookup that ran but found nothing (404) costs the price above; refused calls and errors on our side are free (what's charged).