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.
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.Schematisches Beispiel · fiktive Daten
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.
Wählen Sie die Zahl der gefundenen Einträge und vergleichen Sie, was sie in jedem Apify-Tarif kosten.
1.000
1010.000
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ätzung1.000 Einträge
Kosten je Apify-Tarif für die gewählte Zahl an Einträgen
Tarif
Gesamt
Apify Free0,05 $ pro Eintrag
50,00 $
Apify Starter0,04 $ pro Eintrag
40,00 $
Apify Scale0,035 $ pro Eintrag
35,00 $
Apify Business0,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.
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.
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
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.
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
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.