API ZoomInfo memungkinkan perangkat lunak Anda sendiri mencari data perusahaan dan kontak ZoomInfo, memuat profil lengkap ke CRM, membaca sinyal pembelian, dan menjalankan riset AI. Developer dapat mengakses ZoomInfo melalui tiga cara: antarmuka REST melalui HTTPS, server MCP ZoomInfo untuk asisten AI, dan klien terminal. ZoomInfo menyatakan ketiganya berbagi satu login dan satu saldo kredit.
Panduan ini membahas apa yang ditawarkan ZoomInfo kepada developer, di mana dokumentasi API ZoomInfo berada, cara kerja autentikasi, kelompok endpoint utama, harga API, ZoomInfo MCP, dan Chorus API yang terpisah. Panduan ini diakhiri dengan cara aman untuk memeriksa alamat email hasil pengayaan data sebelum kampanye. Setiap fakta berasal dari dokumentasi dan layar harga resmi ZoomInfo, yang dibaca pada Oktober 2026. Kami tidak berafiliasi dengan ZoomInfo. BillionVerify adalah layanan verifikasi email, dan kami menulis tentang alat-alat yang menyuplai daftar penjualan.
Fakta utama (diperiksa pada Oktober 2026):
- ZoomInfo mendokumentasikan API terbarunya di docs.zoominfo.com, yang mengarah ke docs.gtm.ai. Enterprise API yang lama diberi label "Legacy" dan sedang dihentikan secara bertahap.
- API terbaru menandatangani permintaan melalui aplikasi OAuth 2.0, dan setiap panggilan dikirim ke https://api.zoominfo.com/gtm.
- Mencari data bersifat gratis. Pengayaan sebuah data menghabiskan satu kredit pada kali pertama, dan data tersebut tetap tercakup selama 12 bulan pada paket kontrak.
- GTM.ai menerbitkan harga API ZoomInfo self-serve: kredit awal gratis saat mendaftar, lalu isi ulang berbayar.
- ZoomInfo MCP berada di https://mcp.zoominfo.com/mcp dan bekerja dengan Claude, ChatGPT, Cursor, Codex, dan klien MCP lainnya.
API ZoomInfo: Jawaban Singkat
Ya. ZoomInfo menawarkan API, dan layanannya sudah banyak berubah. Tutorial lama menjelaskan layanan era Java dengan nama pengguna, kata sandi, dan JSON Web Token. Dokumentasi legacy milik ZoomInfo sendiri kini memperingatkan bahwa layanan ini "in the process of being deprecated" dan meminta developer membangun pekerjaan baru di layanan yang baru.
API ZoomInfo saat ini berada di balik situs developer GTM.ai. Anda membuat aplikasi, memilih scope, menukar kredensial Anda dengan bearer token, lalu memanggil endpoint di bawah satu base URL. Dari sana Anda dapat mengkueri data dengan filter, menarik profil lengkap untuk data yang dipilih, membaca intent, scoop, dan berita untuk akun target, menjalankan briefing AI, serta mengelola audiens GTM Studio.
Paket langganan Anda menentukan endpoint mana yang terbuka bagi Anda, dan juga menentukan harga. Ringkasan ZoomInfo menyatakannya dengan jelas: "Your subscription determines which API scopes and endpoints you can access, and rate limits apply to all authenticated requests."
Apa yang Dapat Dilakukan ZoomInfo API
Ikhtisar ZoomInfo menjelaskan tiga tugas bagi developer: membangun integrasi, menemukan perusahaan dan kontak, serta bereaksi terhadap perubahan dengan webhook. Dokumentasi menyatakan bahwa dengan permintaan REST, server MCP, atau klien terminal, Anda dapat menjangkau "100M+ companies, 500M+ professionals, and 50+ real-time buying and business signals."
Referensi tersebut mengelompokkan endpoint ke dalam beberapa keluarga. Tabel ini mencantumkannya, beserta tugas masing-masing dalam bahasa yang sederhana.
| Keluarga dalam referensi | Fungsinya |
|---|---|
| Data V1 | Daftar pencarian (lookup), serta catatan perusahaan, kontak, intent, berita, dan scoop |
| Context V1 | Ringkasan akun, wawasan, akun dan orang yang serupa (lookalike), serta pengaturan GTM milik Anda sendiri |
| GTM Studio V1 | Audiens, folder, kolom, dan baris, dengan satu tugas enrichment untuk setiap audiens |
| Marketing V1 | Unggahan audiens untuk ZoomInfo Marketing |
| Platform V1 | Ekspor dan catatan engagement |
| Agent V1 | Menjalankan agen AI ZoomInfo dan membaca hasil eksekusinya |
| Data Quality V1 | Mengurai, menormalkan, mensegmentasi, dan menilai daftar sebelum masuk ke CRM |
Data V1 adalah inti dari semuanya, dan mengikuti pola yang diulang dokumentasi di beberapa halaman. Pertama, lookup mengembalikan nilai persis yang diterima oleh filter, seperti nama industri atau tingkat manajemen. Kedua, pencarian menemukan catatan yang cocok. Ketiga, permintaan enrich mengembalikan profil lengkap untuk catatan yang Anda pilih.
Dokumentasi API ZoomInfo: Di Mana Membacanya
Ada dua tempat untuk membaca dokumentasi API ZoomInfo, dan mencampuradukkan keduanya adalah kesalahan yang paling umum. Yang pertama adalah situs developer terbaru, dengan tab Get Started, Recipes, API Reference, dan MCP. Yang kedua adalah situs Enterprise lama di api-docs.zoominfo.com, yang dipertahankan untuk integrasi yang sudah ada.

