Zum Hauptinhalt springen
Black Friday: 20% Rabatt auf alle Tarife bis 1. Dez.Angebot ansehen

Apollo.io API: Schlüssel, Endpunkte, Limits und MCP-Server

Leo
LeoFounder, BillionVerify

Apollo.io API-Leitfaden: API-Schlüssel erstellen, Health-Check, Personensuche und Anreicherung nutzen, Rate-Limits und Credits verstehen, MCP-Server verbinden.

Apollo.io API-Dashboard mit Schlüsseln, Endpunkten, Rate-Limits, MCP Server und E-Mail-Verifizierung

Die Apollo.io API ermöglicht es deinem eigenen Code, nach Personen zu suchen, Datensätze anzureichern und deinen Vertriebsworkflow zu verwalten. Du rufst sie über HTTPS mit einem Apollo.io API-Schlüssel auf. Du kannst den Schlüssel auch überspringen und einem KI-Client erlauben, über den Apollo.io MCP-Server auf dieselben Daten zuzugreifen. Beide Wege verbrauchen die Credits deines Tarifs und unterliegen dessen Limits.

Dieser Leitfaden führt durch die Apollo.io API – vom ersten Klick bis zum ersten Aufruf. Er zeigt, wie du einen Schlüssel erstellst und wo du ihn findest. Er behandelt die Dokumentation der Apollo.io API, den Health-Check, die Personensuche, die Anreicherung, Rate-Limits und Credit-Kosten. Am Ende geht es um den offiziellen MCP-Server für Apollo.io und eine Routine zur Überprüfung der von der API zurückgegebenen Adressen. Alle Informationen stammen aus der offiziellen Entwicklerdokumentation unter docs.apollo.io, die im Oktober 2026 gelesen wurde. Apollo.io kennzeichnet mehrere Seiten als kürzlich aktualisiert. Bestätige daher die Details an dem Tag, an dem du die Implementierung erstellst.

Wir sind nicht mit Apollo.io verbunden. BillionVerify ist ein E-Mail-Verifizierungsdienst. Für einen umfassenderen Überblick über die Plattform lies unseren Apollo.io-Leitfaden.

Wichtige Fakten (überprüft im Oktober 2026):

  • Jeder Tarif, einschließlich des kostenlosen Tarifs, bietet einen gewissen API-Zugriff. Kostenlose Konten benötigen für bestimmte Endpunkte eine geschäftliche E-Mail-Adresse.
  • Die Apollo.io API sendet den Schlüssel im x-api-key-Header, und die Basis-URL lautet https://api.apollo.io/api/v1.
  • Ein eingeschränkt gültiger Apollo.io API-Schlüssel erreicht nur die von dir ausgewählten Endpunkte. Ein Master-Schlüssel erreicht alle Endpunkte.
  • Die meisten Endpunkte akzeptieren 200 Aufrufe pro Minute in einem kostenpflichtigen Tarif, gegenüber 50 im kostenlosen Tarif.
  • Der Apollo.io MCP-Server befindet sich unter https://mcp.apollo.io/mcp und meldet sich per OAuth an.

Was die Apollo.io API leistet

Apollo.io beschreibt seine API als Möglichkeit, Daten programmgesteuert zu suchen, anzureichern, zu erstellen und zu verwalten. Dahinter steht eine Datenbank mit mehr als 240 Millionen Kontakten und 30 Millionen Unternehmen. Die Dokumentation unterteilt die Arbeit in drei Aufgaben:

  • Integrationen erstellen. Verbinden Sie Ihr Produkt mit Apollo.io-Daten, erstellen Sie Konten und steuern Sie Sequenzen.
  • Daten anreichern. Ergänzen Sie Personen- und Unternehmensdatensätze einzeln oder in großen Mengen.
  • Personen finden. Suchen Sie nach Jobtitel, Standort, Seniorität und vielen weiteren Filtern.

Ihr Tarif bestimmt, welche Endpunkte Sie nutzen können, wie schnell Sie sie aufrufen dürfen und was jeder Aufruf kostet. Apollo.io erklärt außerdem, dass seine Tools nichts können, was Sie nicht auch in der App erledigen könnten. Wenn Ihrem Konto eine Funktion fehlt, wird die API sie nicht freischalten.

Welche Tarife beinhalten die API?

Die FAQ für Entwickler besagt, dass jede Tarifstufe grundlegenden Zugriff bietet. Erweiterte Funktionen sind nur in bestimmten Tarifstufen verfügbar. Unser Apollo.io-Preisleitfaden führt die Tarifstufen und ihre Guthabenkontingente auf.

Für kostenlose Konten gilt eine Einschränkung. Einige Endpunkte für die Personensuche, Anreicherung und Datensätze erfordern ein Konto, das mit einer geschäftlichen E-Mail-Adresse registriert wurde. Auf jeder betroffenen Endpunktseite wird darauf hingewiesen. Kostenpflichtige Konten sind davon nicht betroffen.

Für wen ist die Apollo.io API gedacht?

Sie wird hauptsächlich von drei Gruppen genutzt:

  1. Vertriebs- und RevOps-Teams, die angereicherte Daten in ein CRM oder Data Warehouse übertragen möchten.
  2. Entwickler in Softwareunternehmen, die Apollo.io-Daten in ihr eigenes Produkt integrieren.
  3. Partner, die Marketplace-Integrationen erstellen. Sie melden sich statt mit einem Schlüssel über OAuth 2.0 an.

Apollo.io ergänzt einen Lizenzhinweis. Das Teilen, Offenlegen oder Weiterverkaufen der Daten an Personen, die keine Apollo.io-Nutzer sind, erfordert einen individuellen Vertrag.

