# TED Tenders Scraper: EU Public Procurement Notices API (`rowcraft/ted-tenders-scraper`) Actor

EU public procurement notices from TED (Tenders Electronic Daily), the official EU tenders portal, through its public Search API: title, buyer, country, CPV codes, values, deadlines, lots and document links. Filter by country, CPV, stage, text and date. Pay per notice, no personal data.

- **URL**: https://apify.com/rowcraft/ted-tenders-scraper.md
- **Developed by:** [Rowcraft](https://apify.com/rowcraft) (community)
- **Categories:** Business, Lead generation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.00 / 1,000 tender notices

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## TED Tenders Scraper: EU Public Procurement Notices API

Get EU public procurement notices from **TED (Tenders Electronic Daily)**, the official portal where every tender above the EU thresholds is published. This **TED tenders scraper** reads the portal's **public Search API**, so it is fast, complete and does not break when a web page changes. Each notice comes back as one flat row: title, buyer, country, CPV codes, estimated and awarded values, deadlines, lots and links to the notice, its PDF and XML, as JSON, CSV or Excel.

Filter by country, CPV code, stage (calls for tenders, awards, planning), full text, dates, value and EU funding, or paste a TED expert query. Schedule it with **Only new rows** to get a daily feed of new tenders for the price of the new rows.

![Input form of TED Tenders Scraper: EU Public Procurement Notices API](https://api.apify.com/v2/key-value-stores/7hbQFQdGq61v2OZ2h/records/ted-tenders-scraper-input.png)

### What you get

One row per notice, the same columns for every country and language:

- **Notice:** publication number, notice type and stage, version, publication and dispatch dates, links to the notice page, PDF and XML
- **Title:** in the language you choose (TED translates titles into all 24 official EU languages) and in the original language, plus the procedure title
- **Buyer:** name, country, city, postcode, registration number, legal type, main activity, website and buyer profile, never a contact person
- **Classification:** main and additional CPV codes with the CPV division name, contract nature (works, supplies, services), procedure type, legal basis, framework agreement, GPA coverage, SME suitability, reserved procurement
- **Place:** NUTS codes, countries and cities of performance
- **Money:** estimated value (procedure or sum of lots) and awarded value with currency, values per lot
- **Dates:** tender deadline with time, request deadline, contract conclusion, duration, start and end
- **Lots and texts:** number of lots, lot identifiers and titles, procedure and lot descriptions, change descriptions for corrigenda, EU funding flag

### Why this actor

- **Official API, iteration mode:** the Search API's iteration mode is used, so there is no 15,000-result cap and pages stay consistent while new notices arrive.
- **Filters that read like the TED form:** country names or codes, CPV prefixes (72 covers all IT services), stage, nature, dates such as `7 days`, open-for-tenders only, minimum value, EU funds, or your own expert query.
- **Nearly 80 flat fields** with stable names, labels next to every code, numbers as numbers, dates in ISO format.
- **Count before you pay:** **Count only** shows how many notices match and what they would be charged; nothing is delivered.
- **Contact persons, winners and tenderers are never requested;** you pay per delivered notice, with a charge cap.

### How to use it

1. Open the Actor and fill in **Buyer countries** (the other fields are optional filters).
2. Set **Maximum notices** to a small number for a first try (the default is a safe start).
3. Optional: tick **Count only** and start once. You get the number of matching rows and the estimated cost, for free (only the start event is charged). Untick it to get the data.
4. Click **Start**. The status line shows progress; the run stops cleanly at your limit or at the charge limit you set in the run options.
5. Open the **Dataset** tab and download JSON, CSV, Excel, XML or HTML, or send the rows to Google Sheets, Slack, Make, n8n or Zapier with the Integrations tab.
6. To run it on a schedule, use **Schedules** in Apify Console and turn on **Only new rows since the last run** below: every run then costs only the new rows, and a webhook URL tells you when something new came in.

### Input

| Field | What it does |
|---|---|
| `countries` | Buyer countries: names or ISO codes (`Germany`, `DE`, `DEU`), one per line; empty = all |
| `text`, `cpv`, `formTypes`, `contractNatures` | Full text (`software OR hardware`), CPV codes or prefixes, stage, works/supplies/services |
| `publishedAfter`, `publishedBefore`, `openOnly`, `scope` | Dates (`2026-10-01`, `yesterday`, `7 days`, `3 months`), only notices still open, active notices or the whole archive |
| `buyerName`, `placeOfPerformance`, `procedureTypes`, `minValue`, `euFundedOnly` | Buyer name contains, country or NUTS region of performance, procedure, minimum value, EU funds |
| `sort`, `language`, `maxItems`, `includeDescription`, `includeLots` | Newest, oldest, highest value or relevance; language of titles and descriptions; limits and text fields |
| `query`, `publicationNumbers` | A TED expert query instead of the filters; or specific notices by publication number or link |
| `countOnly`, `onlyNew`, `stateName`, `notifyUrl`, `notifyWhenEmpty` | Count only (deliver nothing); see **Automation** below |

**Expert queries** use the TED search language: `buyer-country=FRA AND classification-cpv=72* AND publication-date>=today(-30)`, with `FT~"data centre"` for full text and `SORT BY estimated-value-proc DESC` for ordering. When `query` is set the filter fields are ignored; `scope`, `sort` and the output options still apply.

Example: open calls for tenders for IT services in Germany and Austria from the last two weeks, biggest first.

```json
{
  "countries": ["Germany", "Austria"],
  "cpv": ["72"],
  "formTypes": ["competition"],
  "publishedAfter": "2 weeks",
  "openOnly": true,
  "sort": "value",
  "maxItems": 200
}
```

### Output

78 fields per row. Empty values are `null`, never missing, so CSV and Excel columns are stable.

| Field | Type | Example |
|---|---|---|
| `id` | string | 696546-2026 |
| `url` | string | `https://ted.europa.eu/en/notice/-/detail/696546-2026` |
| `pdfUrl` | string | `https://ted.europa.eu/en/notice/696546-2026/pdf` |
| `xmlUrl` | string | `https://ted.europa.eu/en/notice/696546-2026/xml` |
| `publicationNumber` | string | 696546-2026 |
| `noticeId` | string | 592659fa-96c2-4454-8464-282c2a0fa89a |
| `ojsIssue` | string | 196/2026 |
| `noticeType` | string | cn-standard |
| `noticeTypeLabel` | string | Contract notice |
| `formType` | string | competition |
| `formTypeLabel` | string | Competition (contract notice, call for tenders) |
| `noticeVersion` | integer | 1 |
| `publishedAt` | string | 2026-10-09 |
| `dispatchedAt` | string | 2026-10-08 |
| `title` | string | Germany – Refuse and waste related services – Ballierung von Haus- … |
| `titleLanguage` | string | eng |
| `titleOriginal` | string | Deutschland – Dienstleistungen im Zusammenhang mit Siedlungs- und a… |
| `procedureTitle` | string | Ballierung von Haus- und Gewerbeabfall in Revisionszeiten |
| `originalLanguage` | string | deu |
| `buyerName` | string | EVS Gesellschaft für Abfallwirtschaft mbH |
| `buyerNames` | array | All buyers (joint procurement) |
| `buyerCountry` | string | DEU |
| `buyerCountryName` | string | Germany |
| `buyerCity` | string | Saarbrücken |
| `buyerPostcode` | string | 66117 |
| `buyerRegistrationNumber` | string | Berichtseinheit-ID 00006142 |
| `buyerLegalType` | string | body-pl-la |
| `buyerLegalTypeLabel` | string | Body governed by public law, controlled by a local authority |
| `buyerMainActivity` | string | env-pro |
| `buyerMainActivityLabel` | string | Environmental protection |
| `buyerWebsite` | string | `https://www.evs.de` |
| `buyerProfileUrl` | string | Buyer profile URL |
| `contractNature` | string | services |
| `contractNatures` | array | \["services"] |
| `procedureType` | string | open |
| `procedureTypeLabel` | string | Open procedure |
| `procedureAccelerated` | boolean | False |
| `legalBasis` | array | \["32014L0024"] |
| `cpvMainCode` | string | 90500000 |
| `cpvDivision` | string | Sewage, refuse, cleaning and environmental services |
| `cpvCodes` | array | \["90500000"] |
| `cpvAdditionalCodes` | array | Additional CPV codes |
| `placeNutsCodes` | array | \["DEC03"] |
| `placeCountries` | array | \["DEU"] |
| `placeCities` | array | \["Neunkirchen"] |
| `estimatedValue` | number | 1521621.97 |
| `estimatedValueCurrency` | string | EUR |
| `estimatedValueIsSumOfLots` | boolean | False |
| `lotEstimatedValues` | array | \[104504.39, 95546.89] |
| `awardedValue` | number | 495484 |
| `awardedValueCurrency` | string | EUR |
| `lotAwardedValues` | array | Awarded value per lot |
| `deadline` | string | 2026-10-20 |
| `deadlineTime` | string | 10:00:00+02:00 |
| `deadlines` | array | \["2026-10-20"] |
| `requestDeadline` | string | Deadline for requests to participate |
| `contractConclusionDate` | string | 2026-10-06 |
| `durationValue` | number | 12 |
| `durationUnit` | string | MONTH |
| `contractStart` | string | 2027-01-01 |
| `contractEnd` | string | 2028-12-31 |
| `frameworkAgreement` | string | none |
| `frameworkAgreementLabel` | string | No framework agreement |
| `euFunded` | boolean | False |
| `gpaCovered` | boolean | True |
| `smeSuitable` | boolean | True |
| `reservedProcurement` | string | none |
| `submissionUrl` | string | `https://www.subreport.de/E16878761` |
| `documentsUrl` | string | `https://www.subreport.de/E16878761` |
| `changeReason` | string | cor-pub |
| `lotsCount` | integer | 1 |
| `lotIds` | array | \["LOT-0001"] |
| `lotTitles` | array | Lot titles |
| `description` | string | Procedure description |
| `descriptionLanguage` | string | deu |
| `lotDescriptions` | array | Lot descriptions |
| `changeDescription` | string | Description of the change (corrigenda) |
| `scrapedAt` | string | Scraped at |

#### Example rows

Two real rows from a run (long texts shortened here, complete in the dataset):

```json
[
  {
    "id": "697868-2026",
    "url": "https://ted.europa.eu/en/notice/-/detail/697868-2026",
    "pdfUrl": "https://ted.europa.eu/en/notice/697868-2026/pdf",
    "xmlUrl": "https://ted.europa.eu/en/notice/697868-2026/xml",
    "publicationNumber": "697868-2026",
    "noticeId": "e041cf24-e4af-4327-bbbd-42647a8aa8cd",
    "ojsIssue": "196/2026",
    "noticeType": "cn-standard",
    "noticeTypeLabel": "Contract notice",
    "formType": "competition",
    "formTypeLabel": "Competition (contract notice, call for tenders)",
    "noticeVersion": 1,
    "publishedAt": "2026-10-09",
    "dispatchedAt": "2026-10-08",
    "title": "Germany – Engineering-design services for traffic installations – A4, Fahrbahnerneuerung AS Uhyst - AS Salzenforst, beide RF Objektplanun…",
    "titleLanguage": "eng",
    "titleOriginal": "Deutschland – Technische Planungsleistungen für Verkehrsanlagen – A4, Fahrbahnerneuerung AS Uhyst - AS Salzenforst, beide RF Objektplanun…",
    "procedureTitle": "A4, Fahrbahnerneuerung AS Uhyst - AS Salzenforst, beide RF Objektplanung Lph. 1-6",
    "originalLanguage": "deu",
    "buyerName": "Die Autobahn GmbH des Bundes - NL Ost",
    "buyerNames": [
      "Die Autobahn GmbH des Bundes - NL Ost"
    ],
    "buyerCountry": "DEU",
    "buyerCountryName": "Germany",
    "buyerCity": "Halle (Saale)",
    "buyerPostcode": "06112",
    "buyerRegistrationNumber": "USt-ID DE329214156",
    "buyerLegalType": "pub-undert",
    "buyerLegalTypeLabel": "Public undertaking",
    "buyerMainActivity": "gen-pub",
    "buyerMainActivityLabel": "General public services",
    "buyerWebsite": "https://www.autobahn.de",
    "buyerProfileUrl": "https://vergabe.autobahn.de",
    "contractNature": "services",
    "contractNatures": [
      "services"
    ],
    "procedureType": "open",
    "procedureTypeLabel": "Open procedure",
    "procedureAccelerated": false,
    "legalBasis": [
      "32014L0024"
    ],
    "cpvMainCode": "71322500",
    "cpvDivision": "Architectural, construction, engineering and inspection services",
    "cpvCodes": [
      "71322500",
      "71322300",
      "71327000",
      "… 3 more"
    ],
    "cpvAdditionalCodes": [
      "71322300",
      "71327000",
      "71322000",
      "… 2 more"
    ],
    "placeNutsCodes": [
      "DED21",
      "DEU",
      "DED2C"
    ],
    "placeCountries": [
      "DEU"
    ],
    "placeCities": [
      "Dresden",
      "Uhyst am Taucher",
      "Salzenforst"
    ],
    "estimatedValue": 395546.02,
    "estimatedValueCurrency": "EUR",
    "estimatedValueIsSumOfLots": false,
    "lotEstimatedValues": [
      332391.61
    ],
    "awardedValue": 395546.02,
    "awardedValueCurrency": "EUR",
    "lotAwardedValues": [],
    "deadline": "2026-10-20",
    "deadlineTime": "10:00:00+02:00",
    "deadlines": [
      "2026-10-20"
    ],
    "requestDeadline": null,
    "contractConclusionDate": null,
    "durationValue": null,
    "durationUnit": null,
    "contractStart": "2026-12-23",
    "contractEnd": "2027-06-25",
    "frameworkAgreement": "none",
    "frameworkAgreementLabel": "No framework agreement",
    "euFunded": false,
    "gpaCovered": true,
    "smeSuitable": true,
    "reservedProcurement": "none",
    "submissionUrl": "https://vergabe.autobahn.de",
    "documentsUrl": "https://vergabe.autobahn.de/NetServer/TenderingProcedureDetails?function=_Details&TenderOID=54321-Tender-19ffa084b1c-2ff70e063f44ac9f",
    "changeReason": "update-add",
    "lotsCount": 1,
    "scrapedAt": "2026-10-10T04:05:57.289Z",
    "lotIds": [
      "LOT-0000"
    ],
    "lotTitles": [
      "A4, Fahrbahnerneuerung AS Uhyst - AS Salzenforst, beide RF Objektplanung Lph. 1-6"
    ],
    "description": "A4, FBE A4o, AS Uhyst - AS Salzenforst, beide RF Objektplanung Lph 1-6",
    "descriptionLanguage": "deu",
    "lotDescriptions": [
      "A1029700101 - Grobmengen -Objektplanung Verkehrsanlagen Lph. 1, 2, 3, 5 und 6 für Sanierungsmaßnahme im Bereich der Fahrbahn A4ost, FBE A…"
    ],
    "changeDescription": null
  },
  {
    "id": "698902-2026",
    "url": "https://ted.europa.eu/en/notice/-/detail/698902-2026",
    "pdfUrl": "https://ted.europa.eu/en/notice/698902-2026/pdf",
    "xmlUrl": "https://ted.europa.eu/en/notice/698902-2026/xml",
    "publicationNumber": "698902-2026",
    "noticeId": "4cdd8304-17b4-4048-a198-99b296dfc0df",
    "ojsIssue": "196/2026",
    "noticeType": "cn-standard",
    "noticeTypeLabel": "Contract notice",
    "formType": "competition",
    "formTypeLabel": "Competition (contract notice, call for tenders)",
    "noticeVersion": 1,
    "publishedAt": "2026-10-09",
    "dispatchedAt": "2026-10-07",
    "title": "Poland – Software package and information systems – Wdrożenie e-Usług w Gminie Sompolno",
    "titleLanguage": "eng",
    "titleOriginal": "Polska – Pakiety oprogramowania i systemy informatyczne – Wdrożenie e-Usług w Gminie Sompolno",
    "procedureTitle": "Wdrożenie e-Usług w Gminie Sompolno",
    "originalLanguage": "pol",
    "buyerName": "Gmina Sompolno",
    "buyerNames": [
      "Gmina Sompolno"
    ],
    "buyerCountry": "POL",
    "buyerCountryName": "Poland",
    "buyerCity": "Sompolno",
    "buyerPostcode": "62-610",
    "buyerRegistrationNumber": "NIP: 665-295-52-83, REGON: 311019272, TERYT: 3010104",
    "buyerLegalType": "la",
    "buyerLegalTypeLabel": "Local authority",
    "buyerMainActivity": "gen-pub",
    "buyerMainActivityLabel": "General public services",
    "buyerWebsite": "https://bipsompolno.pl/",
    "buyerProfileUrl": "https://ezamowienia.gov.pl/mp-client/search/list/ocds-148610-c11f85e5-454b-4a78-b244-1e940d83de9a",
    "contractNature": "supplies",
    "contractNatures": [
      "supplies",
      "services"
    ],
    "procedureType": "open",
    "procedureTypeLabel": "Open procedure",
    "procedureAccelerated": false,
    "legalBasis": [
      "32014L0024"
    ],
    "cpvMainCode": "48000000",
    "cpvDivision": "Software package and information systems",
    "cpvCodes": [
      "48000000",
      "48422000",
      "48600000",
      "… 5 more"
    ],
    "cpvAdditionalCodes": [
      "48422000",
      "48600000",
      "48900000",
      "… 4 more"
    ],
    "placeNutsCodes": [
      "PL414",
      "POL"
    ],
    "placeCountries": [
      "POL"
    ],
    "placeCities": [
      "Sompolno"
    ],
    "estimatedValue": 1290750,
    "estimatedValueCurrency": "PLN",
    "estimatedValueIsSumOfLots": false,
    "lotEstimatedValues": [
      1290750
    ],
    "awardedValue": 1290750,
    "awardedValueCurrency": "PLN",
    "lotAwardedValues": [],
    "deadline": "2026-10-13",
    "deadlineTime": "10:00:00+02:00",
    "deadlines": [
      "2026-10-13"
    ],
    "requestDeadline": null,
    "contractConclusionDate": null,
    "durationValue": 210,
    "durationUnit": "DAY",
    "contractStart": null,
    "contractEnd": null,
    "frameworkAgreement": "none",
    "frameworkAgreementLabel": "No framework agreement",
    "euFunded": true,
    "gpaCovered": true,
    "smeSuitable": true,
    "reservedProcurement": "none",
    "submissionUrl": "https://ezamowienia.gov.pl/mp-client/search/list/ocds-148610-c11f85e5-454b-4a78-b244-1e940d83de9a",
    "documentsUrl": "https://ezamowienia.gov.pl/mp-client/search/list/ocds-148610-c11f85e5-454b-4a78-b244-1e940d83de9a",
    "changeReason": "update-add",
    "lotsCount": 1,
    "scrapedAt": "2026-10-10T04:05:58.356Z",
    "lotIds": [
      "LOT-0001"
    ],
    "lotTitles": [
      "Wdrożenie e-Usług w Gminie Sompolno"
    ]
  }
]
```

Results can be downloaded as JSON, CSV, Excel, XML or HTML from the Dataset tab, or read through the Apify API.

![Results of TED Tenders Scraper: EU Public Procurement Notices API in the Apify dataset view](https://api.apify.com/v2/key-value-stores/7hbQFQdGq61v2OZ2h/records/ted-tenders-scraper-results.png)

### Pricing

**Pay per result.** You pay for each notice delivered to your dataset, nothing else: no subscription, no minimum, no charge for rows your filters drop or for the requests behind them.

| Your Apify plan | Price per 1,000 rows | Price per row |
|---|---|---|
| Free plan | **$3.00** | $0.003 |
| Starter plan | **$2.67** | $0.00267 |
| Scale plan | **$2.33** | $0.00233 |
| Business plan and above | **$2.00** | $0.002 |

Example: 1,000 notices cost $3.00 on the Free plan and $2.00 on the Business plan. The Apify platform usage of a run (compute, storage) is small for this actor — well under one cent per 1,000 rows — and is billed by Apify separately, as for every Actor.
A start event of $0.00005 is charged once per run (Apify default).
**Cap your spend:** set *Maximum total charge* in the run options. The actor stops cleanly when the cap is reached and you keep everything delivered until then. The run summary (`RUN_SUMMARY` in the key-value store) says why a run stopped.
**Check before you pay:** turn on **Count only** to see how many rows match and what they would cost at your tier. That run delivers nothing and costs only the start event.

### Automation: only new rows, notifications, schedules

**Only new rows since the last run.** Turn on `onlyNew` and the actor remembers every notice it delivered to you (in a key-value store named `rowcraft-ted-tenders-scraper-state` in your Apify account). The next run with the same `stateName` skips what you already have and you pay only for new rows. The first run delivers everything that matches. Use a different `stateName` for each schedule or search so they keep separate memories.

**Notification when the run ends.** Put a webhook address in `notifyUrl` and the actor sends one JSON POST with the number of new rows, links to the dataset (JSON and CSV) and the run. It works out of the box with Slack and Discord incoming webhooks (the message is in `text` and `content`), with Make, n8n and Zapier catch hooks, and with your own endpoint. By default it is sent only when there is at least one new row; `notifyWhenEmpty` sends it every time.

**Schedules.** Create a schedule in Apify Console (hourly, daily, weekly or cron) with `onlyNew` on. A daily schedule gives you a feed of new notices for the price of the new rows only.

**Integrations.** Send the results to Make, n8n, Zapier, Google Sheets, Slack, Google Drive, Airtable or any webhooks from the Integrations tab of the Actor, with no code. Apify also offers native actions for Make, n8n and Zapier.

**API, SDKs and AI agents.** Every run is available through the Apify API and the official JavaScript and Python clients; the Actor can also be called by AI agents through the Apify MCP server. The example input in the API tab is a working call.

**Count only.** `countOnly` returns the number of matching notices and the estimated cost without delivering anything, so you can size a job before paying for it.

### Use cases

- **Tender monitoring:** a daily feed of new calls in your countries and CPV codes, with deadlines, straight into Slack or a sheet.
- **Market and competitor intelligence:** who buys what, in which region, for how much; award notices show the contract values.
- **Lead generation for suppliers and consultants:** buyers that publish planning notices today are the tenders of next quarter.
- **Research and journalism:** values, procedures and EU funding across countries and years, back to the archive.

Ready-made examples, each with the input filled in (open one and press Start, or save it as your own task):

- [Find open IT service tenders in Germany on TED](https://apify.com/rowcraft/ted-tenders-scraper/examples/open-it-tenders-germany)
- [Find open construction tenders in France on TED](https://apify.com/rowcraft/ted-tenders-scraper/examples/construction-tenders-france)
- [Find open medical equipment tenders in the EU](https://apify.com/rowcraft/ted-tenders-scraper/examples/medical-equipment-tenders-eu)
- [See EU IT service contracts awarded this month](https://apify.com/rowcraft/ted-tenders-scraper/examples/it-contract-awards-eu-buyers)

### What this actor does not do

- Deliver winners, tenderers, contact persons, e-mail addresses or phone numbers: these fields are never requested from the API.
- Read the full notice documents (specifications, annexes) or the eTendering files; each row links to the notice, its PDF and XML.
- Search national portals below the EU thresholds; TED holds the notices sent to the EU Publications Office.
- Log in, use proxies or solve CAPTCHAs: the public API needs none of that.

### Limits and fair use

- One request per second by default, 500 ms at the lowest, in line with the TED API fair-use policy. Each request returns up to about 150 notices (the API caps fields times notices at 10,000 per page), so 1,000 notices take about 7 seconds of requests.
- The API itself limits a query to 250 notices per page and the actor pages through the result set with the iteration mode (no result cap). Very broad queries without `maxItems` can mean many thousands of notices; set a limit or a charge cap for a first try.
- Notices published before 2024 (the eForms switch) have fewer fields: no notice identifier, no procedure title, no descriptions or lots; the title, buyer, CPV, values and dates are there.
- If the API answers with a rate limit or an error page the actor waits and retries; after repeated failures it stops and keeps what it delivered (see the run summary).

### Data source

The data comes from the [TED Search API](https://docs.ted.europa.eu/api/latest/index.html) (version 3), the public interface of [ted.europa.eu](https://ted.europa.eu/) operated by the Publications Office of the European Union. No key, login or cookie is needed and no path excluded by robots.txt is read. According to the [TED legal notice](https://ted.europa.eu/en/legal-notice) and [Commission Decision 2011/833/EU](https://eur-lex.europa.eu/legal-content/EN/TXT/?uri=CELEX:32011D0833), the notices may be reused, including for commercial purposes, with the source acknowledged; the TED logo is not reused. Each row links to the original notice. Rowcraft is independent and not affiliated with the Publications Office or TED; the names belong to their owners. CPV codes follow the [Common Procurement Vocabulary](https://ted.europa.eu/en/simap/cpv).

### Privacy: no personal data

Rowcraft actors are built not to collect personal data:

- Only notice, buyer-organisation and classification fields are requested from the API. Fields about people, including winners, tenderers, contact points, e-mail addresses and telephone numbers, are not part of the request, so they never reach the dataset.
- E-mail addresses, phone numbers and `mailto:` or `tel:` links that appear inside free-text descriptions are removed before the row is saved.

You are responsible for using the data in line with the law that applies to you.

### Other Rowcraft actors

All Rowcraft actors read official or public sources, deliver flat rows without personal data and support only-new runs and notifications:

- [Ashby Jobs Scraper – Job Postings with Salary Ranges](https://apify.com/rowcraft/ashby-jobs-scraper) — Job postings from Ashby job boards (jobs.ashbyhq.com) by company: title, department, team, locations with country, employment and workplace type, published salary range, full text.
- [Broken Link Checker – Find 404s and Dead Links API](https://apify.com/rowcraft/broken-link-checker) — Pay per crawled page, not per link: crawl a site within robots.txt and check every link on each page for 404s, 5xx errors, DNS and TLS failures and redirects.
- [Career Site Jobs Scraper: Greenhouse, Lever, Ashby, Workday](https://apify.com/rowcraft/career-site-jobs-scraper) — Job listings from the career pages of the companies you choose on Greenhouse, Lever, Ashby, Workday, Workable, Personio, Recruitee, Teamtailor and Gem, in one run and one format: title, locations, department, salary when published, full text.
- [Chrome Web Store Scraper: Users, Ratings & Versions](https://apify.com/rowcraft/chrome-web-store-scraper) — Reads public Chrome Web Store listing pages with no login, no proxy and no personal data: users, rating, category, version, update date, permissions and company developers.
- [Domain Email and DNS Checker API: MX, SPF, DMARC, Providers](https://apify.com/rowcraft/domain-email-dns-checker) — Find which email provider, sending services and DNS host each domain uses, from public DNS records only.
- [SIRENE France Company Scraper: SIREN, NAF, Revenue, Status](https://apify.com/rowcraft/france-company-register) — French companies from the official Recherche d'entreprises API (INSEE SIRENE + INPI): SIREN and SIRET, legal form, NAF activity, head-office address, employee band, revenue and net income, labels, creation date and VAT number.
- [Gem Jobs Scraper – Job Board Listings from jobs.gem.com](https://apify.com/rowcraft/gem-jobs-scraper) — Job listings from Gem job boards (jobs.gem.com) by company: title, department, offices with country, employment type, remote, hybrid or on-site, requisition ID, publication date and full ad text, from the public Gem Job Board API.
- [Google Play Apps Scraper: App Details, Installs, Ratings](https://apify.com/rowcraft/google-play-apps-scraper) — Public Google Play app details as flat rows: installs, rating, number of ratings, price, version, last update, minimum Android, ads and in-app purchases.
- [Greenhouse Jobs Scraper – Job Listings by Company Board](https://apify.com/rowcraft/greenhouse-jobs-scraper) — Job listings from Greenhouse job boards by company: title, departments, offices, publication date, full ad text, published pay ranges.
- [Himalayas Jobs Scraper: Remote Jobs API with Salaries](https://apify.com/rowcraft/himalayas-jobs-scraper) — Remote jobs from Himalayas through its public jobs API: title, company, salary range, seniority, categories, the countries and time zones open to candidates, full description and job link.
- [KRS Poland Companies Scraper: Register Data, PKD, Status](https://apify.com/rowcraft/krs-poland-companies) — Polish companies from the official KRS register API of the Ministry of Justice: name, KRS, NIP and REGON numbers, legal form, status, address, PKD activity codes, share capital, branches and registration dates.
- [LEI Records Scraper: Legal Entity Identifier Lookup API](https://apify.com/rowcraft/lei-records-scraper) — Legal Entity Identifier (LEI) records from the Global LEI Index, read through the public GLEIF API: legal name, legal form, register number, addresses, status, renewal date and parent companies.
- [Lever Jobs Scraper – Job Postings from jobs.lever.co](https://apify.com/rowcraft/lever-jobs-scraper) — Job postings from Lever career pages (jobs.lever.co) by company: title, team, department, location, commitment, workplace type, salary range when published, description, requirements and benefits.
- [Norway Company Register Scraper: Brønnøysund Business Data](https://apify.com/rowcraft/norway-company-register-scraper) — Norwegian companies from the Central Coordinating Register for Legal Entities (Brønnøysund, NLOD open data): organisation number, legal form, industry, employees, share capital, addresses, website, VAT and bankruptcy status.
- [Personio Jobs Scraper: Job Listings, Salaries, Departments](https://apify.com/rowcraft/personio-jobs-scraper) — Job ads from any company's Personio careers feed: title, department, office, employment type, schedule, seniority, salary when published, keywords and the full description in the language you choose.
- [Platsbanken Scraper: Sweden Jobs, Employers, Org Numbers](https://apify.com/rowcraft/platsbanken-jobs-scraper) — Every job ad on Platsbanken (Arbetsförmedlingen) from the official JobTech API: headline, employer and organisation number, occupation codes, municipality, coordinates, salary type, deadline and full text.
- [Recruitee Jobs Scraper – Job Listings by Company Career Site](https://apify.com/rowcraft/recruitee-jobs-scraper) — Job listings from Recruitee career sites by company: title, department, locations with country, employment type, remote flag, published salary and full text, one request per company.
- [Robots.txt and AI Crawler Access Checker API](https://apify.com/rowcraft/robots-ai-crawler-checker) — Check which AI and search crawlers a website lets in: GPTBot, ClaudeBot, PerplexityBot, Google-Extended and more, read from robots.txt by the RFC 9309 rules.
- [RSS Feed Finder and Reader – Blog and News Article API](https://apify.com/rowcraft/rss-feed-finder-reader) — Find the RSS, Atom and JSON feeds of any website and read their newest articles, from a domain name alone.
- [SEO Audit Tool: Titles, Meta Tags, Headings and Links API](https://apify.com/rowcraft/seo-audit-tool) — Audit the on-page SEO of any list of pages or websites: titles, meta descriptions, headings, canonicals, indexing, links, images and structured data, with a score and the issues found per page.
- [Shopify Products Scraper: Store Catalog Export to JSON, CSV](https://apify.com/rowcraft/shopify-products-scraper) — Products from any Shopify store's public catalog: title, vendor, type, tags, description, variants with price, compare-at price, SKU and stock, images, options, store currency.
- [Sitemap URL Extractor: Every Page with Last-Modified Dates](https://apify.com/rowcraft/sitemap-url-extractor) — Get every page a site lists in its sitemaps, with last-modified dates, from robots.txt through sitemap indexes and .gz files.
- [SSL Certificate and Security Headers Checker API](https://apify.com/rowcraft/ssl-security-headers-checker) — Check the TLS certificate and the HTTP security headers of every domain in one run, with an A+ to F grade and the exact issues to fix.
- [Store Products Scraper – Shopify, WooCommerce, VTEX](https://apify.com/rowcraft/store-products-scraper) — Export the product catalogue of any Shopify, WooCommerce or VTEX store from its public catalogue endpoint: title, brand, prices, discounts, stock, categories, images and links, one row per product, the same columns on every platform.
- [Structured Data Extractor: JSON-LD, Schema.org, Open Graph](https://apify.com/rowcraft/structured-data-extractor) — Pull the schema.org JSON-LD, Microdata, RDFa and Open Graph of any page list into flat rows: types, product price, availability, ratings, organization, breadcrumbs, with validation issues.
- [Teamtailor Jobs Scraper – Career Site Jobs by Company](https://apify.com/rowcraft/teamtailor-jobs-scraper) — Job listings from Teamtailor career sites by company: title, department, role, locations with city and country, remote or hybrid status, publication date and full ad text, from the official job feed.
- [UK Companies House Scraper: Company Search & Profiles API](https://apify.com/rowcraft/uk-companies-house-scraper) — UK companies from the official Companies House API with your free key: search by name, status, type, SIC code, date or location, or look up company numbers.
- [UK Tenders Scraper: Find a Tender + Contracts Finder API](https://apify.com/rowcraft/uk-tenders-scraper) — UK public procurement notices from Find a Tender and Contracts Finder, the official UK government portals, through their open OCDS APIs: title, buyer, region, CPV codes, values, deadlines, notice type and links.
- [Bulk URL Status and Redirect Chain Checker API](https://apify.com/rowcraft/url-status-redirect-checker) — Check the status code, redirect chain, canonical and indexing signals of every URL in a list, with the final destination and a loop flag.
- [VTEX Products Scraper – Public Catalog Export](https://apify.com/rowcraft/vtex-products-scraper) — Export the catalogue of any VTEX store (Auchan, Chedraui and thousands of retailers in Europe and Latin America) from its public search endpoint: title, brand, EAN, prices, list prices, stock, categories, specifications and images, one row per product.
- [Website Tech Stack Detector – Technology Lookup API](https://apify.com/rowcraft/website-tech-stack-detector) — Find the technologies behind a list of websites: CMS, e-commerce platform, analytics, tag managers, ad pixels, consent tools, chat, CDN and payments, from one polite home-page request per domain.
- [WooCommerce Products Scraper – Store API Export](https://apify.com/rowcraft/woocommerce-products-scraper) — Export every product of a WooCommerce store through its public Store API: title, SKU, prices and sale prices, stock, categories, tags, attributes, ratings, images and links, one row per product.
- [Workable Jobs Scraper: Job Listings from Career Pages](https://apify.com/rowcraft/workable-jobs-scraper) — Job listings from any company's Workable career page: title, department, location, remote or on-site, employment type, description, requirements, benefits and salary when published.
- [Workday Jobs Scraper – Jobs from myworkdayjobs.com Sites](https://apify.com/rowcraft/workday-jobs-scraper) — Job listings from Workday career sites (myworkdayjobs.com) by company: title, locations, country, posting date, time type, requisition ID and the full description.

### FAQ

**Which countries are covered?** Every country whose buyers publish on TED: the 27 EU member states, the EEA countries, and others such as Switzerland, the United Kingdom, Ukraine, Türkiye or the Western Balkans when their notices are sent to TED. Type a name or ISO code; empty means all.

**What is the difference between the stages?** `competition` is a call for tenders you can still bid on, `result` is a contract award (with the awarded value), `planning` is a prior information notice about a coming procurement, `cont-modif` is a change to a running contract. Pick several at once.

**How do CPV codes work here?** A code or prefix covers everything below it: `72` is all IT services, `7222` the consultancy group, `72220000` the exact code. Each row has the main code, all codes and the division name.

**Which language are the titles in?** Titles exist in all 24 official EU languages because TED translates them; you choose the language in `language` (default English) and the original is in `titleOriginal`. Descriptions are usually only in the original language, so they come back as written by the buyer, with `descriptionLanguage` telling you which.

**Can I get only notices that are still open?** Yes: `openOnly` keeps notices with a tender deadline today or later. Combine it with the `competition` stage.

**How far back does it go?** The whole TED archive: set `scope` to `All` and give dates. Older notices (before 2024) carry fewer fields; see Limits.

**Can I use my own TED query?** Yes, paste it into `query`. The syntax is the expert search of the TED website; `scope`, `sort` and the output options still apply. A syntax error is reported with the API's message in the run log.

**How do I fetch specific notices?** Put their publication numbers (`696546-2026`) or notice links in `publicationNumbers`. Numbers that do not exist are listed under `missingNumbers` in the run summary and are not charged.

**What does Count only do?** It asks the API for the number of matching notices and writes it, with the cost at your plan, into the run summary. Nothing is delivered and only the start event is charged.

**Can I pay only for new notices?** Yes. Turn on **Only new rows since the last run**: the actor remembers what it delivered to you and later runs with the same state name deliver (and charge) only the new rows.

**How do I get the results into Slack, Google Sheets, Make, n8n or Zapier?** Use the Integrations tab of the Actor for the data, and the `notifyUrl` field for a message when a run ends (Slack and Discord webhooks work directly; catch hooks of Make, n8n and Zapier too).

**Can I call it from code or from an AI agent?** Yes: through the Apify API, the JavaScript and Python clients, and the Apify MCP server. The API tab shows a working example with the input of this Actor.

**Is it legal to use this data?** The actor reads the official API described in the Data source section and delivers procurement notice data without personal data. The licence of the source is described above. How you use the data is your responsibility under the law that applies to you.

**Does it collect personal data?** No. Contact persons, e-mails and phone numbers are removed and fields about people are never requested. See the Privacy section.

**The run finished with 0 rows. Did I pay?** No: with no rows delivered nothing is charged apart from the start event. Check the run summary (`RUN_SUMMARY`) for warnings, widen the filters, or run with **Only new rows** off if everything matching was already delivered to you.

### Support and reviews

**Problems, missing fields, questions:** open an issue on the **Issues** tab of this Actor. We answer within one working day and fix confirmed bugs in the next release; the changelog lists every change.

If this Actor saved you time, a short review on its page helps other users find it and helps us keep improving it.

# Changelog

This Actor's version history is a separate document: https://apify.com/rowcraft/ted-tenders-scraper/changelog.md

# Actor input Schema

## `countries` (type: `array`):

Countries of the contracting authority, one per line: English name or ISO code (Germany, DE or DEU). Empty = every country on TED (EU, EEA and others).

## `text` (type: `string`):

Full-text search in the whole notice (title, descriptions, buyer). A phrase is matched as written; you can also use OR, AND, NOT and parentheses: software OR hardware.

## `cpv` (type: `array`):

Common Procurement Vocabulary codes, one per line, as a code or a prefix: 72 (all IT services), 45 (construction work), 72220000 (systems and technical consultancy). A code matches itself and everything below it.

## `formTypes` (type: `array`):

Which stage of the procedure: open calls for tenders (competition), results and awards (result), planning notices, modifications. Empty = all.

## `contractNatures` (type: `array`):

Works, supplies or services. Empty = all.

## `publishedAfter` (type: `string`):

Only notices published on or after this day. A date (2026-10-01), today, yesterday, or a relative value such as 7 days, 2 weeks, 3 months.

## `publishedBefore` (type: `string`):

Only notices published on or before this day (2026-10-07). For notices older than about a year set the scope below to All.

## `openOnly` (type: `boolean`):

Keep only notices with a tender deadline today or later. Useful with the Competition stage to list what can still be bid on.

## `scope` (type: `string`):

Active = notices currently in force (default). All = the whole TED archive, including expired and old notices. Latest = only the current issue of the Official Journal supplement.

## `buyerName` (type: `string`):

Word or phrase from the name of the contracting authority, for example Universit or Stadt Wien.

## `placeOfPerformance` (type: `array`):

Where the contract is performed: a country (France, FR) or a NUTS region code (DE1, FR10, ITC4), one per line. A country or a short code covers every region below it.

## `procedureTypes` (type: `array`):

Empty = all.

## `minValue` (type: `integer`):

Keep notices whose estimated value (procedure or any lot) or awarded value is at least this amount, in the currency of the notice (most are EUR, some are national currencies).

## `euFundedOnly` (type: `boolean`):

Keep notices where at least one lot is financed by EU funds.

## `sort` (type: `string`):

Order of the results when you take fewer than all matching notices.

## `language` (type: `string`):

Titles exist in all 24 official EU languages; descriptions mostly in the language of the notice. The chosen language is used when available, then the original language.

## `maxItems` (type: `integer`):

Stop after this many notices. 0 = all matching notices (no cap: the actor uses the API's iteration mode).

## `includeDescription` (type: `boolean`):

Procedure and lot descriptions and the text of changes, in the preferred language when available. Switch off for smaller rows and faster runs.

## `includeLots` (type: `boolean`):

Adds lotIds and lotTitles (one entry per lot). Lot values, deadlines and dates are always included.

## `query` (type: `string`):

A TED expert-search query, as on the TED website: buyer-country=FRA AND classification-cpv=72\* AND publication-date>=today(-30). When set, the filters above are ignored; the sort order and scope still apply.

## `publicationNumbers` (type: `array`):

TED publication numbers (696546-2026) or notice links, one per line. When set, every filter above is ignored and the whole archive is searched.

## `countOnly` (type: `boolean`):

Only count how many rows match your filters and estimate the cost at your price tier. Nothing is delivered and nothing is charged apart from the start event. Turn it off to get the data.

## `onlyNew` (type: `boolean`):

Remember the rows already delivered to you (in a key-value store in your Apify account) and deliver only rows that appeared since the last run with the same state key. The first run delivers everything that matches; later runs cost only the new rows. Ideal for schedules.

## `stateName` (type: `string`):

Name of the memory used by "Only new rows". Use a different name for each schedule or search (for example `stockholm-python`) so they do not share one memory.

## `notifyUrl` (type: `string`):

A webhook address that receives one JSON POST with the number of new rows and links to the dataset: a Slack or Discord incoming webhook, a Make, n8n or Zapier catch hook, or your own endpoint. The message is also in the `text` (Slack) and `content` (Discord) fields.

## `notifyWhenEmpty` (type: `boolean`):

By default the notification is sent only when at least one row was delivered.

## `requestIntervalMs` (type: `integer`):

Default 1000 ms (one request per second). Each request returns up to about 160 notices. Minimum 500, in line with the TED fair-use policy.

## Actor input object example

```json
{
  "countries": [
    "Germany"
  ],
  "formTypes": [
    "competition"
  ],
  "publishedAfter": "7 days",
  "openOnly": false,
  "scope": "ACTIVE",
  "euFundedOnly": false,
  "sort": "newest",
  "language": "eng",
  "maxItems": 50,
  "includeDescription": true,
  "includeLots": true,
  "countOnly": false,
  "onlyNew": false,
  "stateName": "default",
  "notifyWhenEmpty": false,
  "requestIntervalMs": 1000
}
```

# Actor output Schema

## `results` (type: `string`):

All delivered rows in the default dataset (JSON, CSV, Excel and other formats via the dataset API).

## `runSummary` (type: `string`):

Counts, warnings and why the run stopped (RUN_SUMMARY record in the default key-value store).

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "countries": [
        "Germany"
    ],
    "formTypes": [
        "competition"
    ],
    "publishedAfter": "7 days",
    "maxItems": 50
};

// Run the Actor and wait for it to finish
const run = await client.actor("rowcraft/ted-tenders-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "countries": ["Germany"],
    "formTypes": ["competition"],
    "publishedAfter": "7 days",
    "maxItems": 50,
}

# Run the Actor and wait for it to finish
run = client.actor("rowcraft/ted-tenders-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "countries": [
    "Germany"
  ],
  "formTypes": [
    "competition"
  ],
  "publishedAfter": "7 days",
  "maxItems": 50
}' |
apify call rowcraft/ted-tenders-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,rowcraft/ted-tenders-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/ApxMtrujxucnfhpaE/builds/SQZeGbLFrJk8YV9C9/openapi.json