Langkau ke kandungan utama
Black Friday: diskaun 20% untuk setiap pelan sehingga 1 Dis.Lihat tawaran

ZoomInfo API: Fungsi dan Cara Menggunakannya

Leo
LeoFounder, BillionVerify

Panduan API ZoomInfo: fungsi, cara OAuth berfungsi, kumpulan endpoint, had kadar, harga API, pelayan MCP ZoomInfo dan cara mengesahkan e-mel diperkaya.

ZoomInfo API: Fungsi dan Cara Menggunakannya

API ZoomInfo membolehkan perisian anda sendiri mencari rekod syarikat dan kenalan ZoomInfo, memuatkan profil lengkap ke dalam CRM, membaca isyarat pembelian dan menjalankan penyelidikan AI. Pembangun boleh menggunakan ZoomInfo melalui tiga cara: antara muka REST melalui HTTPS, pelayan MCP ZoomInfo untuk pembantu AI, dan klien terminal. ZoomInfo menyatakan ketiga-tiganya berkongsi satu log masuk dan satu baki kredit.

Panduan ini merangkumi apa yang ZoomInfo tawarkan kepada pembangun, di mana dokumentasi API ZoomInfo disimpan, cara pengesahan berfungsi, kumpulan endpoint utama, harga API, ZoomInfo MCP dan API Chorus yang berasingan. Panduan ini diakhiri dengan cara selamat untuk menyemak alamat e-mel yang telah diperkaya sebelum kempen. Setiap fakta datang daripada dokumentasi dan skrin harga ZoomInfo sendiri, yang dibaca pada Oktober 2026. Kami tidak berkaitan dengan ZoomInfo. BillionVerify ialah perkhidmatan pengesahan e-mel, dan kami menulis tentang alat yang membekalkan senarai jualan.

Fakta utama (disemak pada Oktober 2026):

  • ZoomInfo mendokumentasikan API semasanya di docs.zoominfo.com, yang membuka ke docs.gtm.ai. Enterprise API yang lebih lama dilabelkan "Legacy" dan sedang dihentikan.
  • API semasa menandatangani permintaan melalui aplikasi OAuth 2.0, dan setiap panggilan dihantar ke https://api.zoominfo.com/gtm.
  • Mencari rekod adalah percuma. Memperkaya sesuatu rekod menggunakan satu kredit pada kali pertama, dan rekod itu kekal dilindungi selama 12 bulan pada pelan kontrak.
  • GTM.ai menerbitkan harga API ZoomInfo layan diri: kredit permulaan percuma semasa pendaftaran, kemudian tambah nilai berbayar.
  • ZoomInfo MCP terletak di https://mcp.zoominfo.com/mcp dan berfungsi dengan Claude, ChatGPT, Cursor, Codex dan klien MCP lain.

API ZoomInfo: Jawapan Ringkas

Ya. ZoomInfo menawarkan API, dan ia telah banyak berubah. Tutorial lama menerangkan perkhidmatan era Java dengan nama pengguna, kata laluan dan JSON Web Token. Dokumentasi legasi ZoomInfo sendiri kini memberi amaran bahawa perkhidmatan ini "dalam proses dihentikan" dan menyuruh pembangun membina kerja baharu di atas perkhidmatan yang baharu.

API ZoomInfo hari ini terletak di sebalik laman pembangun GTM.ai. Anda mencipta aplikasi, memilih skop, menukar kelayakan anda dengan token bearer dan memanggil endpoint di bawah satu URL asas. Dari situ anda boleh membuat pertanyaan rekod dengan penapis, menarik profil penuh bagi rekod yang dipilih, membaca intent, scoop dan berita untuk akaun sasaran, menjalankan taklimat AI, dan mengurus audiens GTM Studio.

Pelan anda menentukan endpoint mana yang dibuka untuk anda, dan ia turut menentukan harga. Gambaran keseluruhan ZoomInfo menyatakannya dengan jelas: "Langganan anda menentukan skop dan endpoint API yang boleh anda akses, dan had kadar dikenakan pada semua permintaan yang disahkan."

Apa yang Boleh Dilakukan oleh API ZoomInfo

Gambaran keseluruhan ZoomInfo menerangkan tiga tugas untuk pembangun: membina integrasi, mencari syarikat dan kenalan, serta bertindak balas terhadap perubahan dengan webhook. Dokumentasi tersebut menyatakan bahawa dengan permintaan REST, pelayan MCP atau klien terminal, anda boleh mencapai "100M+ syarikat, 500M+ profesional, dan 50+ isyarat pembelian dan perniagaan masa nyata."

Rujukan tersebut mengumpulkan endpoint ke dalam beberapa keluarga. Jadual ini menyenaraikannya, bersama tugas setiap satu dalam bahasa yang mudah.