Apollo.io API-Dokumentation: Wo alles zu finden ist

Die Apollo.io API-Dokumentation befindet sich unter docs.apollo.io. Die obere Leiste ist in „Erste Schritte“, API, MCP, CLI, OpenAPI und Änderungsprotokoll unterteilt. Der API-Bereich enthält eine Seite für jeden Endpunkt.

Apollo.io API-Dokumentationsseite für die People API-Suche mit dem Anmeldeinformationsbereich und Beispielantwort

Screenshot: die Seite zur People API-Suche in der Apollo.io-Entwicklerdokumentation aus Apollo.ios Anleitung zum Testen eines Schlüssels.

Jede Endpunktseite folgt demselben Muster. Ein Kasten mit den „wichtigsten Informationen zum Endpunkt“ oben zeigt den wichtigsten Zugriffspfad, den OAuth-Bereich, wer ihn verwenden kann und wie viele Credits er kostet. Darunter folgen die Parameter. Rechts finden Sie eine Sprachauswahl, ein Feld für Anmeldeinformationen, eine cURL-Anfrage und eine Beispielantwort.

Sie können direkt auf der Seite live testen. Fügen Sie Ihren Schlüssel in das Header-Feld ein, füllen Sie die erforderlichen Parameter aus und klicken Sie auf „Ausprobieren“. Ein 200 bedeutet, dass der Aufruf funktioniert hat. Auch ohne Schlüssel können Sie jede Beispielantwort öffnen, um das Schema zu sehen.

Die OpenAPI-Datei

Apollo.io veröffentlicht die gesamte API als eine OpenAPI-3-Datei unter https://docs.apollo.io/openapi/apollo-rest-api.json. Sie wird bei jeder Änderung der Dokumentation neu erstellt. Laden Sie sie in Postman oder einen anderen API-Client, und jeder Endpunkt wird zusammen mit seinen Parametern übernommen. Sie können sie auch an einen Codegenerator übergeben, um einen typisierten Client in Ihrer eigenen Sprache zu erstellen.

Behalten Sie den Schlüssel in Postman in der vorkonfigurierten API-Key-Autorisierung und legen Sie eine apiKey-Variable fest. Die Dokumentation warnt davor, den Schlüssel als Bearer-Token einzufügen, da dies einen 401 zurückgibt. Bearer-Tokens sind für OAuth-Partner vorgesehen.

Ein maschinenlesbarer Index

Die Dokumentation veröffentlicht außerdem einen Klartextindex unter docs.apollo.io/llms.txt. Er listet jede Seite als Markdown-Link auf. KI-Coding-Tools können ihn lesen, um die richtige Endpunktseite zu finden, ohne die Website zu durchsuchen.

So erhalten Sie einen Apollo.io API-Schlüssel

Ein Apollo.io API-Schlüssel wird innerhalb der App erstellt, nicht auf der Dokumentationsseite. Der Pfad lautet „Settings“, dann „Integrations“ und anschließend „API Keys“. Dies können nur Administratoren sowie Benutzer tun, deren Berechtigungsprofil Schlüssel abdeckt.

So erhalten Sie Schritt für Schritt Zugriff auf einen Apollo.io API-Schlüssel:

  1. Öffnen Sie Apollo.io und klicken Sie auf Settings > Integrations > API Keys. Das Entwickler-Dashboard unter developer.apollo.io zeigt dieselbe Seite.
  2. Klicken Sie auf Create new key.
  3. Geben Sie einen Namen und eine Beschreibung ein.
  4. Aktivieren Sie jeden Endpunkt, den der Schlüssel aufrufen darf, oder schalten Sie Set as master key ein.
  5. Klicken Sie auf Create API key.
  6. Klicken Sie auf Copy und fügen Sie den Schlüssel an einem sicheren Ort ein.

Dialog zum Erstellen eines neuen Apollo.io API-Schlüssels mit Name, Beschreibung, API-Auswahl und Umschalter für den Master-Schlüssel

Screenshot: der Dialog zum Erstellen eines neuen API-Schlüssels im Apollo.io-Entwicklerportal aus der Apollo.io-Dokumentation.

Apollo.io zeigt den vollständigen Schlüssel am Ende an. Kopieren Sie ihn dann. Wenn Sie ihn verlieren, generieren Sie ihn im Dashboard neu.

Wo Sie einen vorhandenen Apollo.io API-Schlüssel finden

Wenn Sie einen zuvor erstellten Apollo.io API-Schlüssel finden müssen, kehren Sie zum Entwickler-Dashboard zurück und öffnen Sie „API keys“. Jeder von Ihnen erstellte Schlüssel befindet sich in dieser Liste. Die Seitenleiste des Portals enthält außerdem die Seiten „Quick Start“, „Usage“ und „Subscription“. In derselben Seitenleiste gibt es für Partner eine Seite zur OAuth-Registrierung.

Apollo.io ermöglicht Ihnen mit einem vorhandenen Schlüssel zwei Aktionen. Regenerate erstellt ein neues Secret und kopiert es. Delete entfernt den Schlüssel dauerhaft. Behandeln Sie beide Aktionen als Einbahnstraßen, denn jedes Skript, das den alten Schlüssel verwendet hat, funktioniert danach nicht mehr.

Master-Schlüssel oder eingeschränkter Schlüssel?

Diese Entscheidung ist wichtiger als jede andere, wenn Sie einen Apollo.io API-Schlüssel erstellen.

TypWorauf er zugreiftWofür Sie ihn verwenden
Eingeschränkter Schlüssel (Standard)Nur die von Ihnen aktivierten EndpunkteDie meisten Integrationen
Master-SchlüsselJeder EndpunktEndpunkte, die ihn erfordern, sowie der MCP-Server über einen Schlüssel

Ein eingeschränkter Schlüssel, der einen nicht aktivierten Endpunkt aufruft, erhält einen 403. Einige Endpunkte, etwa die Liste der Workspace-Benutzer, funktionieren nur mit einem Master-Schlüssel. Apollo.io weist Sie an, einen Master-Schlüssel wie ein Passwort zu behandeln. Er kann jede API-Aktion ausführen, die Ihr Konto erlaubt.

Als welcher Benutzer agiert ein Schlüssel?

Ein Apollo.io API-Schlüssel identifiziert Ihren Workspace, nicht eine Person. Apollo.io kann nicht feststellen, welcher Kollege ihn verwendet hat. Jede Anfrage agiert als der am längsten aktive Administrator des Workspace, und dieser Benutzer ist Eigentümer aller durch den Aufruf erstellten Elemente. Um herauszufinden, wer das ist, rufen Sie den Endpunkt zum Abrufen des Profils des aktuellen Benutzers auf; dieser verbraucht keine Credits.

Das überrascht Teams, die einen Schlüssel über einen Login mit eingeschränkten Berechtigungen erstellen. Der Schlüssel schränkt nicht ein, worauf der Code zugreifen kann.

Apollo.io API-Zustandsprüfung

Der schnellste Weg, einen neuen Schlüssel zu testen, ist ein einzelner Health-Check-Aufruf. Dabei handelt es sich um eine GET-Anfrage an auth/health, und es werden keine Credits verbraucht.

curl --request GET \
  --url 'https://api.apollo.io/api/v1/auth/health' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'

Wenn alles richtig eingerichtet ist, gibt die Apollo.io API-Zustandsprüfung zwei Werte zurück:

{ "healthy": true, "is_logged_in": true }

Wenn beide Werte true sind, funktioniert der Schlüssel. Wenn einer davon false ist, suchen Sie nach überflüssigen Leerzeichen oder Zeilenumbrüchen nach dem Schlüssel und senden Sie die Anfrage anschließend erneut. Setzen Sie in Postman den Autorisierungstyp auf „No Auth“ und fügen Sie den Schlüssel stattdessen als Header hinzu.

Ist die Apollo.io API ausgefallen?

Personen, die nach diesem Begriff suchen, möchten manchmal eine andere Antwort. Sie wollen wissen, ob der Dienst selbst ausgefallen ist. Der Aufruf von auth/health testet Ihren Schlüssel und eine Anmeldung, nicht die gesamte Plattform. Bei Ausfällen betreibt Apollo.io eine Statusseite unter status.apollo.io.

Eine 429-Antwort mit dem Code USAGE.RATE_LIMIT.PLATFORM_RATE_LIMIT bedeutet, dass die Plattform den Datenverkehr aufgrund einer allgemein hohen Auslastung ablehnt. Das hat nichts mit Ihrem Tarif zu tun. Laut Dokumentation sollten Sie 60 Sekunden warten und es erneut versuchen.

Hauptgruppen der Endpunkte in der Apollo.io API

Die Referenz führt Dutzende von Endpunkten auf. Sie fallen in sechs Gruppen.

GruppeAbdeckungBeispiele
Suchen und anreichernPersonen und Unternehmen finden, Datensätze vervollständigenSuche über die People API, Personenanreicherung, Organisationssuche
Datensätze verwaltenKonten, Kontakte, Deals, Listen, NotizenKontakt erstellen, Konten gesammelt aktualisieren, Datensätze zu einer Liste hinzufügen
Mit Interessenten interagierenSequenzen, E-Mails, Anrufe, Aufgaben, UnterhaltungenKontakte zu einer Sequenz hinzufügen, E-Mail sofort senden
KI-AssistentEine Aufgabe an den integrierten Assistenten übergebenAssistentenaufgabe ausführen, Assistentenaufgabe abfragen
ArbeitsbereichBenutzer, Postfächer, benutzerdefinierte FelderBenutzerliste abrufen, benutzerdefiniertes Feld erstellen
Analysen und NutzungBerichte, Nutzungsstatistiken, Webhook-ErgebnisseAnalysebericht abfragen, Nutzungsstatistiken anzeigen

Die Verwaltung von Datensätzen, Sequenzen und die meisten Arbeitsbereich-Aufrufe verwenden 0 Credits. Die Kosten entstehen bei der Suche und Anreicherung, die wir weiter unten behandeln.

Suche ist keine Anreicherung

Diese Trennung führt neue Benutzer häufig in die Irre. Durch die Suche in der Personendatenbank von Apollo.io werden Profile zurückgegeben. Die Ergebnisse enthalten keine E-Mail-Adressen oder Telefonnummern. Um diese zu erhalten, benötigen Sie einen zweiten Aufruf an einen Anreicherungsendpunkt. Die Suche nach Ihren eigenen gespeicherten Kontakten erfolgt über eine andere Gruppe von Endpunkten, die zudem anders eingeschränkt sind.

Dokumentation zur Apollo.io API-Personensuche

Die Dokumentation zur Apollo.io API-Personensuche umfasst einen POST-Endpunkt: /mixed_people/api_search. Apollo.io bezeichnet Personen als neue Interessenten, die Sie noch nicht als Kontakte gespeichert haben.

curl --request POST \
  --url 'https://api.apollo.io/api/v1/mixed_people/api_search?person_titles[]=sales%20director&person_locations[]=california&per_page=10' \
  --header 'accept: application/json' \
  --header 'x-api-key: YOUR_API_KEY'

Die Parameter werden in der Abfragezeichenfolge angegeben. Sie können die Suche eingrenzen nach:

  • Jobtiteln: person_titles[], zusätzlich person_not_titles[], um bestimmte Titel auszuschließen.
  • Hierarchieebene: person_seniorities[].
  • Standort: person_locations[] für den Wohnort der Personen, organization_locations[] für den Hauptsitz des Unternehmens.
  • Unternehmensgröße und Umsatz: organization_num_employees_ranges[] und revenue_range[min].
  • Technologie: Filter für mehr als 1.500 Technologien, die ein Unternehmen verwendet.
  • Einstellungssignalen: q_organization_job_titles[] und der Anzahl der Stellenausschreibungen.
  • E-Mail-Status: contact_email_status[] mit Werten wie verifiziert, nicht verifiziert, wahrscheinlich kontaktierbar und nicht verfügbar.
  • Seitennavigation: page und per_page.

Der Endpunkt für die Personensuche verwendet 0 Credits. Pro Seite werden bis zu 100 Datensätze zurückgegeben. Außerdem gibt es ein Anzeigelimit von 50.000 Datensätzen, also 500 Seiten. Fügen Sie Filter hinzu, um darunter zu bleiben.

Was die Apollo.io API-Personensuche zurückgibt

Eine Antwort der Personensuche enthält eine Anzahl total_entries und eine Liste people. E-Mail-Adressen und Telefonnummern werden ausgelassen. Um Kontaktdaten abzurufen, übergeben Sie jedes Ergebnis an den Anreicherungsendpunkt.

Für die Suche gelten eigene Limits, die im folgenden Abschnitt zu den Rate-Limits aufgeführt sind.

Wenn Sie nach contact_email_status[] suchen, denken Sie daran, woher der Wert stammt. Er beschreibt den eigenen Datensatz von Apollo.io für die Adresse. Es handelt sich nicht um einen Live-Test des Postfachs.

So lesen Sie die Dokumentation zur Apollo.io API-Personensuche schneller

Beginnen Sie mit dem Kasten zu den wichtigsten Endpunktinformationen. Prüfen Sie die Zeilen zur Credit-Nutzung und zum Zugriff über ein kostenloses Konto. Überfliegen Sie anschließend die Parameterliste nach den benötigten Filtern. Führen Sie schließlich eine kleine Anfrage mit per_page=10 aus, bevor Sie Tausende von Ergebnissen seitenweise abrufen.

Personen mit der Apollo.io API anreichern

Bei der Anreicherung werden Datensätze aktualisiert, die Sie bereits besitzen. Apollo.io bietet zwei Endpunkte für Personen:

  • Personenanreicherung: POST /people/match, eine Person pro Aufruf.
  • Personenanreicherung im Bulk: bis zu 10 Personen in einer einzigen Anfrage.

Apollo.io benötigt genügend Details, um die richtige Person zuzuordnen. Eine E-Mail-Adresse allein reicht aus. Ebenso ein Name zusammen mit einer Unternehmensdomain. Der Endpunkt akzeptiert außerdem eine LinkedIn-URL, einen Organisationsnamen oder eine Apollo.io-Personen-ID. Wenn Sie nur einen Namen senden, erhalten Sie möglicherweise eine 200-Antwort, die nichts angereichert hat.

Prüfen Sie in jeder Antwort match_confidence. Der Wert lautet high, medium, low oder none.

curl --request POST \
  --url 'https://api.apollo.io/api/v1/people/match?email=mark%40sumware.com' \
  --header 'accept: application/json' \
  --header 'x-api-key: YOUR_API_KEY'

Die Antwort enthält den Titel der Person, den Beschäftigungsverlauf, Unternehmensdaten und einen email_status, etwa verified. Dieser Status ist Apollos.io eigene Kennzeichnung. Unsere spätere Prüfung in diesem Leitfaden testet die Adresse selbst.

Telefonnummern, private Adressen und Waterfall

Drei optionale Schalter ändern, welche Daten Sie zurückerhalten:

  • reveal_personal_emails=true fügt private Adressen hinzu. Apollo.io gibt sie für Personen in GDPR-Regionen nicht heraus.
  • reveal_phone_number=true fügt jede Telefonnummer hinzu, einschließlich Mobilfunknummern. Dafür ist eine webhook_url erforderlich. Apollo.io prüft die Nummern asynchron und sendet sie an Ihren Webhook, was mehrere Minuten dauern kann.
  • run_waterfall_email und run_waterfall_phone durchsuchen zunächst Apollo.io und anschließend Ihre konfigurierten externen Datenanbieter. Die endgültigen Ergebnisse treffen ebenfalls per Webhook ein.

Doppelte Zahlung vermeiden

Wenn Sie dieselbe Person später erneut anreichern, geben Sie möglicherweise erneut Credits für dieselben Daten aus. Apollo.io empfiehlt, angereicherte Personen in Kontakte umzuwandeln. Ein Kontakt gehört zu Ihrer Organisation, sodass seine Daten weiterhin erreichbar bleiben.

Apollo.io API-Ratenlimits

Ratenlimits gelten pro Team, nicht pro Schlüssel oder Benutzer. Sie gelten außerdem pro Endpunkt und laufen gleichzeitig in drei Zeitfenstern: einer Minute, einer Stunde und einem Tag. Sie müssen jedes anwendbare Zeitfenster einhalten.

LimitFreeBasicProfessionalOrganization
Anfragen pro Minute50200200200
Anfragen pro Stunde200400400600
Anfragen pro Tag6002.0002.0006.000

Diese Tabelle zeigt die Standardwerte. Such- und Enrichment-Endpunkte haben in kostenpflichtigen Tarifen höhere Limits:

  • Enrichment-Endpunkte: 1.000 Anfragen pro Minute in kostenpflichtigen Tarifen, ohne stündliches oder tägliches Limit. Kostenlose Konten erhalten 50 pro Minute und 20 bei Bulk-Endpunkten.
  • Suchendpunkte: 200 pro Minute, 6.000 pro Stunde und 50.000 pro Tag in kostenpflichtigen Tarifen.
  • Niedrigere Limits: Der Bericht zur Abfrageanalyse erlaubt 5 Anfragen pro Stunde.

In der Apollo.io-Dokumentation wird darauf hingewiesen, dass das hohe Enrichment-Limit keine Erlaubnis ist, unbegrenzt viele Aufrufe zu senden. Ihr Guthaben steuert weiterhin, wie viele Daten Sie anreichern können.

Apollo.io API-Entwicklerportal mit der Usage-Seite, die tägliche und stündliche Ratenlimits für Enrichment anzeigt

Screenshot: die Usage-Seite des Apollo.io-Entwicklerportals mit täglichen und stündlichen Limits für die Enrichment-Endpunkte aus der Apollo.io-Dokumentation.

Antwort-Header und der 429-Fehler

Apollo.io fügt authentifizierten Aufrufen Header hinzu. Sie zeigen das Limit, die bisherige Nutzung und die verbleibenden Anfragen für jedes Zeitfenster:

  • x-rate-limit-minute, x-rate-limit-hourly und x-rate-limit-24-hour
  • x-minute-usage, x-hourly-usage und x-24-hour-usage
  • x-minute-requests-left, x-hourly-requests-left und x-24-hour-requests-left
  • retry-after, das zusammen mit einem 429 gesendet wird, gibt die Sekunden bis zum Zurücksetzen des Zeitfensters an

Wenn Sie ein Limit überschreiten, erhalten Sie einen 429. Lesen Sie retry-after und warten Sie. Das Zeitfenster beginnt mit Ihrer ersten Anfrage und ist nicht an die Uhrzeit gebunden. Der Fehler-Body enthält ein error_details-Objekt. Sein code lautet für Ihr eigenes Limit USAGE.RATE_LIMIT.API_RATE_LIMIT_EXCEEDED.

Um die aktuellen Limits Ihres Teams im Code auszulesen, rufen Sie den API-Endpunkt zum Anzeigen der Nutzungsstatistiken auf. Ein einzelner Aufruf kann bis zu 74 Endpunktpfade abdecken, und dafür werden keine Credits berechnet.

Apollo.io API-Credits: Was kostet Geld?

Viele Aufrufe kosten nichts. Apollo.io gibt an, dass Endpunkte, die Datensätze erstellen, aktualisieren, auflisten oder verwalten, 0 Credits verbrauchen. Credits werden für Enrichment-, Organisationssuch-, Nachrichtensuch- und AI-Insight-Endpunkte verwendet – und nur, wenn sie qualifizierende Daten zurückgeben.

EndpunktCredit-Kosten
Personen-Enrichment1 bis 9 pro Person: 1 für demografische Daten oder E-Mail, plus 8, wenn eine Mobiltelefonnummer zurückgegeben wird
Bulk-Personen-EnrichmentGleiche Logik, bis zu 10 Personen pro Anfrage
Organisations-Enrichment1 pro Organisation
Organisationssuche1 pro Seite, bis zu 100 Ergebnisse pro Seite
Suche nach Nachrichtenartikeln1 pro Seite, bis zu 25 Ergebnisse pro Seite
Stellenausschreibungen einer Organisation1 pro Seite
Vollständige Informationen zu einer Person abrufen1 pro Person
AssistentenaufgabeVariabel, abhängig von den Aktionen des Assistenten

Die Personensuche ist kostenlos. Daher ist es sinnvoll, zuerst zu suchen und nur die besten Treffer anzureichern. Beim Durchblättern eines Credits verbrauchenden Endpunkts werden für jede Seite Credits ausgegeben. Apollo.io empfiehlt einen kleinen Testlauf und einen Blick auf Ihre Nutzung, bevor Sie skalieren.

Waterfall-Enrichment kann mehr kosten. Beim E-Mail-Waterfall werden typischerweise 1 bis 4 Credits verwendet, manche Konfigurationen nutzen jedoch 20 oder mehr. Beim Telefon-Waterfall werden typischerweise 8 bis 25 Credits verwendet, manche nutzen 45 oder mehr.

Um die Ausgaben zu verfolgen, öffnen Sie in der App Einstellungen > Abrechnung und Credits > Credit-Nutzung. Die Registerkarte „Nutzung“ im Entwickler-Dashboard zeigt die im aktuellen Abrechnungszeitraum verwendeten Telefon- und E-Mail-Credits. Legacy-Tarife können abweichen. Prüfen Sie daher die Seite „Über Credits“ für Ihren Workspace.

Fehler und Statuscodes

Die meisten API-Endpunkte von Apollo.io verwenden eine kurze Liste von Statuscodes:

CodeBedeutungHäufige Ursache
401Nicht autorisiertSchlüssel fehlt, ist ungültig oder stammt von einem inaktiven Konto
403VerbotenDer Tarif bietet keinen API-Zugriff oder ein eingeschränkter Schlüssel hat keinen Zugriff auf den Endpunkt
404Nicht gefundenDer Datensatz existiert nicht oder ist für Sie nicht sichtbar
422Nicht verarbeitbarUngültiger oder fehlender Parameter
429Zu viele AnfragenSie haben ein Ratenlimit überschritten
500ServerfehlerEin Fehler auf Seiten von Apollo.io, daher erneut versuchen

