API ZoomInfo pozwala Twojemu własnemu oprogramowaniu wyszukiwać rekordy firm i kontaktów w ZoomInfo, ładować kompletne profile do CRM, odczytywać sygnały zakupowe i uruchamiać badania z użyciem AI. Programiści korzystają z ZoomInfo na trzy sposoby: przez interfejs REST przez HTTPS, przez serwer ZoomInfo MCP dla asystentów AI oraz przez klienta terminalowego. ZoomInfo twierdzi, że wszystkie trzy współdzielą jedno logowanie i jedno saldo kredytów.
Ten przewodnik omawia, co ZoomInfo oferuje programistom, gdzie znajduje się dokumentacja API ZoomInfo, jak działa uwierzytelnianie, główne grupy endpointów, cennik API, ZoomInfo MCP oraz osobne API Chorus. Kończy się bezpiecznym sposobem sprawdzania wzbogaconych adresów e-mail przed kampanią. Wszystkie fakty pochodzą z własnej dokumentacji i ekranów cennika ZoomInfo, przeczytanych w październiku 2026 roku. Nie jesteśmy powiązani z ZoomInfo. BillionVerify jest usługą weryfikacji adresów e-mail, a my piszemy o narzędziach, które zasilają listy sprzedażowe.
Najważniejsze fakty (sprawdzone w październiku 2026):
- ZoomInfo dokumentuje swoje aktualne API pod adresem docs.zoominfo.com, który przekierowuje na docs.gtm.ai. Starsze Enterprise API jest oznaczone jako „Legacy" i jest wycofywane.
- Obecne API podpisuje żądania za pomocą aplikacji OAuth 2.0, a każde wywołanie trafia pod adres https://api.zoominfo.com/gtm.
- Wyszukiwanie rekordów jest bezpłatne. Wzbogacenie rekordu kosztuje jeden kredyt przy pierwszym razie, a rekord pozostaje objęty na 12 miesięcy w planach kontraktowych.
- GTM.ai publikuje cennik samodzielnego korzystania z API ZoomInfo: bezpłatne kredyty startowe po rejestracji, a następnie płatne doładowania.
- ZoomInfo MCP działa pod adresem https://mcp.zoominfo.com/mcp i współpracuje z Claude, ChatGPT, Cursor, Codex oraz innymi klientami MCP.
ZoomInfo API: krótka odpowiedź
Tak. ZoomInfo oferuje API i bardzo się ono zmieniło. Starsze poradniki opisują usługę z ery Javy, opartą na nazwie użytkownika, haśle i tokenie JSON Web Token. Własna starsza dokumentacja ZoomInfo ostrzega teraz, że ta usługa jest „w trakcie wycofywania" i zaleca programistom budowanie nowych rozwiązań na nowej usłudze.
Dzisiejsze API ZoomInfo działa za serwisem dla programistów GTM.ai. Tworzysz aplikację, wybierasz zakresy (scopes), wymieniasz swoje dane uwierzytelniające na token typu bearer i wywołujesz punkty końcowe pod jednym bazowym adresem URL. Stąd możesz wyszukiwać rekordy za pomocą filtrów, pobierać pełne profile wybranych rekordów, odczytywać dane o intencjach zakupowych (intent), scoopy i wiadomości dla kont docelowych, uruchamiać briefingi AI oraz zarządzać odbiorcami w GTM Studio.
Twój plan decyduje o tym, które punkty końcowe są dla Ciebie dostępne, a także o cenach. Przegląd ZoomInfo mówi to wprost: „Twoja subskrypcja określa, do których zakresów API i punktów końcowych masz dostęp, a limity zapytań dotyczą wszystkich uwierzytelnionych żądań."
Co potrafi API ZoomInfo
Przegląd ZoomInfo opisuje trzy zadania dla programistów: tworzenie integracji, wyszukiwanie firm i kontaktów oraz reagowanie na zmiany za pomocą webhooków. Dokumentacja podaje, że za pomocą żądań REST, serwera MCP lub klienta terminalowego można uzyskać dostęp do „100M+ firm, 500M+ specjalistów oraz 50+ sygnałów zakupowych i biznesowych w czasie rzeczywistym".
Dokumentacja referencyjna grupuje punkty końcowe w rodziny. Poniższa tabela je wymienia wraz z prostym opisem zadania każdej z nich.
| Rodzina w dokumentacji referencyjnej | Do czego służy |
|---|---|
| Data V1 | Listy wyszukiwania oraz rekordy firm, kontaktów, intencji, wiadomości i scoop |
| Context V1 | Podsumowania kont, wnioski, podobne konta i osoby oraz własna konfiguracja GTM |
| GTM Studio V1 | Odbiorcy, foldery, kolumny i wiersze, z zadaniem wzbogacania dla każdej grupy odbiorców |
| Marketing V1 | Przesyłanie grup odbiorców do ZoomInfo Marketing |
| Platform V1 | Eksporty i rekordy zaangażowania |
| Agent V1 | Uruchamianie agentów AI ZoomInfo i odczyt ich przebiegów |
| Data Quality V1 | Analiza składniowa, normalizacja, segmentacja i ocena list, zanim trafią do CRM |
Data V1 stanowi rdzeń i opiera się na wzorcu, który dokumentacja powtarza na kilku stronach. Najpierw wyszukiwanie zwraca dokładne wartości akceptowane przez filtry, takie jak nazwa branży lub poziom zarządzania. Następnie wyszukiwarka znajduje pasujące rekordy. Na końcu żądanie wzbogacenia zwraca pełny profil wybranych rekordów.
Dokumentacja API ZoomInfo: gdzie ją czytać
Dokumentację API ZoomInfo można czytać w dwóch miejscach, a mylenie ich to najczęstszy błąd. Pierwsze to aktualna witryna dla deweloperów z zakładkami Get Started, Recipes, API Reference i MCP. Drugie to stara witryna Enterprise pod adresem api-docs.zoominfo.com, utrzymywana dla istniejących integracji.

Zrzut ekranu: starsza dokumentacja API ZoomInfo. Informacja u góry kieruje nowe prace do nowej witryny.
Starsza witryna nosi tytuł „ZoomInfo API - Legacy". Nadal opisuje starsze endpointy Standard (Search, Enrich, Lookup i Usage), endpointy Scaling (Webhooks i Bulk), usługę WebSights oraz usługę Compliance. Obejmuje też logowanie przez PKI oraz nazwę użytkownika i hasło, przy którym wydany token pozostaje ważny przez godzinę. Integracja zbudowana według tych instrukcji może na razie działać dalej, ale nowy projekt powinien zacząć od aktualnej witryny. Żadna z witryn nie podaje cen, dlatego cennik API ZoomInfo znajdziesz w sekcji o cenach poniżej oraz w swojej umowie.
Aktualną dokumentację łatwo też odczytać maszynowo. Jej plik llms.txt wymienia każdy artykuł, a witryna informuje, że do dowolnego adresu można dodać .md, aby otrzymać Markdown. W części referencyjnej opublikowano również specyfikację OpenAPI, więc kontrakt można zaimportować do narzędzia takiego jak Postman. W referencji można wkleić token bearer i wypróbować prawdziwe wywołania bezpośrednio na stronie.
Przy próbowaniu wywołań z referencji obowiązuje jednak ostrzeżenie. Artykuł dokumentacji o dostępie testowym zastrzega, że wywołania wykonane z tokenami z Developer Portal „są traktowane jak prawdziwe żądania produkcyjne". Zużywają kredyty i wliczają się do limitów, dlatego testuj na małych partiach.
Jak działa uwierzytelnianie w ZoomInfo API
Nowe ZoomInfo API korzysta z OAuth 2.0. Dokumentacja podaje, że OAuth pozwala aplikacji uzyskać dostęp do ZoomInfo „bez udostępniania haseł ani długoterminowych poświadczeń klucza API". Zanim cokolwiek wywołasz, tworzysz aplikację. Klienci Enterprise robią to w ZoomInfo Developer Portal. Użytkownicy self-serve robią to na karcie Developer w GTM.ai. Obie ścieżki wymagają licencji GTM.ai lub Enterprise z włączonym dostępem.
Utworzenie aplikacji trwa kilka minut. Podajesz nazwę, opcjonalne logo i opis, wybierasz metodę uwierzytelniania, w razie potrzeby dodajesz adresy URL przekierowań i wybierasz zakresy (scopes). Po kliknięciu Create App ZoomInfo wystawia poświadczenia aplikacji: identyfikator i sekret. Dokumentacja każe przechowywać oba bezpiecznie i nigdy nie ujawniać ich w kodzie przeglądarki.
Istnieją dwa rodzaje aplikacji i dwa przepływy OAuth:
| Typ aplikacji | Authorization Code Flow (PKCE) | Client Credentials Flow |
|---|---|---|
| Aplikacja standardowa, dla własnego zespołu | Obsługiwany | Obsługiwany |
| Aplikacja partnerska, dla zatwierdzonych partnerów obsługujących wielu klientów | Obsługiwany | Nieobsługiwany |
Przepływ wybierasz, pytając, kto działa. Użyj Authorization Code Flow z PKCE, gdy aplikacja wywołuje ZoomInfo w imieniu zalogowanej osoby. ZoomInfo wymaga metody wyzwania S256, a przepływ zwraca token dostępu oraz token odświeżania. Client Credentials Flow stosuj w usługach backendowych, zadaniach cyklicznych i synchronizacjach. Nikt się wtedy nie loguje, więc musisz wybrać użytkownika integracyjnego, a ZoomInfo przypisuje każde żądanie temu użytkownikowi.
Żądanie tokenu dla komunikacji serwer–serwer to jedno wywołanie POST. Zalecanym sposobem przesyłania poświadczeń jest uwierzytelnianie Basic.
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
Odpowiedź zawiera access_token, wartość expires_in w sekundach, listę zakresów oraz token_type o wartości Bearer. Przykład w dokumentacji pokazuje expires_in równe 1000, więc buforuj tokeny i odświeżaj je według timera zamiast prosić o nowy przy każdym wywołaniu. Każde kolejne żądanie wysyła Authorization: Bearer <access_token>.
Zakresy OAuth w ZoomInfo
Zakresy decydują, do czego token ma dostęp, dlatego żądaj tylko tego, czego aplikacja potrzebuje. Zakresy rekordów to miejsce, od którego zaczyna większość zespołów.
| Wartość zakresu | Co udostępnia |
|---|---|
| api:data:company | Rekordy firm i hierarchia korporacyjna |
| api:data:contact | Rekordy kontaktów i schematy organizacyjne |
| api:data:intent | Sygnały intencji |
| api:data:news i api:data:scoops | Artykuły informacyjne i scoopy |
| api:audience:read i api:audience:manage | Odczyt lub zarządzanie odbiorcami GTM Studio i Marketing |
| api:data-quality:execute | Uruchomienie potoku prepare w Data Quality |
Wywołanie wymagające zakresu, którego token nie ma, kończy się błędem 403 z kodem ZI0002. ZI0003 oznacza coś innego: Twój pakiet nie obejmuje danego endpointu. Pierwszy problem naprawiasz w Developer Portal. Drugi wymaga kontaktu z opiekunem konta ZoomInfo.
Główne kategorie endpointów
Większość integracji korzysta z czterech rodzajów endpointów, a koszt każdego z nich jest inny. Wyszukiwania i zapytania słownikowe nigdy nie zużywają kredytów. Wzbogacanie danych – tak. Poniższa tabela obejmuje wywołania, które są ważne na początku.
| Wywołanie | Co robi | Koszt |
|---|---|---|
| Lookup | Wyświetla akceptowane wartości filtrów, takie jak branże i poziomy zarządzania | Bezpłatnie |
| Search Contacts | Wyszukuje osoby według roli, lokalizacji, cech firmy i sygnałów | Bezpłatnie |
| Search Companies | Wyszukuje konta według branży, wielkości, lokalizacji i technologii | Bezpłatnie |
| Enrich Contacts | Zwraca pełne profile kontaktów, maksymalnie 25 na żądanie | Jeden kredyt za każdy nowy rekord |
| Enrich Companies | Zwraca dane firmograficzne, maksymalnie 25 na żądanie | Jeden kredyt, gdy rekord jest nowy |
| Enrich Intent | Zwraca sygnały intencji zakupowej dla firmy | Kredyty |
| Account and Contact Research | Briefingi AI łączące ZoomInfo i kontekst z Twojego CRM | Kredyty AI |
Lista filtrów jest długa. Artykuł ZoomInfo „Companies & Contacts" podaje, że po stronie firm dostępnych jest ponad 40 grup filtrów, a po stronie kontaktów ponad 25. Filtry firm obejmują tożsamość, dane firmograficzne, wielkość, lokalizację, technologię, strukturę korporacyjną i flagi jakości. Filtry kontaktów obejmują imię i nazwisko, stanowisko, funkcję, poziom zarządzania, lokalizację oraz wskaźnik dokładności kontaktu, którego możesz użyć jako dolnego progu.
Kilka konwencji warto poznać, zanim napiszesz kod. Żądania i odpowiedzi używają typu treści JSON:API, application/vnd.api+json. Wyszukiwania przechodzą przez wyniki za pomocą page[number] i page[size]. Żądania wzbogacania wymagają listy outputFields, a lista requiredFields odrzuca rekordy, którym brakuje kluczowego pola, takiego jak e-mail. Każdy wynik wzbogacania zawiera matchStatus, na przykład FULL_MATCH lub NO_MATCH, a LIMIT_EXCEEDED oznacza, że na Twoim koncie skończyły się kredyty.
Limity zapytań i przepustowość
Limity chronią usługę i wpływają na to, jak szybko można załadować listę. ZoomInfo wiąże limit na sekundę z Twoim pakietem, a ten pakiet jest częścią cennika API.

Zrzut ekranu: artykuł ZoomInfo o limitach, z trzema poziomami pakietów.
| Pakiet | Na sekundę | Na godzinę | Na dobę |
|---|---|---|---|
| Builder | 5 zapytań | 10 800 | 129 600 |
| Standard | 25 zapytań | 54 000 | 648 000 |
| Scaling | 35 zapytań | 75 600 | 907 200 |
Każde zapytanie jest sprawdzane jednocześnie względem wszystkich trzech okien. Jeśli którekolwiek okno jest puste, otrzymasz błąd 429. ZoomInfo podaje, że odrzucone zapytania nie zużywają limitu, więc ponowienie po osiągnięciu limitu nie spala tego, co zostało. Osobny artykuł o kredytach wymienia też płatne dodatki premium na poziomie 30 i 35 zapytań na sekundę, powyżej domyślnych 25.
Odpowiedzi zawierają nagłówki pokazujące, na jakim etapie jesteś, takie jak X-RateLimit-Limit-Second i X-RateLimit-Remaining-Hour. Odpowiedź 429 dodaje Retry-After, nagłówek odrzuconego koszyka oraz znacznik czasu resetu. Dwa starsze nagłówki bez przyrostka okna są oznaczone jako przestarzałe, a ich usunięcie zaplanowano na 2027-01-01, więc przenieś każdy kod, który z nich korzysta.
Limity dotyczą zapytań, a nie rekordów. Wywołanie wyszukiwania zwraca do 25 rekordów przez REST, ale tylko 10 przez MCP lub CLI, więc limit pakietu Standard przekłada się na 625 rekordów na sekundę w jednym przypadku i 250 w drugim. Przy ponowieniach stosuj krótki wykładniczy backoff po osiągnięciu limitu sekundowego, a po osiągnięciu limitu godzinowego lub dobowego wstrzymaj się do czasu podanego w Retry-After. Podniesienie limitu to rozmowa o cenniku z zespołem obsługującym Twoje konto, ponieważ wyższe limity są dostępne jako dodatki lub większe pakiety.
Ceny API ZoomInfo i kredyty
Zespoły pytają o ceny API ZoomInfo częściej niż o prawie cokolwiek innego, a odpowiedź składa się z dwóch części. Ceny dla przedsiębiorstw są wyceniane jako roczny wolumen przez opiekuna konta i nie publikuje się żadnego cennika. Ceny API w modelu samoobsługowym są publiczne, ponieważ publikuje je GTM.ai.

