Handelsregister Scraper

Handelsregister.
Als Echtzeit-API.

Firmenname oder Registernummer genügen: Der Actor fragt das Handelsregister live ab und liefert den bestpassenden Eintrag mit Rechtsform, Sitz, Anschrift und allen Vertretungsberechtigten als JSON.

Ab 0,03 $ pro Eintrag — Abrechnung über Apify

json
{
  "registernummer": "987654",
  "registerart": "HRB",
  "registergericht": "München"
}
json
{
  "bezeichnung": "Beispieltechnik GmbH",
  "rechtsform": {
    "lang": "Gesellschaft mit beschränkter Haftung",
    "kurz": "GmbH"
  },
  "register_eintrag": {
    "gericht": "Amtsgericht München",
    "register": "HRB",
    "laufende_nummer": "987654"
  },
  "sitz": "München",
  "anschrift": {
    "strasse": "Innovationsallee",
    "hausnummer": "42",
    "postleitzahl": "80999",
    "ort": "München",
    "staat": "Deutschland"
  },
  "gegenstand": "Entwicklung und Vertrieb von Software für industrielle Automatisierungssysteme.",
  "stammkapital": {
    "zahl": 25000.0,
    "waehrung": "EUR"
  },
  "daten": {
    "erste_eintragung": "2018-06-12",
    "letzte_eintragung": "2024-10-12",
    "abrufdatum": "2026-05-20"
  },
  "vertretungsberechtigte": [
    {
      "rollenbezeichnung": "Geschäftsführer(in)",
      "typ": "natürliche Person",
      "vorname": "Lena",
      "nachname": "Beispiel",
      "ort": "München"
    }
  ],
  "prokuristen": [
    {
      "rolle": "Prokurist",
      "vorname": "Lukas",
      "nachname": "Bernhardt",
      "ort": "Freising"
    }
  ]
}
Beispiel: Mit der Registernummer 987654, der Registerart HRB und dem Registergericht München ruft der Actor den Eintrag der Beispieltechnik GmbH ab, mit Registergericht, Anschrift, der Geschäftsführerin und dem Prokuristen.

Echtzeit-API

Im Standby-Modus nimmt der Actor Anfragen direkt an. Ein POST an seine URL genügt, die Antwort enthält den Eintrag als JSON.

Alle Vertretungsberechtigten

Inhaber, Geschäftsführer, Vorstand oder persönlich haftende Gesellschafter stehen in einer Liste, jeweils mit ihrer Rolle.

Ein Eintrag pro Anfrage

Der Actor gibt den bestpassenden Treffer zurück. Mit Registernummer, Registerart und Gericht findet er genau den gesuchten.

Eingabe

Firmenname oder Registernummer.

Per API senden Sie die Felder als JSON, in der Apify Console füllen Sie dasselbe als Formular aus. Nötig ist mindestens ein Suchkriterium: Firmenname, Sitz oder Registernummer.

Die Eingabefelder des Handelsregister Scrapers
Feld Bedeutung Standard
firma_schlagwoerter Firmenname oder Schlagwörter, durch Leerzeichen getrennt. —
schlagwoerter_suchoptionen Wie die Schlagwörter passen: „alle Schlagwörter enthalten.“, „mindestens ein Schlagwort enthalten.“ oder „den genauen Firmennamen enthalten.“ Pflicht zu firma_schlagwoerter; „mindestens ein Schlagwort“ verlangt zudem Registerart, Gericht oder Nummer. —
aehnlich_lautende_schlagwoerter Findet auch ähnlich klingende Namen, etwa „Meier“ zu „Meyer“. false
niederlassung_sitz Ort der Niederlassung oder des Sitzes, etwa „Hamburg“. —
zusaetzliche_suchoptionen „Auch geschlossene Registerblätter oder gelöschte Zweigniederlassungen finden.“ oder „Nur nach Zweigniederlassungen neuen Rechts suchen.“ —
registernummer Registernummer ohne Registerart, höchstens 10 Zeichen. Verlangt registerart und registergericht. —
registerart HRA, HRB, GnR, PR, VR, GsR oder „alle“. alle
registergericht Ort des Registergerichts, etwa „München“ oder „Berlin (Charlottenburg)“, oder „alle“. Kleine Tippfehler korrigiert der Actor. alle
xml_im_key_value_store_speichern Legt den strukturierten Registerinhalt als XJustiz-XML im Key-Value Store ab. false
proxyConfiguration Proxy für den Abruf, von Apify oder eigene. Residential, DE
Ausgabe

