{
  "openapi": "3.0.1",
  "info": {
    "title": "German Public Tenders Scraper – service.bund.de Ausschreibungen",
    "description": "German public tenders (Ausschreibungen) from the official service.bund.de portal as flat JSON: title, contracting authority, location, category, procedure, CPV, deadline. Filter by keyword, Bundesland, category, date. For B2B lead alerts. Pay per tender.",
    "version": "1.0",
    "x-build-id": "Ar4coxI4cS9ePkfKC"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/fast_data_asap~german-public-tenders-bund/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-fast_data_asap-german-public-tenders-bund",
        "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/fast_data_asap~german-public-tenders-bund/runs": {
      "post": {
        "operationId": "runs-sync-fast_data_asap-german-public-tenders-bund",
        "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/fast_data_asap~german-public-tenders-bund/run-sync": {
      "post": {
        "operationId": "run-sync-fast_data_asap-german-public-tenders-bund",
        "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": {
          "keywords": {
            "title": "Keywords",
            "type": "array",
            "description": "Search terms (German works best, e.g. Software, Reinigung, Dachsanierung, Beratung). Each keyword is searched separately and results are merged without duplicates. Leave empty to get the newest tenders of all topics.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "states": {
            "title": "Bundesland (state)",
            "type": "array",
            "description": "Only tenders whose place of performance is in these German states. Empty = all of Germany.",
            "items": {
              "type": "string",
              "enum": [
                "Baden-Württemberg",
                "Bayern",
                "Berlin",
                "Brandenburg",
                "Bremen",
                "Hamburg",
                "Hessen",
                "Mecklenburg-Vorpommern",
                "Niedersachsen",
                "Nordrhein-Westfalen",
                "Rheinland-Pfalz",
                "Saarland",
                "Sachsen",
                "Sachsen-Anhalt",
                "Schleswig-Holstein",
                "Thüringen",
                "Bundesweit / ohne Angabe"
              ]
            },
            "default": []
          },
          "categories": {
            "title": "Category (Leistungen und Erzeugnisse)",
            "type": "array",
            "description": "Construction works (Bauleistungen), services (Dienstleistungen), supplies (Lieferleistungen) or a finer category. Empty = all.",
            "items": {
              "type": "string",
              "enum": [
                "Bauleistungen",
                "Dienstleistungen",
                "Lieferleistungen",
                "Informationstechnik",
                "Forschung und Entwicklung",
                "Arbeitsmarktdienstleistungen",
                "Kraftfahrwesen",
                "Kommunikations- und Elektrotechnik",
                "Maschinen",
                "Medizintechnik",
                "Bekleidung, Möbel und Druck",
                "Energiequellen",
                "Lebensmittel"
              ]
            },
            "default": []
          },
          "lastDays": {
            "title": "Published in the last N days",
            "minimum": 0,
            "maximum": 365,
            "type": "integer",
            "description": "Only tenders published within this many days. 0 = no date limit (everything currently open on the portal).",
            "default": 14
          },
          "maxItems": {
            "title": "Max tenders",
            "minimum": 1,
            "maximum": 2000,
            "type": "integer",
            "description": "Maximum number of tenders returned (and charged) per run.",
            "default": 50
          },
          "includeDetails": {
            "title": "Include details (category, procedure, CPV, state)",
            "type": "boolean",
            "description": "Opens each tender's public detail page to add category, procedure rules (VOB/VgV/UVgO), procedure type, EU/national scope, CPV codes, Bundesland and the link to the official notice. Slightly slower.",
            "default": true
          },
          "procedureRules": {
            "title": "Procedure rules (Vergabeverfahren)",
            "type": "array",
            "description": "Optional filter by procurement regulation.",
            "items": {
              "type": "string",
              "enum": [
                "VOB",
                "VgV",
                "VOL",
                "UVgO",
                "VOF",
                "SektVO",
                "KonzVgV",
                "VSVgV",
                "Sonstige"
              ]
            },
            "default": []
          },
          "excludeKeywords": {
            "title": "Exclude words in title",
            "type": "array",
            "description": "Drop tenders whose title contains any of these words (case-insensitive).",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "awardedContracts": {
            "title": "Awarded contracts instead of open tenders",
            "type": "boolean",
            "description": "Return awarded contracts (Vergebene Aufträge) instead of open calls for tenders – useful for competitor and market research.",
            "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
                  },
                  "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}