Keluarga dalam rujukanKegunaannya
Data V1Senarai carian, serta rekod syarikat, kenalan, niat, berita dan scoop
Context V1Ringkasan akaun, pandangan, akaun dan orang yang serupa, serta persediaan GTM anda sendiri
GTM Studio V1Khalayak, folder, lajur dan baris, dengan satu tugas pengayaan bagi setiap khalayak
Marketing V1Muat naik khalayak untuk ZoomInfo Marketing
Platform V1Eksport dan rekod penglibatan
Agent V1Memulakan ejen AI ZoomInfo dan membaca larian mereka
Data Quality V1Menghuraikan, menormalkan, membahagikan dan menilai senarai sebelum ia sampai ke CRM

Data V1 ialah teras, dan ia mengikuti corak yang diulang oleh dokumentasi pada beberapa halaman. Pertama, carian mengembalikan nilai tepat yang diterima oleh penapis, seperti nama industri atau tahap pengurusan. Kedua, pencarian menemui rekod yang sepadan. Ketiga, permintaan pengayaan mengembalikan profil penuh bagi rekod yang anda pilih.

Dokumentasi API ZoomInfo: Di Mana Hendak Membacanya

Terdapat dua tempat untuk membaca dokumentasi API ZoomInfo, dan mencampuradukkan keduanya ialah kesilapan yang paling lazim. Yang pertama ialah tapak pembangun semasa, yang mempunyai tab Get Started, Recipes, API Reference dan MCP. Yang kedua ialah tapak Enterprise lama di api-docs.zoominfo.com, yang dikekalkan untuk integrasi sedia ada.

Dokumentasi API ZoomInfo: Legacy Enterprise API beserta nota penamatan sokongannya

Tangkapan skrin: dokumentasi API ZoomInfo lama. Nota di bahagian atas mengarahkan kerja baharu ke tapak baharu.

Tapak lama itu bertajuk "ZoomInfo API - Legacy". Ia masih menerangkan endpoint Standard yang lebih lama (Search, Enrich, Lookup dan Usage), endpoint Scaling (Webhooks dan Bulk), perkhidmatan WebSights dan perkhidmatan Compliance. Ia turut merangkumi log masuk PKI serta nama pengguna dan kata laluan, yang mana token yang dikeluarkan kekal sah selama satu jam. Integrasi yang dibina berdasarkan arahan tersebut boleh terus berjalan buat masa ini, tetapi projek baharu harus bermula di tapak semasa. Kedua-dua tapak tidak menyenaraikan harga, jadi harga API ZoomInfo terdapat dalam bahagian harga di bawah dan dalam kontrak anda.

Dokumentasi semasa juga mudah dibaca oleh mesin. Fail llms.txt menyenaraikan setiap artikel, dan tapak itu menyatakan anda boleh menambah .md pada mana-mana alamat untuk mendapatkan Markdown. Rujukan itu turut menerbitkan spesifikasi OpenAPI, jadi anda boleh mengimport kontrak tersebut ke dalam alat seperti Postman. Rujukan itu membolehkan anda menampal token bearer dan mencuba panggilan sebenar terus dari halaman.

Satu amaran perlu diberikan tentang mencuba panggilan daripada rujukan itu. Artikel dokumentasi mengenai akses ujian memberi amaran bahawa panggilan yang dibuat dengan token daripada Developer Portal "dianggap sebagai permintaan produksi sebenar". Panggilan itu menggunakan kredit dan dikira dalam had penggunaan, jadi uji dengan kelompok kecil.

Cara Pengesahan API ZoomInfo Berfungsi

API ZoomInfo yang baharu menggunakan OAuth 2.0. Dokumentasi menyatakan OAuth membolehkan sesebuah aplikasi mencapai ZoomInfo "tanpa berkongsi kata laluan atau bukti kelayakan kunci API yang tahan lama." Sebelum anda boleh memanggil apa-apa, anda perlu mencipta sebuah aplikasi. Pelanggan Enterprise melakukannya di ZoomInfo Developer Portal. Pengguna layan diri melakukannya dari tab Developer pada GTM.ai. Kedua-dua laluan memerlukan lesen GTM.ai atau Enterprise dengan akses yang telah diaktifkan.

Penciptaan mengambil masa beberapa minit. Anda memasukkan nama, logo pilihan dan penerangan, memilih kaedah pengesahan, menambah URL ubah hala jika perlu, dan memilih skop. Selepas anda mengklik Create App, ZoomInfo mengeluarkan bukti kelayakan aplikasi tersebut, iaitu ID dan rahsia. Dokumentasi menyuruh anda menyimpan kedua-duanya dengan selamat dan tidak sekali-kali mendedahkannya dalam kod pelayar.

Terdapat dua jenis aplikasi dan dua aliran OAuth:

Jenis aplikasiAuthorization Code Flow (PKCE)Client Credentials Flow
Aplikasi standard, untuk pasukan anda sendiriDisokongDisokong
Aplikasi rakan kongsi, untuk rakan kongsi yang diluluskan yang melayani ramai pelangganDisokongTidak disokong