Tangkapan layar: dokumentasi API ZoomInfo versi lama. Catatan di bagian atas mengarahkan pekerjaan baru ke situs yang baru.
Situs lama ini berjudul "ZoomInfo API - Legacy". Situs ini masih menjelaskan endpoint Standard yang lebih lama (Search, Enrich, Lookup, dan Usage), endpoint Scaling (Webhooks dan Bulk), layanan WebSights, serta layanan Compliance. Situs ini juga mencakup masuk dengan PKI serta nama pengguna dan kata sandi, di mana token yang diterbitkan tetap berlaku selama satu jam. Integrasi yang dibangun berdasarkan petunjuk tersebut masih bisa terus berjalan untuk saat ini, tetapi proyek baru sebaiknya dimulai di situs yang terbaru. Tidak ada situs yang mencantumkan harga, jadi harga API ZoomInfo ada di bagian harga di bawah dan dalam kontrak Anda.
Dokumentasi terbaru juga mudah dibaca oleh mesin. File llms.txt-nya mendaftar setiap artikel, dan situs ini menyebutkan bahwa Anda dapat menambahkan .md ke alamat mana pun untuk mendapatkan Markdown. Referensinya juga menerbitkan spesifikasi OpenAPI, sehingga Anda dapat mengimpor kontraknya ke alat seperti Postman. Referensi ini memungkinkan Anda menempelkan bearer token dan mencoba panggilan sungguhan langsung dari halamannya.
Ada satu peringatan saat mencoba panggilan dari referensi tersebut. Artikel dokumentasi tentang akses uji coba memperingatkan bahwa panggilan yang dibuat dengan token dari Developer Portal "diperlakukan sebagai permintaan produksi yang sesungguhnya". Panggilan tersebut menghabiskan kredit dan dihitung terhadap batas penggunaan, jadi uji dengan batch kecil.
Cara Kerja Autentikasi ZoomInfo API
ZoomInfo API yang baru menggunakan OAuth 2.0. Dokumentasinya menyebutkan bahwa OAuth memungkinkan aplikasi mengakses ZoomInfo "tanpa membagikan kata sandi atau kredensial API-key jangka panjang." Sebelum bisa memanggil apa pun, Anda perlu membuat sebuah aplikasi. Pelanggan Enterprise melakukannya di ZoomInfo Developer Portal. Pengguna self-serve melakukannya dari tab Developer di GTM.ai. Kedua jalur ini mensyaratkan lisensi GTM.ai atau Enterprise dengan akses yang sudah diaktifkan.
Pembuatannya hanya butuh beberapa menit. Anda memasukkan nama, logo opsional, dan deskripsi, memilih metode autentikasi, menambahkan URL pengalihan (redirect) jika diperlukan, lalu memilih scope. Setelah Anda mengklik Create App, ZoomInfo menerbitkan kredensial aplikasi, yaitu ID dan secret. Dokumentasi menyarankan Anda menyimpan keduanya dengan aman dan tidak pernah menampilkannya di kode browser.
Ada dua jenis aplikasi dan dua alur OAuth:
| Jenis aplikasi | Authorization Code Flow (PKCE) | Client Credentials Flow |
|---|---|---|
| Aplikasi standar, untuk tim Anda sendiri | Didukung | Didukung |
| Aplikasi partner, untuk partner yang disetujui yang melayani banyak pelanggan | Didukung | Tidak didukung |
Pilih alurnya dengan bertanya siapa yang bertindak. Gunakan Authorization Code Flow dengan PKCE ketika aplikasi Anda memanggil ZoomInfo atas nama pengguna yang sedang masuk. ZoomInfo mewajibkan metode challenge S256, dan alur ini mengembalikan access token beserta refresh token. Gunakan Client Credentials Flow untuk layanan backend, tugas terjadwal, dan sinkronisasi. Karena tidak ada orang yang masuk, Anda harus memilih seorang integration user, dan ZoomInfo mengaitkan setiap permintaan dengan pengguna tersebut.
Permintaan token untuk pekerjaan server-ke-server hanyalah satu POST. Basic authentication adalah cara yang direkomendasikan untuk mengirim kredensial.
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 berisi access_token, nilai expires_in dalam detik, daftar scope, dan token_type berupa Bearer. Contoh di dokumentasi menunjukkan expires_in sebesar 1000, jadi simpan token dalam cache dan perbarui berdasarkan timer, alih-alih meminta token baru pada setiap panggilan. Setiap permintaan berikutnya mengirim Authorization: Bearer <access_token>.
Scope OAuth ZoomInfo
Scope menentukan apa saja yang boleh diakses sebuah token, dan sebaiknya Anda hanya meminta apa yang dibutuhkan aplikasi. Scope untuk record adalah titik awal bagi sebagian besar tim.
| Nilai scope | Yang dibuka |
|---|---|
| api:data:company | Record perusahaan dan hierarki korporat |
| api:data:contact | Record kontak dan bagan organisasi |
| api:data:intent | Sinyal intent |
| api:data:news dan api:data:scoops | Artikel berita dan scoop |
| api:audience:read dan api:audience:manage | Membaca atau mengelola audiens GTM Studio dan Marketing |
| api:data-quality:execute | Menjalankan pipeline prepare Data Quality |
Panggilan yang membutuhkan scope yang tidak dimiliki token Anda akan gagal dengan kode 403 dan kode ZI0002. ZI0003 berbeda: artinya paket Anda tidak mencakup endpoint tersebut. Masalah pertama diperbaiki di Developer Portal. Masalah kedua memerlukan account manager ZoomInfo Anda.
Kategori Endpoint Utama
Sebagian besar integrasi menyentuh empat jenis endpoint, dan biayanya berbeda di antara keduanya. Panggilan lookup dan pencarian tidak pernah menghabiskan kredit. Enrichment justru menghabiskannya. Tabel ini mencakup panggilan yang paling penting untuk dipahami lebih dulu.
| Panggilan | Fungsinya | Biaya |
|---|---|---|
| Lookup | Menampilkan daftar nilai filter yang diterima, seperti industri dan tingkat manajemen | Gratis |
| Search Contacts | Menemukan orang berdasarkan peran, lokasi, karakteristik perusahaan, dan sinyal | Gratis |
| Search Companies | Menemukan akun berdasarkan industri, ukuran, lokasi, dan teknologi | Gratis |
| Enrich Contacts | Mengembalikan profil kontak lengkap, maksimal 25 per permintaan | Satu kredit untuk setiap rekaman baru |
| Enrich Companies | Mengembalikan firmografi, maksimal 25 per permintaan | Satu kredit saat rekamannya baru |
| Enrich Intent | Mengembalikan sinyal niat membeli untuk sebuah perusahaan | Kredit |
| Account and Contact Research | Ringkasan AI yang menggabungkan konteks ZoomInfo dan CRM Anda | Kredit AI |
Daftar filternya panjang. Artikel "Companies & Contacts" dari ZoomInfo menyebutkan bahwa sisi perusahaan mendukung lebih dari 40 grup filter dan sisi kontak lebih dari 25. Filter perusahaan mencakup identitas, firmografi, ukuran, lokasi, teknologi, struktur korporasi, dan penanda kualitas. Filter kontak mencakup nama, jabatan, fungsi pekerjaan, tingkat manajemen, lokasi, dan skor akurasi kontak yang dapat Anda gunakan sebagai batas minimum.
Beberapa konvensi berikut membantu sebelum Anda menulis kode. Permintaan dan respons menggunakan tipe konten JSON:API, application/vnd.api+json. Pencarian membagi hasil ke dalam halaman dengan page[number] dan page[size]. Permintaan enrich memerlukan daftar outputFields, dan daftar requiredFields akan membuang rekaman yang tidak memiliki field kunci seperti email. Setiap hasil enrich membawa matchStatus, misalnya FULL_MATCH atau NO_MATCH, dan LIMIT_EXCEEDED berarti kredit akun Anda sudah habis.
Batas Laju dan Throughput
Batas ini melindungi layanan dan menentukan seberapa cepat Anda dapat memuat sebuah daftar. ZoomInfo mengaitkan batas per detik dengan paket Anda, dan paket tersebut merupakan bagian dari harga API Anda.

