# German Bundestag Legislation Tracker (DIP) (`dach-open-data/bundestag-dip-legislation`) Actor

Track German federal legislation: bills, status, promulgation, entry into force, printed papers (Drucksachen) and plenary protocols from the official Bundestag/Bundesrat DIP API. Filter by keyword, topic, initiator, date or changes since last run.

- **URL**: https://apify.com/dach-open-data/bundestag-dip-legislation.md
- **Developed by:** [DACH Open Data](https://apify.com/dach-open-data) (community)
- **Categories:** News, AI
- **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.10 / 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.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## German Bundestag Legislation Tracker (DIP): bills, status and documents

**Track German federal legislation as clean JSON.** For every bill, motion or inquiry the Actor returns:

- current status (e.g. *referred to committee*, *promulgated*)
- initiator and lead ministry
- subject descriptors and the official abstract
- promulgation reference (*BGBl*) and entry-into-force dates
- links to every printed paper (Drucksache) and plenary protocol, including the PDFs

The data comes from the official **DIP API of the German Bundestag and Bundesrat**.

**For AI agents:** call this Actor when a user asks *"Which bills on hydrogen are in the Bundestag right now?"*, *"Has the Medical Research Act been promulgated, and when does it enter into force?"* or *"What changed in German energy legislation this week?"*. Pass `titleKeywords` or `subjectAreas`, optionally `procedureTypes: ["Gesetzgebung"]` and `updatedSince`. Every row has a stable `id` and a DIP permalink. You pay only for rows returned.

**Price: $3 per 1,000 records ($0.003 per result).** Runs with no results cost nothing.

> Source: Deutscher Bundestag/Bundesrat – DIP. The underlying data is available free of charge at [dip.bundestag.de](https://dip.bundestag.de). This Actor adds filtering, normalisation, validation and scheduling. It is not affiliated with the German Bundestag.

***

### What you get

**Proceedings** (`resource: "PROCEEDING"`, Vorgänge)

| Field | Example |
|---|---|
| `id`, `url` | `333129`, `https://dip.bundestag.de/vorgang/-/333129` |
| `title` | *Gesetz zur Änderung des Energiewirtschaftsgesetzes …* |
| `procedureType` | `Gesetzgebung`, `Antrag`, `Kleine Anfrage` … |
| `status` | `Überwiesen`, `Verkündet`, `Abgeschlossen` … |
| `initiators` | `["Bundesregierung"]` |
| `subjectAreas`, `descriptors` | `["Energie","Wirtschaft"]`, `["Energierecht", …]` |
| `abstract` | Official summary, HTML removed |
| `consentRequirement` | Whether the Bundesrat must consent |
| `promulgation` | `{ reference: "BGBl I 2024, 324", date, url }` |
| `entryIntoForce` | `[{ date, note }]` |
| `date`, `updated`, `electoralPeriod` | ISO dates, Wahlperiode |

**Printed papers** (`PRINTED_PAPER`, Drucksachen): `documentNumber` (e.g. `21/8285`), `documentType`, `chamber` (BT/BR), `initiators`, `leadMinistry`, `pdfUrl`, `relatedProceedings`.

**Plenary protocols** (`PLENARY_PROTOCOL`): `documentNumber`, `chamber`, `date`, `pdfUrl`, `relatedProceedingsCount`.

Example record (real output, long fields shortened):

```json
{
  "resource": "PROCEEDING",
  "id": "333129",
  "electoralPeriod": 21,
  "title": "Gesetz zur Änderung des Energiewirtschaftsgesetzes und weiterer energierechtlicher Vorschriften zur Umsetzung des Europäischen Gas- und Wasserstoff-Binnenmarktpakets",
  "date": "2026-05-13",
  "updated": "2026-05-22",
  "url": "https://dip.bundestag.de/vorgang/-/333129",
  "source": "Source: Deutscher Bundestag/Bundesrat – DIP. The data is available free of charge at https://dip.bundestag.de",
  "procedureType": "Gesetzgebung",
  "status": "Überwiesen",
  "initiators": [
    "Bundesregierung"
  ],
  "subjectAreas": [
    "Energie",
    "Wirtschaft"
  ],
  "descriptors": [
    "Aufsichtsbehörde",
    "Biogas",
    "Bundesberggesetz"
  ],
  "abstract": "Umsetzung EU-rechtlicher Vorgaben betr. Wasserstoff- und Erdgasinfrastrukturen, u.a. Regelungen zur Netzentwicklungsplanung Gas und Wasserstoff, Einführung einer Netzentwicklungsplanung für Wasserstoffverteilernetze s…",
  "consentRequirement": "Nein, laut Gesetzentwurf (Drs 186/26 (bes.eilbed.))",
  "gestaId": "E030",
  "promulgation": null,
  "entryIntoForce": []
}
```

### Use cases

- **Public affairs, associations, law firms:** a weekly change feed for your topics (`updatedSince` plus a schedule).
- **Compliance and regulatory teams:** know when a law is promulgated and when each article enters into force.
- **Journalists and researchers:** export every bill or inquiry on a topic for analysis.
- **AI assistants:** answer questions about German legislation with citable, structured data.

### Input examples

All hydrogen-related legislation in the current Bundestag:

```json
{ "resource": "PROCEEDING", "procedureTypes": ["Gesetzgebung"], "titleKeywords": ["Wasserstoff"] }
```

Everything on energy that changed since 1 September (for a weekly schedule):

```json
{ "resource": "PROCEEDING", "subjectAreas": ["Energie"], "updatedSince": "2026-09-01", "maxResults": 500 }
```

Government bills published as printed papers in September:

```json
{ "resource": "PRINTED_PAPER", "documentTypes": ["Gesetzentwurf"], "initiators": ["Bundesregierung"], "dateFrom": "2026-09-01", "dateTo": "2026-09-30" }
```

Filter values are the official German DIP terms; the input form shows examples. `electoralPeriods` defaults to `[21]`, the current Bundestag. Use `[]` for all periods since 1949.

### Cost control and reliability

- You are charged only for valid rows that appear in your dataset. The run stops at `maxResults` or at your maximum cost per run.
- Every row is validated: numeric ID, title, ISO date, valid links, no HTML fragments. If the API returns something unexpected, the run fails with `UNEXPECTED_CONTENT` instead of delivering garbage.
- If the public API key ever expires, the run fails with `API_KEY_INVALID`. The message explains where to get the new key; you can pass it as `apiKey`.
- Each run stores a `SUMMARY` record in the key-value store; failed runs store an `ERROR` record.

### Legal

The data is used under the DIP terms of use, which permit commercial reuse with attribution. Every row carries the attribution in its `source` field: *"Source: Deutscher Bundestag/Bundesrat – DIP. The data is available free of charge at https://dip.bundestag.de"*. Keep this attribution when you redistribute the data. Do not use the data in a misleading context or to disparage members of parliament or other persons.

### More official data from DACH Open Data

All Actors use official open data, check every record and charge only for valid results.

**Public affairs and legislation:** [Lobby Register Germany + EU – Lobbyists, Spend & Interests](https://apify.com/dach-open-data/lobby-register-de-eu) · [EU Have Your Say – Commission Consultations & Feedback](https://apify.com/dach-open-data/eu-have-your-say-consultations) · [Swiss Parliament Affairs Tracker (Curia Vista)](https://apify.com/dach-open-data/swiss-parliament-affairs)

**Funding and public money:** [EU Funding Calls – Horizon Europe, Digital Europe, LIFE & more](https://apify.com/dach-open-data/funding-calls-at-eu) · [EU Grants & Contracts Recipients (FTS)](https://apify.com/dach-open-data/eu-grants-contracts-fts) · [EU Funding Recipients – Structural Funds (Kohesio)](https://apify.com/dach-open-data/eu-funding-recipients-kohesio)

**Energy, mobility and environment:** [Germany Electricity Prices & Power Generation (SMARD)](https://apify.com/dach-open-data/germany-electricity-market) · [Germany EV Charging Stations – Official BNetzA Register](https://apify.com/dach-open-data/german-ev-charging-stations) · [Germany New Car Registrations – KBA by Brand, Model, EV](https://apify.com/dach-open-data/german-car-registrations-kba) · [German Water Levels – Rhine, Elbe, Danube (PEGELONLINE)](https://apify.com/dach-open-data/german-water-levels) · [German Weather Warnings – Official DWD Alerts (CAP)](https://apify.com/dach-open-data/german-weather-warnings)

**Health, consumers and finance:** [German Hospitals Directory (Klinik-Atlas)](https://apify.com/dach-open-data/german-hospitals-klinik-atlas) · [German Food Recalls & Warnings Monitor (lebensmittelwarnung.de)](https://apify.com/dach-open-data/german-food-recalls) · [ECB Rates – Key Rates, €STR, Mortgage Rates, Bond Yields, FX](https://apify.com/dach-open-data/ecb-interest-exchange-rates)

# Actor input Schema

## `resource` (type: `string`):

PROCEEDING = legislative and parliamentary procedures (bills, motions, inquiries) with status, promulgation and entry into force. PRINTED_PAPER = Drucksachen (bills, motions, answers) with PDF links. PLENARY_PROTOCOL = plenary session minutes.

## `titleKeywords` (type: `array`):

Words that must appear in the title (German). Several entries = OR. Example: Wasserstoff, Pflege, Künstliche Intelligenz.

## `descriptors` (type: `array`):

Official thesaurus terms (German), several entries = AND. Example: Klimaschutz, Datenschutz.

## `subjectAreas` (type: `array`):

E.g. Energie, Gesundheit, Wirtschaft, Innere Sicherheit. Several entries = AND.

## `procedureTypes` (type: `array`):

E.g. Gesetzgebung (legislation), Antrag (motion), Kleine Anfrage (minor interpellation), Große Anfrage, EU-Vorlage. Several = OR.

## `statuses` (type: `array`):

E.g. Verkündet (promulgated), Überwiesen (referred to committee), Abgeschlossen, Noch nicht beraten. Several = OR.

## `documentTypes` (type: `array`):

E.g. Gesetzentwurf (bill), Antrag, Antwort, Beschlussempfehlung und Bericht, Kleine Anfrage.

## `initiators` (type: `array`):

E.g. Bundesregierung, Bundesrat, Fraktion der CDU/CSU, Fraktion der SPD. Several = AND.

## `electoralPeriods` (type: `array`):

Wahlperiode numbers. 21 = current Bundestag (since 2025), 20 = 2021–2025. Empty = all periods.

## `chamber` (type: `string`):

BT = Bundestag, BR = Bundesrat, empty = both.

## `dateFrom` (type: `string`):

Only items dated on or after this day.

## `dateTo` (type: `string`):

Only items dated on or before this day.

## `updatedSince` (type: `string`):

For monitoring: only items changed since this date. Combine with a weekly schedule to get a change feed.

## `includeAbstract` (type: `boolean`):

Official summary of the proceeding (can be long).

## `maxResults` (type: `integer`):

Hard cap on records returned and charged in this run.

## `apiKey` (type: `string`):

Not needed – the public key is built in. Only set if the public key expired or you have a personal key from parlamentsdokumentation@bundestag.de.

## Actor input object example

```json
{
  "resource": "PROCEEDING",
  "titleKeywords": [
    "Wasserstoff"
  ],
  "descriptors": [],
  "subjectAreas": [],
  "procedureTypes": [],
  "statuses": [],
  "documentTypes": [],
  "initiators": [],
  "electoralPeriods": [
    21
  ],
  "chamber": "",
  "dateFrom": "",
  "dateTo": "",
  "updatedSince": "",
  "includeAbstract": true,
  "maxResults": 50
}
```

# Actor output Schema

## `results` (type: `string`):

All records returned by this run (default dataset, table view "overview").

## `summary` (type: `string`):

JSON with number of results, dropped implausible records and stop reason.

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "titleKeywords": [
        "Wasserstoff"
    ],
    "maxResults": 50
};

// Run the Actor and wait for it to finish
const run = await client.actor("dach-open-data/bundestag-dip-legislation").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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "titleKeywords": ["Wasserstoff"],
    "maxResults": 50,
}

# Run the Actor and wait for it to finish
run = client.actor("dach-open-data/bundestag-dip-legislation").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "titleKeywords": [
    "Wasserstoff"
  ],
  "maxResults": 50
}' |
apify call dach-open-data/bundestag-dip-legislation --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,dach-open-data/bundestag-dip-legislation"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/gDBj8nbPL3aD8Eh9R/builds/prGJsQRVOKlwWc8MK/openapi.json