Mit der ZoomInfo API kann Ihre eigene Software die Unternehmens- und Kontaktdatensätze von ZoomInfo abfragen, vollständige Profile in ein CRM laden, Kaufsignale auslesen und KI-Recherchen durchführen. Entwickler erreichen ZoomInfo auf drei Wegen: über eine REST-Schnittstelle via HTTPS, über den ZoomInfo MCP-Server für KI-Assistenten und über einen Terminal-Client. Laut ZoomInfo teilen sich alle drei eine gemeinsame Anmeldung und ein gemeinsames Guthaben an Credits.
Dieser Leitfaden behandelt, was ZoomInfo Entwicklern bietet, wo die ZoomInfo-API-Dokumentation zu finden ist, wie die Authentifizierung funktioniert, die wichtigsten Endpunktgruppen, die API-Preise, ZoomInfo MCP und die separate Chorus API. Am Ende steht ein sicherer Weg, angereicherte E-Mail-Adressen vor einer Kampagne zu prüfen. Alle Angaben stammen aus der eigenen Dokumentation und den Preisseiten von ZoomInfo, eingesehen im Oktober 2026. Wir stehen in keiner Verbindung zu ZoomInfo. BillionVerify ist ein Dienst für E-Mail-Verifizierung, und wir schreiben über die Tools, die Vertriebslisten speisen.
Wichtige Fakten (geprüft im Oktober 2026):
- ZoomInfo dokumentiert seine aktuelle API unter docs.zoominfo.com, das zu docs.gtm.ai weiterleitet. Die ältere Enterprise API ist als „Legacy" gekennzeichnet und wird eingestellt.
- Die aktuelle API signiert Anfragen über OAuth-2.0-Apps, und jeder Aufruf geht an https://api.zoominfo.com/gtm.
- Das Finden von Datensätzen ist kostenlos. Das Anreichern eines Datensatzes kostet beim ersten Mal einen Credit, und der Datensatz bleibt bei Vertragstarifen 12 Monate lang abgedeckt.
- GTM.ai veröffentlicht Self-Service-Preise für die ZoomInfo API: kostenlose Start-Credits bei der Anmeldung, danach kostenpflichtige Aufladungen.
- ZoomInfo MCP befindet sich unter https://mcp.zoominfo.com/mcp und funktioniert mit Claude, ChatGPT, Cursor, Codex und anderen MCP-Clients.
ZoomInfo API: Die schnelle Antwort
Ja. ZoomInfo bietet eine API, und sie hat sich stark verändert. Ältere Tutorials beschreiben einen Dienst aus der Java-Ära mit Benutzername, Passwort und einem JSON Web Token. Die eigene Legacy-Dokumentation von ZoomInfo warnt inzwischen, dass dieser Dienst „in the process of being deprecated" sei, und fordert Entwickler auf, neue Projekte auf dem neuen Dienst aufzubauen.
Die heutige ZoomInfo API befindet sich hinter der GTM.ai-Entwicklerseite. Sie erstellen eine App, wählen Scopes aus, tauschen Ihre Zugangsdaten gegen ein Bearer-Token und rufen Endpunkte unter einer einzigen Basis-URL auf. Von dort aus können Sie Datensätze mit Filtern abfragen, vollständige Profile für ausgewählte Datensätze abrufen, Intent-Daten, Scoops und News für Zielkonten lesen, KI-Briefings ausführen und GTM-Studio-Zielgruppen verwalten.
Ihr Tarif bestimmt, welche Endpunkte für Sie freigeschaltet sind, und er bestimmt auch die Preise. Die Übersicht von ZoomInfo sagt es klar: „Your subscription determines which API scopes and endpoints you can access, and rate limits apply to all authenticated requests."
Was die ZoomInfo API leisten kann
Die Übersicht von ZoomInfo beschreibt drei Aufgaben für Entwickler: Integrationen aufbauen, Unternehmen und Kontakte finden und mit Webhooks auf Änderungen reagieren. Laut Dokumentation erreichen Sie mit REST-Anfragen, dem MCP-Server oder dem Terminal-Client „100M+ Unternehmen, 500M+ Fachkräfte und über 50 Echtzeit-Kauf- und Geschäftssignale".
Die Referenz gruppiert die Endpunkte in Familien. Diese Tabelle listet sie auf, jeweils mit ihrer Aufgabe in einfachen Worten.
| Familie in der Referenz | Wofür sie gedacht ist |
|---|---|
| Data V1 | Nachschlagelisten sowie Datensätze zu Unternehmen, Kontakten, Intent, News und Scoops |
| Context V1 | Account-Zusammenfassungen, Insights, ähnliche Accounts und Personen sowie Ihr eigenes GTM-Setup |
| GTM Studio V1 | Zielgruppen, Ordner, Spalten und Zeilen, mit einem Anreicherungsjob pro Zielgruppe |
| Marketing V1 | Zielgruppen-Uploads für ZoomInfo Marketing |
| Platform V1 | Exporte und Engagement-Datensätze |
| Agent V1 | ZoomInfos KI-Agenten starten und ihre Durchläufe auslesen |
| Data Quality V1 | Listen parsen, normalisieren, segmentieren und bewerten, bevor sie in ein CRM gelangen |
Data V1 ist der Kern und folgt einem Muster, das die Dokumentation auf mehreren Seiten wiederholt. Erstens liefert eine Nachschlageabfrage die exakten Werte, die Filter akzeptieren, etwa einen Branchennamen oder eine Management-Ebene. Zweitens findet eine Suche passende Datensätze. Drittens liefert eine Enrich-Anfrage das vollständige Profil für die ausgewählten Datensätze.
ZoomInfo-API-Dokumentation: Wo Sie sie lesen können
Die ZoomInfo-API-Dokumentation gibt es an zwei Orten, und diese beiden zu verwechseln ist der häufigste Fehler. Der erste ist die aktuelle Entwicklerseite mit den Tabs Get Started, Recipes, API Reference und MCP. Der zweite ist die alte Enterprise-Seite unter api-docs.zoominfo.com, die für bestehende Integrationen beibehalten wird.