Pilih aliran dengan bertanya siapa yang bertindak. Gunakan Authorization Code Flow dengan PKCE apabila aplikasi anda memanggil ZoomInfo untuk seseorang yang telah log masuk. ZoomInfo memerlukan kaedah cabaran S256, dan aliran ini mengembalikan token akses serta token segar semula. Gunakan Client Credentials Flow untuk perkhidmatan bahagian belakang, tugas berjadual dan penyegerakan. Tiada sesiapa yang log masuk, jadi anda mesti memilih pengguna integrasi, dan ZoomInfo mengaitkan setiap permintaan kepada pengguna tersebut.

Permintaan token untuk kerja pelayan-ke-pelayan ialah satu POST. Pengesahan Basic ialah cara yang disyorkan untuk menghantar bukti kelayakan.

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

Respons mengandungi access_token, nilai expires_in dalam saat, senarai skop dan token_type bernilai Bearer. Contoh dalam dokumentasi menunjukkan expires_in sebagai 1000, jadi simpan token dalam cache dan segarkannya mengikut pemasa dan bukannya meminta yang baharu pada setiap panggilan. Setiap permintaan seterusnya menghantar Authorization: Bearer <access_token>.

Skop OAuth ZoomInfo

Skop menentukan apa yang boleh disentuh oleh sesuatu token, dan anda hanya perlu meminta apa yang diperlukan oleh aplikasi. Skop rekod ialah tempat kebanyakan pasukan bermula.

Nilai skopApa yang dibuka
api:data:companyRekod syarikat dan hierarki korporat
api:data:contactRekod kenalan dan carta organisasi
api:data:intentIsyarat niat
api:data:news dan api:data:scoopsArtikel berita dan scoop
api:audience:read dan api:audience:manageBaca atau urus audiens GTM Studio dan Marketing
api:data-quality:executeJalankan saluran paip prepare Data Quality

Panggilan yang memerlukan skop yang tiada pada token anda gagal dengan ralat 403 dan kod ZI0002. ZI0003 adalah berbeza: ia bermaksud pakej anda tidak merangkumi titik akhir tersebut. Anda menyelesaikan masalah pertama di Developer Portal. Masalah kedua memerlukan pengurus akaun ZoomInfo anda.

Kategori Endpoint Utama

Kebanyakan integrasi menggunakan empat jenis endpoint, dan kosnya berbeza antara satu sama lain. Panggilan carian dan pencarian tidak pernah menggunakan kredit. Pengayaan data pula menggunakannya. Jadual ini merangkumi panggilan yang paling penting pada peringkat awal.

PanggilanFungsiKos
LookupMenyenaraikan nilai penapis yang diterima seperti industri dan peringkat pengurusanPercuma
Search ContactsMencari individu mengikut peranan, lokasi, ciri syarikat dan isyaratPercuma
Search CompaniesMencari akaun mengikut industri, saiz, lokasi dan teknologiPercuma
Enrich ContactsMengembalikan profil kenalan penuh, paling banyak 25 setiap permintaanSatu kredit bagi setiap rekod baharu
Enrich CompaniesMengembalikan firmografik, paling banyak 25 setiap permintaanSatu kredit apabila rekod itu baharu
Enrich IntentMengembalikan isyarat niat pembelian bagi sesebuah syarikatKredit
Account and Contact ResearchTaklimat AI yang menggabungkan ZoomInfo dan konteks CRM andaKredit AI

Senarai penapis ini panjang. Artikel "Companies & Contacts" ZoomInfo menyatakan bahawa bahagian syarikat menyokong lebih daripada 40 kumpulan penapis dan bahagian kenalan lebih daripada 25. Penapis syarikat merangkumi identiti, firmografik, saiz, lokasi, teknologi, struktur korporat dan penanda kualiti. Penapis kenalan merangkumi nama, jawatan, fungsi kerja, peringkat pengurusan, lokasi dan skor ketepatan kenalan yang boleh anda gunakan sebagai had minimum.

Beberapa konvensyen berguna untuk diketahui sebelum anda menulis kod. Permintaan dan respons menggunakan jenis kandungan JSON:API, application/vnd.api+json. Carian membahagikan hasil kepada halaman dengan page[number] dan page[size]. Permintaan enrich memerlukan senarai outputFields, dan senarai requiredFields akan menggugurkan rekod yang tidak mempunyai medan utama seperti e-mel. Setiap hasil enrich membawa matchStatus, contohnya FULL_MATCH atau NO_MATCH, dan LIMIT_EXCEEDED bermaksud akaun anda telah kehabisan kredit.

Had Kadar dan Daya Pemprosesan

Had melindungi perkhidmatan dan menentukan sepantas mana anda boleh memuatkan senarai. ZoomInfo mengaitkan had maksimum sesaat dengan pakej anda, dan pakej itu merupakan sebahagian daripada harga API anda.

Had kadar API ZoomInfo: jadual pakej dengan permintaan sesaat, sejam dan sehari

