# Bundesanzeiger Scraper - German Filings & Insolvencies (`jungle_synthesizer/bundesanzeiger-crawler`) Actor Scrape bundesanzeiger.de for German corporate disclosures. Search 1.5M+ entities: annual reports with revenue, equity, net income; insolvency notices; capital markets filings. First Apify actor for this data source. - **URL**: https://apify.com/jungle\_synthesizer/bundesanzeiger-crawler.md - **Developed by:** [BowTiedRaccoon](https://apify.com/jungle_synthesizer) (community) - **Categories:** Business, Lead generation, Other - **Stats:** 4 total users, 3 monthly users, 91.7% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing Pay per event 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 ## Bundesanzeiger Scraper — German Corporate Filings & Insolvencies Scrapes corporate disclosures from [Bundesanzeiger](https://www.bundesanzeiger.de), Germany's official federal gazette. Returns annual reports, shareholder announcements, insolvency notices, and capital markets filings for the ~1.5M German entities that publish here — which is roughly all of them. --- ### Bundesanzeiger Scraper Features - Searches by company name, HRB/HRA registration number, or any full-text term - Filters by publication area — financial statements, insolvencies, capital markets, shareholder announcements, and the rest - Solves the site's image CAPTCHA automatically on Jahresabschluss pages so you don't have to - Extracts structured financials when available — revenue, equity, total assets, net income, employee count, fiscal year end - Returns the full publication text alongside the metadata, up to 1,000 characters per record (most announcements fit comfortably) - Works on a plain HTTP session with cookies. No browser, no residential proxy, no ceremony. --- ### Who Uses Bundesanzeiger Data? - **Credit risk teams** — Pull balance sheets and equity figures for counterparty screening - **M&A analysts** — Track shareholder announcements and corporate changes across the DACH market - **B2B sales** — Build lead lists from registered German entities with known financial size - **Compliance & litigation** — Monitor insolvency filings and mandatory disclosures in near-real-time - **Academic & journalism** — Cite primary-source German corporate disclosures without paying Northdata or Creditreform rates --- ### How Bundesanzeiger Scraper Works 1. Enter a search term — a company name, HRB number, or any keyword 2. Optionally pick a publication area (financial statements, insolvencies, capital markets, etc.) 3. The scraper submits the search, paginates results, and visits each publication page 4. For financial statements behind the image CAPTCHA, it solves the challenge via CapSolver and fetches the content 5. Returns clean JSON records with entity info, publication metadata, full text excerpt, and — where parseable — structured financials --- ### Input ```json { "query": "SAP SE", "area": "22", "extractFinancials": true, "maxItems": 10 } ```` | Field | Type | Default | Description | |-------|------|---------|-------------| | `query` | string | required | Search term: company name, HRB/HRA number, or any keyword | | `area` | string | `""` | Publication area filter. Empty = all areas. See below for enum values | | `extractFinancials` | boolean | `true` | Parse Jahresabschluss text for revenue, assets, equity, net income, employees | | `maxItems` | integer | `10` | Cap on records returned. Max 100 | | `proxyConfiguration` | object | `{ useApifyProxy: false }` | Optional Apify proxy. Not required — the site works without one | #### Publication Area Values | Value | German | English | |-------|--------|---------| | `""` | (all) | All areas | | `"1"` | Amtlicher Teil | Official Part | | `"5"` | Gerichtlicher Teil | Judicial | | `"6"` | Gesellschaftsbekanntmachungen | Shareholder Announcements | | `"8"` | Verschiedene Bekanntmachungen | Miscellaneous | | `"22"` | Rechnungslegung/Finanzberichte | Financial Statements | | `"2"` | Nichtamtlicher Teil | Non-Official | | `"7"` | Kapitalmarkt | Capital Markets | #### Example: Search Insolvencies ```json { "query": "Berlin", "area": "5", "maxItems": 25 } ``` #### Example: Company-Specific Financial Report Hunt ```json { "query": "BMW AG", "area": "22", "extractFinancials": true, "maxItems": 5 } ``` *** ### Bundesanzeiger Scraper Output Fields ```json { "entity_name": "SAP SE", "entity_city": "Walldorf", "publication_area": "Rechnungslegung/Finanzberichte", "publication_title": "Jahres- und Konzernabschluss zum Geschäftsjahr vom 01.01.2021 bis zum 31.12.2021", "publication_date": "11.07.2022", "fiscal_year_end": "31.12.2021", "document_url": "https://www.bundesanzeiger.de/pub/de/suchen2?3-1.-search~table~panel-rows-0-search~table~row~panel-publication~link", "document_excerpt": "SAP SE Walldorf Jahres- und Konzernabschluss zum Geschäftsjahr vom 01.01.2021 bis zum 31.12.2021 ...", "scraped_at": "2026-04-19T10:28:31.530Z" } ``` | Field | Type | Description | |-------|------|-------------| | `entity_name` | string | Legal entity name | | `entity_city` | string | Registered city (or cities, e.g. "Berlin und München") | | `publication_area` | string | Bundesanzeiger area label (German) | | `publication_title` | string | Publication heading | | `publication_date` | string | Publication date, DD.MM.YYYY | | `fiscal_year_end` | string | Fiscal year end date when detected (annual reports only) | | `total_assets` | number | Bilanzsumme in EUR (when extractable) | | `total_equity` | number | Eigenkapital in EUR (when extractable) | | `revenue` | number | Umsatzerlöse in EUR (when extractable) | | `net_income` | number | Jahresüberschuss in EUR (when extractable) | | `employee_count` | number | Average number of employees (when stated) | | `document_url` | string | Direct link to the publication on bundesanzeiger.de | | `document_excerpt` | string | First 1,000 characters of cleaned publication text | | `scraped_at` | string | ISO timestamp when the record was captured | Structured financial fields (`total_assets`, `revenue`, etc.) populate on a best-effort basis. Not every annual report follows the same template, so some filings return only the excerpt and fiscal year. *** ### FAQ #### How do I scrape Bundesanzeiger? Bundesanzeiger Scraper handles it for you. Enter a search term, pick a publication area if you want, and set `maxItems`. The scraper submits the search, walks result pages, and visits each publication — solving the image CAPTCHA that guards financial statements along the way. #### How much does Bundesanzeiger Scraper cost to run? Pay-per-event pricing. $0.10 per run start plus $0.001 per record. A 100-record run costs about $0.20, a 1,000-record run about $1.10. CAPTCHA solves on financial statements are included in the per-record price. #### What publication types can I extract? Bundesanzeiger Scraper works across all 7 publication areas — annual reports (Rechnungslegung), shareholder announcements (Gesellschaftsbekanntmachungen), insolvency notices (Gerichtlicher Teil), capital markets filings (Kapitalmarkt), and the miscellaneous and official-part catch-all categories. Filter by area or leave empty to search across everything. #### Does this actor need proxies? No. Bundesanzeiger serves its search and most publication pages to plain HTTP requests. The actor runs fine from Apify's default IPs. An optional residential DE proxy is available in the input schema if you plan to run heavy volume and want the extra reliability buffer. #### Can it parse financials from every annual report? Not every one. German annual reports vary wildly in formatting — some are full-text HTML, some are ESEF XBRL viewers that don't expose parseable prose. When the scraper can read the text, it pulls Umsatzerlöse, Bilanzsumme, Eigenkapital, Jahresüberschuss, and employee count via German-language regex patterns. When it can't, you still get the metadata and a direct URL to the document. *** ### Need More Features? Need custom fields, bulk entity-list support, or deeper XBRL parsing? [File an issue](https://console.apify.com/actors/issues) or get in touch. ### Why Use Bundesanzeiger Scraper? - **Blue ocean** — First and only Apify actor targeting bundesanzeiger.de. Commercial providers (Northdata, Creditreform) charge EUR 20-50 per document for data that's freely published here - **CAPTCHA handled** — Image challenges on financial statements solve automatically via CapSolver, which is the kind of thing you'd otherwise spend a weekend building yourself - **Affordable** — $0.001 per record with no hidden proxy fees. A 1,000-company portfolio refresh runs for around a dollar # Actor input Schema ## `sp_intended_usage` (type: `string`): Please describe how you plan to use the data extracted by this crawler. ## `sp_improvement_suggestions` (type: `string`): Provide any feedback or suggestions for improvements. ## `sp_contact` (type: `string`): Provide your email address so we can get in touch with you. ## `query` (type: `string`): Company name, HRB/HRA number, or any search term (e.g. 'Siemens AG' or 'HRB 12345'). ## `area` (type: `string`): Filter by Bundesanzeiger publication area. ## `extractFinancials` (type: `boolean`): Parse annual report text for revenue, assets, equity, net income, employees. Slower — solves CAPTCHAs via CapSolver on financial statements. ## `maxItems` (type: `integer`): Maximum number of records to return. ## `proxyConfiguration` (type: `object`): Apify proxy config. Not required - bundesanzeiger.de works without proxies. Optional residential DE proxy improves reliability on heavy runs. ## Actor input object example ```json { "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "query": "SAP SE", "extractFinancials": true, "maxItems": 10, "proxyConfiguration": { "useApifyProxy": false } } ``` # Actor output Schema ## `results` (type: `string`): No description # 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 = { "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "query": "SAP SE", "area": "", "extractFinancials": true, "maxItems": 10, "proxyConfiguration": { "useApifyProxy": false } }; // Run the Actor and wait for it to finish const run = await client.actor("jungle_synthesizer/bundesanzeiger-crawler").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 = { "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "query": "SAP SE", "area": "", "extractFinancials": True, "maxItems": 10, "proxyConfiguration": { "useApifyProxy": False }, } # Run the Actor and wait for it to finish run = client.actor("jungle_synthesizer/bundesanzeiger-crawler").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 '{ "sp_intended_usage": "Describe your intended use...", "sp_improvement_suggestions": "Share your suggestions here...", "sp_contact": "Share your email here...", "query": "SAP SE", "area": "", "extractFinancials": true, "maxItems": 10, "proxyConfiguration": { "useApifyProxy": false } }' | apify call jungle_synthesizer/bundesanzeiger-crawler --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=jungle_synthesizer/bundesanzeiger-crawler", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Bundesanzeiger Scraper - German Filings & Insolvencies", "description": "Scrape bundesanzeiger.de for German corporate disclosures. Search 1.5M+ entities: annual reports with revenue, equity, net income; insolvency notices; capital markets filings. First Apify actor for this data source.", "version": "0.1", "x-build-id": "fapOOu9abpSbrt9hP" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jungle_synthesizer~bundesanzeiger-crawler/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jungle_synthesizer-bundesanzeiger-crawler", "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/jungle_synthesizer~bundesanzeiger-crawler/runs": { "post": { "operationId": "runs-sync-jungle_synthesizer-bundesanzeiger-crawler", "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/jungle_synthesizer~bundesanzeiger-crawler/run-sync": { "post": { "operationId": "run-sync-jungle_synthesizer-bundesanzeiger-crawler", "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": { "sp_intended_usage": { "title": "What is the intended usage of this data?", "minLength": 1, "type": "string", "description": "Please describe how you plan to use the data extracted by this crawler." }, "sp_improvement_suggestions": { "title": "How can we improve this crawler for you?", "minLength": 1, "type": "string", "description": "Provide any feedback or suggestions for improvements." }, "sp_contact": { "title": "Contact Email", "minLength": 1, "type": "string", "description": "Provide your email address so we can get in touch with you." }, "query": { "title": "Search Query", "type": "string", "description": "Company name, HRB/HRA number, or any search term (e.g. 'Siemens AG' or 'HRB 12345')." }, "area": { "title": "Publication Area", "enum": [ "", "1", "5", "6", "8", "22", "2", "7" ], "type": "string", "description": "Filter by Bundesanzeiger publication area." }, "extractFinancials": { "title": "Extract Structured Financials", "type": "boolean", "description": "Parse annual report text for revenue, assets, equity, net income, employees. Slower — solves CAPTCHAs via CapSolver on financial statements.", "default": true }, "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 100, "type": "integer", "description": "Maximum number of records to return.", "default": 10 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Apify proxy config. Not required - bundesanzeiger.de works without proxies. Optional residential DE proxy improves reliability on heavy runs." } } }, "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 } } } } } } } } } } ```