Zrzut ekranu: cennik GTM.ai z dwoma suwakami kredytów.
Ekran cennika GTM.ai informuje, że dostęp do platformy jest zawsze wliczony: dostęp MCP, REST i CLI, z bezpłatnymi wywołaniami wyszukiwania, znajdowania i znajdowania podobnych. Darmowy poziom jest ograniczony do pięciu żądań na sekundę i pięciu aplikacji. Nowe konto otrzymuje po 1000 kredytów każdego rodzaju bez karty kredytowej. Potem obowiązuje rozliczenie według zużycia, z doładowaniami od 20 USD, bez umowy i bez opłat za stanowiska.
Istnieją dwa rodzaje kredytów:
- Kredyty danych płacą za wzbogacanie danych. Jeden kredyt obejmuje pojedynczy rekord firmy, kontaktu lub intencji, który został wzbogacony lub wyeksportowany. Suwak pokazywał 0,38 USD za kredyt przy domyślnym ustawieniu 5000 kredytów, co było wycenione na 1900 USD przed czasową zniżką 70% przy pierwszym zakupie.
- Kredyty AI płacą za research i inne działania AI. Ekran podaje stałą cenę 0,05 USD za sztukę, a 2000 z nich kosztuje 100 USD, co według niego odpowiada około 200 wywołaniom researchu konta lub kontaktu.
Ten sam model cenowy obejmuje każdą powierzchnię dostępu. Żądania REST, CLI i ZoomInfo MCP korzystają ze wspólnego salda kredytów, a wyszukiwanie pozostaje w każdym z nich bezpłatne. Cennik usługi Data Quality opiera się na tej samej zasadzie: parsowanie, walidacja i normalizacja adresu e-mail nic nie kosztują, natomiast uruchomienia segmentów, uruchomienia scoringu, weryfikacja adresów i typ linii telefonicznej zużywają kredyty. Data Quality jest w wersji beta, a dokumentacja stwierdza, że korzystanie z wersji beta jest rozliczane według pełnej stawki, bez wstępnego limitu promocyjnego.
W każdym porównaniu cen API ZoomInfo zasady dotyczące kredytów mają większe znaczenie niż cena katalogowa. Dokumentacja kredytów ZoomInfo mówi, że rekord wzbogacony po raz pierwszy w okresie ruchomych 12 miesięcy kosztuje jeden kredyt, a następnie jest umieszczany w stanie Under Management na rok. Dopóki pozostaje w tym stanie, ponowne wzbogacenie go nie kosztuje nic dodatkowo, choć każde żądanie nadal wlicza się do limitu rekordów. FAQ dotyczące cen dodaje, że ta gwarancja jest korzyścią planu Enterprise, która nie dotyczy darmowego poziomu, oraz że każdy kredyt wygasa 12 miesięcy po przyznaniu.
Ponieważ wyszukiwania są bezpłatne, najtańszy przepływ pracy w tym modelu cenowym polega na szerokim odpytywaniu, uszeregowaniu wyników i wzbogacaniu tylko tego, czego faktycznie użyjesz. Wskazówki ZoomInfo dla agentów mówią to samo, radząc agentom, aby „unikali pętli wzbogacania" i potwierdzali przed wzbogaceniem 25 kontaktów, ponieważ partia może zużyć do 25 kredytów.
W przypadku starszej usługi ceny API są zapisane w umowie. Jej endpoint Usage i nagłówki odpowiedzi podają limit żądań, limit rekordów i limit unikalnych rekordów na okres obowiązywania umowy. Poproś zespół obsługujący Twoje konto o te wartości, ponieważ publiczna dokumentacja pokazuje tylko przykładowe liczby.
ZoomInfo MCP: podłącz asystenta AI
ZoomInfo MCP to hostowany serwer Model Context Protocol, który pozwala asystentowi AI bezpośrednio wywoływać ZoomInfo. Wymagana jest licencja ZoomInfo, a Twój plan, limity i kredyty obowiązują również przy korzystaniu z MCP, więc nie istnieje osobny cennik ZoomInfo MCP. Serwer wymaga klienta obsługującego Streamable HTTP i OAuth oraz przeglądarki do pierwszego logowania.
Dokumentacja ZoomInfo MCP obejmuje wielu klientów. W Claude Code możesz zainstalować oficjalną wtyczkę poleceniem claude plugin install zoominfo@claude-plugins-official albo dodać serwer ręcznie poleceniem claude mcp add --transport http zoominfo https://mcp.zoominfo.com/mcp. Następnie uruchom /mcp, aby się zalogować. Codex ma ścieżkę przez wtyczkę i ścieżkę niestandardową. Cursor i VS Code przyjmują krótki wpis JSON z adresem serwera. Claude, ChatGPT i Perplexity wymieniają ZoomInfo jako natywny konektor, więc dodajesz go z menu konektorów i logujesz się swoimi danymi ZoomInfo.
Wyróżnia się jedna zasada. ZoomInfo „zabrania wykorzystywania danych udostępnianych przez MCP do trenowania modeli AI" i prosi, aby przed połączeniem wyłączyć trenowanie modeli na koncie AI.

