Skip to content

About

German company filings straight from the federal gazette. Python, Node.js and cURL clients for the Bundesanzeiger Scraper on Apify, pay per result.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Bundesanzeiger Scraper: German Filings and Insolvenzen

Search the Bundesanzeiger, the German federal gazette where every company is legally required to publish, and get structured records back. Covers annual financial statements, insolvency proceedings, ad hoc disclosures and voting rights notifications. No login and no API key, and you only pay for publications actually delivered.

Run it on Apify: apify.com/themineworks/germany-bundesanzeiger-monitor Docs, FAQ and pricing: themineworks.com/actors/germany-bundesanzeiger-monitor

Price: From $0.60 per 1,000 publications on Apify's higher plans ($1.00 on the free plan), plus a $0.005 start fee per run. Failed and empty results are never charged.

What it returns

  • Every filing category, or filter to one
  • Annual accounts, insolvencies, ad hoc disclosures
  • Plain HTTP, so runs finish in seconds
  • MCP-native for AI agents
  • Empty results are never charged

Quick start

You need a free Apify account and its API token (Settings, API & Integrations).

Python

pip install apify-client
from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")
run = client.actor("themineworks/germany-bundesanzeiger-monitor").call(run_input={
    "searchTerms": [
        "Siemens Aktiengesellschaft"
    ],
    "category": "0",
    "maxResultsPerSearch": 40
})

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

Node.js

npm install apify-client
import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' });
const run = await client.actor('themineworks/germany-bundesanzeiger-monitor').call({
    "searchTerms": [
        "Siemens Aktiengesellschaft"
    ],
    "category": "0",
    "maxResultsPerSearch": 40
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

cURL

One request that runs the actor and returns the results in the response (for runs under 5 minutes):

curl -X POST "https://api.apify.com/v2/acts/themineworks~germany-bundesanzeiger-monitor/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"searchTerms": ["Siemens Aktiengesellschaft"], "category": "0", "maxResultsPerSearch": 40}'

Command line

This repo includes ready-made clients that save results to JSON and CSV:

python3 bundesanzeiger_scraper.py --token YOUR_APIFY_TOKEN --search-terms "Siemens Aktiengesellschaft" --category "0" --max-results-per-search "40"
node bundesanzeiger_scraper.mjs --token YOUR_APIFY_TOKEN --search-terms "Siemens Aktiengesellschaft" --category "0" --max-results-per-search "40"

Input

Field Type Default Description
searchTerms (required) array One or more German company names or keywords to search for in the Bundesanzeiger (Federal Gazette)
category string "0" Restrict the search to one area of the Bundesanzeiger
maxResultsPerSearch integer 50 Hard cap on how many publication rows to deliver for each search term

Output

One row per result, as JSON, CSV, Excel or through the API.

Field Type Description
search_term string The search term this row was found under
category string Publication area as shown by Bundesanzeiger, for example Gesellschaftsbekanntmachungen or Kapitalmarkt
publisher_name string The company or entity that filed the publication
publisher_location string The filer's registered location as shown, for example a city
title string The publication headline or subject
related_entities array Secondary company names or securities identifiers (for example ISIN) mentioned in the listing, when present
publication_date_raw string Publication date exactly as displayed, DD.MM.YYYY
publication_date string Publication date parsed to ISO 8601 (YYYY-MM-DD)
scraped_at string ISO timestamp of capture

Use it from an AI agent

The actor works as a tool in Claude, Cursor or any MCP client through Apify's MCP server:

https://mcp.apify.com/?tools=themineworks/germany-bundesanzeiger-monitor

FAQ

What is the Bundesanzeiger?

It is the German federal gazette. Companies operating in Germany are legally required to publish annual financial statements and certain corporate events there, which makes it the authoritative public source for German company filings.

Do I need an account or API key?

No. The actor reads publicly published records. There is no login, no key and no paid data subscription.

How does pricing work?

Pay per result: from $0.60 per 1,000 publications on Apify's higher plans, $1.00 on the free plan, plus a $0.005 start fee per run. A search that returns nothing adds no result charges.

Which filing types are covered?

Annual financial statements, insolvency proceedings, ad hoc disclosures and voting rights notifications. Pull every category or filter to one.

How long does a search take?

Seconds. The actor runs over plain HTTP with no browser, and a search that returns nothing adds no result charges.

How much does the Bundesanzeiger Scraper cost?

From $0.60 per 1,000 publications on Apify's higher plans ($1.00 on the free plan), plus a $0.005 start fee per run. Failed and empty results are never charged. You can cap what a single run may spend with the maximum cost setting on Apify.

Can I export the results to CSV or Excel?

Yes. Every run saves to an Apify dataset you can download as JSON, CSV, Excel or XML, or read through the API. The Python and Node clients in this repo also write the results to local files.

Can I run it on a schedule?

Yes. Save your input as a task on Apify and attach a schedule, or call the API from your own cron job. Scheduled runs are billed the same way as manual ones.

Related scrapers

Part of The Mine Works: 151 pay-per-result scrapers with no login and no browser setup on your side.

License

MIT © The Mine Works

About

German company filings straight from the federal gazette. Python, Node.js and cURL clients for the Bundesanzeiger Scraper on Apify, pay per result.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages