Help Center
Wie können wir helfen? 👋

API-Schlüssel erstellen & API nutzen

Erstellen Sie einen API-Schlüssel in B2B Hero, um Ihre Leads, Suchlisten und Kampagnen-Statistiken automatisiert abzufragen und zu exportieren.

In diesem Artikel zeigen wir Ihnen, was die B2B Hero API kann, wie Sie einen API-Schlüssel erstellen und wo Sie die technische Dokumentation finden.


Was ist die B2B Hero API?

Die API (Programmierschnittstelle) verbindet B2B Hero mit Ihren eigenen Systemen. So rufen Sie Ihre Daten automatisiert ab – ganz ohne manuellen Export.

Aktuell stehen Ihnen folgende Möglichkeiten zur Verfügung:

  • Alle Suchanfragen auflisten und einzelne Queries anzeigen lassen
  • Unternehmen & Daten pro Suchanfrage exportieren
  • Statistiken zu Postmailings sowie E-Mail-Daten exportieren

Wir erweitern die API laufend – weitere Funktionen folgen in Kürze.


Schritt-für-Schritt Anleitung

So erstellen Sie Ihren API-Schlüssel in wenigen Schritten.

1. API-Schlüssel öffnen

  1. Gehen Sie in B2B Hero zu Einstellungen
  1. Öffnen Sie den Bereich API-Schlüssel
Notion image

2. Neuen Schlüssel erstellen

  1. Klicken Sie auf Schlüssel erstellen
  1. Vergeben Sie einen Namen für den Schlüssel
    1. 💡
      Tipp: Benennen Sie den Schlüssel nach dem System/Integration, das Sie anbinden (z. B. „CRM" oder „Zapier"). So behalten Sie den Überblick, welcher Schlüssel wofür verwendet wird.
  1. Legen Sie fest, welche Daten der Schlüssel abfragen darf. Pro Schlüssel wählen Sie genau einen Bereich:
  • Leads & Suchlisten Lesen – Zugriff auf Suchanfragen, Unternehmen und Lead-Daten
  • Kampagnen & Postmailing Statistiken Lesen – Zugriff auf Postmailing-Statistiken und E-Mail-Daten
  1. Klicken Sie anschließend auf „Erstellen", um den API-Schlüssel anzulegen.
⚠️

Behandeln Sie den Schlüssel wie ein Passwort: Er gewährt Zugriff auf Ihre Daten. Geben Sie ihn nicht weiter und speichern Sie ihn nicht öffentlich (z. B. nicht im Quellcode oder in geteilten Dokumenten).

Notion image

Sicherheitskonzept: Ein Schlüssel pro Bereich & System

Für maximale Sicherheit empfehlen wir, für jedes System einen eigenen Schlüssel zu erstellen und diesem nur einen Bereich zuzuweisen.

Die Vorteile:

  • Volle Kontrolle: Sie steuern genau, welches System auf welche Daten zugreift.
  • Besserer Datenschutz: Jedes System erhält nur Zugriff auf die Daten, die es wirklich benötigt.
  • Einfaches Widerrufen: Wird ein Schlüssel nicht mehr benötigt oder gelangt in falsche Hände, deaktivieren Sie einfach den betroffenen Schlüssel – alle anderen bleiben davon unberührt.
👉

Empfehlung: Erstellen Sie also lieber mehrere Schlüssel mit eng gefasster Berechtigung als einen einzigen Schlüssel für alles.


Technische Dokumentation

Alle technischen Details – verfügbare Endpunkte, Authentifizierung und Beispiel-Anfragen – finden Sie in unserer API-Dokumentation:

Verwenden Sie Ihren erstellten API-Schlüssel, um sich bei den Anfragen zu authentifizieren. Je nach gewählter Berechtigung fragen Sie damit Lead-Daten oder Kampagnen- und E-Mail-Daten ab.


💡
Pro Tip: Starten Sie mit einem einzelnen Schlüssel und einem klar abgegrenzten Anwendungsfall (z. B. nur Lead-Export in Ihr CRM). Sobald das reibungslos läuft, binden Sie weitere Systeme mit jeweils eigenen Schlüsseln an.