Der Eintrag als JSON.

Die Antwort ist ein JSON-Objekt, das der Actor zugleich im Dataset ablegt; Apify exportiert es als JSON, CSV oder Excel. Felder ohne Wert lässt der Actor weg.

Die Felder eines Eintrags
Feld Bedeutung
bezeichnung Firmenname, wie eingetragen.
rechtsform Rechtsform, ausgeschrieben (lang) und abgekürzt (kurz).
register_eintrag Registergericht (gericht), Registerart (register) und Nummer (laufende_nummer), diese ohne Zusatz: „8438“ statt „HRA 8438 P“.
sitz Sitz der Firma.
anschrift Geschäftsanschrift in Feldern: strasse, hausnummer, postleitzahl, ort und staat.
gegenstand Gegenstand des Unternehmens.
stammkapital Stamm- oder Grundkapital mit Betrag (zahl) und Währung (waehrung), nur bei Kapitalgesellschaften.
daten Erste Eintragung, Satzungsdatum, letzte Änderung, letzte Eintragung und Abrufdatum, nach ISO 8601.
vertretungsberechtigte Alle, die die Firma vertreten, mit rollenbezeichnung und typ: natürliche Personen mit Vor- und Nachname, Wohnort und, falls eingetragen, Geburtsdatum; juristische Personen mit bezeichnung, sitz und register_eintrag.
prokuristen Prokuristen mit rolle, Vor- und Nachname, Wohnort und, falls eingetragen, Geburtsdatum.
kommanditisten Die Kommanditisten einer KG, angegeben wie die Vertretungsberechtigten, dazu ihre Hafteinlage (hafteinlage).

Das Original als XML.

Mit xml_im_key_value_store_speichern legt der Actor den strukturierten Registerinhalt im XJustiz-Format in den Key-Value Store des Laufs, unter einem Schlüssel wie xml_{Gericht}_{Registerart}_{Registernummer}.xml.

Preise

Bezahlt wird pro Treffer.

Apify berechnet einen festen Preis für jeden gefundenen Eintrag und eine kleine Gebühr für jeden Start des Actors, in US-Dollar. Kosten für Rechenzeit fallen nicht an. Je höher Ihr Apify-Tarif, desto niedriger die Preise.

  • Free

    Apify Free

    0,05 $ pro Eintrag

    dazu 0,02 $ pro Start

  • Bronze

    Apify Starter

    0,04 $ pro Eintrag

    dazu 0,008 $ pro Start

  • Silver

    Apify Scale

    0,035 $ pro Eintrag

    dazu 0,006 $ pro Start

  • Gold

    Apify Business

    0,03 $ pro Eintrag

    dazu 0,004 $ pro Start

Maßgeblich ist der Preis auf der Preisseite des Actors im Apify Store; Ihr Krake-Guthaben gilt dort nicht.

Rechner

Was kosten Ihre Abfragen?

Wählen Sie die Zahl der gefundenen Einträge und vergleichen Sie, was sie in jedem Apify-Tarif kosten.

Jede Anfrage liefert höchstens einen Eintrag, und nur gefundene Einträge kosten. Dazu kommt die Gebühr für jeden Start des Actors.

Kostenschätzung 1.000 Einträge
Kosten je Apify-Tarif für die gewählte Zahl an Einträgen
Tarif Gesamt
Apify Free 0,05 $ pro Eintrag 50,00 $
Apify Starter 0,04 $ pro Eintrag 40,00 $
Apify Scale 0,035 $ pro Eintrag 35,00 $
Apify Business 0,03 $ pro Eintrag 30,00 $

Es gilt die Zeile Ihres Apify-Tarifs.

API

Per HTTP abfragen.

Im Standby-Modus läuft der Actor als Webdienst: Ein POST an seine URL, authentifiziert mit Ihrem Apify-Token, liefert den Eintrag direkt als JSON. Die erste Anfrage weckt den Actor und dauert etwas länger.

