# Bundesanzeiger Scraper — German Company Filings (`studio-amba/bundesanzeiger-scraper`) Actor Search Germany's official company gazette (bundesanzeiger.de) by company name and extract published notices: annual filing index, capital market notices, corporate announcements, court notices, publication date, and full notice text where publicly viewable. No login required. - **URL**: https://apify.com/studio-amba/bundesanzeiger-scraper.md - **Developed by:** [Studio Amba](https://apify.com/studio-amba) (community) - **Categories:** Business, Lead generation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $12.00 / 1,000 result scrapeds 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/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 Search Germany's official company gazette (bundesanzeiger.de) by company name and extract published notices — filing type, publication date, and full notice text where publicly viewable. ### Why use this actor? The Bundesanzeiger (Federal Gazette) is where German companies are legally required to publish corporate announcements: supervisory board changes, capital market notices, court notices, and the index of filed annual accounts. Lawyers, credit-risk teams, M&A researchers, and compliance teams use it to track what a German counterparty has published and when. The site itself has no public API and its search is a stateful, session-bound web form — this actor handles that so you can pull structured results by company name instead of clicking through it by hand. ### How to scrape Bundesanzeiger company data 1. Enter a company name in **Search** (e.g. `"Robert Bosch GmbH"`, `"Siemens AG"`, `"Volkswagen AG"`). German legal-form suffixes (GmbH, AG, KG) improve match precision since Bundesanzeiger indexes the full registered name. 2. Optionally restrict to one **Publication Area** — for example `Gesellschaftsbekanntmachungen` for corporate announcements only, or `Rechnungslegung/Finanzberichte` to see which annual accounts a company has filed and when. 3. Set **Max Results** and run. The actor paginates through Bundesanzeiger's own results (20 per page) until it reaches your limit. 4. Each result includes the notice's full free text when the site allows it (see Limitations below for the one category it doesn't). Typical uses: monitoring a counterparty for new supervisory-board or capital-market notices, building a filing-history index for a portfolio of German companies, or checking whether a company has published its required annual accounts. ### Input | Field | Type | Required | Description | |-------|------|----------|-------------| | `searchQuery` | String | No | Company name to search for. Defaults to `"Robert Bosch GmbH"` if left empty. | | `filingArea` | String | No | Restrict to one publication area (see the dropdown for the full list). Default: all areas. | | `fetchContent` | Boolean | No | Fetch each notice's full text (default: `true`). Disable for a faster, index-only run. | | `maxResults` | Integer | No | Maximum notices to return (default: 20). | | `proxyConfiguration` | Object | No | Apify proxy settings. Defaults to German residential proxy. | ### Output Each result contains: | Field | Type | Example | |-------|------|---------| | `companyName` | String | `"Robert Bosch Gesellschaft mit beschränkter Haftung"` | | `location` | String | `"Stuttgart"` | | `filingArea` | String | `"Gesellschaftsbekanntmachungen"` | | `filingType` | String | `"Aufsichtsrat"` (notice title as published) | | `filingReference` | String | Secondary reference shown in the listing (e.g. WKN/ISIN for capital-market notices), if any | | `publicationDate` | String | `"2026-07-07"` | | `registerCourt` | String | `"Amtsgericht Stuttgart"` (only when the notice text itself mentions one — see Limitations) | | `registerNumber` | String | `"HRB 14000"` (only when the notice text itself mentions one) | | `documentText` | String | Full published notice text (empty when `captchaRequired` is `true`) | | `captchaRequired` | Boolean | `true` if the site requires solving a CAPTCHA to view this notice's text (annual-accounts filings only — see Limitations) | | `url` | String | Session-bound link to the notice on bundesanzeiger.de (valid roughly 30 minutes per the site's own session policy) | | `scrapedAt` | String | ISO 8601 timestamp | ### Example output ```json { "companyName": "Robert Bosch Gesellschaft mit beschränkter Haftung", "location": "Stuttgart", "filingArea": "Gesellschaftsbekanntmachungen", "filingType": "Aufsichtsrat", "filingReference": "", "publicationDate": "2026-07-07", "registerCourt": "Amtsgericht Stuttgart", "registerNumber": "", "documentText": "Robert Bosch Gesellschaft mit beschränkter Haftung\nStuttgart\n\nBekanntmachung gemäß § 19 Mitbestimmungsgesetz\n\nHerr Oliver Simon ist mit Wirkung zum 30.06.2026 aus dem Aufsichtsrat ausgeschieden. Durch Beschluss des Amtsgerichts Stuttgart wurde Herr Dr. Stefan Bischoff mit Wirkung zum 01.07.2026 zum Mitglied des Aufsichtsrats der Robert Bosch GmbH als Vertreter der Arbeitnehmer bestellt.", "captchaRequired": false, "url": "https://www.bundesanzeiger.de/pub/de/suchen2?3-1.-search~table~panel-rows-0-search~table~row~panel-publication~link", "scrapedAt": "2026-07-14T21:00:16.409Z" } ```` ### Publication areas Bundesanzeiger organizes notices into seven areas. Pass the area code as `filingArea`, or leave it empty to search all of them at once: | Area | Code | What it covers | |------|------|-----------------| | All areas | `""` | Everything below, ranked by relevance | | Amtlicher Teil | `1` | Official/statutory notices | | Gerichtlicher Teil | `5` | Court notices (insolvency proceedings, etc.) | | Gesellschaftsbekanntmachungen | `6` | Corporate announcements (supervisory board changes, mergers, registered-office relocations) | | Rechnungslegung/Finanzberichte | `22` | Annual accounts filing index (`Jahresabschluss`, `Jahresfinanzbericht`) — CAPTCHA-gated content, see Limitations | | Nichtamtlicher Teil | `2` | Non-official notices | | Kapitalmarkt | `7` | Capital market notices (bond terms, interest rate fixings, prospectuses) | | Verschiedene Bekanntmachungen | `8` | Miscellaneous notices | ### Frequently asked questions **Does this need a Bundesanzeiger account or login?** No. Everything this actor reads is publicly accessible without logging in. **Why is `documentText` sometimes empty even though the run succeeded?** That's the CAPTCHA gate on `Rechnungslegung/Finanzberichte` notices described above — check `captchaRequired` on that row. **Can I search multiple companies in one run?** Run the actor once per company name via the Apify API or a scheduled task with different `searchQuery` values — the actor itself takes one query per run, matching how Bundesanzeiger's own search works. **Does the actor need Bright Data or a browser?** No. Recon confirmed no anti-bot wall (Cloudflare/DataDome/Akamai) anywhere in the search, pagination, or detail-page flow — a plain HTTP session with a cookie jar is sufficient. ### Cost estimate This actor uses approximately **1-2 compute units per 100 results** (mostly network wait time, not CPU). At standard Apify pricing, that's a small fraction of a dollar per 100 notices in compute — actual cost to you is set by this actor's per-result pricing on the Store listing, not raw compute. ### Limitations - **Annual-accounts filings (`Rechnungslegung/Finanzberichte`) are CAPTCHA-gated on the site itself.** Bundesanzeiger requires solving a CAPTCHA before showing the actual balance-sheet text for `Jahresabschluss`/`Jahresfinanzbericht` notices — this is a deliberate site restriction (confirmed in the site's own FAQ: "Eine Volltextsuche über den Veröffentlichungsinhalt ist bei Jahresabschlüssen ... nicht möglich"). This actor does not attempt to bypass it. You still get the filing index (company, filing type, publication date) for these rows — `captchaRequired` is set to `true` and `documentText` is left empty so this is never silently hidden. - **`registerCourt` / `registerNumber` are best-effort, not guaranteed.** Most Bundesanzeiger notices (capital-market notices, supervisory-board changes, etc.) simply don't mention a Handelsregister court or number in their free text — that data lives in Germany's separate Handelsregister/Unternehmensregister systems, not in gazette notices. These fields are populated only when the notice text itself states them. - **`url` is session-bound.** Bundesanzeiger's search is a stateful web app (per the site's own FAQ, "Warum kann ich kein Lesezeichen/Bookmark setzen?") — links to individual notices are tied to the browsing session that found them and expire after roughly 30 minutes. Re-run the search to get a fresh, working link. - For `Gerichtlicher Teil` (court notices), the "Name" column on the site itself shows the issuing court rather than the company — `companyName` may reflect the court name for that specific area. This doesn't affect the other six publication areas. - Data is scraped from the public website and may change without notice. ### Need this data on a schedule, or a custom version? We run this scraper as a managed service for businesses: scheduled runs, deduplication, delta detection, and delivery to your inbox, Google Sheets, or API — maintenance included. We can also build a custom version with your exact fields and filters, or combine multiple sources into one feed. See [studioamba.dev/services](https://studioamba.dev/services/) or email for a free data sample. We maintain 300+ European web scrapers and answer within one business day. # Actor input Schema ## `searchQuery` (type: `string`): Search for a German company by name. Example: 'Robert Bosch GmbH', 'Siemens AG', 'Deutsche Bank'. ## `filingArea` (type: `string`): Restrict the search to one publication area. 'All areas' (default) covers everything. 'Rechnungslegung/Finanzberichte' is the annual-accounts filing index — notice text there requires a CAPTCHA on the site itself and is not fetched, only the filing index (company, filing type, date). ## `fetchContent` (type: `boolean`): When enabled (default), the actor opens each notice's detail page to extract the full published text (and register court/number when the text mentions them). Disable to get only the lightweight search-result fields (company, filing type, date) much faster. Note: notices in 'Rechnungslegung/Finanzberichte' are CAPTCHA-gated on the site and never return full text regardless of this setting. ## `maxResults` (type: `integer`): Maximum number of notices to return. The actor paginates through Bundesanzeiger's own search results (20 per page) to reach this count. ## `proxyConfiguration` (type: `object`): Select proxies to use. A German residential proxy is used by default for geo-consistent results; recon found no anti-bot wall on the search flow itself. ## Actor input object example ```json { "searchQuery": "Robert Bosch GmbH", "filingArea": "", "fetchContent": true, "maxResults": 20, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "DE" } } ``` # 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": "Robert Bosch GmbH", "filingArea": "", "maxResults": 20, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "DE" } }; // Run the Actor and wait for it to finish const run = await client.actor("studio-amba/bundesanzeiger-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": "Robert Bosch GmbH", "filingArea": "", "maxResults": 20, "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "DE", }, } # Run the Actor and wait for it to finish run = client.actor("studio-amba/bundesanzeiger-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": "Robert Bosch GmbH", "filingArea": "", "maxResults": 20, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "DE" } }' | apify call studio-amba/bundesanzeiger-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=studio-amba/bundesanzeiger-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Bundesanzeiger Scraper — German Company Filings", "description": "Search Germany's official company gazette (bundesanzeiger.de) by company name and extract published notices: annual filing index, capital market notices, corporate announcements, court notices, publication date, and full notice text where publicly viewable. No login required.", "version": "0.0", "x-build-id": "9vX2Ml2R1XmlsZA78" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/studio-amba~bundesanzeiger-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-studio-amba-bundesanzeiger-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~bundesanzeiger-scraper/runs": { "post": { "operationId": "runs-sync-studio-amba-bundesanzeiger-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~bundesanzeiger-scraper/run-sync": { "post": { "operationId": "run-sync-studio-amba-bundesanzeiger-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 Name", "type": "string", "description": "Search for a German company by name. Example: 'Robert Bosch GmbH', 'Siemens AG', 'Deutsche Bank'." }, "filingArea": { "title": "Publication Area", "enum": [ "", "1", "5", "6", "22", "2", "7", "8" ], "type": "string", "description": "Restrict the search to one publication area. 'All areas' (default) covers everything. 'Rechnungslegung/Finanzberichte' is the annual-accounts filing index — notice text there requires a CAPTCHA on the site itself and is not fetched, only the filing index (company, filing type, date).", "default": "" }, "fetchContent": { "title": "Fetch Full Notice Text", "type": "boolean", "description": "When enabled (default), the actor opens each notice's detail page to extract the full published text (and register court/number when the text mentions them). Disable to get only the lightweight search-result fields (company, filing type, date) much faster. Note: notices in 'Rechnungslegung/Finanzberichte' are CAPTCHA-gated on the site and never return full text regardless of this setting.", "default": true }, "maxResults": { "title": "Max Results", "minimum": 1, "maximum": 200, "type": "integer", "description": "Maximum number of notices to return. The actor paginates through Bundesanzeiger's own search results (20 per page) to reach this count.", "default": 20 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Select proxies to use. A German residential proxy is used by default for geo-consistent results; recon found no anti-bot wall on the search flow itself.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "DE" } } } }, "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 } } } } } } } } } } ```