Apollo.io stellt Fehler schrittweise auf ein einheitliches Format um. Wenn ein Endpunkt umgestellt wurde, enthält die Antwort ein error_details-Objekt mit einem stabilen code, einer message, suggestions und context. Richten Sie Ihren Code nach error_details.code aus, niemals nach dem Nachrichtentext. Apollo.io plant, die alten Fehlerfelder auf der obersten Ebene am 16. Februar 2027 zu entfernen. Bauen Sie daher jetzt auf dem neuen Objekt auf.

Der Apollo.io MCP-Server

MCP ist ein Standard, mit dem AI-Tools externe Dienste aufrufen können. Der Apollo.io MCP-Server verbindet Claude, ChatGPT und ähnliche Clients mit deinem Apollo.io-Konto. Anschließend kannst du in natürlicher Sprache fragen: Finde Marketing-Verantwortliche auf VP-Ebene bei SaaS-Unternehmen oder reicher diese zehn potenziellen Kunden an.

Apollo.io MCP-Dokumentationsseite mit den drei Verbindungsmöglichkeiten: AI-Konnektoren, Coding-Plug-ins und ein eigenständiger MCP-Server

Screenshot: die Apollo.io-MCP-Seite in der Entwicklerdokumentation, Oktober 2026.

Drei Verbindungsmöglichkeiten

RouteFunktionsweise
AI-KonnektorenIntegrierte Integrationen in ChatGPT, Claude, Perplexity, Replit und Cursor. Keine Servereinrichtung.
Coding-Plug-insPlug-ins des jeweiligen Anbieters für Tools wie Codex.
Eigenständiger MCP-ServerVerweise jeden MCP-Client, der Remote-Server unterstützt, auf eine URL.

Die Einstellungen für den eigenständigen Server sind kurz:

EinstellungWert
Endpunkthttps://mcp.apollo.io/mcp
TransportStreamable HTTP
AnmeldungOAuth 2.0
Lokale InstallationNicht erforderlich
API-SchlüsselNicht erforderlich, sofern der Client über einen Browser verfügt

In Claude Code fügt ein Befehl den Server hinzu. Führe ihn aus, gib anschließend /mcp ein und schließe die OAuth-Anmeldung ab:

claude mcp add --transport http apollo https://mcp.apollo.io/mcp

Wenn du mehrere Workspaces verwaltest, füge dieselbe URL unter einem anderen Namen für jeden Workspace hinzu. Melde dich bei jeder Verbindung separat an.

Server ohne Browser

OAuth benötigt ein Browserfenster. Ein Cron-Job oder eine CI-Pipeline hat keines. Für diese Fälle akzeptiert der Server einen als X-Api-Key gesendeten API-Schlüssel. Der Schlüssel muss ein Hauptschlüssel sein. Ein eingeschränkter Schlüssel führt zu einem 403 mit dem Code API_INACCESSIBLE, da der MCP-Server nicht zu den Endpunkten gehört, die du auswählen kannst.

Bewahre diesen Schlüssel wie jedes Produktionsgeheimnis auf. Er fungiert als Administrator des Workspaces und verbraucht Workspace-Credits. Neue MCP-Tools erhalten sofort Zugriff auf einen Hauptschlüssel, aber dein Client verwendet möglicherweise weiterhin eine zwischengespeicherte Tool-Liste. Stelle die Verbindung wieder her und rufe tools/list auf, um sie zu aktualisieren.

Was der Apollo.io MCP-Server kann

Die Tool-Liste umfasst Suche und Prospecting, die Anreicherung von Personen und Unternehmen, Kontakte, Listen, Sequenzen, einzelne E-Mails, Aufgaben, Prüfungen von E-Mail-Domains und Analysen. Anreicherungsaktionen verbrauchen Credits. Die meisten anderen Aktionen verbrauchen keine. Apollo.io weist darauf hin, dass die Personensuche keine E-Mail-Adressen oder Telefonnummern zurückgibt. Dein Assistent muss daher für diese Daten einen Anreicherungsschritt ausführen.

Praktische Einschränkungen aus der Dokumentation:

  • Für die Verbindung fallen keine zusätzlichen Gebühren an. Dein Tarif, deine Berechtigungen und deine Credits gelten.
  • Destruktive Aktionen wie das massenhafte Löschen werden nicht unterstützt.
  • Der Server folgt deinen Berechtigungen. Bei OAuth agiert er als der angemeldete Benutzer.
  • Apollo.io MCP verwendet separate Rate-Limits und gibt die Rate-Limit-Header nicht zurück.
  • Apollo.io untersagt das Training von AI-Modellen mit seinen MCP-Daten. Deaktiviere das Training daher zuerst in deinem AI-Client.

Apollo.io empfiehlt, kreditverbrauchende Aktionen auf „Genehmigung erforderlich“ zu setzen, damit ein redseliger Assistent nicht eigenständig Credits aufbrauchen kann.

Weitere Möglichkeiten zur Nutzung der Apollo.io API

  • Apollo.io CLI. Ein Befehlszeilentool mit Zugriff auf die vollständige API. Installieren Sie es mit Homebrew, einer vorkompilierten Binärdatei oder aus dem Quellcode. Es verwendet OAuth und benötigt daher keinen Schlüssel.
  • OAuth 2.0. Partner verwenden es, um die API für gemeinsame Kunden aufzurufen, und die Dokumentation listet eine Marktplatzanwendung für fertige Integrationen auf.
  • Chrome-Erweiterung. Wenn Sie lieber klicken als programmieren, lesen Sie unseren Leitfaden zur Apollo Chrome-Erweiterung.

