# Deutsche Gerichtsentscheidungen API (`fuchsblau/court-decisions-de`) Actor - **URL**: https://apify.com/fuchsblau/court-decisions-de.md - **Developed by:** [Matthias Nitsch](https://apify.com/fuchsblau) (community) - **Categories:** AI, Developer tools, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing from $5.00 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. 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.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.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/platform/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 ## Deutsche Gerichtsentscheidungen API – Rechtsprechung JSON Programmatischer Zugriff auf **deutsche Gerichtsentscheidungen** aus den offiziellen Open-Data-Quellen des Bundes. Suchen, filtern und exportieren Sie die Rechtsprechung der deutschen Bundesgerichte als strukturiertes JSON – per REST-API oder als Run über die Apify-Plattform. Jede Entscheidung kommt mit **ECLI, Aktenzeichen, Leitsatz, Tenor und Entscheidungsgründen**. **Kein API-Schlüssel nötig, kein Scraping, kein Login.** ### Für wen ist das gedacht? - **Legal-Tech-Entwicklung** – deutsche Rechtsprechung in eigene Anwendungen, Datenbanken oder Such-Pipelines einbinden, ohne selbst zu scrapen. - **Compliance & Due Diligence** – neue Entscheidungen zu einem Rechtsgebiet beobachten und als Datensatz exportieren (z. B. alle BAG-Entscheidungen zu „Kündigungsschutz" seit 2023). - **Recht-Research & KI-Agenten** – Entscheidungen programmatisch durchsuchen, abrufen und in Analyse- oder RAG-Pipelines weiterverarbeiten. Der **Job**: deutsche Rechtsprechung programmatisch durchsuchen und exportieren – als JSON, nicht als HTML-Seite, ohne eigenen Scraper und ohne Abo-Datenbank. > **KI-Agenten (MCP):** Dieses DE-Listing ist REST-API/Run. Den **MCP-Server** für KI-Agenten > (Claude Desktop, Cursor) stellt das übergreifende Aggregat-Listing **„Court Decisions MCP + API"** > bereit – deutsche Entscheidungen inklusive (`source=de`). Für MCP also dort einbinden. ### Warum dieses Werkzeug? Deutsche Rechtsprechung ist öffentlich, aber für den maschinellen Zugriff bisher schlecht erschlossen: | Weg | Programmatischer Zugang | |-----|-------------------------| | Premium-Abo-Datenbanken (z. B. juris, beck-online) | Lizenzgebunden, üblicherweise kein offener API-Zugang | | Freie Recherche-Portale (z. B. dejure.org, openJur) | Auf Web-Recherche ausgelegt, kein strukturierter Datensatz-Export | | Eigener Scraper | Wartung, Layout-Brüche, mögliche Sperren | | **Dieses Werkzeug** | **Offizielle Open-Data-API → strukturiertes JSON** | Der Zugriff erfolgt ausschließlich über die offizielle öffentliche API von NeuRIS – kein Scraping, kein API-Schlüssel. ### Welche Gerichte sind abgedeckt? Quelle ist **NeuRIS** ([rechtsinformationen.bund.de](https://www.rechtsinformationen.bund.de)), das Rechtsinformationssystem des Bundes. Abgedeckt sind die deutschen Bundesgerichte: | Gericht | Kürzel | Rechtsgebiet | |---------|--------|--------------| | Bundesgerichtshof | BGH | Zivil- und Strafrecht | | Bundesverfassungsgericht | BVerfG | Verfassungsrecht | | Bundesverwaltungsgericht | BVerwG | Verwaltungsrecht | | Bundesfinanzhof | BFH | Steuerrecht | | Bundesarbeitsgericht | BAG | Arbeitsrecht | | Bundessozialgericht | BSG | Sozialrecht | | Bundespatentgericht | BPatG | Patentrecht | Die Suche ist **volltextfähig**: Treffer werden per BM25-Volltextabgleich kombiniert mit der nativen Reihenfolge der Quelle (Reciprocal Rank Fusion) sortiert. Alternativ lässt sich nach Datum sortieren (neueste zuerst). ### Schnell loslegen Wählen Sie eine Aktion, setzen Sie die Parameter, starten Sie den Run – die Ergebnisse laden Sie im Tab **Dataset** als JSON, CSV oder Excel herunter. Ein Länderfeld ist **nicht** nötig: dieses Werkzeug liefert standardmäßig deutsche Entscheidungen. #### Option A: Als Apify-Actor 1. Aktion wählen: **Entscheidungen suchen**, **Entscheidung per ECLI abrufen** oder **Gerichte auflisten** 2. Parameter setzen (z. B. Suchbegriff, Gericht, Zeitraum) 3. Run starten und Ergebnisse im Dataset-Tab herunterladen #### Option B: REST-API Rufen Sie die Endpunkte direkt aus einem beliebigen HTTP-Client auf: ```bash ## Entscheidungen suchen curl "https://--court-decisions-de.apify.actor/api/search?query=Datenschutz" ## Nach Gericht und Zeitraum filtern curl "https://--court-decisions-de.apify.actor/api/search?query=Kündigungsschutz&court=BAG&dateFrom=2023-01-01" ## Eine bestimmte Entscheidung per ECLI abrufen curl "https://--court-decisions-de.apify.actor/api/decisions/ECLI:DE:BAG:2023:210323.U.2AZR45.22.0" ## Verfügbare Gerichte auflisten curl "https://--court-decisions-de.apify.actor/api/courts" ```` ### Eingabeparameter | Feld | Beschreibung | |------|--------------| | `action` | `search`, `getByEcli` oder `listCourts` (Standard: `search`) | | `query` | Volltext-Suchbegriff (z. B. „Datenschutz", „Kündigungsschutz") | | `court` | Gerichtskürzel als Filter (z. B. `BGH`, `BVerfG`). Optional | | `dateFrom` / `dateTo` | Zeitraum-Filter (JJJJ-MM-TT). Optional | | `limit` | Maximale Trefferzahl (1–300, Standard 50) | | `sort` | `relevance` (Standard) oder `date` | | `ecli` | ECLI-Kennung für die Aktion `getByEcli` | ### Ausgabe Jede Entscheidung wird als strukturiertes JSON geliefert: ECLI, Gericht, Datum, Aktenzeichen, Entscheidungsart sowie – soweit von der Quelle bereitgestellt – Leitsatz, Orientierungssatz, Tenor und Entscheidungsgründe. Das Schema ist über alle Aktionen einheitlich. #### Beispiel-Ausgabe ```json { "ecli": "ECLI:DE:BAG:2023:210323.U.2AZR45.22.0", "source": "de", "court": { "name": "Bundesarbeitsgericht", "abbreviation": "BAG" }, "date": "2023-03-21", "fileNumber": "2 AZR 45/22", "decisionType": "Urteil", "guidingPrinciple": "Zur Sozialauswahl bei betriebsbedingter Kündigung ...", "tenor": "Die Revision der Beklagten wird zurückgewiesen ...", "keywords": ["Kündigungsschutz", "Arbeitsrecht", "Sozialauswahl"] } ``` (Beispielwerte zur Veranschaulichung der Feldstruktur.) ### Preis Abrechnung über das Pay-per-Event-Modell von Apify: **$0.01 pro Result-Item** – kein Abo, kein Mindestumsatz. Keine Treffer = keine Kosten. Den genauen Preis zeigt der **Pricing**-Tab. ### Datenquelle & Rechtslage Die Daten stammen aus **NeuRIS** (rechtsinformationen.bund.de), dem offiziellen Rechtsinformationssystem des Bundes, und werden als **Open Data** bereitgestellt. Es findet kein Scraping statt – der Zugriff erfolgt ausschließlich über die offizielle öffentliche API. Amtliche Entscheidungstexte deutscher Gerichte sind nach § 5 UrhG gemeinfrei. Hinweis: NeuRIS befindet sich seit April 2025 in der öffentlichen Testphase; gelegentliche Instabilität der Quelle ist möglich. Der Zugriff enthält automatische Wiederholversuche mit ansteigendem Backoff. Dieses Werkzeug deckt **Deutschland** ab. Für eine länderübergreifende Suche über Deutschland, Österreich, die Niederlande und die EU steht das übergreifende Aggregat-Listing „Court Decisions MCP + API" zur Verfügung (MCP-Hinweis siehe oben). # Actor input Schema ## `action` (type: `string`): Wählen Sie, was geschehen soll: nach Entscheidungen suchen, eine bestimmte Entscheidung per ECLI abrufen oder die verfügbaren Gerichte auflisten. ## `query` (type: `string`): Volltext-Suchbegriff (z. B. "Datenschutz", "Kündigungsschutz"). ## `court` (type: `string`): Filter nach Gerichtskürzel. Deutsche Bundesgerichte: BGH, BVerfG, BVerwG, BFH, BAG, BSG, BPatG. Optional. ## `dateFrom` (type: `string`): Nur Entscheidungen ab diesem Datum zurückgeben (JJJJ-MM-TT). Optional. ## `dateTo` (type: `string`): Nur Entscheidungen bis zu diesem Datum zurückgeben (JJJJ-MM-TT). Optional. ## `limit` (type: `integer`): Maximale Anzahl der zurückgegebenen Treffer (1–300). ## `sort` (type: `string`): Sortierung der Treffer. "Relevanz" (Standard) ordnet die Treffer per Volltext-Matching (BM25) kombiniert mit der nativen Reihenfolge der Quelle (Reciprocal Rank Fusion) – einschlägige Entscheidungen erscheinen ohne Blättern in den ersten 5–10 Treffern. "Datum" sortiert alle Treffer nach Datum, neueste zuerst. ## `ecli` (type: `string`): European Case Law Identifier (z. B. ECLI:DE:BGH:2024:120324UVIZR234.23.0). ## Actor input object example ```json { "action": "search", "query": "Kündigungsschutz", "limit": 50, "sort": "relevance" } ``` # Actor output Schema ## `decisions` (type: `string`): Search results, individual court decisions, or court listings as structured JSON objects in the default dataset. ## `cache` (type: `string`): Previously retrieved court decisions cached by ECLI for faster repeated access (7-day TTL). # 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 = { "query": "Kündigungsschutz" }; // Run the Actor and wait for it to finish const run = await client.actor("fuchsblau/court-decisions-de").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 = { "query": "Kündigungsschutz" } # Run the Actor and wait for it to finish run = client.actor("fuchsblau/court-decisions-de").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 '{ "query": "Kündigungsschutz" }' | apify call fuchsblau/court-decisions-de --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=fuchsblau/court-decisions-de", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Deutsche Gerichtsentscheidungen API", "description": null, "version": "2.0", "x-build-id": "itEg0JlLYgnXXFFby" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fuchsblau~court-decisions-de/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fuchsblau-court-decisions-de", "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/fuchsblau~court-decisions-de/runs": { "post": { "operationId": "runs-sync-fuchsblau-court-decisions-de", "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/fuchsblau~court-decisions-de/run-sync": { "post": { "operationId": "run-sync-fuchsblau-court-decisions-de", "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", "required": [ "action" ], "properties": { "action": { "title": "Aktion", "enum": [ "search", "getByEcli", "listCourts" ], "type": "string", "description": "Wählen Sie, was geschehen soll: nach Entscheidungen suchen, eine bestimmte Entscheidung per ECLI abrufen oder die verfügbaren Gerichte auflisten.", "default": "search" }, "query": { "title": "Suchbegriff", "type": "string", "description": "Volltext-Suchbegriff (z. B. \"Datenschutz\", \"Kündigungsschutz\")." }, "court": { "title": "Gericht (Filter)", "type": "string", "description": "Filter nach Gerichtskürzel. Deutsche Bundesgerichte: BGH, BVerfG, BVerwG, BFH, BAG, BSG, BPatG. Optional." }, "dateFrom": { "title": "Datum von", "type": "string", "description": "Nur Entscheidungen ab diesem Datum zurückgeben (JJJJ-MM-TT). Optional." }, "dateTo": { "title": "Datum bis", "type": "string", "description": "Nur Entscheidungen bis zu diesem Datum zurückgeben (JJJJ-MM-TT). Optional." }, "limit": { "title": "Maximale Trefferzahl", "minimum": 1, "maximum": 300, "type": "integer", "description": "Maximale Anzahl der zurückgegebenen Treffer (1–300).", "default": 50 }, "sort": { "title": "Sortierung", "enum": [ "relevance", "date" ], "type": "string", "description": "Sortierung der Treffer. \"Relevanz\" (Standard) ordnet die Treffer per Volltext-Matching (BM25) kombiniert mit der nativen Reihenfolge der Quelle (Reciprocal Rank Fusion) – einschlägige Entscheidungen erscheinen ohne Blättern in den ersten 5–10 Treffern. \"Datum\" sortiert alle Treffer nach Datum, neueste zuerst.", "default": "relevance" }, "ecli": { "title": "ECLI-Kennung", "type": "string", "description": "European Case Law Identifier (z. B. ECLI:DE:BGH:2024:120324UVIZR234.23.0)." } } }, "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 } } } } } } } } } } ```