Tangkapan layar: artikel ZoomInfo tentang batas laju, dengan tiga tingkat paket.
| Paket | Per detik | Per jam | Per hari |
|---|---|---|---|
| Builder | 5 permintaan | 10.800 | 129.600 |
| Standard | 25 permintaan | 54.000 | 648.000 |
| Scaling | 35 permintaan | 75.600 | 907.200 |
Setiap permintaan diperiksa terhadap ketiga jendela sekaligus. Jika salah satu jendela kosong, Anda akan menerima 429. ZoomInfo menyatakan bahwa permintaan yang ditolak tidak menggunakan kuota, sehingga mencoba lagi setelah terkena batas tidak menghabiskan sisa kuota. Artikel kredit tersendiri juga mencantumkan add-on premium sebesar 30 dan 35 per detik di atas default 25.
Respons membawa header yang menunjukkan posisi Anda saat ini, seperti X-RateLimit-Limit-Second dan X-RateLimit-Remaining-Hour. Respons 429 menambahkan Retry-After, header bucket yang ditolak, dan stempel waktu reset. Dua header lama tanpa akhiran jendela ditandai sebagai deprecated, dengan penghapusan dijadwalkan pada 2027-01-01, jadi pindahkan kode apa pun yang membacanya.
Batas ini berlaku untuk permintaan, bukan untuk rekaman. Satu panggilan pencarian mengembalikan hingga 25 rekaman melalui REST tetapi hanya 10 melalui MCP atau CLI, sehingga batas Standard memindahkan 625 rekaman per detik di satu jalur dan 250 di jalur lainnya. Untuk percobaan ulang, gunakan exponential backoff singkat setelah terkena batas per detik, dan jeda hingga Retry-After setelah terkena batas per jam atau per hari. Menaikkan batas merupakan pembicaraan soal harga dengan tim akun Anda, karena batas yang lebih tinggi hadir sebagai add-on atau paket yang lebih besar.
Harga API ZoomInfo dan Kredit
Tim-tim bertanya tentang harga API ZoomInfo lebih sering daripada hampir semua hal lain, dan jawabannya terdiri dari dua bagian. Harga Enterprise ditawarkan sebagai volume tahunan melalui account manager, dan tidak ada daftar harga yang dipublikasikan. Harga API self-serve bersifat publik, karena GTM.ai mempublikasikannya.

