{ "openapi": "3.0.1", "info": { "title": "German Construction Tenders + GAEB Bill of Quantities Extractor", "description": "German public construction tenders from the official oeffentlichevergabe.de API with their GAEB bills of quantities (.x83/.d83/.p83) as clean JSON: OZ, short/long text, quantity, unit. Plus deadline and location. No portal account needed.", "version": "1.4", "x-build-id": "wGAx7tPlp09t6Er45" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/brsksr~german-construction-tenders-gaeb/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-brsksr-german-construction-tenders-gaeb", "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/brsksr~german-construction-tenders-gaeb/runs": { "post": { "operationId": "runs-sync-brsksr-german-construction-tenders-gaeb", "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/brsksr~german-construction-tenders-gaeb/run-sync": { "post": { "operationId": "run-sync-brsksr-german-construction-tenders-gaeb", "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": { "pubDaysBack": { "title": "Days back", "minimum": 1, "maximum": 30, "type": "integer", "description": "Number of calendar days to load, counting back from yesterday (today's export is published the next day). Weekends are included; they usually carry fewer notices.", "default": 3 }, "pubDays": { "title": "Explicit publication days", "type": "array", "description": "Optional list of specific publication days, each in YYYY-MM-DD format (one day per entry). Overrides 'Days back'. Leave empty for a rolling daily search.", "items": { "type": "string" } }, "cpvPrefixes": { "title": "CPV code prefixes", "type": "array", "description": "Keep notices with at least one CPV code starting with one of these prefixes. 45 = all construction work, 453 = building installation work, 4526 = roof works, 45233 = road construction. Leave empty for all categories.", "default": [ "45" ], "items": { "type": "string" } }, "postalCodePrefixes": { "title": "Postal code prefixes (PLZ)", "type": "array", "description": "Keep only tenders whose place of performance (or, if missing, the contracting authority's seat in the same district) has a German postal code starting with one of these prefixes, e.g. [\"10\", \"80\"] for the Berlin and Munich areas. Notices without a postal code are excluded while this filter is set.", "items": { "type": "string" } }, "nutsPrefixes": { "title": "NUTS region prefixes", "type": "array", "description": "Keep only tenders whose place of performance lies in these NUTS regions. DE = all of Germany. Federal states: DE1 Baden-Württemberg, DE2 Bayern, DE3 Berlin, DE4 Brandenburg, DE5 Bremen, DE6 Hamburg, DE7 Hessen, DE8 Mecklenburg-Vorpommern, DE9 Niedersachsen, DEA Nordrhein-Westfalen, DEB Rheinland-Pfalz, DEC Saarland, DED Sachsen, DEE Sachsen-Anhalt, DEF Schleswig-Holstein, DEG Thüringen. Districts work too, e.g. DEA22 (Bonn).", "items": { "type": "string" } }, "keywords": { "title": "Keywords (title, description and LV positions)", "type": "array", "description": "Optional, case-insensitive. A tender is kept if a keyword appears in its title/description OR in the short or long text of any GAEB position, e.g. a product or material such as \"Wärmepumpe\", \"Gussasphalt\" or \"Rohrrahmentür\". Matching positions are listed in 'keywordPositionHits'.", "items": { "type": "string" } }, "onlyWithGaeb": { "title": "Only tenders with a parsed GAEB bill of quantities", "type": "boolean", "description": "If enabled (recommended), only tenders with at least one extracted GAEB position are written to the dataset. If disabled, all matching notices are written, including those without documents; these extra records are free of charge.", "default": true }, "maxTenders": { "title": "Max tenders in output", "minimum": 1, "maximum": 10000, "type": "integer", "description": "The run stops after this many dataset items. Use it to cap your costs.", "default": 50 }, "portals": { "title": "Document portals", "type": "array", "description": "Document portals to download from.", "items": { "type": "string", "enum": [ "evergabe-online", "cosinex", "evergabe-de", "subreport", "netserver", "healy-hudson", "deutsche-evergabe", "rib" ], "enumTitles": [ "evergabe-online.de (federal e-procurement platform)", "cosinex marketplaces (dtvp.de, evergabe.nrw.de, vergabe.niedersachsen.de, vergabemarktplatz.brandenburg.de, ...)", "evergabe.de (most tenders from Saxony, Saxony-Anhalt and Thuringia)", "subreport ELViS (subreport-elvis.de; opened in a headless browser, only started when such tenders are found)", "AI NetServer platforms (Die Autobahn GmbH, HAD / eHAD Hessen, vergabe.hessen.de, Land BW, Bremen, Düsseldorf, Köln, tender24, ...)", "Healy Hudson bidder portals (Deutsche Bahn bieterportal.noncd.db.de, Hamburg fbhh-evergabe, ...)", "Deutsche eVergabe (deutsche-evergabe.de, incl. partner system)", "RIB meinauftrag (Vergabeplattform Bayern, Berlin, Stuttgart, Hannover, GMSH, ...; GAEB only if published by the authority)" ] }, "default": [ "evergabe-online", "cosinex", "evergabe-de", "subreport", "netserver", "healy-hudson", "deutsche-evergabe", "rib" ] }, "downloadMode": { "title": "Download mode", "enum": [ "direct", "zip" ], "type": "string", "description": "direct: download only the listed GAEB files and LV sub-archives (fast, little traffic) and fall back to the complete ZIP only if nothing was found. zip: always download the complete tender ZIP.", "default": "direct" }, "maxZipSizeMb": { "title": "Max download size per file", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Largest file loaded into memory; keep the Actor memory at least 4 times this value. Tender archives on subreport ELViS and the Healy Hudson portals (e.g. Deutsche Bahn) may be up to 2.5 times larger: they are streamed to the container disk and only their GAEB files are read into memory. Raise this value to search very large archives (e.g. 500 MB Deutsche Bahn track-construction packages); longer downloads mean higher run costs.", "default": 100 }, "includeLongText": { "title": "Include long texts", "type": "boolean", "description": "Include the full long text (Langtext) of every position. Disable for smaller items if you only need short texts and quantities.", "default": true }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 10, "type": "integer", "description": "Number of tenders processed in parallel. Keep it low to stay polite to the public portals.", "default": 3 } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }