# Germany Handelsregister Scraper (`regdata/germany-handelsregister-scraper`) Actor Search the German Commercial Register (Handelsregister) by company name or register number. Extract company data, officers / managing directors (Geschäftsführer) with dates of birth, capital, legal form, seat, business purpose. No official API - structured JSON for KYC, KYB & due diligence. - **URL**: https://apify.com/regdata/germany-handelsregister-scraper.md - **Developed by:** [getregdata](https://apify.com/regdata) (community) - **Categories:** Lead generation, Automation, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing from $5.20 / 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. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. 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 ## Germany Handelsregister Scraper - Company Data, Officers & Capital Extract official company data from the **German Commercial Register (Handelsregister)** - master data, registered office, **registered capital**, legal form, **officers / managing directors (Geschäftsführer) with dates of birth**, business purpose and representation rules. Search by company name or register number and get clean, structured JSON in seconds, parsed from the register's official structured (**XJustiz**) content. There is **no official public API** for `handelsregister.de`. This actor is the API. ### Zero setup - clean structured data, no scripting `handelsregister.de` has **no official public API**, runs slowly, and limits how fast it can be queried. This actor takes care of the access, retries and parsing for you - just send a company name and get clean structured JSON back. **No proxy to configure, no infrastructure to manage, no browser to script.** All access costs are already included in the price, so there is no separate bill to worry about. ### Quick Start Click **Try it** and paste this input: ```json { "searchQuery": "Zalando SE" } ```` Or pin an exact company name and cap the results: ```json { "searchQuery": "BioNTech", "exactMatch": true, "maxResults": 5 } ``` ### Sample Output ```json { "companyName": "Connected Retail GmbH", "legalForm": "Gesellschaft mit beschränkter Haftung", "legalFormCode": "221110", "registerCourt": "Amtsgericht Charlottenburg", "registerType": "HRB", "registerNumber": "HRB 215511 B", "euid": "DEF1103R.HRB215511B", "status": "aktuell", "seat": "Berlin", "address": { "street": "Valeska-Gert-Straße", "houseNumber": "5", "postalCode": "10243", "city": "Berlin", "formatted": "Valeska-Gert-Straße 5, 10243 Berlin" }, "capital": { "amount": 30000, "currency": "EUR", "formatted": "30000.00 EUR" }, "officers": [ { "name": "Tim Seelmann", "firstName": "Tim", "lastName": "Seelmann", "dateOfBirth": "1990-03-24", "city": "Berlin", "roleCode": "086", "role": "Geschäftsführer" }, { "name": "Joanna Ewa Rogers", "firstName": "Joanna Ewa", "lastName": "Rogers", "dateOfBirth": "1975-02-26", "city": "Berlin", "roleCode": "086", "role": "Geschäftsführer" } ], "representationRule": "Ist ein Geschäftsführer bestellt, so vertritt er die Gesellschaft allein. Sind mehrere Geschäftsführer bestellt, wird die Gesellschaft gemeinschaftlich durch zwei Geschäftsführer oder durch einen Geschäftsführer in Gemeinschaft mit einem Prokuristen vertreten.", "businessPurpose": "Die Erbringung von Vertriebsdienstleistungen für Einzelhändler ...", "registrationHistory": ["Die Gesellschaft hat auf Grund des Spaltungsvertrages vom 22.01.2020 ... im Wege der Ausgliederung übertragen."], "structuredData": true, "sourceUrl": "https://www.handelsregister.de", "scrapedAt": "2026-06-09T19:04:27.810Z" } ``` ### Pricing Pay-per-event - you pay only for results: | Event | Price | |-------|-------| | Actor start (per run) | $0.025 | | Company record returned | $0.008 | A typical lookup costs about **$0.033 for one company** and scales linearly with `maxResults` (e.g. 10 companies ≈ $0.105). A search that returns nothing costs only the **$0.025** start fee. There is no separate infrastructure bill - all access costs are already included in the prices above. No subscription, no minimum commitment. ### Features - **Zero setup** - no proxy or infrastructure to manage; reliable access is handled for you - **Search by name or register number** - keyword search (Schlagwörter) or exact company name (genaue Firmenbezeichnung) - **Official structured data** - parsed from the register's **XJustiz** XML (Strukturierter Registerinhalt), not scraped HTML - **Officers with dates of birth** - managing directors, board members and Prokuristen with DOB and city (the key field for KYC name matching) - **Registered capital** - amount and currency - **EUID** - the European Unique Identifier for cross-border matching - **Representation rules & company history** - Vertretungsregelung and Eintragungstexte - **Resilient** - automatic retries against the slow government portal ### Related Actors Build a full cross-border KYC / company-intelligence stack with the rest of the suite: - [France Societe.com Scraper](https://apify.com/regdata/societe-com-scraper) - French company directors, financials and shareholders (SIREN) - [Spain Company Directory Scraper](https://apify.com/regdata/spain-company-directory-scraper) - Spanish companies, officers, NIF and CNAE codes - [Austria WKO Business Directory Scraper](https://apify.com/regdata/wko-business-directory-scraper) - 620,000+ Austrian businesses with contact details - [Poland CRBR Beneficial Owners Scraper](https://apify.com/regdata/crbr-beneficial-owners-scraper) - ultimate beneficial owners (UBO) for KYC/AML - [Poland REGON Scraper](https://apify.com/regdata/polish-regon-scraper) - resolve any Polish company by name, NIP, KRS or REGON ### Input Parameters | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | `searchQuery` | string | No\* | Company name or keyword(s) to search for (Schlagwörter) | | `exactMatch` | boolean | No | Match the exact company name instead of keyword containment. Default `false` | | `registerNumber` | string | No\* | Register number to narrow the search, e.g. `215511` | | `maxResults` | integer | No | Max matching companies to return (1-30). Default `10` | \*Provide a `searchQuery` (alone or combined with a `registerNumber`). The portal does not allow searching by register number alone. ### Output Fields | Field | Description | |-------|-------------| | `companyName` | Full legal company name | | `legalForm` / `legalFormCode` | Legal form (e.g. GmbH, AG) and its raw XJustiz code | | `status` | Register status (e.g. `aktuell`) | | `registerCourt` | Registering court (Registergericht, e.g. Amtsgericht Charlottenburg) | | `registerType` | HRB / HRA / GnR / PR / VR | | `registerNumber` | Register number | | `euid` | European Unique Identifier | | `seat` | Registered seat (Sitz) | | `address` | Full registered address (street, house number, postal code, city, formatted) | | `capital` | Registered capital (`amount` + `currency`) | | `officers` | Representatives with `name`, `firstName`, `lastName`, `dateOfBirth`, `city`, `role` and raw `roleCode` | | `representationRule` | General rule of representation (Vertretungsregelung); `representationDetails` for per-officer clauses | | `businessPurpose` | Object of the company (Gegenstand des Unternehmens) | | `registrationHistory` | Registration narrative entries (Eintragungstexte) | | `structuredData` | `true` when official XJustiz structured content was parsed | | `sourceUrl` / `scrapedAt` | Provenance | `legalForm` and officer `role` labels are mapped from the official XJustiz code lists for the most common values; the raw code (`legalFormCode`, `roleCode`) is always included so nothing is lost. ### Use Cases - **KYC / KYB & onboarding** - verify a German counterparty's legal identity, register status, capital and representatives - **Due diligence & compliance** - capture officers (with dates of birth), representation rules and corporate history - **Sales & lead enrichment** - resolve a company name to its official register data and decision-makers - **Risk & credit** - monitor legal form, capital and status changes - **Investigations & research** - map directorships and corporate structures across the largest EU economy ### How It Works The actor queries the **public** `handelsregister.de` search and parses each match's official **XJustiz** structured content (Strukturierter Registerinhalt) into clean JSON fields. It reads only the **freely available, public** register data - no login, no account, and no paid document purchase is involved. This is the same information any visitor can look up by hand; the actor simply returns it as structured data. ### Data Source & Compliance - **Source**: German Commercial Register portal - https://www.handelsregister.de - **Standard**: XJustiz (the official German legal-data XML standard) - **Legal basis**: § 9 HGB (Handelsgesetzbuch) - the Handelsregister is a public register open to everyone - Officer data (names, dates of birth) is published by the register by law. Use it in compliance with the GDPR and applicable law. ### European Business Data Suite This Actor is part of a growing collection of European company data actors with no public API - structured JSON, pay-per-result, no subscriptions. | Country | Actor | Data Source | What it does | |---------|-------|-------------|-------------| | **Germany** | **Handelsregister Scraper** | Handelsregister | Company data, officers, capital | | **France** | [Societe.com](https://apify.com/regdata/societe-com-scraper) | Societe.com | Directors, financials, shareholders | | **Spain** | [Company Directory](https://apify.com/regdata/spain-company-directory-scraper) | Registro Mercantil | NIF, officers, CNAE codes | | **Spain** | [Corporate Acts](https://apify.com/regdata/borme-corporate-acts-scraper) | BORME | Daily gazette, appointments | | **Austria** | [Business Directory](https://apify.com/regdata/wko-business-directory-scraper) | WKO | 620,000+ businesses | | **Austria** | [Insolvencies](https://apify.com/regdata/austria-ediktsdatei-scraper) | Ediktsdatei | Insolvency & auction edicts | | **Poland** | [10+ actors](https://apify.com/regdata) | KRS / eKRS / CRBR | Financials, UBO, directors, debtors | > **Full suite**: [apify.com/regdata](https://apify.com/regdata) ### Auf Deutsch #### Was macht dieser Actor? Dieser Actor extrahiert offizielle Unternehmensdaten aus dem **deutschen Handelsregister** (`handelsregister.de`): Firma, Rechtsform, Registergericht, Registernummer (HRB/HRA), Sitz und Anschrift, **Stammkapital**, **Geschäftsführer und Vorstände samt Geburtsdatum**, Vertretungsregelung, Gegenstand des Unternehmens und Eintragungshistorie. Die Daten stammen aus dem **Strukturierten Registerinhalt (XJustiz-XML)** und werden in sauberes JSON umgewandelt. Es gibt **keine offizielle API** - dieser Actor ersetzt sie. #### Für wen? Für **Compliance- und KYC/KYB-Teams**, die deutsche Geschäftspartner verifizieren, **Due-Diligence- und Kanzlei-Workflows**, **Vertrieb und Lead-Anreicherung** sowie **Risiko- und Kreditanalyse**. **Kein Proxy und kein Setup nötig** - der zuverlässige Zugriff ist bereits eingebaut. Keine Abos - Sie zahlen nur pro Ergebnis. ### Notes & Limits - Returns matches from the first results page (up to `maxResults`). For one specific company, use `exactMatch` or add a `registerNumber`. - The register's document service has its own rate limit. Under heavy use, some records may return **core identity only** (company name, register number, court, status) with a *"retry later"* status instead of the full SI document; simply rerun those for the complete structured data. The `structuredData` field is `true` when the full document was parsed. - Data originates from the German federal-state register portal and is provided as-is. ### Disclaimer This actor extracts publicly available information from the German Commercial Register for legitimate business purposes (KYC/AML, due diligence, research). Personal data of officers is published by the register by law; process it in compliance with the GDPR and applicable law. *** ### Handelsregister Auszug als API - Firmendaten, Geschäftsführer & Kapital Automatischer Abruf von **Handelsregister**-Daten über `handelsregister.de`: Firmenname, Rechtsform (GmbH, AG, UG), Registergericht, HRB-/HRA-Nummer, Sitz, **Stammkapital**, **Geschäftsführer mit Geburtsdatum**, Vertretungsregelung und Unternehmensgegenstand - alles als strukturiertes JSON, ohne Proxy und ohne eigenes Setup. Ideal für KYC/KYB, Compliance, Due Diligence und Lead-Anreicherung in Deutschland. # Actor input Schema ## `searchQuery` (type: `string`): Company name or keyword(s) to search for (Schlagwörter). E.g. "Zalando SE" or "BioNTech". ## `exactMatch` (type: `boolean`): Match the exact company name (genaue Firmenbezeichnung) instead of keyword containment. Reduces noise for precise lookups. ## `registerNumber` (type: `string`): Optional commercial register number to narrow the search, e.g. "215511" (HRB). Must be combined with a company name/keyword - the portal does not allow number-only searches. ## `maxResults` (type: `integer`): Maximum number of matching companies to return structured data for (from the first results page). 1-30. ## `scrapflyApiKey` (type: `string`): Optional. This actor ships with anti-bot bypass already configured, so leave this empty. Provide your own Scrapfly API key only if you want the run billed to your own Scrapfly account. ## Actor input object example ```json { "searchQuery": "Zalando SE", "exactMatch": false, "maxResults": 10 } ``` # Actor output Schema ## `companies` (type: `string`): Company records with name, register court/type/number, EUID, seat, address, capital, officers (with dates of birth), business purpose and representation rules. # 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": "Zalando SE" }; // Run the Actor and wait for it to finish const run = await client.actor("regdata/germany-handelsregister-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": "Zalando SE" } # Run the Actor and wait for it to finish run = client.actor("regdata/germany-handelsregister-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": "Zalando SE" }' | apify call regdata/germany-handelsregister-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=regdata/germany-handelsregister-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Germany Handelsregister Scraper", "description": "Search the German Commercial Register (Handelsregister) by company name or register number. Extract company data, officers / managing directors (Geschäftsführer) with dates of birth, capital, legal form, seat, business purpose. No official API - structured JSON for KYC, KYB & due diligence.", "version": "1.0", "x-build-id": "a5Nqa7NCdYZo4WZek" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/regdata~germany-handelsregister-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-regdata-germany-handelsregister-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/regdata~germany-handelsregister-scraper/runs": { "post": { "operationId": "runs-sync-regdata-germany-handelsregister-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/regdata~germany-handelsregister-scraper/run-sync": { "post": { "operationId": "run-sync-regdata-germany-handelsregister-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 / keyword", "type": "string", "description": "Company name or keyword(s) to search for (Schlagwörter). E.g. \"Zalando SE\" or \"BioNTech\"." }, "exactMatch": { "title": "Exact company name", "type": "boolean", "description": "Match the exact company name (genaue Firmenbezeichnung) instead of keyword containment. Reduces noise for precise lookups.", "default": false }, "registerNumber": { "title": "Register number (optional)", "type": "string", "description": "Optional commercial register number to narrow the search, e.g. \"215511\" (HRB). Must be combined with a company name/keyword - the portal does not allow number-only searches." }, "maxResults": { "title": "Max results", "minimum": 1, "maximum": 30, "type": "integer", "description": "Maximum number of matching companies to return structured data for (from the first results page). 1-30.", "default": 10 }, "scrapflyApiKey": { "title": "Scrapfly API Key (optional override)", "type": "string", "description": "Optional. This actor ships with anti-bot bypass already configured, so leave this empty. Provide your own Scrapfly API key only if you want the run billed to your own Scrapfly account." } } }, "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 } } } } } } } } } } ```