Zrzut ekranu: lista narzędzi ZoomInfo MCP wraz z typem kredytów.
Narzędzia dzielą się na dwa rodzaje. Narzędzia danych udostępniają rekordy Twojemu asystentowi, który łączy je krok po kroku. Agenci kontekstowi uruchamiają subagenta, który łączy rekordy ZoomInfo z Twoim CRM i historią rozmów.
| Narzędzie | Co robi | Typ kredytów |
|---|---|---|
| Search Companies, Search Contacts | Wyszukuje rekordy według kryteriów | Bezpłatne |
| Lookup | Pokazuje dozwolone wartości filtrów | Bezpłatne |
| Find Similar Companies, Find Similar Contacts, Find Recommended Contacts | Listy podobnych rekordów i gotowe do kontaktu | Bezpłatne |
| Search Intent, Search Scoops | Wyszukuje konta według sygnałów | Bezpłatne |
| Enrich Companies, Enrich Contacts | Pełne profile dla maksymalnie 25 rekordów | Dane zbiorcze |
| Enrich Intent, Enrich Scoops, Enrich News | Sygnały dla jednej firmy | Dane zbiorcze |
| Account Research, Contact Research | Briefing AI dla jednej firmy lub osoby | Akcja AI |
Zapytanie w stylu „znajdź VP of Sales w firmach fintech" nic nie kosztuje, ponieważ tylko wyszukuje. Zapytanie w stylu „wzbogać tych 50 kontaktów i wyślij je do Salesforce" zużywa kredyty. FAQ o cenach GTM.ai wprowadza ten sam podział: w ZoomInfo MCP o opłacie decyduje wywołane narzędzie.
ZoomInfo udostępnia także klienta wiersza poleceń na tym samym backendzie co ZoomInfo MCP, z tym samym logowaniem i kredytami. Instalujesz go przez Homebrew (brew install zoominfo/gtm-ai/gtm-ai-cli) lub npm, uruchamiasz gtm auth login i wywołujesz polecenia takie jak gtm companies search oraz gtm contacts enrich. Wynik może mieć postać JSON, CSV, YAML lub tabeli.
Praktyczny przykład: najpierw znajdź, potem wzbogać
Dokumentacja ZoomInfo API zawiera samouczek, który wyszukuje dyrektorów marketingu w firmach programistycznych w Kalifornii. Wykorzystuje trzy wywołania w kolejności: lookup, search i enrich. Poniższe polecenia korzystają z nazw pól z samouczka, więc zastąp przykładowe wartości własnymi.
Najpierw wyszukiwanie. Nic nie kosztuje i zwraca wskazówki dopasowania, a nie adresy e-mail.
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"}}}'
Odpowiedź zawiera listę osób z polami takimi jak firstName, jobTitle, contactAccuracyScore oraz wartościami logicznymi, np. hasEmail, a także id każdej osoby. Następnie wzbogać tylko te identyfikatory, których potrzebujesz, maksymalnie 25 na jedno wywołanie.
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"]}'
Każdy wynik zawiera matchStatus. FULL_MATCH zwraca żądane pola. NO_MATCH zwraca puste atrybuty. Z dokumentacji ZoomInfo wynika, że gdy nie uda się znaleźć rekordu lub zwrócony zostanie błąd, kredyty nie są pobierane.
Dwa nawyki pozwalają utrzymać niskie koszty. Sprawdzaj wartości w lookup przed wyszukiwaniem, ponieważ dowolny tekst branży lub stanowiska nieznany w lookup zwraca błąd 400 z kodem PFAPI0006. Zapisuj też wzbogacone identyfikatory, ponieważ ZoomInfo zaleca ich buforowanie na czas okna Under Management.
Typowe błędy ZoomInfo API
Dokumentacja wymienia wszystkie kody błędów. Te cztery obejmują większość awarii.
| Status i kod | Znaczenie | Co zrobić |
|---|---|---|
| 400, PFAPI0006 | Wartość filtra jest nieprawidłowa | Sprawdź wartość w lookup i użyj jej dokładnie tak, jak na liście |
| 401, ZI0001 | Token jest nieprawidłowy lub wygasł | Pobierz nowy token lub użyj tokenu odświeżania |
| 403, ZI0002 lub ZI0003 | Brak zakresu uprawnień albo pakiet nie obejmuje endpointu | Dodaj zakres uprawnień lub skontaktuj się z opiekunem konta |
| 429, ZI0004 | Zbyt wiele żądań | Zwolnij, a następnie ponów próbę po czasie podanym w Retry-After |
Błędy serwera wyglądają inaczej. Błąd 500 warto ponowić po pewnym czasie, a po błędzie 504 następnym razem należy wysłać mniejsze żądanie. Artykuł o kredytach podaje, że błędów 400, 401 i 403 nie należy ponawiać, dopóki nie usunie się przyczyny.
ZoomInfo Chorus API
Chorus to osobny produkt ZoomInfo do nagrywania rozmów i analizy konwersacji, który ma własny interfejs. ZoomInfo Chorus API znajduje się na innej stronie niż powyższe strony, pod adresem api-docs.chorus.ai, i nie korzysta z modelu aplikacji OAuth. Dokumentacja Chorus API obejmuje użytkowników, zaangażowania (engagements) i nagrania.
We wstępie Chorus API opisano jako REST API, które pozwala pobierać dane o użytkownikach, pobierać dane o zaangażowaniach (spotkaniach i rozmowach z dialera), przesyłać nowe nagrania oraz usuwać nagrania. Uwierzytelnianie odbywa się za pomocą tokenu. Każdy użytkownik Chorus może go wygenerować w ustawieniach osobistych, jeśli pozwala na to jego rola, a token umieszcza się w nagłówku Authorization. Nagrania oznaczone jako prywatne nie są zwracane, a ustawienia kontroli dostępu w Chorus obowiązują dla każdego żądania.
Transkrypcje w dokumentacji ZoomInfo Chorus API
Najczęstsze pytanie dotyczy tekstu rozmów: słów wypowiedzianych podczas nagranej rozmowy. Menu na stronie Chorus wymienia wśród swoich grup Conversations, Engagement filter i Emails, więc aktualną listę pól znajdziesz w sekcji Conversations. We wstępie, który przeczytaliśmy, nie ma wzmianki o endpoincie transkrypcji. Przewodnik Zoom dotyczący przenoszenia nagrań Chorus do Zoom Revenue Accelerator pokazuje odpowiedź dla konwersacji, w której transkrypcja jest zapisana jako wypowiedzi (utterances) wewnątrz obiektu nagrania.
Jeśli potrzebujesz obu rodzajów rekordów, zaplanuj dwa zestawy poświadczeń: aplikację OAuth dla głównej usługi oraz token przypisany do użytkownika dla Chorus. Oba nie współdzielą limitów ani kredytów. Jeśli chodzi o tekst rozmów, zacznij od strony Chorus, a nie docs.gtm.ai. Każdy endpoint Chorus wymaga tokenu Chorus, więc najpierw poproś administratora Chorus o dostęp. Strony, które przeczytaliśmy, nie podają publicznego cennika Chorus API, więc zapytaj administratora także o koszty.
Zweryfikuj adresy e-mail z API ZoomInfo przed wysyłką
Zapytanie enrich zwraca adres e-mail. Nie mówi jednak, czy skrzynka przyjmie dziś Twoją wiadomość. ZoomInfo mówi o tym wprost w dokumentacji Data Quality. W przypadku e-maila ten produkt obsługuje wyłącznie parsowanie, walidację i normalizację, a w tekście czytamy: „there is no email verification or bounce checking" (nie ma weryfikacji e-maili ani sprawdzania odbić). Dodano tam, że walidacja jest strukturalna. Potwierdza ona, że adres zawiera znak @ i domenę, ale nie że adres uniknie odbicia.
W tej luce powinien znaleźć się krok weryfikacji. Prosty potok wygląda tak:
- Wykonaj bezpłatne zapytanie query i uszereguj wyniki.
- Wzbogać (enrich) tylko tych kontaktów, do których planujesz dotrzeć, z e-mailem w requiredFields.
- Wyślij zwrócone adresy do usługi weryfikacji.
- Zachowaj wyniki valid, przejrzyj te oznaczone jako catch-all i unknown, a invalid odrzuć.
- Wczytaj oczyszczoną listę do swojego CRM lub narzędzia do sekwencji.
BillionVerify obsługuje krok trzeci za pomocą interfejsu REST i hostowanego serwera MCP. Wszystko poniżej pochodzi z naszej dokumentacji pod adresem billionverify.com/docs. Bazowy adres URL to https://api.billionverify.com/v1, a Twój klucz trafia do nagłówka BV-API-KEY. Pojedyncze żądanie sprawdza pojedynczy adres:
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}'
Odpowiedź zawiera status, taki jak valid, invalid lub catchall, wraz z flagami dla adresów jednorazowych, rolowych i catch-all. Wywołanie zbiorcze przyjmuje do 50 adresów naraz. W przypadku dużego eksportu prześlij plik CSV, TXT lub XLSX, śledź zadanie do jego zakończenia, a następnie pobierz wyniki. Webhooki mogą powiadomić Twój system o ukończeniu zadania z plikiem.

