Germany Handelsregister Scraper — HRB, Address & Directors

Paste a company name (or court + HRB / HRA number) and get matching German companies as a clean dataset: court, register number, status, legal form, share capital, registered address — and on KYB, directors / legal representatives.

No API key. No account. Public register only. This Actor does not crawl company websites or collect emails.

Built for: German B2B suppliers · outbound / SDR · KYB & compliance · market research

---

Who is this for?

You are…	Typical goal	Suggested setup
B2B supplier or SaaS vendor	Prospect list by name, state, or legal type	Company name · Profile
Outbound SDR / sales team	Legal name, court and address before outreach	Company name · Profile
Compliance or KYB analyst	Verify HRB, legal form, capital, seat and directors	Register ids · KYB
Market researcher	Map companies in a Land or register type	Company name + state · Basic
Legal or accounting firm	Confirm registration date and disclosed accounts	Register ids · Profile
Data / ops	Backfill CRM with official register fields	Register ids · Profile

By default (Profile) you get court, HRB/HRA, name, city, status, legal form, capital, registration date and registered address. Basic is the search row only (faster). KYB adds directors (Vorstand / Geschäftsführer). Turn All representatives on if you also need Prokuristen.

The Handelsregister does not publish emails or a company website. Use the legal name + city in an enricher if you need inboxes.

---

What it does

Mode	How it works	Best for
Company name	Keywords on the official extended search (all / at least one / exact). Optional federal state (max 2) and register type.	Discovery lists
Register ids	Paste Mannheim HRB 719915 (court + number).	CRM backfill, KYB checks

German companies are identified by court + register type + number, not by a national number like a UK company number or a French SIREN.

---

What it extracts

Search row (all runs)

Field	Description
registerNummer	e.g. HRB 719915
registerArt	HRB, HRA, GnR, VR, PR, GsR
name	Registered name
court	Amtsgericht
state	Federal state
city	City from the result list
status	e.g. aktuell
documents	Document codes listed on the portal (AD, CD, UT, SI, …)

Profile / KYB

Field	Description
legalForm	e.g. GmbH, SE
capital	Share capital as published
registeredOn / deletedOn	Entry / deletion date
accountsFiledTo	Last disclosed annual accounts (if shown)
registeredAddress	Address block (plus postcode / city / country when parsed)
directorName / directorRole / directorDateOfBirth	Primary legal representative (KYB)
officers	All parsed representatives (KYB)
representation	Representation rule when published (KYB)

Missing fields are null. Unknown court names or numbers with no hit are logged and not billed.

---

Quick start

1. Open this Actor in Apify Console
2. Keep Mode = Company name, leave the prefilled example or type a firm name
3. Pick Profile (or Basic / KYB)
4. Set Max companies to 10 for a preview → Start

To enrich ids you already have: Mode = Register ids, one Court HRB nnnnn per line.

---

Input

Field	Console	Notes
mode	Mode	keyword or registerIds
keywords	Company name	Ignored in register-ids mode
keywordMatch	Keyword match	all / min / exact
federalStates	Federal states	Max two. Empty = nationwide
registerArt	Register type	Optional HRB/HRA/… filter
registerIds	Court + number	e.g. München HRB 12345
enrichmentLevel	Depth	basic / profile / kyb
officersScope	KYB officers	directors (default) or all (includes Prokuristen)
maxResults	Cap	0 = no cap (free plan still capped at 100)

---

Output example

{
  "registerNummer": "HRB 719915",
  "registerArt": "HRB",
  "name": "SAP SE",
  "court": "Mannheim",
  "state": "Baden-Württemberg",
  "city": "Walldorf",
  "status": "aktuell",
  "legalForm": "Europäische Aktiengesellschaft (SE)",
  "capital": "1.228.504.232,00 EUR",
  "registeredOn": "07.07.2014",
  "registeredAddress": "SAP SE, Dietmar-Hopp-Allee 16, 69190 Walldorf, Deutschland",
  "addressPostcode": "69190",
  "directorName": "Ada Beispiel",
  "directorRole": "Geschäftsführerin",
  "officers": [
    { "name": "Ada Beispiel", "firstName": "Ada", "lastName": "Beispiel", "role": "Geschäftsführerin", "bornOn": "1979-03-12" }
  ],
  "documents": ["AD", "CD", "HD", "DK", "UT", "VÖ", "SI"],
  "extractedAt": "2026-08-18T12:00:00.000Z"
}

Dataset views: Overview, Outreach / CRM, KYB / Compliance.

---

How to use

1. Choose Company name or Register ids
2. Fill keywords or court + HRB lines
3. Choose enrichment depth
4. Start. Export CSV / Excel / JSON from the dataset

---

Pricing

Pay per saved company (not-found ids are free):

Event	What you get	Price
company-basic	Search row	$0.001
company-profile	+ legal form, capital, address	$0.003
company-kyb	+ directors / legal representatives	$0.004

---

Limitations

• No emails, no website harvest. The public portal does not publish them.
• Directors on KYB only. Default is Vorstand / Geschäftsführer. Prokuristen are opt-in (officersScope: all).
• Identity is court + HRB/HRA, not a single national number. You must include the court when enriching a list.
• At most two federal states per name search (portal rule).
• Targeted enricher, not a national dump. Each name search returns at most 100 matches. The Actor paces lookups to stay within the public register's usage rules — large KYB lists take longer; raise the run timeout.
• Register dates on the portal can include a system disclaimer; we store the date as shown.

---

Same suite

Official-register scrapers in the same family:

• France — recherche entreprises / SIREN
• Belgium — BCE / KBO
• UK — Companies House

---

FAQ

Do I need an API key? No.

Can I paste a handelsregister.de search URL? The portal is session-based (no stable public search URL). Use keywords or court + number instead.

Why is my court “not found”? Use the Amtsgericht name as on the portal (e.g. Mannheim, München, Charlottenburg).

Does Basic include the address? No. Address, legal form and capital come from Profile / KYB.

---

Local development

npm install
npm test
# edit input.json then:
npx apify run

---

Support

Issues and feature requests via the Actor’s Issues tab on Apify, or the Store listing.