A procurement data API for EU's official TED journal: search government tenders by country, CPV code, date or open submission deadline. Returns clean, deduplicated JSON in 24 EU languages: buyer, value, deadlines, CPV codes and notice link. Includes tender notices, contract awards and corrigenda.
ISO 3166-1 alpha-3 codes of the buyer's country (e.g. DEU, FRA, ITA, ESP, NLD). Leave empty for all EU/EEA countries.
Type:array
Default:
[]
CPV codes
cpvCodes
Optional
Common Procurement Vocabulary codes to filter by, 8 digits (e.g. 72000000 for IT services, 45000000 for construction). Leave empty for all. IMPORTANT -- TED matches the whole CPV SUBTREE under each code you give, at every level, not the code itself: 72000000 also returns notices tagged only 72313000 or 72220000, and even a narrow code like 72267000 also returns its children 72267100/72267200. First measured 2026-09-21 on a 10-notice sample (6 carried the literal 72267000); re-measured live 2026-11-02 on a 100-notice sample from the last 365 days: 67 of 100 notices matched by 72267000 carried that literal code (35 carried the child 72267100, 3 carried 72267200), and only 36 of 100 matched by 72000000 carried 72000000 itself (e.g. notice 723769-2025 is tagged 72200000 and 79400000 only). So expect a third or more of your rows not to carry the code you asked for, and more of them the broader the code. There is no exact-code mode -- post-filter the cpvCodes output field yourself if you need one.
Type:array
Default:
[]
Notice types
noticeTypes
Optional
TED notice-type codes to filter by. This is TED's COMPLETE filterable notice-type vocabulary (all 22 codes; first established cycle 836, re-verified live cycle 2609 by exhausting TED's expert-search index: excluding all 22 leaves 0 notices over TED's whole history). Leave empty for all types. The common ones are cn-standard (contract notice, ~2.96M notices), can-standard (contract award notice, ~2.86M) and pin-only/pin-buyer/pin-rtl (prior information). Note there is no "pin-standard" code — TED rejects it — the prior-information notices are split across the six pin-* codes below. Two of the 22 are HISTORICAL-ONLY: "corr" and "subco" are still accepted as filter values and still match older notices (81,317 and 5 since 2023-01-01) but had 0 notices published in the last 365 days (measured live cycle 2852, 2026-11-07, re-proved live and unchanged cycle 3188, 2026-11-14 and again cycle 3524, 2026-11-21) — eForms retired them. Selecting only those needs "publicationDateFrom" set to an older date, because publishedWithinDays maxes out at 365 and so cannot reach them.
Type:string[]
Default:
[]
Procedure types
procedureType
Optional
TED procedure-type codes to filter by. This is TED's COMPLETE filterable procedure-type vocabulary (all 18 codes; first established cycle 836, updated cycle 1533, re-verified live cycle 2609: excluding all 18 codes from a search still returns 0 TED notices: the 8 modern eForms codes, 9 legacy pre-2023 single-character codes TED still accepts, plus comp-tend -- a real eForms code for public-passenger-transport competitive tendering under Regulation 1370/2007 that cycle 836's probe missed). Leave empty for all. Server-side filter, same OR-group as noticeTypes. Two upstream quirks: there is no "exp-int-rest" code (TED rejects it), and the value "7" DOES appear in the output 'procedureType' field on some older notices but TED's expert search refuses it as a filter value, so it cannot be selected here. Most notices older than ~2014 carry no procedure type at all. NINE of the 18 are HISTORICAL-ONLY: the legacy single-character codes 4, 9, V, E, Z, 6, A, F and 8 are still accepted and still match older notices (25,624 / 26,290 / 14,465 / 3,792 / 1,007 / 45 / 351 / 189 / 400 respectively since 2023-01-01) but every one had 0 notices published in the last 365 days (measured live cycle 2852, 2026-11-07, re-proved live and unchanged cycle 3188, 2026-11-14 and again cycle 3524, 2026-11-21) — the eForms cutover dried them up. Selecting only legacy codes needs "publicationDateFrom" set to an older date; publishedWithinDays maxes out at 365 and cannot reach them. The Actor warns about this at run start instead of just returning 0 rows. Every option count in this dropdown is an all-time TED total measured live on 2026-11-21 (cycle 3524); the live codes grow daily and the legacy ones drift slowly downward as TED prunes pre-2023 notices from its index, so treat them as of that date.
Type:string[]
Default:
[]
Published within (days)
publishedWithinDays
Optional
Only return notices published in the last N days. Ignored if publicationDateFrom or publicationDateTo is set.
Type:integer
Minimum:1
Maximum:365
Default:7
Published from (absolute date)
publicationDateFrom
Optional
YYYYMMDD or YYYY-MM-DD. Overrides 'Published within (days)' with an absolute historical window. Leave empty for no lower bound (with publicationDateTo set).
Type:string
Published to (absolute date)
publicationDateTo
Optional
YYYYMMDD or YYYY-MM-DD. Overrides 'Published within (days)'. Leave empty for no upper bound (with publicationDateFrom set). WATCH MODE WARNING: combined with watchLabel, a FIXED value here is a permanent dead end once the real date passes it -- publication-date is assigned once when TED publishes a notice and never revised afterward, so no notice can ever be dated on or before an already-passed cutoff again. Leave it unset in a watched query; publicationDateFrom alone is safe to keep. See README FAQ.
Type:string
Keywords (full-text)
keywords
Optional
Free-text search using TED's FT~ full-text operator. Example: "cloud hosting". First verified cycle 919: this matches against the WHOLE notice text TED indexes, not just title/description/buyer name -- a search for "software" matched a notice whose only occurrence of the word was in technical-capacity/selection-criteria text, not one of this Actor's output fields. Re-verified live 2026-11-02: still holds -- notice 681576-2026 (a Greek advertising-campaign-services tender) matched the same "software" search though the word appears in none of this Actor's output fields (title, description, buyer name, or any other exposed field). A returned row may not visibly contain your keyword anywhere in its output. Leave empty to match everything in your other filters.
Type:string
Expert query (advanced, overrides the filters above)
expertQuery
Optional
Raw TED expert-query string (same syntax as the TED website's expert search), e.g. "buyer-country=DEU AND classification-cpv=72000000 AND publication-date>=today(-30)". If set, this replaces countries/cpvCodes/noticeTypes/publishedWithinDays entirely.
Type:string
Max results
maxResults
Optional
Stop after this many notices.
Type:integer
Minimum:1
Maximum:5000
Default:100
Output language
outputLanguage
Optional
Preferred language for localized fields (title, description, buyer name, notice link). Falls back to English, then to whichever language TED provided, if this notice has no translation into the chosen language.
Only keep notices whose estimated/total contract value (the 'totalValue' output field) is at least this number. Compares the raw numeric value regardless of currency (TED reports EUR, CZK, RON, SEK etc. per notice — check 'totalValueCurrency' before comparing across countries). Roughly half of all TED notices carry no value at all; those are dropped whenever this filter is set. Leave empty for no minimum.
Type:integer
Max contract value
maxValue
Optional
Only keep notices whose estimated/total contract value is at most this number. Same currency caveat as 'Min contract value'. Leave empty for no maximum.
Type:integer
Only tenders still open for bids
onlyOpenDeadlines
Optional
Keep only notices whose submission deadline ('deadlineDate') is today or later, i.e. ones you can still bid on. Notices where TED published no deadline at all are dropped while this is on — award/result notices and many prior-information notices carry none, and an absent deadline cannot be shown to be open. Off by default (every matching notice, open or closed). Filtered-out notices are not charged.
Type:boolean
Default:false
Minimum days until deadline
minDaysUntilDeadline
Optional
Keep only notices with at least this many whole days left before the submission deadline, counted in Brussels local time — the zone every TED deadline is stamped in ('daysUntilDeadline' in the output). Use it to skip tenders you cannot realistically prepare a bid for: 14 drops anything closing inside two weeks. Implies the open-deadline filter (a passed deadline is negative), and drops notices with no published deadline. Leave empty for no deadline floor.
Type:integer
Minimum:0
Flatten array fields for CSV/Excel
flatten
Optional
Join the 4 array fields (CPV codes, contract nature, place of performance country/city) into a single comma-separated string instead of a JSON array. Off by default (JSON arrays); turn on if you're exporting to CSV/Excel and want one clean column per field instead of numbered field/0, field/1 columns.
Type:boolean
Default:false
Watch mode: label
watchLabel
Optional
Set a name (e.g. "my-cpv-watch") to turn this run into an alert: the FIRST run with a given label + filter combination records every currently-matching notice and returns nothing (you pay nothing). Every run after that returns and charges only for notices NOT already delivered under that label — ideal for a scheduled run that should only tell you what's new. Leave empty for a normal one-off search. Don't pair this with a FIXED publicationDateTo -- see that field's warning.
Type:string
Webhook URL (notify on completion)
webhookUrl
Optional
Optional. An http(s) URL to POST a small JSON summary to when the run finishes — notices pushed, pages scanned, TED's own reported total, watch-label new count if Watch mode label is set, and the run's dataset ID so you can fetch the results. A convenience for callers who want a completion ping without setting up an Apify platform webhook (which needs separate Console/API configuration per Task, not per run). Best-effort: a failed or slow webhook is logged as a warning and never fails the run or affects charging — it fires after every notice has already been pushed and charged. Leave empty to skip.