bash
ACTOR_URL=https://dominic-quaiser--handelsregister-scraper.apify.actor

curl --fail-with-body "$ACTOR_URL" \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  --data '{
    "firma_schlagwoerter": "Beispieltechnik GmbH",
    "schlagwoerter_suchoptionen": "alle Schlagwörter enthalten.",
    "niederlassung_sitz": "München"
  }'

# Antwort, gekürzt:
{
  "bezeichnung": "Beispieltechnik GmbH",
  "rechtsform": { "kurz": "GmbH" },
  "register_eintrag": { "gericht": "Amtsgericht München", "register": "HRB", "laufende_nummer": "987654" },
  "vertretungsberechtigte": [
    { "rollenbezeichnung": "Geschäftsführer(in)", "vorname": "Lena", "nachname": "Beispiel" }
  ]
}
ACTOR_URL=https://dominic-quaiser--handelsregister-scraper.apify.actor

curl --fail-with-body "$ACTOR_URL" \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  --data '{
    "registernummer": "987654",
    "registerart": "HRB",
    "registergericht": "München",
    "xml_im_key_value_store_speichern": true
  }'

# Antwort, gekürzt; das XML liegt im Key-Value Store des Laufs:
{
  "bezeichnung": "Beispieltechnik GmbH",
  "stammkapital": { "zahl": 25000.0, "waehrung": "EUR" },
  "daten": { "erste_eintragung": "2018-06-12", "letzte_eintragung": "2024-10-12" },
  "prokuristen": [
    { "rolle": "Prokurist", "vorname": "Lukas", "nachname": "Bernhardt" }
  ]
}
ACTOR_URL=https://dominic-quaiser--handelsregister-scraper.apify.actor

curl "$ACTOR_URL" \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  --data '{
    "registernummer": "987654",
    "registerart": "HRB",
    "registergericht": "Munchhen"
  }'

# 400 Bad Request:
{
  "error": {
    "status_code": 400,
    "message": "Invalid registergericht: 'Munchhen'. Suggestions: München, Mühldorf a. Inn, Münster"
  }
}

# 200  Eintrag gefunden und im Dataset abgelegt
# 400  Anfrage unvollständig oder ungültig
# 401  Apify-Token fehlt oder ist ungültig
# 402  Limit für berechnete Einträge erreicht
# 404  Kein Eintrag gefunden
# 500  Abruf fehlgeschlagen, etwa während einer Wartung des Registers
Kombinieren

Das Impressum einer Website nennt die Registernummer, mit der dieser Actor genau den Eintrag findet. Firmenlisten, Veröffentlichungen und E-Mail-Adressen liefern die anderen Actors.

Apify Actor

German Imprint Scraper

Findet auf deutschen Websites das Impressum und liest die Kontaktdaten strukturiert aus, auf Wunsch mit den Entscheidungsträgern.

Eingabe
Website-URLs und die gewünschten Felder
Ergebnis
Firmenname, Anschrift, Telefon, Fax, E-Mail, Registernummer, USt-ID, Social-Media-Profile, Entscheidungsträger
Apify Actor

Unternehmensregister Scraper

Sucht Unternehmen im Unternehmensregister und liefert pro Abfrage ein Firmenprofil. Auf Wunsch mit Metadaten zu Finanzveröffentlichungen und ausgewählten Registerauszügen als PDF oder XML, sofern verfügbar.

Eingabe
Firmenname, EUID oder Registernummer, optional Sitz, Rechtsform und Bundesland
Ergebnis
Firmenname, EUID, Sitz, Rechtsform, Registerangaben, Status, Finanzveröffentlichungen
Apify Actor

Das Örtliche Scraper

Liest Firmeneinträge aus Das Örtliche aus, dem Verzeichnis für Unternehmen vor Ort, nach Suchbegriff und Ort.

Eingabe
Suchbegriff und Ort, maximale Anzahl
Ergebnis
Name, Anschrift, Telefon, Fax, E-Mail, Website, Branche
Apify Actor

Email Scraper

