Langsung ke konten utama
Black Friday: diskon 20% untuk semua paket sampai 1 Des.Lihat promonya

ZoomInfo API: Fitur dan Cara Menggunakannya

Leo
LeoFounder, BillionVerify

Panduan API ZoomInfo: fungsi, cara kerja OAuth, grup endpoint, rate limit, harga API, server MCP ZoomInfo, dan cara memverifikasi email hasil enrichment.

ZoomInfo API: Fitur dan Cara Menggunakannya

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 referensiFungsinya
Data V1Daftar pencarian (lookup), serta catatan perusahaan, kontak, intent, berita, dan scoop
Context V1Ringkasan akun, wawasan, akun dan orang yang serupa (lookalike), serta pengaturan GTM milik Anda sendiri
GTM Studio V1Audiens, folder, kolom, dan baris, dengan satu tugas enrichment untuk setiap audiens
Marketing V1Unggahan audiens untuk ZoomInfo Marketing
Platform V1Ekspor dan catatan engagement
Agent V1Menjalankan agen AI ZoomInfo dan membaca hasil eksekusinya
Data Quality V1Mengurai, 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.

Dokumentasi API ZoomInfo: Legacy Enterprise API beserta catatan penghentiannya

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 aplikasiAuthorization Code Flow (PKCE)Client Credentials Flow
Aplikasi standar, untuk tim Anda sendiriDidukungDidukung
Aplikasi partner, untuk partner yang disetujui yang melayani banyak pelangganDidukungTidak 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 scopeYang dibuka
api:data:companyRecord perusahaan dan hierarki korporat
api:data:contactRecord kontak dan bagan organisasi
api:data:intentSinyal intent
api:data:news dan api:data:scoopsArtikel berita dan scoop
api:audience:read dan api:audience:manageMembaca atau mengelola audiens GTM Studio dan Marketing
api:data-quality:executeMenjalankan 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.

PanggilanFungsinyaBiaya
LookupMenampilkan daftar nilai filter yang diterima, seperti industri dan tingkat manajemenGratis
Search ContactsMenemukan orang berdasarkan peran, lokasi, karakteristik perusahaan, dan sinyalGratis
Search CompaniesMenemukan akun berdasarkan industri, ukuran, lokasi, dan teknologiGratis
Enrich ContactsMengembalikan profil kontak lengkap, maksimal 25 per permintaanSatu kredit untuk setiap rekaman baru
Enrich CompaniesMengembalikan firmografi, maksimal 25 per permintaanSatu kredit saat rekamannya baru
Enrich IntentMengembalikan sinyal niat membeli untuk sebuah perusahaanKredit
Account and Contact ResearchRingkasan AI yang menggabungkan konteks ZoomInfo dan CRM AndaKredit 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.

Batas laju API ZoomInfo: tabel paket dengan permintaan per detik, jam, dan hari

Tangkapan layar: artikel ZoomInfo tentang batas laju, dengan tiga tingkat paket.

PaketPer detikPer jamPer hari
Builder5 permintaan10.800129.600
Standard25 permintaan54.000648.000
Scaling35 permintaan75.600907.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.

Harga API ZoomInfo: slider kredit GTM.ai untuk pengayaan data dan pekerjaan AI

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.

ZoomInfo MCP tools: artikel Available MCP Tools yang mencantumkan setiap tool beserta biaya kreditnya

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.

ToolFungsinyaJenis kredit
Search Companies, Search ContactsMencari rekaman berdasarkan kriteriaGratis
LookupMenampilkan nilai filter yang diizinkanGratis
Find Similar Companies, Find Similar Contacts, Find Recommended ContactsDaftar lookalike dan daftar siap dihubungiGratis
Search Intent, Search ScoopsMenemukan akun berdasarkan sinyalGratis
Enrich Companies, Enrich ContactsProfil lengkap hingga 25 rekamanData massal
Enrich Intent, Enrich Scoops, Enrich NewsSinyal untuk satu perusahaanData massal
Account Research, Contact ResearchRingkasan AI untuk satu perusahaan atau orangAksi 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 kodeArtiYang harus dilakukan
400, PFAPI0006Nilai filter tidak validCari nilainya lewat lookup dan gunakan persis seperti yang tercantum
401, ZI0001Token tidak valid atau kedaluwarsaAmbil token baru atau gunakan refresh token
403, ZI0002 atau ZI0003Scope tidak ada, atau paket tidak mencakup endpoint tersebutTambahkan scope, atau hubungi account manager Anda
429, ZI0004Terlalu banyak permintaanTunggu 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:

  1. Lakukan query secara gratis dan beri peringkat pada hasilnya.
  2. Enrich hanya kontak yang akan Anda hubungi, dengan email di requiredFields.
  3. Kirim alamat yang dikembalikan ke layanan verifikasi.
  4. Pertahankan hasil yang valid, tinjau yang catch-all dan unknown, lalu buang yang invalid.
  5. 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.

Server MCP verifikasi email BillionVerify beserta perintah untuk menghubungkannya

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:

  1. Gunakan nilai lookup untuk setiap filter bertipe enumerasi, seperti yang disarankan tabel error di atas.
  2. Urutkan hasil sebelum Anda melakukan enrichment, dengan memakai kolom seperti skor akurasi kontak dan hasEmail.
  3. Lakukan enrichment dalam batch berisi 25 data, dan simpan di cache ID yang sudah Anda miliki.
  4. Baca header sisa kuota dan kurangi kecepatan sebelum Anda mencapai batas. Periksa kembali harga API sebelum melakukan pemuatan data dalam jumlah besar.
  5. 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

Leo
LeoFounder, BillionVerify
Wawasan Verifikasi Email

Mulai Verifikasi Hari Ini

Mulai verifikasi email dengan BillionVerify hari ini. Dapatkan 20 kredit gratis setiap hari Anda login, hingga 600 per bulan - tanpa memerlukan kartu kredit. Bergabunglah dengan ribuan bisnis yang meningkatkan ROI pemasaran email mereka dengan verifikasi email yang akurat.

Tanpa memerlukan kartu kredit · API real-time dan verifikasi massal · Hasil unknown gratis

0
Kredit untuk hasil unknown
Waktu nyata
Kecepatan API
$0.00014
Per email
600/bln
Gratis selamanya