apyhub
Back
▣ RETRIEVAL KIT

Search EU Public Tenders API

What it does

Search EU Tenders API helps businesses discover public procurement opportunities across European countries using data from Tenders Electronic Daily (TED), the European Union's official tender publication platform.

Search for tenders using keywords, countries, CPV codes, notice types, estimated contract values, publication dates, and submission deadlines. Filter results by language and open tender status to find relevant government contract opportunities.

Each result includes tender details such as the notice ID, title, contracting authority, buyer's location, contract value, CPV codes, publication date, submission deadline, and links to official notices and supporting documents.

POST
TED Scraper - EU Tenders Electronic Daily & Tender Alerts
https://api.eu.apyhub.com/martin10291/search-eu-tenders

QUICKSTART

GUIDE

Quickstart

Request

curl -X POST "YOUR_ENDPOINT_URL" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "keywords": ["software"],
    "maxItems": 2
  }'

Sample Response

{
  "billed": 2,
  "count": 2,
  "items": [
    {
      "noticeId": "796576-2026",
      "noticeType": "cn-standard",
      "noticeTypeLabel": "Contract notice",
      "title": "France – Software implementation services",
      "mainCpv": "72263000",
      "buyerName": "SOCIETE PUBLIQUE LOCALE DU STATIONNEMENT GRENOBLOIS",
      "buyerCity": "Grenoble",
      "buyerCountry": "FRA",
      "publishedAt": "2026-11-10",
      "deadline": "2026-12-14",
      "source": "TED",
      "url": "https://ted.europa.eu/..."
    }
  ]
}
TRY ITLIVE · 100 ATOMS
Loading your default key…
The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.
keywords
Keywords used to search tender notices.
countries
Countries to search using ISO country codes or English country names.
cpvCodes
CPV procurement codes. Broad codes also match their sub-codes.

About this endpoint

What it does

Searches the European Union's official Tenders Electronic Daily (TED) database and returns matching public procurement notices.

The endpoint supports filtering by keywords, countries, CPV codes, notice types, estimated contract value, publication date, language, and submission deadline. Results include tender details, contracting authority information, and links to official notices and supporting documents.

Request Body

ParameterTypeDescription
keywordsString ArrayKeywords used to search tender notices.
countriesString ArrayFilter by country using ISO country codes or English country names (e.g. DE, FR, Germany).
cpvCodesString ArrayFilter by Common Procurement Vocabulary (CPV) codes. Broad codes also match their sub-codes.
noticeTypesString ArrayNotice categories to include. Allowed values: contract-notices, prior-information, contract-awards. Empty or omitted means all notice types.
searchInStringSearch location. Allowed values: title, fullText.
languageStringLanguage for translated tender information. Supports 22 language codes accepted by the API.
maxItemsIntegerMaximum number of results to return. Minimum: 1, maximum: 100. Default: 20.
minValueNumberMinimum estimated contract value. Must be greater than or equal to 0. Tenders without a published estimated value are also retained.
postedWithinDaysIntegerReturn notices published within the specified number of days. Must be greater than or equal to 0.
onlyOpenTendersBooleanWhen true, returns only tenders with submission deadlines in the future.
includeDescriptionBooleanWhen true, includes the tender description where available. Default: false.

Supported Notice Types

ValueDescription
contract-noticesNew contract opportunities.
prior-informationAdvance information about upcoming procurement opportunities.
contract-awardsNotices announcing awarded contracts.

When noticeTypes is omitted or empty, all notice types are included.

Response

Returns a JSON object containing billed, count, and items.

ParameterTypeDescription
billedIntegerNumber of results charged for.
countIntegerNumber of matching tender records returned.
itemsObject ArrayArray of matching tender records containing the following fields.
items[].noticeIdStringTED's unique identifier for the tender notice.
items[].noticeTypeStringSpecific notice subtype code (e.g. cn-standard, can-modif, pin-rtl).
items[].noticeTypeLabelStringHuman-readable notice type (e.g. Contract notice). Currently returned in English regardless of the requested language.
items[].titleStringTender title. The category portion is translated according to the language filter, while the detailed project description remains in its original language.
items[].titleOriginalStringTender title in its original language.
items[].mainCpvStringPrimary procurement category code.
items[].cpvCodesString ArrayAll procurement category codes associated with the notice.
items[].buyerNameStringName of the contracting authority.
items[].buyerCityString or nullBuyer's city, when available.
items[].buyerCountryStringBuyer's country as a three-letter country code (e.g. FRA, DEU).
items[].buyerEmailString or nullBuyer's email address, when published.
items[].buyerWebsiteString or nullBuyer's website, when published.
items[].contractNatureStringType of contract, such as works, supplies, or services.
items[].procedureTypeStringProcurement procedure used, such as open or restricted.
items[].estimatedValueNumber or nullEstimated contract value. Null when not published.
items[].currencyString or nullCurrency of the estimated contract value.
items[].publishedAtString (Date)Date when the tender notice was published.
items[].deadlineString (Date) or nullTender submission deadline, when available.
items[].deadlineTimeString or nullSubmission deadline time, when provided.
items[].daysLeftInteger or nullNumber of days remaining until the submission deadline.
items[].placeOfPerformanceString or nullLocation where the contract work will be performed.
items[].documentsUrlsString ArrayLinks to supporting tender documents.
items[].pdfUrlStringLink to the official PDF notice.
items[].xmlUrlStringLink to the official XML notice.
items[].urlStringLink to the notice on the official TED website.
items[].scrapedAtString (Date-Time)Date and time when the scraper last retrieved the notice.
items[].sourceStringSource of the tender data. Always TED.
▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.