Durchsucht Websites nach E-Mail-Adressen, auch wenn sie verschleiert sind: in mailto-Links, im Text, in „[at]“-Schreibweise, hinter Cloudflare-Schutz oder mit RTL-Zeichen.

Eingabe
Start-URLs, Crawl-Tiefe und Filter für Adressen
Ergebnis
E-Mail-Adresse, Fundstelle, Start-URL, Fundmethode, Tiefe
Vergleich

Apify oder Krake?

Der Actor ruft einzelne Einträge in Echtzeit ab, in Ihrem eigenen Ablauf. Für ganze Firmenlisten sucht die Datenanreicherung in der Krake-Konsole Registerangaben und Kontaktdaten in mehreren Quellen zusammen.

Handelsregister Scraper

Für einzelne Abfragen, in Ihrem Ablauf auf Apify.

  • Ein Eintrag pro Anfrage, mit allen Vertretungsberechtigten
  • Echtzeit-API im Standby-Modus oder Start in der Apify Console
  • Auf Wunsch der strukturierte Registerinhalt als XML
  • Ab 0,03 $ pro Eintrag, abgerechnet über Apify
Auf Apify starten

Datenanreicherung

Wenn ganze Firmenlisten ergänzt werden sollen.

  • Startet mit Firmenname und Ort, der Domain oder Registernummer und Gericht
  • Ergebnis aus über 10 Quellen zusammengeführt
  • Registerangaben, Vertretung und geprüfte E-Mail-Adressen
  • 0,05 € pro Datensatz mit Ergebnis
Zur Datenanreicherung
Fragen

Häufige Fragen.

Ihre Frage ist nicht dabei? Schreiben Sie uns an hello@krake.run.

Was kostet der Actor?

Je nach Apify-Tarif 0,03 $ bis 0,05 $ pro gefundenem Eintrag und 0,004 $ bis 0,02 $ pro Start des Actors, abgerechnet über Apify (Preise). Ein Start bedient viele Anfragen: Im Standby-Modus läuft der Actor weiter, bis er eine Weile keine Anfrage bekommt. Maßgeblich ist der Preis auf der Preisseite des Actors im Apify Store. Ihr Krake-Guthaben gilt dort nicht.

Warum liefert der Actor nur einen Eintrag?

Er ist für die Abfrage einer bestimmten Firma gebaut und gibt den ersten, bestpassenden Treffer der Suche zurück. Eindeutig wird die Suche mit Registernummer, Registerart und Registergericht oder mit dem genauen Firmennamen und dem Sitz.

Welche Registerart wähle ich?

HRA für Einzelkaufleute, OHG und KG, auch die GmbH & Co. KG; HRB für GmbH, UG, AG, KGaA und SE. GnR steht für Genossenschaften, PR für Partnerschaftsgesellschaften, VR für Vereine und GsR für eingetragene Gesellschaften bürgerlichen Rechts. Mit „alle“ sucht der Actor in jedem Register.

Was, wenn das Handelsregister nicht erreichbar ist?

Der Actor fragt handelsregister.de live ab, und das Portal hat häufig Wartungsfenster und Ausfälle, manchmal nur für einzelne Bundesländer. Dann antwortet der Actor mit Status 500. Ob das Register erreichbar ist, zeigen die Statusseite des Actors mit unabhängiger Überwachung und die Länderinformationen des Handelsregisters.

Was gilt für die Nutzung der Daten?

Für die weitere Nutzung sind Sie verantwortlich. Die Registerdaten sind öffentlich, enthalten aber personenbezogene Daten wie Namen, Wohnorte und Geburtsdaten, für die die DSGVO gilt; Werbung per E-Mail oder Telefon regelt zudem das UWG.

Gehört der Actor zum Handelsregister?

Nein. Der Actor ist ein unabhängiges Angebot und nicht mit dem Registerportal der Länder verbunden. Er ruft Angaben ab, die auf handelsregister.de öffentlich zugänglich sind.

Ganze Firmenlisten anreichern?

Firmenname und Ort genügen: Die Datenanreicherung in der Krake-Konsole sucht Registerangaben, Vertretung und geprüfte E-Mail-Adressen für jede Zeile Ihrer Liste.

10 € Startguthaben nach der E-Mail-Bestätigung — Kein Abo