Tangkapan layar: harga GTM.ai dengan dua slider kreditnya.
Layar harga GTM.ai menyatakan bahwa akses platform selalu disertakan: akses MCP, akses REST, dan akses CLI, dengan panggilan lookup, search, dan find-similar gratis. Paket gratis dibatasi lima permintaan per detik dan lima aplikasi. Akun baru mendapatkan 1.000 kredit untuk masing-masing jenis tanpa kartu kredit. Setelah itu, harga bersifat bayar sesuai pemakaian, dengan top-up mulai dari $20, tanpa kontrak dan tanpa biaya per seat.
Ada dua jenis kredit:
- Kredit data membayar pengayaan data. Satu kredit mencakup satu catatan perusahaan, kontak, atau intent yang diperkaya atau diekspor. Slider menunjukkan $0,38 per kredit pada pengaturan default 5.000 kredit, yang tercantum sebagai $1.900 sebelum diskon terbatas 70% untuk pembelian pertama.
- Kredit AI membayar riset dan tindakan AI lainnya. Layar mencantumkan tarif tetap $0,05 per kredit, dan 2.000 kredit berharga $100, yang disetarakan dengan sekitar 200 panggilan riset akun atau kontak.
Model harga yang sama berlaku untuk setiap permukaan. Permintaan REST, CLI, dan ZoomInfo MCP semuanya menarik dari saldo kredit bersama, dan pencarian tetap gratis di masing-masing. Harga layanan Data Quality mengikuti gagasan yang sama: mengurai, memvalidasi, dan menormalisasi email tidak dikenai biaya, sedangkan segment run, score run, verifikasi alamat, dan tipe saluran telepon menghabiskan kredit. Data Quality masih dalam versi beta, dan dokumentasi menyebutkan bahwa penggunaan beta ditagih dengan tarif penuh tanpa jatah pengantar.
Aturan kredit lebih penting daripada harga yang tertera dalam perbandingan harga API ZoomInfo apa pun. Dokumentasi kredit ZoomInfo menyatakan bahwa catatan yang diperkaya untuk pertama kalinya dalam periode bergulir 12 bulan membutuhkan satu kredit, lalu catatan itu ditempatkan dalam status Under Management selama setahun. Selama masih berstatus under management, memperkaya ulang catatan tersebut tidak dikenai biaya tambahan, meskipun setiap permintaan tetap dihitung terhadap batas catatan Anda. FAQ harga menambahkan bahwa jaminan ini merupakan manfaat Enterprise yang tidak berlaku untuk paket gratis, dan bahwa setiap kredit kedaluwarsa 12 bulan setelah diberikan.
Karena lookup dan pencarian gratis, alur kerja termurah dalam model harga ini adalah melakukan kueri seluas mungkin, memberi peringkat pada hasilnya, dan hanya memperkaya yang akan Anda gunakan. Panduan agen ZoomInfo menyatakan hal yang sama, dengan menyarankan agen untuk "avoid enrichment loops" dan meminta konfirmasi sebelum memperkaya 25 kontak, karena satu batch dapat menggunakan hingga 25 kredit.
Untuk layanan lama (legacy), harga API tercantum dalam kontrak Anda. Endpoint Usage dan header respons-nya melaporkan batas permintaan, batas catatan, dan batas catatan unik selama masa kontrak. Tanyakan angka-angka tersebut kepada tim akun Anda, karena dokumentasi publik hanya menampilkan nilai contoh.
ZoomInfo MCP: Menghubungkan Asisten AI
ZoomInfo MCP adalah server Model Context Protocol terkelola yang memungkinkan asisten AI memanggil ZoomInfo secara langsung. Lisensi ZoomInfo diperlukan, dan paket, batas, serta kredit Anda semuanya berlaku untuk penggunaan MCP, sehingga tidak ada harga ZoomInfo MCP yang terpisah. Server ini membutuhkan klien yang mendukung Streamable HTTP dan OAuth, ditambah browser untuk proses masuk pertama kali.
Dokumentasi ZoomInfo MCP mencakup banyak klien. Di Claude Code, Anda dapat memasang plugin resmi dengan claude plugin install zoominfo@claude-plugins-official, atau menambahkan server secara manual dengan claude mcp add --transport http zoominfo https://mcp.zoominfo.com/mcp. Lalu jalankan /mcp untuk masuk. Codex memiliki jalur plugin dan jalur kustom. Cursor dan VS Code cukup memakai entri JSON singkat berisi alamat server. Claude, ChatGPT, dan Perplexity mencantumkan ZoomInfo sebagai konektor bawaan, sehingga Anda menambahkannya dari menu konektor dan masuk dengan kredensial ZoomInfo Anda.
Ada satu aturan yang menonjol. ZoomInfo "melarang data yang diakses melalui MCP digunakan untuk pelatihan model AI," dan meminta Anda mematikan pelatihan model di akun AI Anda sebelum terhubung.