Screenshot: die Legacy-Dokumentation der ZoomInfo API. Der Hinweis oben verweist neue Projekte auf die neue Seite.
Die Legacy-Seite trägt den Titel „ZoomInfo API - Legacy". Sie erklärt weiterhin die älteren Standard-Endpunkte (Search, Enrich, Lookup und Usage), die Scaling-Endpunkte (Webhooks und Bulk), den WebSights-Dienst und den Compliance-Dienst. Außerdem behandelt sie PKI sowie die Anmeldung mit Benutzername und Passwort, bei der das ausgestellte Token eine Stunde lang gültig bleibt. Eine Integration, die auf diesen Anleitungen aufbaut, kann vorerst weiterlaufen, ein neues Projekt sollte jedoch auf der aktuellen Seite beginnen. Keine der beiden Seiten nennt Preise, daher finden Sie die Preise der ZoomInfo API im Abschnitt zu den Preisen weiter unten und in Ihrem Vertrag.
Auch maschinell lässt sich die aktuelle Dokumentation gut lesen. Ihre Datei llms.txt listet jeden Artikel auf, und die Seite gibt an, dass Sie an jede Adresse .md anhängen können, um Markdown zu erhalten. Die Referenz veröffentlicht außerdem eine OpenAPI-Spezifikation, sodass Sie den Vertrag in ein Tool wie Postman importieren können. In der Referenz können Sie ein Bearer-Token einfügen und echte Aufrufe direkt auf der Seite ausprobieren.
Beim Ausprobieren von Aufrufen in der Referenz ist Vorsicht geboten. Der Dokumentationsartikel zum Testzugang warnt, dass Aufrufe mit Tokens aus dem Developer Portal „als echte Produktionsanfragen behandelt werden". Sie verbrauchen Credits und zählen auf die Limits, testen Sie daher mit kleinen Batches.
Wie die ZoomInfo-API-Authentifizierung funktioniert
Die neue ZoomInfo API verwendet OAuth 2.0. Laut Dokumentation ermöglicht OAuth einer Anwendung den Zugriff auf ZoomInfo „ohne Weitergabe von Passwörtern oder langlebigen API-Key-Zugangsdaten". Bevor Sie irgendetwas aufrufen können, erstellen Sie eine Anwendung. Enterprise-Kunden tun dies im ZoomInfo Developer Portal. Self-Serve-Nutzer erledigen es über den Tab „Developer" auf GTM.ai. Beide Wege setzen eine GTM.ai- oder Enterprise-Lizenz mit aktiviertem Zugriff voraus.
Die Erstellung dauert nur wenige Minuten. Sie geben einen Namen, ein optionales Logo und eine Beschreibung ein, wählen eine Authentifizierungsmethode, fügen bei Bedarf Redirect-URLs hinzu und wählen Scopes aus. Nachdem Sie auf „Create App" geklickt haben, stellt ZoomInfo die Zugangsdaten der App aus, eine ID und ein Secret. Die Dokumentation weist an, beides sicher zu speichern und niemals in Browser-Code offenzulegen.
Es gibt zwei App-Typen und zwei OAuth-Flows:
| App-Typ | Authorization Code Flow (PKCE) | Client Credentials Flow |
|---|---|---|
| Standard-App, für Ihr eigenes Team | Unterstützt | Unterstützt |
| Partner-App, für zugelassene Partner, die viele Kunden betreuen | Unterstützt | Nicht unterstützt |
Wählen Sie den Flow danach, wer handelt. Verwenden Sie den Authorization Code Flow mit PKCE, wenn Ihre App ZoomInfo für eine angemeldete Person aufruft. ZoomInfo verlangt die Challenge-Methode S256, und der Flow liefert ein Access-Token sowie ein Refresh-Token zurück. Verwenden Sie den Client Credentials Flow für Backend-Dienste, geplante Jobs und Synchronisierungen. Da sich keine Person anmeldet, müssen Sie einen Integrationsnutzer auswählen, und ZoomInfo ordnet jede Anfrage diesem Nutzer zu.
Die Token-Anfrage für Server-zu-Server-Aufgaben ist ein einziger POST. Basic Authentication ist die empfohlene Methode, um die Zugangsdaten zu senden.
POST https://api.zoominfo.com/gtm/oauth/v1/token Authorization: Basic <client_id:client_secret, base64> Content-Type: application/x-www-form-urlencoded grant_type=client_credentials
Die Antwort enthält einen access_token, einen expires_in-Wert in Sekunden, die Scope-Liste und einen token_type von Bearer. Im Beispiel der Dokumentation steht expires_in auf 1000, daher sollten Sie Tokens zwischenspeichern und zeitgesteuert erneuern, statt bei jedem Aufruf ein neues anzufordern. Jede weitere Anfrage sendet Authorization: Bearer <access_token>.
ZoomInfo-OAuth-Scopes
Scopes bestimmen, worauf ein Token zugreifen darf, und Sie sollten nur anfordern, was die App benötigt. Die Records-Scopes sind der Punkt, an dem die meisten Teams anfangen.
| Scope-Wert | Was er freischaltet |
|---|---|
| api:data:company | Unternehmensdatensätze und Konzernhierarchie |
| api:data:contact | Kontaktdatensätze und Organigramme |
| api:data:intent | Intent-Signale |
| api:data:news und api:data:scoops | Nachrichtenartikel und Scoops |
| api:audience:read und api:audience:manage | GTM-Studio- und Marketing-Zielgruppen lesen oder verwalten |
| api:data-quality:execute | Die Data-Quality-Prepare-Pipeline ausführen |
Ein Aufruf, der einen Scope benötigt, den Ihr Token nicht besitzt, schlägt mit einem 403 und dem Code ZI0002 fehl. ZI0003 ist etwas anderes: Es bedeutet, dass Ihr Paket den Endpunkt nicht enthält. Das erste Problem beheben Sie im Developer Portal. Für das zweite benötigen Sie Ihren ZoomInfo-Account-Manager.
Wichtigste Endpunkt-Kategorien
Die meisten Integrationen nutzen vier Arten von Endpunkten, und die Kosten unterscheiden sich zwischen ihnen. Lookup-Aufrufe und Suchanfragen verbrauchen nie Credits. Die Anreicherung schon. Diese Tabelle zeigt die Aufrufe, die zuerst wichtig sind.
| Aufruf | Funktion | Kosten |
|---|---|---|
| Lookup | Listet zulässige Filterwerte wie Branchen und Management-Ebenen auf | Kostenlos |
| Search Contacts | Findet Personen nach Rolle, Standort, Unternehmensmerkmalen und Signalen | Kostenlos |
| Search Companies | Findet Accounts nach Branche, Größe, Standort und Technologie | Kostenlos |
| Enrich Contacts | Liefert vollständige Kontaktprofile, höchstens 25 pro Anfrage | Ein Credit für jeden neuen Datensatz |
| Enrich Companies | Liefert Firmografiedaten, höchstens 25 pro Anfrage | Ein einzelner Credit, wenn der Datensatz neu ist |
| Enrich Intent | Liefert Kaufabsichtssignale für ein Unternehmen | Credits |
| Account and Contact Research | KI-Briefings, die ZoomInfo und Ihren CRM-Kontext kombinieren | KI-Credits |
Die Filterliste ist lang. Laut dem ZoomInfo-Artikel „Companies & Contacts" unterstützt die Unternehmensseite mehr als 40 Filtergruppen und die Kontaktseite mehr als 25. Unternehmensfilter decken Identität, Firmografie, Größe, Standort, Technologie, Konzernstruktur und Qualitätsmerkmale ab. Kontaktfilter decken Name, Jobtitel, Jobfunktion, Management-Ebene, Standort und einen Kontaktgenauigkeits-Score ab, den Sie als Untergrenze verwenden können.
Ein paar Konventionen helfen, bevor Sie Code schreiben. Anfragen und Antworten verwenden den JSON:API-Content-Type application/vnd.api+json. Suchanfragen blättern mit page[number] und page[size] durch die Ergebnisse. Enrich-Anfragen benötigen eine outputFields-Liste, und eine requiredFields-Liste verwirft Datensätze, denen ein Schlüsselfeld wie die E-Mail fehlt. Jedes Enrich-Ergebnis enthält einen matchStatus, zum Beispiel FULL_MATCH oder NO_MATCH, und LIMIT_EXCEEDED bedeutet, dass Ihrem Account die Credits ausgegangen sind.
Rate Limits und Durchsatz
Limits schützen den Dienst und bestimmen, wie schnell Sie eine Liste laden können. ZoomInfo koppelt die Obergrenze pro Sekunde an Ihr Paket, und dieses Paket ist Teil Ihrer API-Preise.