Adressen aus der Apollo.io API vor dem Versand prüfen

Egal, für welchen Weg Sie sich entscheiden, die Daten haben eine Schwachstelle. Sie stammen aus einer Datenbank. Menschen wechseln ihre Arbeitsstelle, und Unternehmen ziehen auf neue Domains um. Das Feld email_status ist die eigene Einstufung von Apollo.io, kein aktueller Test. Eine kalte E-Mail an eine nicht mehr aktive Adresse erzeugt einen Bounce, und Bounces schaden Ihrer Absenderreputation.

Fügen Sie daher eine Prüfung zwischen Anreicherung und Ihrer Sequenz ein. BillionVerify testet jede Adresse, ohne eine Nachricht zu senden. Es prüft Syntax, Domain, MX-Einträge und auf Wunsch das Postfach über SMTP. Das System markiert Wegwerf- und Rollenadressen. Catch-all wird als eigenes Ergebnis gemeldet, statt als gültig zu zählen. Unbekannte Ergebnisse kosten nichts, und eine erneute Prüfung innerhalb von 24 Stunden ist kostenlos. Bevor Sie die API einbinden, können Sie manuell prüfen, ob eine E-Mail-Adresse existiert – mit dem kostenlosen Web-Checker.

Ergebnisse der E-Mail-Verifizierungs-API von BillionVerify mit Status-, Zustellbarkeits- und Grundfeldern

BillionVerify liefert für jede Adresse einen Status, ein Zustellbarkeitskennzeichen und einen Grund zurück.

Eine kleine Pipeline

Eine einfache Pipeline besteht aus vier Schritten:

  1. Führen Sie über die API eine kostenlose Personensuche durch.
  2. Reichern Sie nur die besten Treffer an.
  3. Senden Sie jede Adresse an die BillionVerify REST API.
  4. Fügen Sie nur zustellbare Adressen zu Ihrer Sequenz hinzu.

Der BillionVerify-Aufruf ist ein POST. Senden Sie den Schlüssel im Header BV-API-KEY und setzen Sie check_smtp auf true, um ein Live-Postfach zu testen:

curl -X POST https://api.billionverify.com/v1/verify/single \
  -H "BV-API-KEY: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email":"mark@sumware.com","check_smtp":true}'

Die Antwort enthält status, is_deliverable, is_catchall, is_role, is_disposable und einen reason. Für bis zu 50 Adressen in einem Aufruf verwenden Sie die Bulk-Route. Für einen vollständigen Export laden Sie eine CSV-, TXT- oder XLSX-Datei hoch und laden die Ergebnisse später herunter. Die vollständige Referenz finden Sie in der BillionVerify-Dokumentation.

Über den AI-Client verifizieren

Wenn Sie die MCP-Einrichtung von Apollo.io bereits mit einem AI-Client verbinden, fügen Sie daneben den gehosteten MCP-Server von BillionVerify hinzu. Er befindet sich unter https://mcp.billionverify.com/mcp und verwendet OAuth zur Anmeldung. Ihr Assistent kann dann einen Interessenten über Apollo.io anreichern und die Adresse in derselben Unterhaltung prüfen. Teilen Sie ihm Ihre Richtlinien mit, etwa welche Status akzeptiert werden sollen und wie mit Catch-all umzugehen ist.

Weitere Prüfungen

  • Unsere Seite zur Apollo-E-Mail-Verifizierung beschreibt den Export-Workflow.
  • Ein verdächtiger Kontakt kann unsere kostenlose Rückwärtssuche für E-Mail-Adressen durchlaufen. Sie zeigt, was öffentlich mit einer Adresse verknüpft ist.
  • Auch über den Webhook zurückgegebene Telefonnummern sollten getestet werden. Unser kostenloser Telefonnummern-Validator zeigt, ob eine Nummer für ihr Land gültig ist und welchem Leitungstyp sie entspricht.

BillionVerify gewährt jeden Tag, an dem Sie Ihr Konto nutzen, 20 kostenlose Credits – bis zu 600 pro Monat. Sie verfallen nie, und Sie benötigen keine Kreditkarte.

Tipps für die Entwicklung mit der Apollo.io API

  • Beginne für jede Integration mit einem eigenen, begrenzten Schlüssel. Wenn einer davon kompromittiert wird, musst du nur diesen widerrufen.
  • Führe zuerst den Gesundheitscheck durch. So schließt du Schlüsselprobleme aus, bevor du den Code debugst.
  • Lies das Feld mit den wichtigsten Endpoint-Informationen. Die Dokumentation zur Personensuche mit der Apollo.io API zeigt die Credit-Kosten direkt an.
  • Suche, bevor du Daten anreicherst. Die Suche ist kostenlos, die Datenanreicherung jedoch nicht.
  • Teste mit per_page=10. Kleine Durchläufe zeigen die Credit-Kosten, bevor sie sich summieren.
  • Beachte retry-after. Einen begrenzten Endpoint wiederholt anzufragen, verlängert die Wartezeit nur.
  • Lies error_details.code. Der Nachrichtentext kann sich ohne Vorankündigung ändern.
  • Verifiziere vor dem Versand. Ein für eine unzustellbare Adresse ausgegebener Credit ist doppelt verschwendet.

FAQs

Verfügt Apollo.io über eine API?

Ja, Apollo.io verfügt über eine REST API. Damit können Sie Personen und Unternehmen suchen, Kontakte anreichern sowie Accounts, Deals und Sequenzen aktualisieren. Der grundlegende Zugriff ist in jeder Tarifstufe enthalten. Ihr Tarif legt fest, welche Endpunkte Sie aufrufen können, wie schnell dies möglich ist und was jeder Aufruf kostet.