Tangkapan layar: daftar tool ZoomInfo MCP beserta jenis kreditnya.
Tool terbagi menjadi dua jenis. Tool data menampilkan rekaman ke asisten Anda, yang merangkainya langkah demi langkah. Agen konteks menjalankan sub-agen yang memadukan rekaman ZoomInfo dengan CRM dan riwayat panggilan Anda.
| Tool | Fungsinya | Jenis kredit |
|---|---|---|
| Search Companies, Search Contacts | Mencari rekaman berdasarkan kriteria | Gratis |
| Lookup | Menampilkan nilai filter yang diizinkan | Gratis |
| Find Similar Companies, Find Similar Contacts, Find Recommended Contacts | Daftar lookalike dan daftar siap dihubungi | Gratis |
| Search Intent, Search Scoops | Menemukan akun berdasarkan sinyal | Gratis |
| Enrich Companies, Enrich Contacts | Profil lengkap hingga 25 rekaman | Data massal |
| Enrich Intent, Enrich Scoops, Enrich News | Sinyal untuk satu perusahaan | Data massal |
| Account Research, Contact Research | Ringkasan AI untuk satu perusahaan atau orang | Aksi AI |
Prompt seperti "cari VP Sales di perusahaan fintech" tidak memakan biaya, karena hanya melakukan pencarian. Prompt seperti "perkaya 50 kontak ini dan kirim ke Salesforce" menghabiskan kredit. FAQ harga GTM.ai membuat pembagian yang sama: di ZoomInfo MCP, tool yang dipanggil menentukan biayanya.
ZoomInfo juga menyediakan klien command-line di backend yang sama dengan ZoomInfo MCP, dengan proses masuk dan kredit yang sama. Anda memasangnya dengan Homebrew (brew install zoominfo/gtm-ai/gtm-ai-cli) atau npm, menjalankan gtm auth login, lalu memanggil perintah seperti gtm companies search dan gtm contacts enrich. Keluarannya dapat berupa JSON, CSV, YAML, atau tabel.
Contoh Kasus: Cari, Lalu Perkaya
Dokumentasi ZoomInfo API menyertakan tutorial yang mencari Marketing Director di perusahaan perangkat lunak di California. Tutorial ini memakai tiga panggilan secara berurutan: lookup, search, dan enrich. Perintah di bawah mengikuti nama field dalam tutorial tersebut, jadi ganti nilai contohnya dengan nilai Anda sendiri.
Pertama, pencarian. Pencarian ini tidak dikenai biaya dan hanya mengembalikan petunjuk kecocokan, bukan alamat email.
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 berisi daftar orang dengan field seperti firstName, jobTitle, contactAccuracyScore, dan boolean seperti hasEmail, ditambah id untuk setiap orang. Kedua, perkaya hanya ID yang Anda inginkan, maksimal 25 per 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 menyertakan matchStatus. FULL_MATCH kembali dengan field yang Anda minta. NO_MATCH kembali dengan atribut kosong. Referensi ZoomInfo menyatakan bahwa ketika gagal menemukan data atau mengembalikan error, tidak ada kredit yang dikenakan.
Dua kebiasaan ini menjaga biaya tetap rendah. Cari nilai lewat lookup sebelum melakukan search, karena industri atau jabatan berupa teks bebas yang tidak dikenali lookup akan mengembalikan 400 dengan kode PFAPI0006. Dan simpan ID yang sudah diperkaya, karena ZoomInfo menyarankan untuk men-cache-nya selama jendela Under Management.
Error Umum ZoomInfo API
Dokumentasi mencantumkan setiap kode error. Empat error berikut mencakup sebagian besar kegagalan.
| Status dan kode | Arti | Yang harus dilakukan |
|---|---|---|
| 400, PFAPI0006 | Nilai filter tidak valid | Cari nilainya lewat lookup dan gunakan persis seperti yang tercantum |
| 401, ZI0001 | Token tidak valid atau kedaluwarsa | Ambil token baru atau gunakan refresh token |
| 403, ZI0002 atau ZI0003 | Scope tidak ada, atau paket tidak mencakup endpoint tersebut | Tambahkan scope, atau hubungi account manager Anda |
| 429, ZI0004 | Terlalu banyak permintaan | Tunggu sejenak, lalu coba lagi setelah jeda Retry-After |
Error server berbeda. Error 500 layak dicoba ulang setelah jeda, dan error 504 berarti sebaiknya gunakan permintaan yang lebih kecil lain kali. Artikel kredit menyebutkan bahwa 400, 401, dan 403 tidak boleh dicoba ulang sebelum penyebabnya diperbaiki.
API ZoomInfo Chorus
Chorus adalah produk ZoomInfo terpisah untuk perekaman panggilan dan intelijen percakapan, dan memiliki antarmukanya sendiri. API ZoomInfo Chorus berada di situs yang berbeda dari halaman-halaman di atas, yaitu di api-docs.chorus.ai, dan tidak menggunakan model aplikasi OAuth. Dokumentasi API Chorus mencakup pengguna, engagement, dan rekaman.
Pengantarnya menyebut API Chorus sebagai REST API yang dapat mengambil data tentang pengguna Anda, mengambil data tentang engagement Anda (rapat dan panggilan dialer), mengunggah rekaman baru, dan menghapus rekaman. Autentikasi menggunakan token. Setiap pengguna Chorus dapat membuatnya di Personal Settings, jika perannya mengizinkan, dan token tersebut dimasukkan ke header Authorization. Rekaman yang ditandai privat tidak dikembalikan, dan pengaturan kontrol akses Chorus Anda berlaku untuk setiap permintaan.
Transkrip Dokumentasi API ZoomInfo Chorus
Pertanyaan yang paling umum adalah tentang teks panggilan: kata-kata yang diucapkan dalam panggilan yang direkam. Menu di situs Chorus mencantumkan Conversations, Engagement filter, dan Emails di antara grupnya, jadi buka Conversations untuk melihat daftar kolom terbaru. Pengantar yang kami baca tidak menyebutkan endpoint transkrip. Panduan Zoom tentang memindahkan rekaman Chorus ke Zoom Revenue Accelerator menunjukkan respons percakapan yang menyimpan transkrip sebagai ucapan (utterances) di dalam objek rekaman.
Jika Anda membutuhkan kedua jenis catatan tersebut, rencanakan dua kredensial: aplikasi OAuth untuk layanan utama dan token per pengguna untuk Chorus. Keduanya tidak berbagi batas atau kredit. Untuk teks panggilan, mulailah dari situs Chorus, bukan docs.gtm.ai. Setiap endpoint Chorus memerlukan token Chorus, jadi mintalah akses kepada admin Chorus Anda terlebih dahulu. Halaman-halaman yang kami baca tidak mencantumkan harga API Chorus publik, jadi tanyakan juga biayanya kepada admin Anda.
Verifikasi Email dari ZoomInfo API Sebelum Anda Mengirim
Panggilan enrich memberi Anda sebuah alamat email. Panggilan itu tidak memberi tahu apakah kotak surat tersebut akan menerima pesan Anda hari ini. ZoomInfo menyatakannya secara langsung dalam dokumentasi Data Quality-nya. Untuk email, produk tersebut hanya mendukung parse, validate, dan normalize, dan teksnya berbunyi: "there is no email verification or bounce checking." Dokumentasi itu menambahkan bahwa validasinya bersifat struktural. Validasi hanya memastikan sebuah alamat memiliki @ dan domain, bukan bahwa alamat tersebut akan terhindar dari bounce.
Celah itulah tempat langkah verifikasi seharusnya berada. Alur sederhananya seperti ini:
- Lakukan query secara gratis dan beri peringkat pada hasilnya.
- Enrich hanya kontak yang akan Anda hubungi, dengan email di requiredFields.
- Kirim alamat yang dikembalikan ke layanan verifikasi.
- Pertahankan hasil yang valid, tinjau yang catch-all dan unknown, lalu buang yang invalid.
- Muat daftar yang sudah bersih ke CRM atau sequencer Anda.
BillionVerify menangani langkah ketiga dengan antarmuka REST dan server MCP yang di-hosting. Semua yang tertulis di bawah ini berasal dari dokumentasi kami di billionverify.com/docs. URL dasarnya adalah https://api.billionverify.com/v1, dan kunci Anda dimasukkan ke header BV-API-KEY. Satu permintaan memeriksa 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, beserta penanda untuk alamat disposable, role, dan catch-all. Panggilan bulk menerima hingga 50 alamat sekaligus. Untuk ekspor besar, unggah file CSV, TXT, atau XLSX, pantau job hingga selesai, lalu unduh hasilnya. Webhook dapat memberi tahu sistem Anda saat job file selesai.