Screenshot: ZoomInfos Artikel zu den Limits, mit den drei Paketstufen.
| Paket | Pro Sekunde | Pro Stunde | Pro Tag |
|---|---|---|---|
| Builder | 5 Anfragen | 10.800 | 129.600 |
| Standard | 25 Anfragen | 54.000 | 648.000 |
| Scaling | 35 Anfragen | 75.600 | 907.200 |
Jede Anfrage wird gleichzeitig gegen alle drei Zeitfenster geprüft. Ist eines der Fenster leer, erhalten Sie einen 429. ZoomInfo gibt an, dass abgelehnte Anfragen kein Kontingent verbrauchen, sodass ein erneuter Versuch nach einem Treffer das verbleibende Kontingent nicht aufbraucht. Ein separater Artikel zu Credits listet außerdem Premium-Add-ons mit 30 und 35 Anfragen pro Sekunde über dem Standardwert von 25 auf.
Die Antworten enthalten Header, die zeigen, wo Sie stehen, etwa X-RateLimit-Limit-Second und X-RateLimit-Remaining-Hour. Ein 429 fügt Retry-After, einen Header für den abgelehnten Bucket und einen Reset-Zeitstempel hinzu. Die beiden älteren Header ohne Fenstersuffix sind als veraltet markiert, ihre Entfernung ist für den 01.01.2027 vorgesehen. Stellen Sie daher jeden Code um, der sie ausliest.
Die Obergrenzen gelten für Anfragen, nicht für Datensätze. Ein Suchaufruf liefert über REST bis zu 25 Datensätze, über MCP oder die CLI jedoch nur 10. Die Standard-Obergrenze bewegt also auf dem einen Weg 625 Datensätze pro Sekunde und auf dem anderen 250. Verwenden Sie bei Wiederholungsversuchen nach einem Treffer im Sekundenfenster ein kurzes exponentielles Backoff und pausieren Sie nach einem Treffer im Stunden- oder Tagesfenster bis zum Ablauf von Retry-After. Eine höhere Obergrenze ist ein Preisgespräch mit Ihrem Account-Team, denn höhere Limits gibt es nur als Add-ons oder in größeren Paketen.
ZoomInfo API-Preise und Credits
Teams fragen nach den ZoomInfo-API-Preisen häufiger als nach fast allem anderen, und die Antwort hat zwei Teile. Die Enterprise-Preise werden als jährliches Volumen über einen Account Manager angeboten, und es gibt keine veröffentlichte Preisliste. Die Self-Serve-API-Preise sind öffentlich, weil GTM.ai sie veröffentlicht.

