# French Public Tenders (`tagadanar/french-public-tenders`) Actor
Monitor French (BOAMP) and EU-wide (TED) public tenders in one call. Filter by keywords, CPV codes, department, publication window and deadline. Unified, deduplicated, structured output from official open data. For bid monitoring, public-sector sales and AI agents.
- **URL**: https://apify.com/tagadanar/french-public-tenders.md
- **Developed by:** [Raphaël R](https://apify.com/tagadanar) (community)
- **Categories:** Lead generation, Automation, AI
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet
## Pricing
Pay per event
This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event
## What's an Apify Actor?
Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
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.
Actors are written with capital "A".
## 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.
The best way to integrate Actors is as follows.
In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):
```bash
npm install apify-client
```
In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):
```bash
pip install apify-client
```
In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):
````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash
In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).
If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).
For usage examples, see the [API](#api) section below.
For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).
# README
## French & EU Public Tenders Monitor (BOAMP + TED)
**Track public procurement opportunities across France and the EU from one call — and let AI tell you which ones are worth bidding on.** Query **BOAMP** (the French official procurement journal, *Bulletin officiel des annonces des marchés publics*) and **TED** (*Tenders Electronic Daily*, the EU-wide procurement journal) with keyword, CPV, department and deadline filters — and get one clean, unified, structured record per tender.
Built for **bid/tender monitoring, sales & business development to the public sector, market intelligence, and AI agents** (works via API and MCP out of the box).
### Why this actor
- ✅ **Two official sources, one schema** — BOAMP (France) + TED (EU) results normalized to identical fields, deduplicated, deadline-filtered.
- ✅ **True monitor mode** — remembers what it already reported; scheduled runs return (and charge for) **new tenders only**.
- ✅ **Slack & webhook alerts** — new tenders land in your Slack channel or any endpoint the moment a run finds them.
- ✅ **AI relevance scoring** (bring your own Anthropic API key) — describe your company once; every tender gets a **0–100 relevance score**, a one-line reason and a **bid / consider / skip** recommendation.
- ✅ **Official open data** — DILA (BOAMP) and the EU Publications Office (TED). No scraping, no stale caches.
- ✅ **Real filtering** — keywords, French department codes, CPV codes, publication window, and "only tenders still open for bids".
### The 5-minute tender radar
1. Set your `keywords` / `cpvCodes` / `departments`.
2. Turn on **`monitorMode`** and paste a **Slack webhook URL**.
3. (Optional) Describe your business in **`companyProfile`**, add your **`anthropicApiKey`** and set `alertMinScore: 60`.
4. Create an Apify **Schedule** (daily).
Every morning, your Slack channel gets only the **new** tenders relevant to **your** business, scored and sorted — nothing you've already seen, nothing off-topic.
### Use cases
- **Never miss a relevant tender** — get every new public contract matching your keywords/CPV the day it's published.
- **Stop reading irrelevant tenders** — the AI score reads them for you and tells you which ones fit.
- **Public-sector sales** — build a live pipeline of buyers and deadlines in your segment and region.
- **Market intelligence** — who is buying what, where, and by when.
- **AI agents** — plug into Claude / Cursor via MCP and ask *"any open IT tenders in Île-de-France closing this month?"*
### Input
```json
{
"keywords": ["logiciel", "cybersécurité", "infogérance"],
"sources": ["boamp", "ted"],
"departments": ["75", "69", "13"],
"cpvCodes": ["72000000"],
"publishedWithinDays": 7,
"onlyOpen": true,
"monitorMode": true,
"monitorName": "cyber-idf",
"webhookUrl": "https://hooks.slack.com/services/XXX/YYY/ZZZ",
"companyProfile": "ESN de 15 personnes à Paris : audit cybersécurité, pentest, développement sécurisé, RGPD. Clients secteur public et santé.",
"alertMinScore": 60
}
````
- `keywords` — matched in the tender object/title (OR). Empty = all tenders in your other filters.
- `sources` — `boamp`, `ted`, or both.
- `departments` — French department codes (BOAMP filter).
- `cpvCodes` — Common Procurement Vocabulary codes (TED filter).
- `onlyOpen` — drop tenders whose response deadline has passed.
- `monitorMode` — only return tenders not seen in previous runs (per `monitorName`).
- `webhookUrl` — Slack incoming webhook (digest message) or any URL (JSON payload).
- `companyProfile` — enables AI scoring; a few sentences, French or English.
- `alertMinScore` — alerts only include tenders scoring at least this.
### Output (one record per tender)
```json
{
"source": "TED",
"id": "378060-2026",
"title": "France – Services de maintenance des systèmes...",
"buyer": "GRENOBLE ALPES METROPOLE",
"publicationDate": "2026-06-03",
"deadline": "2026-07-20",
"marketType": "Services",
"cpvCodes": ["72250000"],
"location": "NUTS FRK24",
"country": "FR",
"url": "https://ted.europa.eu/fr/notice/-/detail/378060-2026",
"relevanceScore": 82,
"relevanceReason": "Maintenance de systèmes IT pour une métropole : cœur de métier, région couverte.",
"recommendation": "bid",
"source_ref": "api.ted.europa.eu (TED / EU Publications Office)",
"retrievedAt": "2026-07-03T09:12:00.000Z"
}
```
BOAMP records share the exact same shape (`source: "BOAMP"`, `location: "FR dept 75"`, `url` to boamp.fr). The `relevance*` fields appear when `companyProfile` is set; results are then sorted best-first.
### Pricing
Pay per event — no subscription:
| Event | When |
|---|---|
| Actor start | Once per run |
| Tender found | Per tender returned (in monitor mode: **new tenders only**) |
| Tender scored | Per tender AI-scored (only when `companyProfile` is set) |
### FAQ
**Where does the data come from?** Official open data only: `boamp-datadila.opendatasoft.com` (BOAMP / DILA) and `api.ted.europa.eu` (TED / EU Publications Office). Fetched live at run time.
**How does monitor mode work?** The actor keeps a per-`monitorName` memory of every tender id it already returned (kept 120 days). Scheduled runs output only what's new — you're not charged twice for the same tender.
**How does AI scoring work?** Each tender's key facts (title, buyer, type, CPV, location, deadline) are rated against your `companyProfile` by a fast Claude model, called with **your own Anthropic API key** (`anthropicApiKey` input — get one at console.anthropic.com). You get a 0–100 score, a one-sentence reason, and bid/consider/skip. Token cost on your key is tiny (~$1 per 1,000 tenders); your key is used for the calls only, never stored.
**How fresh is it?** Both registries publish continuously; the actor returns what's live at run time. Schedule it daily for a monitoring feed.
**Can I filter by amount / procedure type?** Keywords, department, CPV, deadline and window are supported today. More structured filters are on the roadmap — open an issue with what you need.
**Does it deduplicate?** Yes — within a run (by source + notice id), and across runs in monitor mode.
**Does it work with AI agents?** Yes — exposed via REST API and **MCP**, callable as a tool from Claude, Cursor & co.
***
*Keywords: appels d'offres, marchés publics, BOAMP, TED, public tenders France, EU procurement, tender monitoring, tender alerts, veille marchés publics, CPV, appel d'offre API, government contracts, AI tender scoring, bid/no-bid.*
# Actor input Schema
## `keywords` (type: `array`):
Free-text terms to match in the tender object/title (matched with OR). Leave empty to get all recent tenders in your other filters. E.g. logiciel, cybersécurité, infogérance.
## `sources` (type: `array`):
Which registries to query.
## `departments` (type: `array`):
Filter BOAMP tenders by French department code(s), e.g. 75, 69, 2A. Empty = all of France.
## `cpvCodes` (type: `array`):
Common Procurement Vocabulary codes to filter TED results, e.g. 72000000 (IT services). Empty = all categories.
## `publishedWithinDays` (type: `integer`):
Only return tenders published in this window.
## `onlyOpen` (type: `boolean`):
Exclude tenders whose response deadline has already passed (based on the published deadline, when available).
## `maxResultsPerSource` (type: `integer`):
Cap the number of tenders returned from each registry.
## `monitorMode` (type: `boolean`):
Remember which tenders were already returned in previous runs and only output (and charge for) new ones. Perfect with an Apify Schedule: run daily, get only what's new.
## `monitorName` (type: `string`):
Memory bucket for monitor mode. Use a different name per saved search (e.g. cyber-paris, btp-sud) so each keeps its own history.
## `webhookUrl` (type: `string`):
POST new tenders to this URL after each run. Slack incoming-webhook URLs (hooks.slack.com) get a formatted digest message; any other URL gets a JSON payload. Leave empty to disable.
## `companyProfile` (type: `string`):
Describe what your company sells and to whom (a few sentences, French or English). Each tender then gets relevanceScore (0–100), relevanceReason and a bid/consider/skip recommendation, and results are sorted by score. Requires your Anthropic API key below.
## `anthropicApiKey` (type: `string`):
Get one at console.anthropic.com. Used only to score tenders against your profile; never stored. If empty, scoring is skipped.
## `maxTendersToScore` (type: `integer`):
Cap on AI-scored tenders per run (each scored tender is a paid event).
## `alertMinScore` (type: `integer`):
Webhook/Slack alerts only include tenders with a relevance score at or above this value (unscored tenders always alert). 0 = alert on everything.
## Actor input object example
```json
{
"keywords": [
"logiciel",
"développement"
],
"sources": [
"boamp",
"ted"
],
"departments": [],
"cpvCodes": [],
"publishedWithinDays": 7,
"onlyOpen": true,
"maxResultsPerSource": 100,
"monitorMode": false,
"monitorName": "default",
"maxTendersToScore": 50,
"alertMinScore": 0
}
```
# Actor output Schema
## `tenders` (type: `string`):
All matched tender notices (one item per tender) in the default dataset.
# 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 '' with your token
const client = new ApifyClient({
token: '',
});
// Prepare Actor input
const input = {
"keywords": [
"logiciel",
"développement"
],
"departments": [],
"cpvCodes": []
};
// Run the Actor and wait for it to finish
const run = await client.actor("tagadanar/french-public-tenders").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 '' with your token.
client = ApifyClient("")
# Prepare the Actor input
run_input = {
"keywords": [
"logiciel",
"développement",
],
"departments": [],
"cpvCodes": [],
}
# Run the Actor and wait for it to finish
run = client.actor("tagadanar/french-public-tenders").call(run_input=run_input)
# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
print(item)
# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start
```
## CLI example
```bash
echo '{
"keywords": [
"logiciel",
"développement"
],
"departments": [],
"cpvCodes": []
}' |
apify call tagadanar/french-public-tenders --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=tagadanar/french-public-tenders",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "French Public Tenders",
"description": "Monitor French (BOAMP) and EU-wide (TED) public tenders in one call. Filter by keywords, CPV codes, department, publication window and deadline. Unified, deduplicated, structured output from official open data. For bid monitoring, public-sector sales and AI agents.",
"version": "0.1",
"x-build-id": "3q8fSgkg13wZg1VL3"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/tagadanar~french-public-tenders/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-tagadanar-french-public-tenders",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
},
"/acts/tagadanar~french-public-tenders/runs": {
"post": {
"operationId": "runs-sync-tagadanar-french-public-tenders",
"x-openai-isConsequential": false,
"summary": "Executes an Actor and returns information about the initiated run in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/runsResponseSchema"
}
}
}
}
}
}
},
"/acts/tagadanar~french-public-tenders/run-sync": {
"post": {
"operationId": "run-sync-tagadanar-french-public-tenders",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
}
},
"components": {
"schemas": {
"inputSchema": {
"type": "object",
"required": [
"sources"
],
"properties": {
"keywords": {
"title": "Keywords",
"type": "array",
"description": "Free-text terms to match in the tender object/title (matched with OR). Leave empty to get all recent tenders in your other filters. E.g. logiciel, cybersécurité, infogérance.",
"items": {
"type": "string"
}
},
"sources": {
"title": "Sources",
"type": "array",
"description": "Which registries to query.",
"items": {
"type": "string",
"enum": [
"boamp",
"ted"
],
"enumTitles": [
"BOAMP (France)",
"TED (EU-wide)"
]
},
"default": [
"boamp",
"ted"
]
},
"departments": {
"title": "French departments (BOAMP only)",
"type": "array",
"description": "Filter BOAMP tenders by French department code(s), e.g. 75, 69, 2A. Empty = all of France.",
"items": {
"type": "string"
}
},
"cpvCodes": {
"title": "CPV codes (TED)",
"type": "array",
"description": "Common Procurement Vocabulary codes to filter TED results, e.g. 72000000 (IT services). Empty = all categories.",
"items": {
"type": "string"
}
},
"publishedWithinDays": {
"title": "Published within the last N days",
"minimum": 1,
"maximum": 365,
"type": "integer",
"description": "Only return tenders published in this window.",
"default": 7
},
"onlyOpen": {
"title": "Only tenders still open for bids",
"type": "boolean",
"description": "Exclude tenders whose response deadline has already passed (based on the published deadline, when available).",
"default": true
},
"maxResultsPerSource": {
"title": "Max results per source",
"minimum": 1,
"maximum": 1000,
"type": "integer",
"description": "Cap the number of tenders returned from each registry.",
"default": 100
},
"monitorMode": {
"title": "Monitor mode (only NEW tenders)",
"type": "boolean",
"description": "Remember which tenders were already returned in previous runs and only output (and charge for) new ones. Perfect with an Apify Schedule: run daily, get only what's new.",
"default": false
},
"monitorName": {
"title": "Monitor name",
"type": "string",
"description": "Memory bucket for monitor mode. Use a different name per saved search (e.g. cyber-paris, btp-sud) so each keeps its own history.",
"default": "default"
},
"webhookUrl": {
"title": "Webhook / Slack URL",
"pattern": "^https?://.+",
"type": "string",
"description": "POST new tenders to this URL after each run. Slack incoming-webhook URLs (hooks.slack.com) get a formatted digest message; any other URL gets a JSON payload. Leave empty to disable."
},
"companyProfile": {
"title": "Company profile (enables AI relevance scoring)",
"type": "string",
"description": "Describe what your company sells and to whom (a few sentences, French or English). Each tender then gets relevanceScore (0–100), relevanceReason and a bid/consider/skip recommendation, and results are sorted by score. Requires your Anthropic API key below."
},
"anthropicApiKey": {
"title": "Anthropic API key (required for AI scoring)",
"type": "string",
"description": "Get one at console.anthropic.com. Used only to score tenders against your profile; never stored. If empty, scoring is skipped."
},
"maxTendersToScore": {
"title": "Max tenders to score per run",
"minimum": 1,
"maximum": 500,
"type": "integer",
"description": "Cap on AI-scored tenders per run (each scored tender is a paid event).",
"default": 50
},
"alertMinScore": {
"title": "Alert threshold (min score)",
"minimum": 0,
"maximum": 100,
"type": "integer",
"description": "Webhook/Slack alerts only include tenders with a relevance score at or above this value (unscored tenders always alert). 0 = alert on everything.",
"default": 0
}
}
},
"runsResponseSchema": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"actId": {
"type": "string"
},
"userId": {
"type": "string"
},
"startedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"finishedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"status": {
"type": "string",
"example": "READY"
},
"meta": {
"type": "object",
"properties": {
"origin": {
"type": "string",
"example": "API"
},
"userAgent": {
"type": "string"
}
}
},
"stats": {
"type": "object",
"properties": {
"inputBodyLen": {
"type": "integer",
"example": 2000
},
"rebootCount": {
"type": "integer",
"example": 0
},
"restartCount": {
"type": "integer",
"example": 0
},
"resurrectCount": {
"type": "integer",
"example": 0
},
"computeUnits": {
"type": "integer",
"example": 0
}
}
},
"options": {
"type": "object",
"properties": {
"build": {
"type": "string",
"example": "latest"
},
"timeoutSecs": {
"type": "integer",
"example": 300
},
"memoryMbytes": {
"type": "integer",
"example": 1024
},
"diskMbytes": {
"type": "integer",
"example": 2048
}
}
},
"buildId": {
"type": "string"
},
"defaultKeyValueStoreId": {
"type": "string"
},
"defaultDatasetId": {
"type": "string"
},
"defaultRequestQueueId": {
"type": "string"
},
"buildNumber": {
"type": "string",
"example": "1.0.0"
},
"containerUrl": {
"type": "string"
},
"usage": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "integer",
"example": 1
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
},
"usageTotalUsd": {
"type": "number",
"example": 0.00005
},
"usageUsd": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "number",
"example": 0.00005
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
}
}
}
}
}
}
}
}
```