| 📑 Tender title and lots | ⏳ Deadline (Paris time) | 💶 Estimated value |
| 🏷️ CPV sector | 📎 Documents link | 🏛️ Buyer and contact |
| 🏆 Winner (SIRET, size, activity) | 💶 Awarded amount | 🔢 Number of bids |
| 📍 Department and region | 📊 Top winners, buyers, market shares | 🔔 Alerts for new tenders |
nettoyage and entretien locaux.
## `cpvCodes` (type: `array`):
EU procurement codes, full or partial: 72 (all IT services), 4521, 90911000.
## `contractTypes` (type: `array`):
Works, services or supplies.
## `departments` (type: `array`):
Department codes, e.g. 69, 75, 2A, 971. Tenders: the notice's departments. Contracts: the buyer's department or the place of performance.
## `buyerName` (type: `string`):
Part of the buyer's name, e.g. Lyon, CHU, Département du Nord.
## `noticeTypes` (type: `array`):
Default: open calls for tenders only.
## `openOnly` (type: `boolean`):
Keep only calls for tenders whose response deadline hasn't passed.
## `publishedAfter` (type: `string`):
A date (2026-10-01) or a duration (7 days, 3 months).
## `publishedBefore` (type: `string`):
A date or a duration, like "Published after".
## `searchIn` (type: `string`):
Searching the whole notice finds more; the title is more precise.
## `families` (type: `array`):
The legal regime, which depends on the estimated value.
## `minEstimatedValue` (type: `integer`):
Notices without an estimated value are excluded when this is set.
## `maxEstimatedValue` (type: `integer`):
Notices without an estimated value are excluded when this is set.
## `onlyNew` (type: `boolean`):
Remembers the notices already returned, so a scheduled run only outputs new ones. Combine with a schedule and an email/Slack integration for tender alerts.
## `monitorName` (type: `string`):
Keeps separate memories for separate alerts, e.g. cleaning-lyon. Defaults to one memory per set of filters.
## `includeRawNotice` (type: `boolean`):
Adds the complete notice as published (large).
## `awardedAfter` (type: `string`):
A date (2025-01-01) or a duration (12 months).
## `awardedBefore` (type: `string`):
A date or a duration, like "Awarded after".
## `regions` (type: `array`):
Region of the buyer.
## `buyerIds` (type: `array`):
Exact SIRET (14 digits) or SIREN (9 digits, matches all its establishments).
## `buyerCategories` (type: `array`):
Type of public buyer.
## `winnerName` (type: `string`):
Track a competitor, e.g. Onet, Capgemini.
## `winnerIds` (type: `array`):
Exact SIRET (14 digits) or SIREN (9 digits, matches all its establishments).
## `winnerCategories` (type: `array`):
Size category of the winning company (INSEE).
## `minAmount` (type: `integer`):
Contract amount in euros, excluding VAT as declared by the buyer.
## `maxAmount` (type: `integer`):
Contract amount in euros.
## `procedures` (type: `array`):
How the contract was awarded.
## `frameworkOnly` (type: `boolean`):
Keep only framework agreements (accords-cadres), which often run for several years.
## `excludeAbnormalAmounts` (type: `boolean`):
The dataset flags amounts that are clearly wrong (e.g. typos with extra zeros). Recommended for totals and rankings.
## `groupBy` (type: `string`):
One row per winner, buyer, sector, department, month… with contracts, totals and market share.
## `cpvLevel` (type: `string`):
How detailed the sectors are when analysing by CPV.
## `sortBy` (type: `string`):
How the analysis rows are ranked.
## `maxResults` (type: `integer`):
Notices, contracts or analysis rows.
## `countOnly` (type: `boolean`):
Only count matching notices or contracts and estimate the cost. Nothing is charged.
## Actor input object example
```json
{
"mode": "tenders",
"keywords": [
"nettoyage"
],
"noticeTypes": [
"APPEL_OFFRE"
],
"openOnly": true,
"searchIn": "everywhere",
"onlyNew": false,
"includeRawNotice": false,
"awardedAfter": "12 months",
"frameworkOnly": false,
"excludeAbnormalAmounts": true,
"groupBy": "winner",
"cpvLevel": "2",
"sortBy": "totalAmount",
"maxResults": 20,
"countOnly": false
}
```
# Actor output Schema
## `tenders` (type: `string`):
Tender notices with deadline, value, sector and buyer contact.
## `contracts` (type: `string`):
Contracts with winner, amount and buyer.
## `analysis` (type: `string`):
Ranked analysis rows.
## `results` (type: `string`):
Every field of every row.
# 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 '