Tangkapan skrin: artikel ZoomInfo tentang had, dengan tiga peringkat pakej.

PakejSesaatSejamSehari
Builder5 permintaan10,800129,600
Standard25 permintaan54,000648,000
Scaling35 permintaan75,600907,200

Setiap permintaan disemak berdasarkan ketiga-tiga tetingkap sekaligus. Jika mana-mana tetingkap sudah kosong, anda akan menerima 429. ZoomInfo menyatakan permintaan yang ditolak tidak menggunakan kuota, jadi mencuba semula selepas terkena had tidak menghabiskan baki yang tinggal. Satu artikel kredit yang berasingan turut menyenaraikan tambahan premium pada 30 dan 35 sesaat berbanding lalai 25.

Respons membawa pengepala yang menunjukkan kedudukan anda, seperti X-RateLimit-Limit-Second dan X-RateLimit-Remaining-Hour. Respons 429 menambah Retry-After, pengepala baldi yang ditolak dan cap masa set semula. Dua pengepala lama tanpa akhiran tetingkap ditandakan sebagai usang, dengan penyingkiran ditetapkan pada 2027-01-01, jadi alihkan mana-mana kod yang membacanya.

Had ini dikenakan pada permintaan, bukan pada rekod. Satu panggilan carian memulangkan sehingga 25 rekod melalui REST tetapi hanya 10 melalui MCP atau CLI, jadi had Standard menggerakkan 625 rekod sesaat dalam satu cara dan 250 dalam cara yang lain. Untuk percubaan semula, gunakan backoff eksponen yang pendek selepas terkena had sesaat, dan berhenti sehingga Retry-After selepas terkena had sejam atau sehari. Menaikkan had ialah perbincangan harga dengan pasukan akaun anda, kerana had yang lebih tinggi datang sebagai tambahan atau pakej yang lebih besar.

Harga API ZoomInfo dan Kredit

Pasukan bertanya tentang harga API ZoomInfo lebih daripada hampir semua perkara lain, dan jawapannya mempunyai dua bahagian. Harga Enterprise ditawarkan sebagai volum tahunan melalui pengurus akaun, dan tiada senarai harga disiarkan. Harga API layan diri adalah terbuka kepada umum, kerana GTM.ai menyiarkannya.

Harga API ZoomInfo: peluncur kredit GTM.ai untuk pengayaan dan kerja AI

Tangkapan skrin: harga GTM.ai dengan dua peluncur kreditnya.

Skrin harga GTM.ai menyatakan akses platform sentiasa disertakan: akses MCP, akses REST dan akses CLI, dengan panggilan carian, penemuan dan cari-yang-serupa secara percuma. Peringkat percuma dihadkan kepada lima permintaan sesaat dan lima apl. Akaun baharu mendapat 1,000 kredit bagi setiap jenis tanpa kad kredit. Selepas itu, harga adalah bayar-mengikut-penggunaan, dengan tambah nilai bermula dari $20, tanpa kontrak dan tanpa bayaran kerusi.

Terdapat dua jenis kredit:

  • Kredit data membayar untuk pengayaan. Satu kredit meliputi satu rekod syarikat, kenalan atau niat yang diperkaya atau dieksport. Peluncur menunjukkan $0.38 setiap kredit pada tetapan lalai 5,000 kredit, disenaraikan sebagai $1,900 sebelum diskaun terhad 70% untuk pembelian pertama.
  • Kredit AI membayar untuk penyelidikan dan tindakan AI yang lain. Skrin menyenaraikan kadar tetap $0.05 setiap satu, dan 2,000 kredit berharga $100, yang disamakan dengan kira-kira 200 panggilan penyelidikan akaun atau kenalan.

Model harga yang sama meliputi setiap permukaan. Permintaan REST, CLI dan ZoomInfo MCP semuanya menggunakan baki kredit bersama, dan carian kekal percuma pada setiap satunya. Harga bagi perkhidmatan Data Quality mengikut idea yang sama: menghurai, mengesahkan dan menormalkan e-mel tidak dikenakan sebarang kos, manakala larian segmen, larian skor, pengesahan alamat dan jenis talian telefon menggunakan kredit. Data Quality masih dalam beta, dan dokumentasi menyatakan penggunaan beta dikenakan bayaran penuh tanpa peruntukan pengenalan.

Peraturan kredit lebih penting daripada harga yang tertera dalam sebarang perbandingan harga API ZoomInfo. Dokumentasi kredit ZoomInfo menyatakan rekod yang diperkaya buat kali pertama dalam tempoh 12 bulan bergolek berharga satu kredit, dan rekod itu kemudian diletakkan di bawah Pengurusan (Under Management) selama setahun. Selagi ia kekal di bawah pengurusan, memperkayakannya semula tidak dikenakan kos tambahan, walaupun setiap permintaan masih dikira terhadap had rekod anda. FAQ harga menambah bahawa jaminan ini ialah faedah Enterprise yang tidak terpakai pada peringkat percuma, dan setiap kredit tamat tempoh 12 bulan selepas diberikan.