Tangkapan layar: ringkasan server MCP BillionVerify, beserta perintah untuk menambahkannya ke Claude Code.
Jika tim Anda sudah bekerja melalui asisten, pemeriksaan yang sama dapat dijalankan dari MCP. Server jarak jauh BillionVerify di https://mcp.billionverify.com/mcp masuk menggunakan OAuth. Tool-nya dapat memverifikasi satu alamat atau satu batch berisi 50 alamat, membaca saldo Anda, memantau job file, membuat tautan unduhan, dan mengelola webhook. Dengan demikian, asisten dapat melakukan query ke ZoomInfo melalui ZoomInfo MCP, lalu memeriksa hasilnya melalui layanan kami, dalam satu percakapan.
Soal harga, hasil valid atau invalid memakai satu kredit, hasil unknown gratis, dan pemeriksaan ulang dalam 24 jam juga gratis. Anda mendapat 20 kredit gratis setiap hari saat menggunakan akun Anda, hingga 600 per bulan. Kredit tersebut tidak pernah kedaluwarsa, dan tidak perlu kartu. Untuk panduan yang ditujukan bagi ekspor, lihat halaman kami tentang verifikasi email ZoomInfo.
Dua tool gratis membantu untuk rekaman tunggal. Pencarian email terbalik menunjukkan domain dan sinyal publik di balik sebuah alamat. Validator nomor telepon memeriksa apakah nomor langsung dari panggilan enrich valid untuk negaranya dan menampilkan jenis saluran.
Tips untuk Membangun Aplikasi dengan ZoomInfo
Beberapa kebiasaan yang diambil dari dokumentasi ZoomInfo API ini bisa menghemat kredit dan waktu:
- Gunakan nilai lookup untuk setiap filter bertipe enumerasi, seperti yang disarankan tabel error di atas.
- Urutkan hasil sebelum Anda melakukan enrichment, dengan memakai kolom seperti skor akurasi kontak dan hasEmail.
- Lakukan enrichment dalam batch berisi 25 data, dan simpan di cache ID yang sudah Anda miliki.
- Baca header sisa kuota dan kurangi kecepatan sebelum Anda mencapai batas. Periksa kembali harga API sebelum melakukan pemuatan data dalam jumlah besar.
- Minta scope yang paling sempit, dan simpan client secret di server.
Untuk latar belakang perusahaannya, baca panduan ZoomInfo kami. Jika rekan tim tidak dapat mengakses aplikasi web yang membuat aplikasi Anda, panduan login ZoomInfo kami membahas proses masuk, SSO, dan verifikasi dua langkah.
FAQ
Apakah ZoomInfo memiliki API?
ZoomInfo memiliki API, dan dokumentasinya ada di docs.zoominfo.com. Versi terbaru masuk melalui aplikasi OAuth. Layanan Enterprise yang lebih lama berlabel Legacy dan sedang dipensiunkan.
Di mana dokumentasi API ZoomInfo?
Dokumentasi API ZoomInfo ada di docs.zoominfo.com, yang kini diarahkan ke docs.gtm.ai. Halaman Enterprise legacy masih tersedia di api-docs.zoominfo.com, dan Chorus memiliki situsnya sendiri di api-docs.chorus.ai.
Berapa biaya API ZoomInfo?
Harga API ZoomInfo bergantung pada cara Anda membelinya. GTM.ai mencantumkan harga swalayan, dengan 1.000 kredit untuk setiap jenis di awal dan isi ulang seharga $20. Harga kontrak Enterprise ditawarkan oleh tim penjualan ZoomInfo.
Apakah API ZoomInfo gratis?
API ZoomInfo gratis untuk memulai di GTM.ai, dengan saldo awal dan tanpa kartu kredit. Pencarian dan lookup tidak dikenai biaya, dan enrichment menggunakan kredit setelah jumlah awal habis.
Bagaimana cara mendapatkan kunci API ZoomInfo?
API ZoomInfo versi terbaru tidak memiliki satu kunci tunggal. Anda membuat aplikasi di Developer Portal, atau di tab Developer pada GTM.ai, lalu ZoomInfo memberikan kredensial. Versi legacy menggunakan client ID dengan kunci privat, atau nama pengguna dan kata sandi.
Berapa batas laju (rate limit) API ZoomInfo?
API ZoomInfo mengizinkan lima panggilan per detik pada Builder, 25 pada Standard, dan 35 pada Scaling. Setiap paket juga memiliki batas per jam dan per hari, dan respons 429 memberi tahu Anda jendela waktu mana yang terlampaui.
Apa itu ZoomInfo MCP?
ZoomInfo MCP adalah server terhosting yang memungkinkan asisten AI menanyakan dan menarik data ZoomInfo melalui bahasa alami. Layanan ini membutuhkan lisensi ZoomInfo dan login OAuth, dan ZoomInfo MCP mengenakan kredit yang sama dengan panggilan REST.
Apakah ZoomInfo MCP dikenai biaya tambahan?
ZoomInfo MCP tidak memiliki harga terpisah. Alat yang hanya melakukan pencarian gratis, sedangkan alat yang melakukan enrichment atau riset menggunakan kredit dari saldo yang sama dengan permintaan REST.
Apa itu ZoomInfo Chorus API?
ZoomInfo Chorus API adalah antarmuka REST untuk Chorus, produk conversation intelligence. API ini membaca pengguna dan engagement, serta dapat mengunggah atau menghapus rekaman. API ini menggunakan token per pengguna, bukan aplikasi OAuth seperti layanan utama.
Di mana saya bisa menemukan transkrip dokumentasi ZoomInfo Chorus API?
Transkrip panggilan termasuk dalam Chorus API, bukan API ZoomInfo utama. Periksa grup Conversations di api-docs.chorus.ai untuk melihat kolom terbaru, dan minta token dari admin Chorus Anda sebelum melakukan pengujian.
Bisakah saya mendapatkan alamat email dari API ZoomInfo?
Anda bisa mendapatkan email bisnis dengan melakukan enrichment pada kontak melalui API ZoomInfo, dan entri requiredFields untuk email akan melewati data yang tidak memilikinya. Produk Data Quality milik ZoomInfo sendiri tidak memverifikasi kemampuan penerimaan email, jadi periksa alamatnya sebelum mengirim.
Haruskah saya memverifikasi email yang dikembalikan ZoomInfo?
Alamat yang dikembalikan ZoomInfo sebaiknya diverifikasi sebelum kampanye, karena orang berganti pekerjaan di sela pembaruan data. REST interface dan server MCP milik BillionVerify memeriksa setiap alamat dan melaporkan hasil catch-all, unknown, disposable, dan role secara terpisah.
Tonton video: Cara memvalidasi nomor telepon: validator nomor telepon gratis
Tonton video: Pencarian Email Terbalik Gratis: Yang Ditampilkan dan Tidak