Zrzut ekranu: przegląd serwera MCP BillionVerify wraz z poleceniem, które dodaje go do Claude Code.
Jeśli Twój zespół pracuje już z asystentem, te same kontrole można uruchomić przez MCP. Zdalny serwer BillionVerify pod adresem https://mcp.billionverify.com/mcp loguje się przez OAuth. Jego narzędzia weryfikują pojedynczy adres lub partię 50 adresów, odczytują saldo, śledzą zadanie z plikiem, tworzą linki do pobrania i zarządzają webhookami. Asystent może więc odpytać ZoomInfo przez ZoomInfo MCP, a następnie sprawdzić wyniki przez nasz serwer, w jednej rozmowie.
Jeśli chodzi o cennik, wynik valid lub invalid zużywa jeden kredyt, wynik unknown jest bezpłatny, a ponowne sprawdzenie w ciągu 24 godzin również jest bezpłatne. Otrzymujesz 20 darmowych kredytów każdego dnia, w którym korzystasz z konta, do 600 miesięcznie. Nigdy nie wygasają i nie jest potrzebna karta. Aby zobaczyć omówienie skierowane do eksportów, zajrzyj na naszą stronę o weryfikacji e-maili ZoomInfo.
Dwa bezpłatne narzędzia pomagają przy pojedynczych rekordach. Odwrotne wyszukiwanie e-maila pokazuje domenę i publiczne sygnały stojące za adresem. Walidator numerów telefonów sprawdza, czy numer bezpośredni z wywołania enrich jest prawidłowy dla danego kraju, i pokazuje typ linii.
Wskazówki dotyczące tworzenia integracji z ZoomInfo
Kilka nawyków wyniesionych z dokumentacji ZoomInfo API pozwala oszczędzić kredyty i czas:
- Używaj wartości z wyszukiwania (lookup) dla każdego filtra wyliczeniowego, jak sugeruje powyższa tabela błędów.
- Uszereguj wyniki przed wzbogaceniem, korzystając z pól takich jak wynik dokładności kontaktu i hasEmail.
- Wzbogacaj dane w partiach po 25 rekordów i zapisuj w pamięci podręcznej identyfikatory, które już posiadasz.
- Czytaj nagłówki z informacją o pozostałym limicie i zwolnij, zanim osiągniesz limit. Przed dużym ładowaniem danych jeszcze raz sprawdź cennik API.
- Żądaj możliwie najwęższych zakresów uprawnień i przechowuj client secret na serwerze.
Aby poznać tło firmy, przeczytaj nasz przewodnik po ZoomInfo. Jeśli ktoś z zespołu nie może wejść do aplikacji internetowej, w której tworzy się Twoją aplikację, nasz przewodnik logowania do ZoomInfo opisuje logowanie, SSO i weryfikację dwuetapową.
FAQs
Czy ZoomInfo ma API?
ZoomInfo ma API, a jego dokumentacja znajduje się pod adresem docs.zoominfo.com. Obecna wersja loguje się przez aplikacje OAuth. Starsza usługa Enterprise ma etykietę Legacy i jest wygaszana.
Gdzie znajduje się dokumentacja API ZoomInfo?
Dokumentacja API ZoomInfo jest dostępna pod adresem docs.zoominfo.com, który obecnie otwiera docs.gtm.ai. Starsze strony Enterprise nadal działają pod adresem api-docs.zoominfo.com, a Chorus ma własną witrynę pod adresem api-docs.chorus.ai.
Ile kosztuje API ZoomInfo?
Cena API ZoomInfo zależy od sposobu zakupu. GTM.ai podaje cennik samoobsługowy: na start po 1000 kredytów każdego rodzaju oraz doładowania po 20 USD. Ceny w umowach Enterprise wycenia dział sprzedaży ZoomInfo.
Czy API ZoomInfo jest darmowe?
API ZoomInfo można zacząć używać za darmo w GTM.ai, ze startowym saldem i bez karty kredytowej. Wyszukiwania i zapytania lookup nic nie kosztują, a wzbogacanie danych zużywa kredyty, gdy kwota startowa się skończy.
Jak uzyskać klucz API ZoomInfo?
Obecne API ZoomInfo nie ma jednego klucza. Tworzysz aplikację w Developer Portal lub na karcie Developer w GTM.ai, a ZoomInfo wydaje Ci dane uwierzytelniające. Wersja legacy używała identyfikatora klienta z kluczem prywatnym albo nazwy użytkownika i hasła.
Jakie są limity zapytań API ZoomInfo?
API ZoomInfo dopuszcza pięć wywołań na sekundę w pakiecie Builder, 25 w Standard i 35 w Scaling. Każdy pakiet ma też limit godzinny i dzienny, a odpowiedź 429 informuje, w którym oknie czasowym limit został przekroczony.
Czym jest ZoomInfo MCP?
ZoomInfo MCP to hostowany serwer, który pozwala asystentom AI przeszukiwać i pobierać rekordy ZoomInfo za pomocą języka naturalnego. Wymaga licencji ZoomInfo i logowania przez OAuth, a ZoomInfo MCP pobiera te same kredyty co wywołania REST.
Czy ZoomInfo MCP kosztuje dodatkowo?
ZoomInfo MCP nie ma osobnego cennika. Narzędzia, które tylko wyszukują, są darmowe, a te, które wzbogacają dane lub prowadzą research, zużywają kredyty z tego samego salda co zapytanie REST.
Czym jest API ZoomInfo Chorus?
API ZoomInfo Chorus to interfejs REST dla Chorus, produktu do analizy rozmów. Odczytuje użytkowników i spotkania (engagements) oraz może przesyłać lub usuwać nagrania. Używa tokenów przypisanych do użytkowników, a nie aplikacji OAuth głównej usługi.
Gdzie znajdę transkrypty w dokumentacji API ZoomInfo Chorus?
Transkrypty rozmów należą do API Chorus, a nie do głównego API ZoomInfo. Aktualne pola sprawdź w grupie Conversations na api-docs.chorus.ai, a token uzyskaj od administratora Chorus, zanim zaczniesz testy.
Czy mogę pobrać adresy e-mail z API ZoomInfo?
Służbowe adresy e-mail można uzyskać, wzbogacając kontakt przez API ZoomInfo, a wpis requiredFields dla adresu e-mail pomija rekordy, które go nie mają. Własny produkt ZoomInfo Data Quality nie weryfikuje dostarczalności, więc sprawdź adresy przed wysyłką.
Czy powinienem weryfikować e-maile zwrócone przez ZoomInfo?
Adresy zwrócone przez ZoomInfo warto zweryfikować przed kampanią, ponieważ ludzie zmieniają pracę między aktualizacjami. Interfejs REST i serwer MCP BillionVerify sprawdzają każdy adres i osobno raportują wyniki catch-all, unknown, disposable i role.
Obejrzyj wideo: Jak zweryfikować numer telefonu: darmowy walidator numerów
Obejrzyj wideo: Darmowe odwrotne wyszukiwanie e-maili: co pokazuje, a czego nie
