# German Insolvency Announcements Scraper (`studio-amba/insolvenzbekanntmachungen-scraper`) Actor Search and extract German insolvency announcements from the official portal. Filter by company name, state, court, date range, or proceeding type. Returns debtor name, court, case number, proceeding type, and full announcement text. No cookies, no login. - **URL**: https://apify.com/studio-amba/insolvenzbekanntmachungen-scraper.md - **Developed by:** [Studio Amba](https://apify.com/studio-amba) (community) - **Categories:** E-commerce - **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## 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 ## German Insolvency Announcements — Bankruptcy Data Scraper Search and extract German insolvency announcements from the official court portal (insolvenzbekanntmachungen.de). Filter by company name, federal state, court, city, proceeding type, or date range. Returns debtor name, address, court, case number, proceeding type, full announcement text, and insolvency administrator. No cookies, no login required. ### How to scrape German insolvency data This actor searches the official German insolvency announcements portal, operated by the NRW Ministry of Justice on behalf of all 16 federal states. Every German insolvency proceeding — from initial filing through final distribution — is published here. The portal is the canonical source for German bankruptcy data. #### Search by Company or Person Name Enter a debtor's name (company or individual) to find all insolvency announcements. Minimum 2 characters. Wildcards are supported for broader searches. #### Filter by State, Court, or City Narrow to a specific federal state, insolvency court, or city. Useful for regional credit risk monitoring or local market analysis. #### Filter by Proceeding Type Focus on specific stages: opening of proceedings (Eröffnung), rejection for lack of assets (Abweisung mangels Masse), discharge of residual debt (Restschuldbefreiung), or insolvency plans. ### What data does German Insolvency Announcements Scraper extract? | Field | Type | Description | |-------|------|-------------| | **debtorName** | String | Debtor company or person name | | **debtorAddress** | String | Debtor's registered address | | **city** | String | City | | **postalCode** | String | German postal code (PLZ) | | **state** | String | Federal state (Bundesland) | | **court** | String | Insolvency court (Amtsgericht) | | **caseNumber** | String | Court case number (Aktenzeichen) | | **proceedingType** | String | Type of proceeding (opening, rejection, discharge, etc.) | | **releaseDate** | String | Date of announcement | | **announcementText** | String | Full announcement text (up to 5,000 characters) | | **administratorName** | String | Insolvency administrator name | | **url** | String | Source URL | | **scrapedAt** | String | ISO timestamp | ### Example output ```json { "debtorName": "Muster GmbH", "debtorAddress": "Hauptstrasse 1, 10115 Berlin", "city": "Berlin", "postalCode": "10115", "state": "Berlin", "court": "Amtsgericht Charlottenburg", "caseNumber": "36n IN 1234/26", "proceedingType": "Eröffnung des Insolvenzverfahrens", "releaseDate": "19.05.2026", "announcementText": "In dem Insolvenzverfahren über das Vermögen der Muster GmbH...", "administratorName": "Dr. Hans Schmidt", "url": "https://neu.insolvenzbekanntmachungen.de/ap/suche.jsf", "scrapedAt": "2026-05-20T14:30:00.000Z" } ```` ### Tips for best results - **Credit risk monitoring**: Run daily with a state or city filter to catch new insolvencies in your market. Early detection of supplier or customer bankruptcy can save significant losses. - **Due diligence**: Search by company name before entering a business relationship. Check if potential partners have any insolvency history. - **Administrator lookup**: Use the administratorName field to track which insolvency practitioners handle cases in your region. - **Time sensitivity**: Consumer insolvency cases are only searchable for 2 weeks. Company cases have no time restriction. Standard cases are deleted after 1 month. ### How much does it cost? | Search size | Estimated time | Estimated cost | |-------------|---------------|----------------| | 20 announcements | ~2 minutes | ~$0.05 | | 100 announcements | ~10 minutes | ~$0.20 | | 500 announcements | ~45 minutes | ~$0.80 | Uses Playwright (headless browser) due to the JSF-based portal — costs are higher than pure API actors. ### Can I use it as an API? ```python from apify_client import ApifyClient client = ApifyClient("YOUR_API_TOKEN") run = client.actor("studio-amba/insolvenzbekanntmachungen-scraper").call(run_input={ "searchQuery": "GmbH", "state": "Berlin", "proceedingType": "opening", "maxResults": 50, }) for notice in client.dataset(run["defaultDatasetId"]).iterate_items(): print(f"{notice['debtorName']} | {notice['court']} {notice['caseNumber']} | {notice['proceedingType']}") ``` ### Limitations - The portal caps results at 1,000 per search — use specific filters to stay under this limit - Consumer insolvency data is only available for 2 weeks after publication - Standard cases are deleted after 1 month, closure records after 6 months - Uses headless browser (Playwright) which is slower than API-based scrapers - Session timeout after 60 minutes — long runs may need to reinitialize ### Other European insolvency and company scrapers - **[BODACC Scraper](https://apify.com/studio-amba/bodacc-scraper)** — French insolvency and commercial announcements - **[German Company Register](https://apify.com/studio-amba/handelsregister-scraper)** — German Handelsregister data - **[Belgian Company Enrichment](https://apify.com/studio-amba/kbo-enrichment)** — Belgian KBO/BCE company data ### Your feedback Found a bug or want a feature? Open an issue on the [Issues tab](https://console.apify.com/actors/studio-amba~insolvenzbekanntmachungen-scraper/issues). # Actor input Schema ## `searchQuery` (type: `string`): Search by debtor name (company or person). Minimum 2 characters. ## `state` (type: `string`): Filter by German federal state. ## `city` (type: `string`): Filter by debtor's city. ## `proceedingType` (type: `string`): Filter by type of insolvency proceeding. ## `dateFrom` (type: `string`): Only announcements published on or after this date. Format: DD.MM.YYYY. ## `dateTo` (type: `string`): Only announcements published on or before this date. Format: DD.MM.YYYY. ## `maxResults` (type: `integer`): Maximum number of announcements to return. The portal caps at 1,000 per search. ## `proxyConfiguration` (type: `object`): Apify proxy configuration. ## Actor input object example ```json { "searchQuery": "GmbH", "state": "all", "proceedingType": "all", "maxResults": 20, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # 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 = { "searchQuery": "GmbH", "maxResults": 20, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }; // Run the Actor and wait for it to finish const run = await client.actor("studio-amba/insolvenzbekanntmachungen-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 = { "searchQuery": "GmbH", "maxResults": 20, "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], }, } # Run the Actor and wait for it to finish run = client.actor("studio-amba/insolvenzbekanntmachungen-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 '{ "searchQuery": "GmbH", "maxResults": 20, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }' | apify call studio-amba/insolvenzbekanntmachungen-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=studio-amba/insolvenzbekanntmachungen-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "German Insolvency Announcements Scraper", "description": "Search and extract German insolvency announcements from the official portal. Filter by company name, state, court, date range, or proceeding type. Returns debtor name, court, case number, proceeding type, and full announcement text. No cookies, no login.", "version": "0.0", "x-build-id": "Pqp3sz9wMjEUBQEDb" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/studio-amba~insolvenzbekanntmachungen-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-studio-amba-insolvenzbekanntmachungen-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/studio-amba~insolvenzbekanntmachungen-scraper/runs": { "post": { "operationId": "runs-sync-studio-amba-insolvenzbekanntmachungen-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/studio-amba~insolvenzbekanntmachungen-scraper/run-sync": { "post": { "operationId": "run-sync-studio-amba-insolvenzbekanntmachungen-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": { "searchQuery": { "title": "Company / Person Name", "type": "string", "description": "Search by debtor name (company or person). Minimum 2 characters." }, "state": { "title": "Federal State", "enum": [ "all", "Baden-Württemberg", "Bayern", "Berlin", "Brandenburg", "Bremen", "Hamburg", "Hessen", "Mecklenburg-Vorpommern", "Niedersachsen", "Nordrhein-Westfalen", "Rheinland-Pfalz", "Saarland", "Sachsen", "Sachsen-Anhalt", "Schleswig-Holstein", "Thüringen" ], "type": "string", "description": "Filter by German federal state.", "default": "all" }, "city": { "title": "City / Residence", "type": "string", "description": "Filter by debtor's city." }, "proceedingType": { "title": "Proceeding Type", "enum": [ "all", "opening", "rejection", "scheduling", "distribution", "discharge", "plan", "other" ], "type": "string", "description": "Filter by type of insolvency proceeding.", "default": "all" }, "dateFrom": { "title": "Published After", "type": "string", "description": "Only announcements published on or after this date. Format: DD.MM.YYYY." }, "dateTo": { "title": "Published Before", "type": "string", "description": "Only announcements published on or before this date. Format: DD.MM.YYYY." }, "maxResults": { "title": "Max Results", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of announcements to return. The portal caps at 1,000 per search.", "default": 100 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Apify proxy configuration." } } }, "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 } } } } } } } } } } ```