# German Tenders Scraper (oeffentlichevergabe.de) (`fetchwerk/de-tenders-scraper`) Actor Scrape German public procurement notices from the official Datenservice Oeffentlicher Einkauf, including below-threshold tenders not on TED. Filter by CPV, keywords and notice type. Normalized output + digest mode. - **URL**: https://apify.com/fetchwerk/de-tenders-scraper.md - **Developed by:** [Fetchwerk](https://apify.com/fetchwerk) (community) - **Categories:** Lead generation, Automation, Developer tools - **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 records 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/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 ## German Tenders Scraper (oeffentlichevergabe.de) This **German tenders scraper** collects public procurement notices from Germany's official federal open-data service **Datenservice Öffentlicher Einkauf** (oeffentlichevergabe.de, run by the Beschaffungsamt des BMI). It covers Bund, Länder and Kommunen in one run, **including below-threshold national tenders (Unterschwellenvergaben) that never reach TED**. Output is normalized to a clean JSON schema, filtered by CPV, keywords and notice type. No API keys, no login, no personal-data scraping. ### Why this actor? The EU-wide TED database only carries tenders above the EU thresholds. A large share of German public spending happens **below** those thresholds and is published nationally, not on TED. If you only watch TED, you miss it. This actor reads the official German OCDS feed directly, so you see national and sub-threshold opportunities too. - **Official source, CC0 licensed**: data comes from the government's own open-data API, released into the public domain. - **Same schema as our EU Tenders Scraper**: pipe German, EU (TED) and Dutch (TenderNed) notices into one database without remapping. - **Tenders, awards and planning notices**: watch open calls, track who won contracts, or catch prior information notices. ### What data does it return? Every notice is normalized to this structure: ```json { "id": "doe:ocds-mnwr74-8531ca93-ae3a-4311-b0e6-f2dad978e359", "source": "doe", "title": "Vergabe von Dienstleistungen zum Website-Support", "buyer": "KEA Klimaschutz- und Energieagentur Baden-Württemberg GmbH", "country": "DEU", "cpv_codes": ["72413000"], "notice_type": "tender", "publication_date": "2026-07-21", "deadline": null, "url": "https://oeffentlichevergabe.de/ui/de/notice/8531ca93-ae3a-4311-b0e6-f2dad978e359", "description": null } ```` For award notices the underlying source also carries the winner and contract value. ### How to use it Example input, all fields optional: ```json { "noticeTypes": ["tender"], "cpvCodes": ["72", "48"], "keywords": ["cloud", "rechenzentrum"], "daysBack": 7, "maxItems": 200, "mode": "digest" } ``` - **noticeTypes**: `tender` (open calls), `award` (who won), `planning` (prior information). Default `tender`. - **cpvCodes**: prefix match. `72` matches all IT services (72000000...), `45442100` matches exactly. Empty = all categories. - **keywords**: case-insensitive match on title and description. - **daysBack**: publication window, 1 to 90 days. One bulk download per day. - **mode**: `search` returns the dataset only; `digest` also writes a ready-to-send markdown summary (grouped by notice type) to the key-value store under the key `DIGEST`. ### Tender monitoring and alerts Run the actor on a daily or weekly [schedule](https://docs.apify.com/platform/schedules) in `digest` mode and connect an Apify integration (Slack, email, webhook, Make, Zapier) to deliver the `DIGEST` markdown wherever your team works. ### Use cases - **Bid monitoring in Germany**: catch national and below-threshold tenders that TED-only tools miss. - **Contract award tracking**: set `noticeTypes` to `award` to see who is winning public contracts and for how much. - **Market research**: track which German public buyers purchase what, where, and how often. - **AI agents**: the normalized output makes this actor easy to consume from Claude, Cursor or your own agent stack. ### FAQ **Is this allowed?** Yes. The data comes from the official German federal open-data API (Datenservice Öffentlicher Einkauf), released under a CC0 public-domain dedication. This actor uses the documented public API and collects no personal data beyond the organization-level procurement information the government itself publishes. **How fresh is the data?** As fresh as the portal: German buyers publish continuously on business days. Run the actor on a schedule to stay current. **Does it cover the whole country?** Yes, the service bundles federal, state and municipal notices, including national procedures below the EU threshold. **How does pricing work?** Pay per event: a small fee per returned notice, and a flat fee per generated digest. `maxItems` caps your cost per run. **Can I combine it with EU and Dutch tenders?** Yes. This actor shares its output schema with our EU Tenders Scraper (TED + TenderNed), so records merge cleanly. ### Related Fetchwerk actors All Fetchwerk procurement actors share the same normalized output schema, so you can merge them into one pipeline: - **[EU Tenders Scraper](https://apify.com/fetchwerk/eu-tenders-scraper)**: EU-wide open calls from TED plus Dutch tenders from TenderNed. - **[EU Contract Award Radar](https://apify.com/fetchwerk/eu-award-radar)**: who won which EU public contract, for how much, against how many bidders. - **[UK Tenders Scraper](https://apify.com/fetchwerk/uk-tenders-scraper)**: UK public contracts from Find a Tender and Contracts Finder, above and below threshold. *** Built and operated by **Fetchwerk**. # Actor input Schema ## `noticeTypes` (type: `array`): tender = open calls, award = contract awards (who won), planning = prior information. Empty = all. ## `keywords` (type: `array`): Case-insensitive match on title/description. Empty = no keyword filter. ## `cpvCodes` (type: `array`): CPV codes, prefix match: 72 matches all IT services (72000000), 45442100 matches exactly. Empty = all categories. ## `daysBack` (type: `integer`): Only notices published in the last N days (one bulk download per day). ## `maxItems` (type: `integer`): Hard cap on returned notices (also caps your cost). ## `mode` (type: `string`): search = dataset only; digest = dataset + markdown digest in key-value store (key DIGEST). ## Actor input object example ```json { "noticeTypes": [ "tender" ], "keywords": [], "cpvCodes": [], "daysBack": 7, "maxItems": 200, "mode": "search" } ``` # 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("fetchwerk/de-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = {} # Run the Actor and wait for it to finish run = client.actor("fetchwerk/de-tenders-scraper").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 fetchwerk/de-tenders-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=fetchwerk/de-tenders-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "German Tenders Scraper (oeffentlichevergabe.de)", "description": "Scrape German public procurement notices from the official Datenservice Oeffentlicher Einkauf, including below-threshold tenders not on TED. Filter by CPV, keywords and notice type. Normalized output + digest mode.", "version": "0.1", "x-build-id": "we1lXpG0fEWvYiMqB" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fetchwerk~de-tenders-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fetchwerk-de-tenders-scraper", "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/fetchwerk~de-tenders-scraper/runs": { "post": { "operationId": "runs-sync-fetchwerk-de-tenders-scraper", "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/fetchwerk~de-tenders-scraper/run-sync": { "post": { "operationId": "run-sync-fetchwerk-de-tenders-scraper", "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": { "noticeTypes": { "title": "Notice types", "type": "array", "description": "tender = open calls, award = contract awards (who won), planning = prior information. Empty = all.", "items": { "type": "string", "enum": [ "tender", "award", "planning" ] }, "default": [ "tender" ] }, "keywords": { "title": "Keywords", "type": "array", "description": "Case-insensitive match on title/description. Empty = no keyword filter.", "default": [], "items": { "type": "string" } }, "cpvCodes": { "title": "CPV codes", "type": "array", "description": "CPV codes, prefix match: 72 matches all IT services (72000000), 45442100 matches exactly. Empty = all categories.", "default": [], "items": { "type": "string" } }, "daysBack": { "title": "Days back", "minimum": 1, "maximum": 90, "type": "integer", "description": "Only notices published in the last N days (one bulk download per day).", "default": 7 }, "maxItems": { "title": "Max items", "minimum": 1, "type": "integer", "description": "Hard cap on returned notices (also caps your cost).", "default": 200 }, "mode": { "title": "Mode", "enum": [ "search", "digest" ], "type": "string", "description": "search = dataset only; digest = dataset + markdown digest in key-value store (key DIGEST).", "default": "search" } } }, "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 } } } } } } } } } } ```