Oleh sebab carian dan pencarian adalah percuma, aliran kerja termurah di bawah model harga ini ialah membuat pertanyaan secara meluas, menyusun keputusan mengikut kedudukan dan memperkaya hanya apa yang akan anda gunakan. Panduan ejen ZoomInfo menyatakan perkara yang sama, menasihatkan ejen supaya "avoid enrichment loops" dan mengesahkan sebelum memperkaya 25 kenalan, kerana kelompok itu mungkin menggunakan sehingga 25 kredit.

Bagi perkhidmatan warisan, harga API terdapat dalam kontrak anda. Endpoint Usage dan pengepala responsnya melaporkan had permintaan, had rekod dan had rekod unik bagi tempoh kontrak. Tanya pasukan akaun anda untuk angka tersebut, kerana dokumentasi awam hanya menunjukkan nilai sampel.

ZoomInfo MCP: Sambungkan Pembantu AI

ZoomInfo MCP ialah pelayan Model Context Protocol yang dihoskan, yang membolehkan pembantu AI memanggil ZoomInfo secara terus. Lesen ZoomInfo diperlukan, dan pelan, had serta kredit anda semuanya terpakai untuk penggunaan MCP, jadi tiada harga ZoomInfo MCP yang berasingan. Pelayan ini memerlukan klien yang menyokong Streamable HTTP dan OAuth, serta pelayar untuk log masuk kali pertama.

Dokumentasi ZoomInfo MCP merangkumi banyak klien. Dalam Claude Code, anda boleh memasang pemalam rasmi dengan claude plugin install zoominfo@claude-plugins-official, atau menambah pelayan secara manual dengan claude mcp add --transport http zoominfo https://mcp.zoominfo.com/mcp. Kemudian jalankan /mcp untuk log masuk. Codex mempunyai laluan pemalam dan laluan tersuai. Cursor dan VS Code menerima entri JSON ringkas dengan alamat pelayan. Claude, ChatGPT dan Perplexity menyenaraikan ZoomInfo sebagai penyambung asli, jadi anda menambahnya daripada menu penyambung dan log masuk dengan kelayakan ZoomInfo anda.

Satu peraturan menonjol. ZoomInfo "melarang data yang diakses melalui MCP digunakan untuk latihan model AI," dan meminta anda mematikan latihan model dalam akaun AI anda sebelum anda menyambung.

Alat ZoomInfo MCP: artikel Available MCP Tools yang menyenaraikan setiap alat dan kos kreditnya

Tangkapan skrin: senarai alat ZoomInfo MCP beserta jenis kreditnya.

Alat-alat ini terbahagi kepada dua jenis. Alat data mendedahkan rekod kepada pembantu anda, yang merantaikannya langkah demi langkah. Ejen konteks menjalankan sub-ejen yang menggabungkan rekod ZoomInfo dengan CRM dan sejarah panggilan anda.

AlatFungsiJenis kredit
Search Companies, Search ContactsCari rekod mengikut kriteriaPercuma
LookupMenunjukkan nilai penapis yang dibenarkanPercuma
Find Similar Companies, Find Similar Contacts, Find Recommended ContactsSenarai serupa dan sedia untuk capaianPercuma
Search Intent, Search ScoopsKesan akaun mengikut isyaratPercuma
Enrich Companies, Enrich ContactsProfil penuh untuk sehingga 25 rekodData pukal
Enrich Intent, Enrich Scoops, Enrich NewsIsyarat untuk satu syarikatData pukal
Account Research, Contact ResearchTaklimat AI untuk satu syarikat atau individuTindakan AI

Gesaan seperti "cari VP Jualan di syarikat fintech" tidak mengenakan sebarang kos, kerana ia hanya mencari. Gesaan seperti "perkaya 50 kenalan ini dan hantar ke Salesforce" menggunakan kredit. Soalan Lazim harga GTM.ai membuat pembahagian yang sama: dalam ZoomInfo MCP, alat yang dipanggil menentukan caj.

ZoomInfo juga menyediakan klien baris perintah pada bahagian belakang yang sama dengan ZoomInfo MCP, dengan log masuk dan kredit yang sama. Anda memasangnya dengan Homebrew (brew install zoominfo/gtm-ai/gtm-ai-cli) atau npm, jalankan gtm auth login, dan panggil arahan seperti gtm companies search dan gtm contacts enrich. Output boleh berupa JSON, CSV, YAML atau jadual.

Contoh Praktikal: Cari, Kemudian Perkayakan

Dokumentasi API ZoomInfo menyertakan tutorial yang mencari Pengarah Pemasaran di syarikat perisian di California. Ia menggunakan tiga panggilan mengikut urutan: carian nilai, carian dan pengayaan. Arahan di bawah mengikut nama medan dalam tutorial tersebut, jadi gantikan nilai sampel dengan nilai anda sendiri.

