# 🇩🇪 German Insolvency Scraper — Insolvenzbekanntmachungen (`inexhaustible_glass/german-insolvency-scraper`) Actor

Scrape official German insolvency announcements (Insolvenzbekanntmachungen): debtor, court, case number, location, register, legal form. Filter by date, Bundesland, company. Daily monitor mode for watchlists — debt collectors, lawyers, credit-risk, M\&A, sales. Free, no key, no proxy.

- **URL**: https://apify.com/inexhaustible\_glass/german-insolvency-scraper.md
- **Developed by:** [Hitman studio](https://apify.com/inexhaustible_glass) (community)
- **Categories:** Lead generation, News, Developer tools
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

from $4.00 / 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.

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

## 🇩🇪 German Insolvency Scraper — Insolvenzbekanntmachungen Monitor

> **Know the day a German company goes insolvent — before it costs you.**

Turn the official German insolvency register
[insolvenzbekanntmachungen.de](https://neu.insolvenzbekanntmachungen.de) into a clean,
filterable **CSV / JSON** feed of every announcement: debtor, court, case number, location,
commercial register and legal form — with a **daily watchlist** mode.

✅ No API key · No login · No proxy · No captcha — just press **Start**.

---

### 💡 Why this matters
Every business day, hundreds of German companies file for insolvency. If one of them is your
**customer, supplier or competitor**, the first to know wins:
- A creditor that reacts on **day 1** recovers far more than one that finds out weeks later.
- A sales team can win clients away from an **insolvent competitor** while they're vulnerable.
- A buyer can spot a **distressed acquisition** before it's on the market.

This actor gives you that edge — automatically.

### 👥 Built for
| You are a… | You get… |
|---|---|
| 💰 **Debt collector / creditor** | Day-1 alerts on debtors → recover more |
| ⚖️ **Insolvency / commercial lawyer** | A clean case feed by court & company |
| 📊 **Credit-risk / finance team** | Insolvency signals for your risk models |
| 📈 **Sales / B2B** | Win customers from insolvent competitors |
| 🤝 **M&A / investor** | Early distressed-asset & acquisition targets |
| 🔔 **Anyone with a watchlist** | Auto-monitor partners & suppliers |

---

### 🏆 Why it's the most complete one on the market
| | Other scrapers | **This actor** |
|---|---|---|
| Official source (insolvenzbekanntmachungen.de) | some | ✅ |
| **Nothing missed** — day-by-day, auto-splits a >1000-hit day by Bundesland | ❌ | ✅ |
| **Structured** legal form + company/person flag | ❌ | ✅ |
| **Register parsed** → court + HRB/HRA + number | ❌ | ✅ |
| Filter by Bundesland / company / legal form / court / keyword | partial | ✅ |
| **Daily "new only" monitor** (watchlist) | ❌ | ✅ |
| Cost | proxy-heavy | **free source, no proxy** |

---

### 🚀 How to use (30 seconds)
1. Set **Published From / To** (or leave empty → yesterday).
2. *(optional)* Filter by **Bundesland**, **company name** (`*wildcard*`), **legal form**, **court** or **keywords**.
3. Press **Start** → export **CSV / Excel / JSON**.

#### Example input
```json
{
  "dateFrom": "2026-06-10",
  "dateTo": "2026-06-10",
  "bundesland": "Bayern",
  "companiesOnly": true,
  "maxResults": 500
}
````

👉 *"All company insolvencies in Bavaria published on 10 June."*

#### 🔁 Daily watchlist (the killer use-case)

Turn on **Monitor mode**, leave the dates empty, and **Schedule** the actor to run once a day.
Each run returns **only the new announcements** — a hands-off alert feed for the companies you care about.

***

### 📦 Output fields

| Field | Description |
|---|---|
| `published_on` | Publication date (ISO `YYYY-MM-DD`) |
| `published_on_de` | Original German date (`DD.MM.YYYY`) |
| `debtor` | The company / person the insolvency is about |
| `legal_form` | GmbH, UG, AG, KG, GbR… (`null` for individuals) |
| `is_company` | `true` = business · `false` = private person |
| `court` | Insolvency court (Amtsgericht) |
| `case_number` | Aktenzeichen |
| `location` | Debtor's seat / residence |
| `register` | Full commercial-register string |
| `register_court` · `register_type` · `register_number` | Parsed register (e.g. `Stendal` · `HRB` · `24425`) |

#### Example output

```json
{
  "published_on": "2026-06-10",
  "debtor": "3SALES GmbH",
  "legal_form": "GmbH",
  "is_company": true,
  "court": "Wetzlar",
  "case_number": "3 IN 70/23",
  "location": "Wetzlar",
  "register": "Wetzlar, HRB 7062",
  "register_court": "Wetzlar",
  "register_type": "HRB",
  "register_number": "7062"
}
```

***

### ❓ FAQ

**Is the data official?** Yes — directly from the government portal `insolvenzbekanntmachungen.de`.

**Do I need an account or API key?** No. The source is fully public and free.

**Will it miss announcements?** No. It scans day-by-day and, if a single day exceeds the site's
1,000-result cap, it automatically re-runs that day per Bundesland and merges the results.

**How fresh is it?** Announcements appear on the portal on the publication day; run with that day's
date (or use Monitor mode for a daily feed).

**Can I track one specific company?** Yes — set `companyName` to `*YourCompany*` and turn on Monitor mode.

**Individuals or companies?** Both. Use `companiesOnly: true` to keep only businesses.

***

### ⚖️ Notes

- **Source:** official `insolvenzbekanntmachungen.de` — public record, free, no key, no captcha.
- One day can contain **4,000+ announcements** nationwide; use filters + `maxResults` to focus.
- The full announcement *body text* lives behind a JavaScript popup on the portal; this actor
  returns the complete structured **listing** (all fields above) for every announcement.

***

*Keywords: Insolvenzbekanntmachungen, German insolvency scraper, Insolvenz, bankruptcy Germany,
Insolvenzverfahren, debtor monitoring, Insolvenzverwalter, credit risk, Bonität, debt collection,
Inkasso, Amtsgericht, Handelsregister, HRB, distressed assets, Eröffnung, Abweisung, watchlist, B2B Germany.*

# Actor input Schema

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

Scan announcements published ON or AFTER this date. Format YYYY-MM-DD. Leave both empty to auto-use yesterday.

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

Scan announcements published ON or BEFORE this date. Format YYYY-MM-DD. Same as 'from' for a single day. Max 92-day range per run.

## `bundesland` (type: `string`):

Limit to one federal state, e.g. 'Bayern', 'Nordrhein-Westfalen', 'Berlin'. Leave empty for all of Germany.

## `companyName` (type: `string`):

Search a specific debtor. Use \* for wildcard, e.g. '*Air Berlin*'. Great for watch-listing a customer or supplier.

## `companiesOnly` (type: `boolean`):

Keep only debtors with a legal form (GmbH, UG, AG, KG…) — skip individual/consumer insolvencies. Best for B2B credit-risk & lead-gen.

## `legalForms` (type: `array`):

Keep only these legal forms. Empty = all.

## `courts` (type: `array`):

Keep only these courts. Example: 'Berlin', 'München', 'Hamburg'.

## `keywords` (type: `array`):

Keep only rows whose debtor, location or court contains ANY of these words (case-insensitive).

## `monitorNew` (type: `boolean`):

Remember announcements already seen and emit only new ones. Perfect for a daily scheduled watchlist that alerts you the moment a company goes insolvent.

## `fetchFullText` (type: `boolean`):

Also fetch each announcement's complete text — procedure type (Eröffnung/Abweisung), the Insolvenzverwalter / managing director name + address, deadlines and legal basis. Adds one request per row, so best for narrow/watchlist searches (a company or one Bundesland), not a whole-Germany day.

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

Cap total announcements returned (one day can have 4,000+).

## Actor input object example

```json
{
  "dateFrom": "2026-06-10",
  "dateTo": "2026-06-10",
  "bundesland": "Bayern",
  "companyName": "*GmbH*",
  "companiesOnly": false,
  "keywords": [
    "Bau",
    "Solar"
  ],
  "monitorNew": false,
  "fetchFullText": false,
  "maxResults": 500
}
```

# 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 = {
    "dateFrom": "2026-06-10",
    "dateTo": "2026-06-10",
    "bundesland": "Bayern"
};

// Run the Actor and wait for it to finish
const run = await client.actor("inexhaustible_glass/german-insolvency-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "dateFrom": "2026-06-10",
    "dateTo": "2026-06-10",
    "bundesland": "Bayern",
}

# Run the Actor and wait for it to finish
run = client.actor("inexhaustible_glass/german-insolvency-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 '{
  "dateFrom": "2026-06-10",
  "dateTo": "2026-06-10",
  "bundesland": "Bayern"
}' |
apify call inexhaustible_glass/german-insolvency-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=inexhaustible_glass/german-insolvency-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "🇩🇪 German Insolvency Scraper — Insolvenzbekanntmachungen",
        "description": "Scrape official German insolvency announcements (Insolvenzbekanntmachungen): debtor, court, case number, location, register, legal form. Filter by date, Bundesland, company. Daily monitor mode for watchlists — debt collectors, lawyers, credit-risk, M&A, sales. Free, no key, no proxy.",
        "version": "1.0",
        "x-build-id": "2lWdastrXBTaN3cM4"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/inexhaustible_glass~german-insolvency-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-inexhaustible_glass-german-insolvency-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/inexhaustible_glass~german-insolvency-scraper/runs": {
            "post": {
                "operationId": "runs-sync-inexhaustible_glass-german-insolvency-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/inexhaustible_glass~german-insolvency-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-inexhaustible_glass-german-insolvency-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": {
                    "dateFrom": {
                        "title": "📅 Published From",
                        "type": "string",
                        "description": "Scan announcements published ON or AFTER this date. Format YYYY-MM-DD. Leave both empty to auto-use yesterday."
                    },
                    "dateTo": {
                        "title": "📅 Published To",
                        "type": "string",
                        "description": "Scan announcements published ON or BEFORE this date. Format YYYY-MM-DD. Same as 'from' for a single day. Max 92-day range per run."
                    },
                    "bundesland": {
                        "title": "📍 Bundesland (state) — optional",
                        "type": "string",
                        "description": "Limit to one federal state, e.g. 'Bayern', 'Nordrhein-Westfalen', 'Berlin'. Leave empty for all of Germany."
                    },
                    "companyName": {
                        "title": "🔍 Company / debtor name — optional",
                        "type": "string",
                        "description": "Search a specific debtor. Use * for wildcard, e.g. '*Air Berlin*'. Great for watch-listing a customer or supplier."
                    },
                    "companiesOnly": {
                        "title": "🏢 Companies only (skip private persons)",
                        "type": "boolean",
                        "description": "Keep only debtors with a legal form (GmbH, UG, AG, KG…) — skip individual/consumer insolvencies. Best for B2B credit-risk & lead-gen.",
                        "default": false
                    },
                    "legalForms": {
                        "title": "🏷️ Legal forms",
                        "uniqueItems": true,
                        "type": "array",
                        "description": "Keep only these legal forms. Empty = all.",
                        "items": {
                            "type": "string",
                            "enum": [
                                "GmbH",
                                "UG",
                                "GmbH & Co. KG",
                                "AG",
                                "SE",
                                "KG",
                                "OHG",
                                "GbR",
                                "e.V.",
                                "e.K.",
                                "Ltd",
                                "eG"
                            ]
                        }
                    },
                    "courts": {
                        "title": "⚖️ Insolvency courts (Amtsgericht) — optional",
                        "type": "array",
                        "description": "Keep only these courts. Example: 'Berlin', 'München', 'Hamburg'.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "keywords": {
                        "title": "🔑 Keywords (debtor / location / court)",
                        "type": "array",
                        "description": "Keep only rows whose debtor, location or court contains ANY of these words (case-insensitive).",
                        "items": {
                            "type": "string"
                        }
                    },
                    "monitorNew": {
                        "title": "🔁 Monitor mode — only NEW since last run",
                        "type": "boolean",
                        "description": "Remember announcements already seen and emit only new ones. Perfect for a daily scheduled watchlist that alerts you the moment a company goes insolvent.",
                        "default": false
                    },
                    "fetchFullText": {
                        "title": "📄 Fetch FULL announcement text (slower)",
                        "type": "boolean",
                        "description": "Also fetch each announcement's complete text — procedure type (Eröffnung/Abweisung), the Insolvenzverwalter / managing director name + address, deadlines and legal basis. Adds one request per row, so best for narrow/watchlist searches (a company or one Bundesland), not a whole-Germany day.",
                        "default": false
                    },
                    "maxResults": {
                        "title": "🔢 Max Results",
                        "minimum": 1,
                        "maximum": 50000,
                        "type": "integer",
                        "description": "Cap total announcements returned (one day can have 4,000+).",
                        "default": 500
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```