Wie erhalte ich einen Apollo.io API-Schlüssel?

Einen Apollo.io-Schlüssel erhalten Sie im Bereich „Integrationen“ der Einstellungen: Öffnen Sie „API-Schlüssel“ und wählen Sie „Neuen Schlüssel erstellen“. Geben Sie ihm einen Namen, aktivieren Sie die Endpunkte, die er aufrufen darf, und bestätigen Sie anschließend. Kopieren Sie das Geheimnis sofort. Ein Administrator oder ein Benutzer mit dem entsprechenden Berechtigungsprofil kann dies tun.

Wo finde ich meinen Apollo.io API-Schlüssel?

Ihre Liste der Apollo.io API-Schlüssel befindet sich auf der Seite „API-Schlüssel“, die Sie über die App oder das Entwickler-Dashboard erreichen. Das vollständige Geheimnis wird bei der Erstellung des Schlüssels angezeigt. Wenn Sie das Geheimnis verlieren, müssen Sie den Schlüssel neu generieren, wodurch ein neuer Schlüssel ausgestellt wird.

Ist die Apollo.io API kostenlos?

Apollo.io API-Aufrufe zum Erstellen, Auflisten oder Aktualisieren von Datensätzen sind kostenlos, ebenso wie die Personensuche. Für die Anreicherung und einige Suchendpunkte werden Credits berechnet, wenn sie Daten zurückgeben. Kostenlose Konten können die API innerhalb der Limits des kostenlosen Tarifs aufrufen, für einige Endpunkte ist jedoch eine geschäftliche E-Mail-Adresse erforderlich.

Wie hoch ist das Rate-Limit der Apollo.io API?

In einer kostenpflichtigen Tarifstufe erlauben die meisten Apollo.io API-Endpunkte 200 Aufrufe pro Minute, mit stündlichen und täglichen Obergrenzen, die je nach Tarif variieren. Der kostenlose Tarif erlaubt 50 Aufrufe pro Minute, 200 pro Stunde und 600 pro Tag. Die Limits gelten pro Team und pro Endpunkt; eine 429-Antwort bedeutet, dass Sie eines dieser Limits überschritten haben.

Wie teste ich den Apollo.io API-Gesundheitscheck?

Der Apollo.io-Gesundheitscheck ist eine GET-Anfrage an den Pfad auth/health, wobei der Schlüssel-Header gesetzt sein muss. Eine Antwort mit healthy: true und is_logged_in: true bedeutet, dass der Schlüssel funktioniert. Dabei werden keine Credits verbraucht.

Gibt die Personensuche der Apollo.io API E-Mail-Adressen zurück?

Nein, der Endpunkt für die Apollo.io-Personensuche gibt nur Profile ohne E-Mail-Adressen oder Telefonnummern zurück. Führen Sie für die Ergebnisse den Endpunkt zur Personenanreicherung oder zur Massenanreicherung von Personen aus, um Kontaktdaten zu erhalten. Dafür werden Credits berechnet.

Wo finde ich die Dokumentation zur Apollo.io API?

Die Dokumentation zur Apollo.io API finden Sie unter docs.apollo.io. Jeder Endpunkt verfügt über eine eigene Seite mit Parametern, einem Testbereich und einer Beispielantwort. Sie können außerdem die OpenAPI-Datei herunterladen und in Postman importieren.

Was ist der Apollo.io MCP-Server?

Der Apollo.io MCP-Server verbindet AI-Clients über das Model Context Protocol mit Ihrem Workspace. Seine URL lautet https://mcp.apollo.io/mcp; er verwendet Streamable HTTP und OAuth und erfordert keine lokale Installation. Ihr Tarif, Ihre Berechtigungen und Ihre Credits gelten weiterhin.

Welcher MCP-Server ist für Apollo.io am besten geeignet?

Apollo.io veröffentlicht einen offiziellen MCP-Server, und genau diesen beschreibt die Dokumentation. Optionen von Drittanbietern haben wir nicht getestet. Wählen Sie den offiziellen Server, wenn Sie dieselben Berechtigungen und Credit-Regeln wie in der App verwenden möchten.

Sollte ich E-Mail-Adressen verifizieren, die aus der Apollo.io API stammen?

Ja, prüfen Sie jede E-Mail-Adresse aus der Apollo.io API vor einer Kampagne. Das Feld email_status spiegelt die eigenen Datensätze von Apollo.io wider, und Personen wechseln ihre Arbeitsstellen. Eine schnelle Prüfung über die BillionVerify API entfernt nicht mehr erreichbare Adressen und schützt Ihre Absenderreputation.

Video ansehen: So validieren Sie eine Telefonnummer: kostenloser Telefonnummern-Validator

Video ansehen: So verifizieren Sie Apollo-E-Mails vor dem Versand

Leo
LeoFounder, BillionVerify
E-Mail-Verifizierungs-Einblicke

Starten Sie noch heute mit der Verifizierung

Beginnen Sie noch heute mit der Verifizierung von E-Mails mit BillionVerify. Erhalten Sie 20 kostenlose Credits an jedem Tag, an dem Sie sich einloggen, bis zu 600 pro Monat - keine Kreditkarte erforderlich. Schließen Sie sich Tausenden von Unternehmen an, die ihren E-Mail-Marketing-ROI mit präziser E-Mail-Verifizierung verbessern.

Keine Kreditkarte erforderlich · Echtzeit-API und Massenverifizierung · Unbekannte Ergebnisse sind kostenlos

0
Credits für unbekannte Ergebnisse
Echtzeit
API-Geschwindigkeit
$0.00014
Pro E-Mail
600/Monat
Für immer kostenlos