Pertama, carian. Ia tidak dikenakan sebarang kos dan hanya memulangkan petunjuk padanan, bukan alamat e-mel.

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"}}}'

Respons tersebut menyenaraikan individu dengan medan seperti firstName, jobTitle, contactAccuracyScore dan nilai boolean seperti hasEmail, serta id bagi setiap individu. Kedua, perkayakan hanya ID yang anda mahu, sehingga 25 bagi setiap panggilan.

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"]}'

Setiap hasil mengandungi matchStatus. FULL_MATCH dipulangkan bersama medan yang anda minta. NO_MATCH dipulangkan dengan atribut kosong. Rujukan ZoomInfo menyatakan bahawa apabila ia gagal menemui rekod, atau memulangkan ralat, tiada kredit dikenakan.

Dua tabiat ini menjimatkan kos. Semak nilai sebelum anda mencari, kerana industri atau jawatan teks bebas yang tidak dikenali oleh carian nilai akan memulangkan 400 dengan kod PFAPI0006. Dan simpan ID yang telah diperkaya, kerana ZoomInfo mengesyorkan agar ia di-cache untuk tempoh Under Management.

Ralat API ZoomInfo yang Biasa

Dokumentasi menyenaraikan setiap kod ralat. Empat ralat ini meliputi kebanyakan kegagalan.

Status dan kodMaksudTindakan
400, PFAPI0006Nilai penapis tidak sahSemak nilai tersebut dan gunakan tepat seperti yang disenaraikan
401, ZI0001Token tidak sah atau telah tamat tempohDapatkan token baharu atau gunakan token segar semula
403, ZI0002 atau ZI0003Skop tiada, atau pakej tidak mempunyai endpoint tersebutTambah skop, atau hubungi pengurus akaun anda
429, ZI0004Terlalu banyak permintaanBerundur, kemudian cuba semula selepas kelewatan Retry-After

Ralat pelayan adalah berbeza. Ralat 500 wajar dicuba semula selepas kelewatan, dan ralat 504 wajar diikuti dengan permintaan yang lebih kecil pada kali berikutnya. Artikel kredit menyatakan 400, 401 dan 403 tidak patut dicuba semula sehingga anda membetulkan puncanya.

API ZoomInfo Chorus

Chorus ialah produk ZoomInfo yang berasingan untuk rakaman panggilan dan kecerdasan perbualan, dan ia mempunyai antara muka tersendiri. API ZoomInfo Chorus terletak pada laman yang berbeza daripada halaman di atas, iaitu di api-docs.chorus.ai, dan ia tidak menggunakan model aplikasi OAuth. Dokumentasi API Chorus merangkumi pengguna, penglibatan (engagement) dan rakaman.

Pengenalannya menggambarkan API Chorus sebagai REST API yang boleh mendapatkan data tentang pengguna anda, mendapatkan data tentang penglibatan anda (mesyuarat dan panggilan dialer), memuat naik rakaman baharu dan memadam rakaman. Pengesahan dilakukan menggunakan token. Setiap pengguna Chorus boleh menjananya dalam Personal Settings, jika peranan mereka membenarkannya, dan token tersebut diletakkan dalam pengepala Authorization. Rakaman yang ditandakan sebagai peribadi tidak akan dikembalikan, dan tetapan kawalan akses Chorus anda terpakai pada setiap permintaan.

Transkrip Dokumentasi API ZoomInfo Chorus

Soalan yang paling kerap ditanya adalah tentang teks panggilan: perkataan yang dituturkan dalam panggilan yang dirakam. Menu pada laman Chorus menyenaraikan Conversations, Engagement filter dan Emails dalam kumpulannya, jadi buka Conversations untuk melihat senarai medan semasa. Pengenalan yang kami baca tidak menyebut sebarang endpoint transkrip. Panduan Zoom tentang memindahkan rakaman Chorus ke Zoom Revenue Accelerator menunjukkan respons perbualan yang menyimpan transkrip sebagai ujaran (utterances) di dalam objek rakaman.

Jika anda memerlukan kedua-dua jenis rekod, rancang untuk dua kelayakan: satu aplikasi OAuth untuk perkhidmatan utama dan satu token bagi setiap pengguna untuk Chorus. Kedua-duanya tidak berkongsi had atau kredit. Untuk teks panggilan, mulakan di laman Chorus, bukan di docs.gtm.ai. Setiap endpoint Chorus memerlukan token Chorus, jadi dapatkan akses daripada pentadbir Chorus anda dahulu. Halaman yang kami baca tidak menyenaraikan harga API Chorus awam, jadi tanya juga pentadbir anda tentang kos.

Sahkan E-mel daripada API ZoomInfo Sebelum Anda Menghantar

