# EU Defense Contract Monitor (`northlab/eu-defense-contract-monitor`) Actor Tracks EU TED defense procurement award notices (CPV 353xx–357xx) and maps winning contractors to stock tickers. Outputs a structured dataset plus a self-contained HTML viewer. - **URL**: https://apify.com/northlab/eu-defense-contract-monitor.md - **Developed by:** [Carlos Schwiening](https://apify.com/northlab) (community) - **Categories:** News, Other - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.01 / 1,000 results 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 web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. 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/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 ## EU Defense Contract Monitor Turns public EU procurement records into an investable signal: **every EU defense contract award, mapped to the stock ticker of the company that won it.** Built on the EU's official [TED (Tenders Electronic Daily)](https://ted.europa.eu/) API — no scraping, no AI-generated summaries, no hallucination risk. Every field comes straight from the structured procurement notice. ### Live demo **[Open the viewer →](https://api.apify.com/v2/key-value-stores/aXKSjS8FtfEGGM6dv/records/viewer?signature=EWtxmy9t4PWZJnAgw115)** Sortable/searchable table of every notice; click a row to expand a summary panel (procedure, description, duration, contract date, buyer contact) and a companies panel (buyer + winning contractor with ticker). ![Overview](https://api.apify.com/v2/key-value-stores/aXKSjS8FtfEGGM6dv/records/overview_v3?signature=12q2L8pDjsgm5iJWT0cFI) ![Notice detail with summary + companies panel](https://api.apify.com/v2/key-value-stores/aXKSjS8FtfEGGM6dv/records/detail_summary_panel_v3?signature=ouWqznWPN8cyDBrLdT8S) ### What you get Each dataset item is one EU defense procurement award notice (CPV 353xx–357xx: military equipment, weapons, ammunition, aircraft, vehicles, communication systems, and related services): | Field | Description | |---|---| | `publicationNumber`, `publicationDate`, `tedUrl` | Notice identity + link to the source notice on TED | | `buyer`, `buyerCountry` | Contracting authority (e.g. a national Ministry of Defence) and its country | | `contractor`, `contractorCountry`, `contractorCity` | Winning company | | `ticker`, `tickerCompany`, `listingStatus` | Stock ticker if the winner is publicly listed (`ticker`), or why not (`privat/JV`, `unmapped`, `no-winner`) | | `title`, `description`, `cpvCodes` | What was procured | | `estimatedValue`/`estimatedCurrency`, `awardedValue`/`awardedCurrency` | Pre-tender estimate vs. actual awarded value | | `procedureType`, `durationValue`/`durationUnit`, `contractDate`, `submissionsCount` | Procurement process details | | `buyerEmail` | Contracting authority contact | ### Query filters (Actor input) The dataset is filterable per run — you don't have to take the full feed: - **`buyerCountries`** — restrict to specific buyer countries (ISO 3166-1 alpha-3 codes as used by TED, e.g. `DEU`, `FRA`, `POL`) - **`cpvPrefixes`** — restrict to CPV sub-categories, e.g. `3531` for ammunition, `3521` for military aircraft, `3563` for military communication equipment - **`dateFrom` / `dateTo`** — restrict to a publication date range - **`minValueEur`** — only notices with a known EUR value at or above this threshold - **`buyerKeyword`** — substring match on the buyer name (e.g. "Ministry of Defence", "Bundeswehr") - **`keyword`** — substring match on title + description (e.g. "drone", "ammunition") - **`onlyWithTicker`** — only notices where the winning contractor maps to a public stock ticker - **`lookbackDays`** — how many days back to sync fresh notices on top of the bundled history (default 5) Leave any filter empty/unset to not restrict on it. ### Who this is for Investors and analysts tracking defense-sector revenue signals before they show up in quarterly earnings — a public contract award is often the first public trace of new order flow for a listed contractor. ### Data source & update frequency [EU TED (Tenders Electronic Daily)](https://ted.europa.eu/), the EU's official public procurement portal — freely accessible, no scraping involved. The Actor runs on a daily schedule and accumulates history over time; values are only reported where TED itself publishes them (real awarded amounts are frequently higher than what's disclosed). # Actor input Schema ## `lookbackDays` (type: `integer`): How many days back to sync fresh TED award notices on top of the bundled snapshot. ## `buyerCountries` (type: `array`): Only return notices where the buyer/contracting authority is in one of these countries. TED uses ISO 3166-1 alpha-3 codes, e.g. DEU, FRA, POL (not DE/FR/PL). Leave empty for all countries. ## `cpvPrefixes` (type: `array`): Only return notices whose CPV code starts with one of these prefixes, e.g. "3531" for ammunition, "3521" for military aircraft, "3563" for military communication equipment. Leave empty for all defense CPV codes (353xx–357xx). ## `dateFrom` (type: `string`): Only return notices published on or after this date (YYYY-MM-DD). Leave empty for no lower bound. ## `dateTo` (type: `string`): Only return notices published on or before this date (YYYY-MM-DD). Leave empty for no upper bound. ## `minValueEur` (type: `integer`): Only return notices with a known EUR value (awarded, or estimated when no award value was published) at or above this threshold. Notices without any EUR value are excluded when this is set. ## `buyerKeyword` (type: `string`): Case-insensitive substring match against the buyer/contracting authority name, e.g. "Ministry of Defence" or "Bundeswehr". ## `keyword` (type: `string`): Case-insensitive substring match against the notice title and description, e.g. "ammunition" or "drone". ## `onlyWithTicker` (type: `boolean`): Only return notices where the winning contractor is mapped to a public stock ticker. ## Actor input object example ```json { "lookbackDays": 5, "buyerCountries": [], "cpvPrefixes": [], "onlyWithTicker": false } ```` # 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 = {}; // Run the Actor and wait for it to finish const run = await client.actor("northlab/eu-defense-contract-monitor").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 = {} # Run the Actor and wait for it to finish run = client.actor("northlab/eu-defense-contract-monitor").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 '{}' | apify call northlab/eu-defense-contract-monitor --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=northlab/eu-defense-contract-monitor", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "EU Defense Contract Monitor", "description": "Tracks EU TED defense procurement award notices (CPV 353xx–357xx) and maps winning contractors to stock tickers. Outputs a structured dataset plus a self-contained HTML viewer.", "version": "0.1", "x-build-id": "B7amo8ySKpeaqp7C1" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/northlab~eu-defense-contract-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-northlab-eu-defense-contract-monitor", "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/northlab~eu-defense-contract-monitor/runs": { "post": { "operationId": "runs-sync-northlab-eu-defense-contract-monitor", "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/northlab~eu-defense-contract-monitor/run-sync": { "post": { "operationId": "run-sync-northlab-eu-defense-contract-monitor", "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", "properties": { "lookbackDays": { "title": "Lookback days", "minimum": 1, "maximum": 60, "type": "integer", "description": "How many days back to sync fresh TED award notices on top of the bundled snapshot.", "default": 5 }, "buyerCountries": { "title": "Buyer countries", "type": "array", "description": "Only return notices where the buyer/contracting authority is in one of these countries. TED uses ISO 3166-1 alpha-3 codes, e.g. DEU, FRA, POL (not DE/FR/PL). Leave empty for all countries.", "default": [], "items": { "type": "string" } }, "cpvPrefixes": { "title": "CPV code prefixes", "type": "array", "description": "Only return notices whose CPV code starts with one of these prefixes, e.g. \"3531\" for ammunition, \"3521\" for military aircraft, \"3563\" for military communication equipment. Leave empty for all defense CPV codes (353xx–357xx).", "default": [], "items": { "type": "string" } }, "dateFrom": { "title": "Publication date from", "type": "string", "description": "Only return notices published on or after this date (YYYY-MM-DD). Leave empty for no lower bound." }, "dateTo": { "title": "Publication date to", "type": "string", "description": "Only return notices published on or before this date (YYYY-MM-DD). Leave empty for no upper bound." }, "minValueEur": { "title": "Minimum contract value (EUR)", "minimum": 0, "type": "integer", "description": "Only return notices with a known EUR value (awarded, or estimated when no award value was published) at or above this threshold. Notices without any EUR value are excluded when this is set." }, "buyerKeyword": { "title": "Buyer keyword", "type": "string", "description": "Case-insensitive substring match against the buyer/contracting authority name, e.g. \"Ministry of Defence\" or \"Bundeswehr\"." }, "keyword": { "title": "Keyword", "type": "string", "description": "Case-insensitive substring match against the notice title and description, e.g. \"ammunition\" or \"drone\"." }, "onlyWithTicker": { "title": "Only notices with a listed contractor", "type": "boolean", "description": "Only return notices where the winning contractor is mapped to a public stock ticker.", "default": false } } }, "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 } } } } } } } } } } ```