Screenshot: GTM.ai-Preise mit den beiden Credit-Schiebereglern.
Auf der GTM.ai-Preisseite steht, dass der Plattformzugang immer inbegriffen ist: MCP-Zugang, REST-Zugang und CLI-Zugang, mit kostenlosen Abfragen, Suchen und Find-similar-Aufrufen. Die kostenlose Stufe ist auf fünf Anfragen pro Sekunde und fünf Apps begrenzt. Ein neues Konto erhält ohne Kreditkarte jeweils 1.000 Credits jeder Art. Danach gilt Pay-as-you-go mit Aufladungen ab 20 $, ohne Vertrag und ohne Seat-Gebühren.
Es gibt zwei Arten von Credits:
- Daten-Credits bezahlen die Anreicherung. Ein Credit deckt einen einzelnen angereicherten oder exportierten Unternehmens-, Kontakt- oder Intent-Datensatz ab. Der Schieberegler zeigte bei der Standardeinstellung von 5.000 Credits 0,38 $ pro Credit an, aufgeführt mit 1.900 $ vor einem zeitlich begrenzten Rabatt von 70 % auf den ersten Kauf.
- KI-Credits bezahlen Recherchen und andere KI-Aktionen. Die Seite nennt pauschal 0,05 $ pro Stück, und 2.000 davon kosten 100 $, was nach ihrer Angabe etwa 200 Recherche-Aufrufen zu Konten oder Kontakten entspricht.
Dasselbe Preismodell gilt für jede Oberfläche. REST-Anfragen, die CLI und ZoomInfo MCP greifen alle auf ein gemeinsames Credit-Guthaben zu, und die Suche bleibt überall kostenlos. Die Preise für den Data-Quality-Service folgen derselben Idee: Das Parsen, Validieren und Normalisieren einer E-Mail-Adresse kostet nichts, während Segment-Läufe, Score-Läufe, Adressprüfung und Telefon-Leitungstyp Credits verbrauchen. Data Quality befindet sich in der Beta, und laut Dokumentation wird die Beta-Nutzung zum vollen Preis abgerechnet, ohne anfängliches Freikontingent.
Bei jedem Vergleich der ZoomInfo-API-Preise sind die Credit-Regeln wichtiger als der Listenpreis. Laut der Credit-Dokumentation von ZoomInfo kostet ein Datensatz, der innerhalb eines rollierenden 12-Monats-Zeitraums zum ersten Mal angereichert wird, einen Credit und wird dann für ein Jahr „Under Management" gestellt. Solange er unter Verwaltung bleibt, kostet eine erneute Anreicherung nichts extra, obwohl jede Anfrage weiterhin auf Ihr Datensatzlimit angerechnet wird. Die Preis-FAQ ergänzt, dass diese Garantie ein Enterprise-Vorteil ist, der nicht für die kostenlose Stufe gilt, und dass jeder Credit 12 Monate nach seiner Gewährung verfällt.
Da Abfragen und Suchen kostenlos sind, besteht der günstigste Workflow in diesem Preismodell darin, breit abzufragen, die Ergebnisse zu ranken und nur anzureichern, was Sie tatsächlich verwenden. Die Agent-Hinweise von ZoomInfo sagen dasselbe und raten Agents, „Anreicherungsschleifen zu vermeiden" und vor der Anreicherung von 25 Kontakten zu bestätigen, da der Stapel bis zu 25 Credits verbrauchen kann.
Beim Legacy-Service stehen die API-Preise in Ihrem Vertrag. Der Usage-Endpunkt und die Antwort-Header melden für die Vertragslaufzeit ein Anfragelimit, ein Datensatzlimit und ein Limit eindeutiger Datensätze. Fragen Sie Ihr Account-Team nach diesen Zahlen, denn die öffentliche Dokumentation zeigt nur Beispielwerte.
ZoomInfo MCP: Einen KI-Assistenten verbinden
ZoomInfo MCP ist der gehostete Model-Context-Protocol-Server, mit dem ein KI-Assistent ZoomInfo direkt aufrufen kann. Eine ZoomInfo-Lizenz ist erforderlich, und Ihr Tarif, Ihre Limits und Ihre Credits gelten auch für die MCP-Nutzung, daher gibt es keine separate ZoomInfo-MCP-Preisgestaltung. Der Server benötigt einen Client, der Streamable HTTP und OAuth unterstützt, sowie einen Browser für die erstmalige Anmeldung.
Die ZoomInfo-MCP-Dokumentation deckt viele Clients ab. In Claude Code können Sie das offizielle Plugin mit claude plugin install zoominfo@claude-plugins-official installieren oder den Server manuell mit claude mcp add --transport http zoominfo https://mcp.zoominfo.com/mcp hinzufügen. Führen Sie anschließend /mcp aus, um sich anzumelden. Codex bietet einen Plugin-Weg und einen benutzerdefinierten Weg. Cursor und VS Code benötigen einen kurzen JSON-Eintrag mit der Serveradresse. Claude, ChatGPT und Perplexity führen ZoomInfo als nativen Connector auf, sodass Sie ihn über das Connector-Menü hinzufügen und sich mit Ihren ZoomInfo-Zugangsdaten anmelden.
Eine Regel fällt besonders auf. ZoomInfo „untersagt die Verwendung von über MCP abgerufenen Daten für das Training von KI-Modellen" und bittet Sie, das Modelltraining in Ihrem KI-Konto auszuschalten, bevor Sie sich verbinden.