Panggilan enrich memberi anda alamat e-mel. Ia tidak memberitahu sama ada peti mel itu akan menerima mesej anda hari ini. ZoomInfo berterus-terang tentang perkara ini dalam dokumentasi Data Quality mereka. Untuk e-mel, produk itu hanya menyokong parse, validate dan normalize, dan teksnya menyatakan: "there is no email verification or bounce checking." Ia menambah bahawa pengesahan itu bersifat struktur. Ia mengesahkan sesuatu alamat mempunyai @ dan domain, bukan bahawa alamat itu tidak akan melantun.

Jurang itulah tempat langkah pengesahan sepatutnya berada. Saluran paip yang mudah kelihatan seperti ini:

  1. Buat query secara percuma dan susun keputusan mengikut kedudukan.
  2. Enrich hanya kenalan yang anda rancang untuk dihubungi, dengan email dalam requiredFields.
  3. Hantar alamat yang dikembalikan kepada perkhidmatan pengesahan.
  4. Simpan keputusan valid, semak yang catch-all dan unknown, dan buang yang invalid.
  5. Muatkan senarai yang telah dibersihkan ke dalam CRM atau sequencer anda.

BillionVerify merangkumi langkah ketiga dengan antara muka REST dan pelayan MCP yang dihoskan. Semua yang berikut datang daripada dokumentasi kami di billionverify.com/docs. URL asasnya ialah https://api.billionverify.com/v1, dan kunci anda diletakkan dalam pengepala BV-API-KEY. Satu permintaan menyemak satu alamat:

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}'

Respons melaporkan status seperti valid, invalid atau catchall, bersama bendera untuk alamat pakai buang, alamat peranan dan alamat catch-all. Panggilan pukal menerima sehingga 50 alamat sekali gus. Untuk eksport yang besar, muat naik fail CSV, TXT atau XLSX, pantau tugasan sehingga selesai, kemudian muat turun keputusannya. Webhook boleh memberitahu sistem anda apabila tugasan fail selesai.

Pelayan MCP pengesahan e-mel BillionVerify dengan arahan sambungan

Tangkapan skrin: gambaran keseluruhan pelayan MCP BillionVerify, dengan arahan yang menambahnya ke Claude Code.

Jika pasukan anda sudah bekerja melalui pembantu, semakan yang sama boleh dijalankan daripada MCP. Pelayan jauh BillionVerify di https://mcp.billionverify.com/mcp log masuk dengan OAuth. Alatnya mengesahkan satu alamat atau kelompok 50 alamat, membaca baki anda, memantau tugasan fail, mencipta pautan muat turun dan mengurus webhook. Oleh itu, pembantu boleh membuat query kepada ZoomInfo melalui ZoomInfo MCP dan kemudian menyemak keputusannya melalui MCP kami, dalam satu sembang.

Mengenai harga, keputusan valid atau invalid menggunakan satu kredit, keputusan unknown adalah percuma, dan semakan semula dalam tempoh 24 jam adalah percuma. Anda mendapat 20 kredit percuma setiap hari anda menggunakan akaun anda, sehingga 600 sebulan. Kredit itu tidak pernah tamat tempoh, dan tiada kad diperlukan. Untuk panduan langkah demi langkah yang ditujukan kepada eksport, lihat halaman kami tentang pengesahan e-mel ZoomInfo.

Dua alat percuma membantu untuk rekod tunggal. Carian e-mel terbalik menunjukkan domain dan isyarat awam di sebalik sesuatu alamat. Pengesah nombor telefon menyemak sama ada talian terus daripada panggilan enrich adalah sah untuk negaranya dan menunjukkan jenis talian.

Petua untuk Membina di Atas ZoomInfo

Beberapa kebiasaan yang diambil daripada dokumentasi ZoomInfo API dapat menjimatkan kredit dan masa:

  1. Gunakan nilai carian (lookup) untuk setiap penapis berenumerasi, seperti yang dicadangkan oleh jadual ralat di atas.
  2. Susun keputusan mengikut kedudukan sebelum anda memperkaya data, menggunakan medan seperti skor ketepatan kenalan dan hasEmail.
  3. Perkaya data dalam kelompok 25, dan simpan dalam cache ID yang sudah anda miliki.
  4. Baca pengepala kuota yang berbaki dan perlahankan kadar sebelum anda mencapai had. Semak semula harga API sebelum pemuatan besar.
  5. Minta skop yang paling sempit, dan simpan rahsia klien pada pelayan.

Untuk latar belakang tentang syarikat ini, baca panduan ZoomInfo kami. Jika rakan sepasukan tidak dapat mengakses aplikasi web yang mencipta aplikasi anda, panduan log masuk ZoomInfo kami merangkumi log masuk, SSO dan pengesahan dua langkah.

Soalan Lazim

Adakah ZoomInfo mempunyai API?

ZoomInfo mempunyai API, dan dokumentasinya terdapat di docs.zoominfo.com. Versi semasa log masuk melalui aplikasi OAuth. Perkhidmatan Enterprise yang lebih lama membawa label Legacy dan sedang dihentikan secara berperingkat.

