Przejdź do treści głównej
Black Friday: 20% rabatu na każdy plan do 1 gru.Zobacz ofertę

ZoomInfo API: co oferuje i jak z niego korzystać

Leo
LeoFounder, BillionVerify

Przewodnik po ZoomInfo API: funkcje, OAuth, grupy endpointów, limity, ceny, serwer MCP ZoomInfo i weryfikacja e-maili.

ZoomInfo API: co oferuje i jak z niego korzystać

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 referencyjnejDo czego służy
Data V1Listy wyszukiwania oraz rekordy firm, kontaktów, intencji, wiadomości i scoop
Context V1Podsumowania kont, wnioski, podobne konta i osoby oraz własna konfiguracja GTM
GTM Studio V1Odbiorcy, foldery, kolumny i wiersze, z zadaniem wzbogacania dla każdej grupy odbiorców
Marketing V1Przesyłanie grup odbiorców do ZoomInfo Marketing
Platform V1Eksporty i rekordy zaangażowania
Agent V1Uruchamianie agentów AI ZoomInfo i odczyt ich przebiegów
Data Quality V1Analiza 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.

Dokumentacja API ZoomInfo: starsze Enterprise API z informacją o wycofaniu

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 aplikacjiAuthorization Code Flow (PKCE)Client Credentials Flow
Aplikacja standardowa, dla własnego zespołuObsługiwanyObsługiwany
Aplikacja partnerska, dla zatwierdzonych partnerów obsługujących wielu klientówObsługiwanyNieobsł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ść zakresuCo udostępnia
api:data:companyRekordy firm i hierarchia korporacyjna
api:data:contactRekordy kontaktów i schematy organizacyjne
api:data:intentSygnały intencji
api:data:news i api:data:scoopsArtykuły informacyjne i scoopy
api:audience:read i api:audience:manageOdczyt lub zarządzanie odbiorcami GTM Studio i Marketing
api:data-quality:executeUruchomienie 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łanieCo robiKoszt
LookupWyświetla akceptowane wartości filtrów, takie jak branże i poziomy zarządzaniaBezpłatnie
Search ContactsWyszukuje osoby według roli, lokalizacji, cech firmy i sygnałówBezpłatnie
Search CompaniesWyszukuje konta według branży, wielkości, lokalizacji i technologiiBezpłatnie
Enrich ContactsZwraca pełne profile kontaktów, maksymalnie 25 na żądanieJeden kredyt za każdy nowy rekord
Enrich CompaniesZwraca dane firmograficzne, maksymalnie 25 na żądanieJeden kredyt, gdy rekord jest nowy
Enrich IntentZwraca sygnały intencji zakupowej dla firmyKredyty
Account and Contact ResearchBriefingi AI łączące ZoomInfo i kontekst z Twojego CRMKredyty 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.

Limity zapytań ZoomInfo API: tabela pakietów z liczbą zapytań na sekundę, godzinę i dobę

Zrzut ekranu: artykuł ZoomInfo o limitach, z trzema poziomami pakietów.

PakietNa sekundęNa godzinęNa dobę
Builder5 zapytań10 800129 600
Standard25 zapytań54 000648 000
Scaling35 zapytań75 600907 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.

Ceny API ZoomInfo: suwaki kredytów GTM.ai dla wzbogacania danych i zadań 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.

Narzędzia ZoomInfo MCP: artykuł Available MCP Tools z listą każdego narzędzia i jego kosztem w kredytach

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ędzieCo robiTyp kredytów
Search Companies, Search ContactsWyszukuje rekordy według kryteriówBezpłatne
LookupPokazuje dozwolone wartości filtrówBezpłatne
Find Similar Companies, Find Similar Contacts, Find Recommended ContactsListy podobnych rekordów i gotowe do kontaktuBezpłatne
Search Intent, Search ScoopsWyszukuje konta według sygnałówBezpłatne
Enrich Companies, Enrich ContactsPełne profile dla maksymalnie 25 rekordówDane zbiorcze
Enrich Intent, Enrich Scoops, Enrich NewsSygnały dla jednej firmyDane zbiorcze
Account Research, Contact ResearchBriefing AI dla jednej firmy lub osobyAkcja 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 kodZnaczenieCo zrobić
400, PFAPI0006Wartość filtra jest nieprawidłowaSprawdź wartość w lookup i użyj jej dokładnie tak, jak na liście
401, ZI0001Token jest nieprawidłowy lub wygasłPobierz nowy token lub użyj tokenu odświeżania
403, ZI0002 lub ZI0003Brak zakresu uprawnień albo pakiet nie obejmuje endpointuDodaj zakres uprawnień lub skontaktuj się z opiekunem konta
429, ZI0004Zbyt 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:

  1. Wykonaj bezpłatne zapytanie query i uszereguj wyniki.
  2. Wzbogać (enrich) tylko tych kontaktów, do których planujesz dotrzeć, z e-mailem w requiredFields.
  3. Wyślij zwrócone adresy do usługi weryfikacji.
  4. Zachowaj wyniki valid, przejrzyj te oznaczone jako catch-all i unknown, a invalid odrzuć.
  5. 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.

Serwer MCP BillionVerify do weryfikacji e-maili z poleceniem połączenia

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:

  1. Używaj wartości z wyszukiwania (lookup) dla każdego filtra wyliczeniowego, jak sugeruje powyższa tabela błędów.
  2. Uszereguj wyniki przed wzbogaceniem, korzystając z pól takich jak wynik dokładności kontaktu i hasEmail.
  3. Wzbogacaj dane w partiach po 25 rekordów i zapisuj w pamięci podręcznej identyfikatory, które już posiadasz.
  4. 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.
  5. Żą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

Leo
LeoFounder, BillionVerify
Informacje o weryfikacji e-mail

Rozpocznij weryfikację dzisiaj

Zacznij weryfikować adresy e-mail z BillionVerify już dziś. Otrzymaj 20 darmowych kredytów za każdy dzień logowania, do 600 miesięcznie - nie wymagana karta kredytowa. Dołącz do tysięcy firm poprawiających ROI z marketingu e-mailowego dzięki dokładnej weryfikacji e-mail.

Nie wymagana karta kredytowa · API w czasie rzeczywistym i weryfikacja masowa · Wyniki nieznane są bezpłatne

0
Kredyty za wyniki nieznane
Na żywo
Szybkość API
$0.00014
Za e-mail
600/mies.
Zawsze darmowe