Screenshot: die Liste der ZoomInfo-MCP-Tools mit ihrem Credit-Typ.
Die Tools lassen sich in zwei Arten einteilen. Daten-Tools stellen Ihrem Assistenten Datensätze zur Verfügung, die dieser Schritt für Schritt verkettet. Kontext-Agenten starten einen Sub-Agenten, der ZoomInfo-Datensätze mit Ihrem CRM und Ihrem Anrufverlauf verbindet.
| Tool | Funktion | Credit-Typ |
|---|---|---|
| Search Companies, Search Contacts | Datensätze nach Kriterien finden | Kostenlos |
| Lookup | Zeigt zulässige Filterwerte an | Kostenlos |
| Find Similar Companies, Find Similar Contacts, Find Recommended Contacts | Lookalike- und Outreach-fertige Listen | Kostenlos |
| Search Intent, Search Scoops | Accounts anhand von Signalen erkennen | Kostenlos |
| Enrich Companies, Enrich Contacts | Vollständige Profile für bis zu 25 Datensätze | Bulk-Daten |
| Enrich Intent, Enrich Scoops, Enrich News | Signale zu einem Unternehmen | Bulk-Daten |
| Account Research, Contact Research | KI-Briefing zu einem Unternehmen oder einer Person | KI-Aktion |
Ein Prompt wie „Finde VPs of Sales bei Fintech-Unternehmen" kostet nichts, da er nur sucht. Ein Prompt wie „Reichere diese 50 Kontakte an und übertrage sie an Salesforce" verbraucht Credits. Die GTM.ai-Preis-FAQ trifft dieselbe Unterscheidung: Bei ZoomInfo MCP entscheidet das aufgerufene Tool über die Kosten.
ZoomInfo liefert außerdem einen Kommandozeilen-Client auf demselben Backend wie ZoomInfo MCP aus, mit derselben Anmeldung und denselben Credits. Sie installieren ihn mit Homebrew (brew install zoominfo/gtm-ai/gtm-ai-cli) oder npm, führen gtm auth login aus und rufen Befehle wie gtm companies search und gtm contacts enrich auf. Die Ausgabe kann JSON, CSV, YAML oder eine Tabelle sein.
Ein durchgespieltes Beispiel: Finden, dann anreichern
Die ZoomInfo-API-Dokumentation enthält ein Tutorial, das Marketing-Direktoren bei Softwareunternehmen in Kalifornien findet. Es nutzt drei Aufrufe in dieser Reihenfolge: Lookup, Suche und Anreicherung. Die folgenden Befehle übernehmen die Feldnamen des Tutorials, ersetzen Sie also die Beispielwerte durch Ihre eigenen.
Zuerst die Suche. Sie kostet nichts und liefert Treffer-Hinweise, keine E-Mail-Adressen.
curl --request POST \
--url 'https://api.zoominfo.com/gtm/data/v1/contacts/search?page%5Bnumber%5D=1&page%5Bsize%5D=25' \
--header 'accept: application/vnd.api+json' \
--header 'content-type: application/vnd.api+json' \
--header 'authorization: Bearer <access_token>' \
--data '{"data":{"type":"ContactSearch","attributes":{"state":"California","managementLevel":"Director","jobFunction":"Marketing","requiredFields":"email"}}}'
Die Antwort listet Personen mit Feldern wie firstName, jobTitle, contactAccuracyScore und booleschen Werten wie hasEmail auf, dazu eine id für jede Person. Zweitens: Reichern Sie nur die gewünschten IDs an, bis zu 25 pro Aufruf.
curl --request POST \
--url 'https://api.zoominfo.com/gtm/data/v1/contacts/enrich' \
--header 'content-type: application/vnd.api+json' \
--header 'authorization: Bearer <access_token>' \
--data '{"data":[{"type":"ContactEnrich","attributes":{"personId":"4191419698"}}],"outputFields":["firstName","lastName","jobTitle","email"],"requiredFields":["email"]}'
Jedes Ergebnis enthält einen matchStatus. Ein FULL_MATCH kommt mit den angeforderten Feldern zurück. Ein NO_MATCH kommt mit leeren Attributen zurück. Laut der Referenz von ZoomInfo wird kein Credit berechnet, wenn kein Datensatz gefunden wird oder ein Fehler auftritt.
Zwei Gewohnheiten halten die Kosten niedrig. Schlagen Sie Werte nach, bevor Sie suchen, denn eine Freitext-Branche oder -Berufsbezeichnung, die der Lookup nicht kennt, liefert einen 400-Fehler mit dem Code PFAPI0006. Und speichern Sie die angereicherten IDs, denn ZoomInfo empfiehlt, sie für das Under-Management-Zeitfenster zwischenzuspeichern.
Häufige ZoomInfo-API-Fehler
Die Dokumentation listet jeden Fehlercode auf. Diese vier decken die meisten Fehlschläge ab.
| Status und Code | Bedeutung | Was zu tun ist |
|---|---|---|
| 400, PFAPI0006 | Ein Filterwert ist ungültig | Den Wert nachschlagen und genau wie aufgelistet verwenden |
| 401, ZI0001 | Das Token ist ungültig oder abgelaufen | Ein neues Token holen oder das Refresh-Token verwenden |
| 403, ZI0002 oder ZI0003 | Fehlender Scope, oder das Paket enthält den Endpunkt nicht | Den Scope hinzufügen oder den Account-Manager fragen |
| 429, ZI0004 | Zu viele Anfragen | Zurückfahren und nach der Retry-After-Verzögerung erneut versuchen |
Serverfehler sind anders. Bei einem 500 lohnt sich ein erneuter Versuch nach einer Verzögerung, bei einem 504 beim nächsten Mal eine kleinere Anfrage. Laut dem Credit-Artikel sollten 400, 401 und 403 nicht erneut versucht werden, bevor die Ursache behoben ist.
Die ZoomInfo Chorus API
Chorus ist ein eigenständiges ZoomInfo-Produkt für Anrufaufzeichnung und Conversation Intelligence und hat eine eigene Oberfläche. Die ZoomInfo Chorus API befindet sich auf einer anderen Seite als die oben genannten Seiten, nämlich unter api-docs.chorus.ai, und verwendet nicht das OAuth-App-Modell. Die Dokumentation der Chorus API behandelt Benutzer, Engagements und Aufzeichnungen.
In ihrer Einführung wird die Chorus API als REST-API beschrieben, mit der sich Daten zu Ihren Benutzern abrufen, Daten zu Ihren Engagements (Meetings und Dialer-Anrufe) abrufen, neue Aufzeichnungen hochladen und Aufzeichnungen löschen lassen. Die Authentifizierung erfolgt per Token. Jeder Chorus-Benutzer kann in den persönlichen Einstellungen eines generieren, sofern seine Rolle es zulässt, und das Token wird im Authorization-Header übergeben. Als privat markierte Aufzeichnungen werden nicht zurückgegeben, und Ihre Zugriffskontrolleinstellungen in Chorus gelten für jede Anfrage.
Transkripte in der Dokumentation der ZoomInfo Chorus API
Die häufigste Frage betrifft den Gesprächstext: die Worte, die in einem aufgezeichneten Anruf gesprochen wurden. Das Menü auf der Chorus-Seite führt unter seinen Gruppen unter anderem Conversations, Engagement filter und Emails auf. Öffnen Sie daher Conversations, um die aktuelle Feldliste zu sehen. Die Einführung, die wir gelesen haben, nennt keinen Transkript-Endpunkt. Die Anleitung von Zoom zum Verschieben von Chorus-Aufzeichnungen in Zoom Revenue Accelerator zeigt eine Conversation-Antwort, die das Transkript als Äußerungen (Utterances) innerhalb des Aufzeichnungsobjekts enthält.
Wenn Sie beide Arten von Datensätzen benötigen, planen Sie zwei Zugangsdaten ein: eine OAuth-App für den Hauptdienst und ein Token pro Benutzer für Chorus. Beide teilen sich weder Limits noch Credits. Für Gesprächstext beginnen Sie auf der Chorus-Seite, nicht auf docs.gtm.ai. Jeder Chorus-Endpunkt erfordert ein Chorus-Token, bitten Sie daher zuerst Ihren Chorus-Administrator um Zugang. Die von uns gelesenen Seiten nennen keine öffentlichen Preise für die Chorus API, fragen Sie Ihren Administrator also auch nach den Kosten.
Verifizieren Sie E-Mails aus der ZoomInfo API, bevor Sie sie versenden
Ein Enrich-Aufruf liefert Ihnen eine E-Mail-Adresse. Er sagt Ihnen nicht, ob das Postfach Ihre Nachricht heute annimmt. ZoomInfo ist in seiner Data-Quality-Dokumentation dazu eindeutig. Für E-Mails unterstützt dieses Produkt nur Parsen, Validieren und Normalisieren, und im Text heißt es: „there is no email verification or bounce checking." Außerdem wird erklärt, dass die Validierung rein strukturell ist. Sie bestätigt, dass eine Adresse ein @ und eine Domain enthält, nicht aber, dass die Adresse keinen Bounce verursacht.
Genau in diese Lücke gehört ein Verifizierungsschritt. Eine einfache Pipeline sieht so aus:
- Kostenlos abfragen und die Ergebnisse priorisieren.
- Nur die Kontakte anreichern, die Sie erreichen möchten, mit email in requiredFields.
- Die zurückgegebenen Adressen an einen Verifizierungsdienst senden.
- Gültige Ergebnisse behalten, Catch-all- und unbekannte Ergebnisse prüfen und ungültige verwerfen.
- Die bereinigte Liste in Ihr CRM oder Ihren Sequencer laden.
BillionVerify deckt Schritt drei mit einer REST-Schnittstelle und einem gehosteten MCP-Server ab. Alles Folgende stammt aus unserer Dokumentation unter billionverify.com/docs. Die Basis-URL lautet https://api.billionverify.com/v1, und Ihr Schlüssel gehört in den Header BV-API-KEY. Eine einzelne Anfrage prüft eine einzelne Adresse:
curl -X POST https://api.billionverify.com/v1/verify/single \
-H "BV-API-KEY: sk_xxx" -H "Content-Type: application/json" \
-d '{"email":"jane@company.com","check_smtp":true}'
Die Antwort meldet einen Status wie valid, invalid oder catchall sowie Kennzeichen für Wegwerf-, Rollen- und Catch-all-Adressen. Ein Bulk-Aufruf nimmt bis zu 50 Adressen auf einmal entgegen. Laden Sie für einen großen Export eine CSV-, TXT- oder XLSX-Datei hoch, verfolgen Sie den Auftrag bis zum Abschluss und laden Sie dann die Ergebnisse herunter. Webhooks können Ihrem System mitteilen, wann ein Datei-Auftrag abgeschlossen ist.