Di manakah dokumentasi API ZoomInfo?

Dokumentasi API ZoomInfo berada di docs.zoominfo.com, yang kini membuka docs.gtm.ai. Halaman Enterprise legacy kekal di api-docs.zoominfo.com, dan Chorus mempunyai laman sendiri di api-docs.chorus.ai.

Berapakah kos API ZoomInfo?

Harga API ZoomInfo bergantung pada cara anda membeli. GTM.ai menyenaraikan harga layan diri, dengan 1,000 kredit bagi setiap jenis untuk bermula dan tambah nilai $20. Harga kontrak Enterprise dinyatakan oleh pasukan jualan ZoomInfo.

Adakah API ZoomInfo percuma?

API ZoomInfo percuma untuk dimulakan di GTM.ai, dengan baki permulaan dan tanpa kad kredit. Carian dan pencarian tidak dikenakan sebarang bayaran, dan pengayaan menggunakan kredit setelah jumlah permulaan habis.

Bagaimanakah cara mendapatkan kunci API ZoomInfo?

API ZoomInfo semasa tidak mempunyai satu kunci tunggal. Anda mencipta aplikasi di Developer Portal, atau pada tab Developer di GTM.ai, dan ZoomInfo akan memberikan kelayakan kepada anda. Versi legacy menggunakan ID klien dengan kunci peribadi, atau nama pengguna dan kata laluan.

Apakah had kadar API ZoomInfo?

API ZoomInfo membenarkan lima panggilan sesaat pada Builder, 25 pada Standard dan 35 pada Scaling. Setiap pakej juga mempunyai had setiap jam dan setiap hari, dan respons 429 memberitahu anda tempoh mana yang telah anda capai.

Apakah itu ZoomInfo MCP?

ZoomInfo MCP ialah pelayan terhos yang membolehkan pembantu AI membuat pertanyaan dan mengambil rekod ZoomInfo melalui bahasa semula jadi. Ia memerlukan lesen ZoomInfo dan log masuk OAuth, dan ZoomInfo MCP mengenakan kredit yang sama seperti panggilan REST.

Adakah ZoomInfo MCP dikenakan kos tambahan?

ZoomInfo MCP tidak mempunyai harga berasingan. Alat yang hanya mencari adalah percuma, dan alat yang memperkaya atau menjalankan penyelidikan menggunakan kredit daripada baki yang sama seperti permintaan REST.

Apakah itu API ZoomInfo Chorus?

API ZoomInfo Chorus ialah antara muka REST untuk Chorus, produk risikan perbualan. Ia membaca pengguna dan interaksi, dan boleh memuat naik atau memadam rakaman. Ia menggunakan token bagi setiap pengguna, bukan aplikasi OAuth perkhidmatan utama.

Di manakah saya boleh mencari transkrip dokumentasi API ZoomInfo Chorus?

Transkrip panggilan tergolong dalam API Chorus, bukan API ZoomInfo utama. Semak kumpulan Conversations di api-docs.chorus.ai untuk medan semasa, dan dapatkan token daripada pentadbir Chorus anda sebelum anda menguji.

Bolehkah saya mendapatkan alamat e-mel daripada API ZoomInfo?

Anda boleh mendapatkan e-mel perniagaan dengan memperkaya kenalan melalui API ZoomInfo, dan entri requiredFields untuk e-mel melangkau rekod yang tidak mempunyainya. Produk Data Quality ZoomInfo sendiri tidak mengesahkan kebolehsampaian, jadi semak alamat tersebut sebelum menghantar.

Perlukah saya mengesahkan e-mel yang dikembalikan oleh ZoomInfo?

Alamat yang dikembalikan oleh ZoomInfo harus disahkan sebelum kempen, kerana orang bertukar pekerjaan antara kemas kini. Antara muka REST dan pelayan MCP BillionVerify menyemak setiap alamat dan melaporkan hasil catch-all, tidak diketahui, pakai buang dan peranan secara berasingan.

Tonton video: Cara mengesahkan nombor telefon: Pengesah Nombor Telefon percuma

Tonton video: Carian Email Songsang Percuma: Apa yang Ditunjukkan dan Tidak

Leo
LeoFounder, BillionVerify
Wawasan Pengesahan Email

Mula Mengesahkan Hari Ini

Mulakan mengesahkan email dengan BillionVerify hari ini. Dapatkan 20 kredit percuma setiap hari anda log masuk, sehingga 600 sebulan - tiada kad kredit diperlukan. Sertai beribu-ribu perniagaan yang meningkatkan ROI pemasaran email mereka dengan pengesahan email yang tepat.

Tiada kad kredit diperlukan · 100+ kredit percuma setiap hari · Hasil tidak diketahui adalah percuma

0
Kredit untuk hasil tidak diketahui
Masa nyata
Kelajuan API
$0.00014
Setiap email
600/bln
Percuma selama-lamanya