Screenshot: die Übersicht des BillionVerify MCP-Servers mit dem Befehl, der ihn zu Claude Code hinzufügt.
Wenn Ihr Team bereits mit einem Assistenten arbeitet, laufen dieselben Prüfungen über MCP. Der Remote-Server von BillionVerify unter https://mcp.billionverify.com/mcp meldet sich per OAuth an. Seine Tools verifizieren eine einzelne Adresse oder einen Stapel von 50, lesen Ihr Guthaben aus, verfolgen einen Datei-Auftrag, erstellen Download-Links und verwalten Webhooks. Ein Assistent kann somit ZoomInfo über ZoomInfo MCP abfragen und die Ergebnisse anschließend über unseren Server prüfen, alles in einem Chat.
Zur Preisgestaltung: Ein gültiges oder ungültiges Ergebnis verbraucht einen Credit, ein unbekanntes Ergebnis ist kostenlos, und eine erneute Prüfung innerhalb von 24 Stunden ist ebenfalls kostenlos. Sie erhalten an jedem Tag, an dem Sie Ihr Konto nutzen, 20 kostenlose Credits, bis zu 600 pro Monat. Sie verfallen nie, und es ist keine Karte erforderlich. Eine Anleitung für Exporte finden Sie auf unserer Seite zur ZoomInfo-E-Mail-Verifizierung.
Zwei kostenlose Tools helfen bei einzelnen Datensätzen. Eine umgekehrte E-Mail-Suche zeigt die Domain und die öffentlichen Signale hinter einer Adresse. Ein Telefonnummern-Validator prüft, ob eine Durchwahl aus einem Enrich-Aufruf für ihr Land gültig ist, und zeigt den Anschlusstyp.
Tipps für die Entwicklung mit ZoomInfo
Einige Gewohnheiten aus der ZoomInfo-API-Dokumentation sparen Credits und Zeit:
- Verwenden Sie für jeden aufzählbaren Filter Lookup-Werte, wie die obige Fehlertabelle nahelegt.
- Sortieren Sie die Ergebnisse, bevor Sie sie anreichern, anhand von Feldern wie dem Contact-Accuracy-Score und hasEmail.
- Reichern Sie in Batches von 25 an und speichern Sie die IDs, die Sie bereits besitzen, im Cache.
- Lesen Sie die Header zum verbleibenden Kontingent und drosseln Sie das Tempo, bevor Sie ein Limit erreichen. Prüfen Sie die API-Preise erneut, bevor Sie einen großen Ladevorgang starten.
- Fordern Sie die engstmöglichen Scopes an und bewahren Sie das Client-Secret auf einem Server auf.
Hintergrundinformationen zum Unternehmen finden Sie in unserem ZoomInfo-Leitfaden. Wenn ein Teammitglied die Web-App, in der Ihre App erstellt wird, nicht erreichen kann, behandelt unser ZoomInfo-Login-Leitfaden Anmeldung, SSO und Zwei-Faktor-Authentifizierung.
FAQs
Hat ZoomInfo eine API?
ZoomInfo hat eine API, und die Dokumentation befindet sich unter docs.zoominfo.com. Die aktuelle Version meldet sich über OAuth-Apps an. Der ältere Enterprise-Dienst trägt die Kennzeichnung Legacy und wird eingestellt.
Wo finde ich die ZoomInfo-API-Dokumentation?
Die ZoomInfo-API-Dokumentation befindet sich unter docs.zoominfo.com, das inzwischen auf docs.gtm.ai weiterleitet. Die Legacy-Enterprise-Seiten bleiben unter api-docs.zoominfo.com erreichbar, und Chorus hat eine eigene Website unter api-docs.chorus.ai.
Was kostet die ZoomInfo-API?
Die Preise der ZoomInfo-API hängen davon ab, wie Sie sie erwerben. GTM.ai listet Self-Service-Preise auf, mit je 1.000 Credits pro Typ zum Start und Aufladungen für 20 $. Die Preise für Enterprise-Verträge nennt der ZoomInfo-Vertrieb.
Ist die ZoomInfo-API kostenlos?
Die ZoomInfo-API ist bei GTM.ai kostenlos im Einstieg, mit einem Startguthaben und ohne Kreditkarte. Abfragen und Suchen kosten nichts, und die Anreicherung verbraucht Credits, sobald das Startguthaben aufgebraucht ist.
Wie erhalte ich einen ZoomInfo-API-Schlüssel?
Die aktuelle ZoomInfo-API hat keinen einzelnen Schlüssel. Sie erstellen eine App im Developer Portal oder auf dem Developer-Tab von GTM.ai, und ZoomInfo stellt Ihnen Zugangsdaten aus. Die Legacy-Version verwendete eine Client-ID mit einem privaten Schlüssel oder einen Benutzernamen mit Passwort.
Welche Rate Limits hat die ZoomInfo-API?
Die ZoomInfo-API erlaubt fünf Aufrufe pro Sekunde bei Builder, 25 bei Standard und 35 bei Scaling. Jedes Paket hat außerdem ein Stunden- und ein Tageslimit, und eine 429-Antwort zeigt Ihnen, welches Zeitfenster Sie erreicht haben.
Was ist ZoomInfo MCP?
ZoomInfo MCP ist ein gehosteter Server, mit dem KI-Assistenten ZoomInfo-Datensätze per natürlicher Sprache abfragen und abrufen können. Er erfordert eine ZoomInfo-Lizenz und eine OAuth-Anmeldung, und ZoomInfo MCP berechnet dieselben Credits wie die REST-Aufrufe.
Kostet ZoomInfo MCP extra?
ZoomInfo MCP hat keine separate Preisgestaltung. Tools, die nur suchen, sind kostenlos, und Tools, die anreichern oder Recherchen durchführen, verbrauchen Credits aus demselben Guthaben wie eine REST-Anfrage.
Was ist die ZoomInfo-Chorus-API?
Die ZoomInfo-Chorus-API ist die REST-Schnittstelle für Chorus, das Produkt für Conversation Intelligence. Sie liest Benutzer und Engagements und kann Aufzeichnungen hochladen oder löschen. Sie verwendet Tokens pro Benutzer statt der OAuth-Apps des Hauptdienstes.
Wo finde ich Transkripte in der Dokumentation der ZoomInfo-Chorus-API?
Gesprächstranskripte gehören zur Chorus-API, nicht zur Haupt-API von ZoomInfo. Prüfen Sie die Gruppe Conversations unter api-docs.chorus.ai auf aktuelle Felder, und holen Sie sich vor dem Testen ein Token von Ihrem Chorus-Administrator.
Kann ich E-Mail-Adressen über die ZoomInfo-API erhalten?
Sie können geschäftliche E-Mail-Adressen erhalten, indem Sie einen Kontakt über die ZoomInfo-API anreichern, und ein requiredFields-Eintrag für E-Mail überspringt Datensätze ohne Adresse. Das hauseigene Data-Quality-Produkt von ZoomInfo prüft die Zustellbarkeit nicht, überprüfen Sie die Adressen daher vor dem Versand.
Sollte ich von ZoomInfo gelieferte E-Mail-Adressen verifizieren?
Von ZoomInfo gelieferte Adressen sollten vor einer Kampagne verifiziert werden, da Personen zwischen zwei Aktualisierungen den Arbeitsplatz wechseln. Die REST-Schnittstelle und der MCP-Server von BillionVerify prüfen jede Adresse und melden Catch-all-, Unknown-, Disposable- und Role-Ergebnisse getrennt.
Video ansehen: So validieren Sie eine Telefonnummer: kostenloser Telefonnummern-Validator
Video ansehen: Kostenlose E-Mail-Rückwärtssuche: Was sie zeigt und was nicht
