API Apollo.io memungkinkan kode Anda sendiri mencari orang, memperkaya catatan, dan mengelola alur kerja penjualan. Anda memanggilnya melalui HTTPS dengan kunci API Apollo.io. Anda juga dapat melewati kunci tersebut dan membiarkan klien AI mengakses data yang sama melalui server MCP Apollo.io. Kedua jalur ini menggunakan kredit paket Anda dan mengikuti batasan paket Anda.
Panduan ini membahas API Apollo.io dari klik pertama hingga panggilan pertama. Panduan ini menunjukkan cara membuat kunci dan tempat menemukannya. Panduan ini mencakup dokumentasi API Apollo.io, pemeriksaan kesehatan, pencarian orang, pengayaan, batas laju, dan biaya kredit. Panduan ini diakhiri dengan server MCP resmi untuk Apollo.io serta rutinitas untuk memeriksa alamat yang dikembalikan API. Semuanya berasal dari dokumentasi developer resmi di docs.apollo.io, yang dibaca pada Oktober 2026. Apollo.io menandai beberapa halaman sebagai baru diperbarui, jadi konfirmasikan detailnya pada hari Anda mulai membangun.
Kami tidak berafiliasi dengan Apollo.io. BillionVerify adalah layanan verifikasi email. Untuk gambaran platform yang lebih luas, baca panduan Apollo.io kami.
Fakta utama (diperiksa Oktober 2026):
- Setiap tingkatan, termasuk gratis, menyediakan akses tertentu ke API. Akun gratis memerlukan email kerja untuk endpoint tertentu.
- API Apollo.io mengirimkan kunci di header
x-api-key, dan URL dasarnya adalahhttps://api.apollo.io/api/v1. - Kunci API Apollo.io dengan cakupan hanya dapat mengakses endpoint yang Anda centang. Kunci master dapat mengakses semuanya.
- Sebagian besar endpoint menerima 200 panggilan setiap menit pada tingkatan berbayar, dibandingkan 50 pada tingkatan gratis.
- Server MCP Apollo.io berada di
https://mcp.apollo.io/mcpdan masuk menggunakan OAuth.
Apa yang Dilakukan API Apollo.io
Apollo.io menjelaskan API-nya sebagai cara untuk mencari, memperkaya, membuat, dan mengelola data secara terprogram. Di baliknya terdapat database berisi lebih dari 240 juta kontak dan 30 juta perusahaan. Dokumentasinya membagi pekerjaan tersebut menjadi tiga tugas:
- Membangun integrasi. Hubungkan produk Anda ke data Apollo.io, buat akun, dan jalankan rangkaian aktivitas.
- Memperkaya data. Lengkapi data orang dan perusahaan satu per satu atau secara massal.
- Menemukan orang. Cari berdasarkan jabatan, lokasi, tingkat senioritas, dan banyak filter lainnya.
Paket Anda menentukan endpoint mana yang dapat digunakan, seberapa cepat Anda dapat memanggilnya, dan biaya setiap pemanggilan. Apollo.io juga menyatakan bahwa alat-alatnya tidak dapat melakukan sesuatu yang tidak dapat Anda lakukan di aplikasinya. Jika akun Anda tidak memiliki suatu fitur, API tidak akan membukanya.
Paket mana yang menyertakan API?
FAQ pengembang menyatakan bahwa setiap tingkatan memiliki akses dasar. Fungsi yang lebih canggih hanya tersedia pada tingkatan tertentu. Panduan harga Apollo.io kami mencantumkan berbagai tingkatan dan kumpulan kreditnya.
Ada satu pengecualian untuk akun gratis. Beberapa endpoint pencarian orang, pengayaan, dan data memerlukan akun yang terdaftar dengan alamat email kantor. Setiap halaman endpoint yang terdampak menyebutkan hal ini. Akun berbayar tidak terdampak.
Untuk siapa API Apollo.io ditujukan?
Tiga kelompok paling sering menggunakannya:
- Tim Sales dan RevOps yang ingin memasukkan data yang telah diperkaya ke dalam CRM atau gudang data.
- Pengembang di perusahaan perangkat lunak yang menyematkan data Apollo.io dalam produk mereka sendiri.
- Mitra yang membangun integrasi marketplace. Mereka masuk menggunakan OAuth 2.0, bukan kunci.
Apollo.io menambahkan catatan lisensi. Membagikan, mengekspos, atau menjual kembali datanya kepada orang yang bukan pengguna Apollo.io memerlukan kontrak khusus.
Dokumentasi API Apollo.io: Di Mana Semuanya Berada
Dokumentasi API Apollo.io tersedia di docs.apollo.io. Bilah atas membaginya menjadi Mulai, API, MCP, CLI, OpenAPI, dan Changelog. Bagian API memiliki satu halaman untuk setiap endpoint.

Tangkapan layar: halaman People API Search di dokumentasi developer Apollo.io, dari panduan Apollo.io untuk menguji sebuah kunci.
Setiap halaman endpoint mengikuti pola yang sama. Kotak "Informasi penting endpoint" di bagian atas mencantumkan jalur akses utama, cakupan OAuth, siapa yang dapat menggunakannya, dan berapa banyak kredit yang diperlukan. Di bawahnya terdapat parameter. Di sisi kanan, Anda mendapatkan pemilih bahasa, kolom kredensial, permintaan cURL, dan contoh respons.
Anda dapat menguji secara langsung dari halaman tersebut. Tempelkan kunci Anda ke kolom header, isi parameter yang wajib, lalu tekan Coba. 200 berarti panggilan berhasil. Bahkan tanpa kunci, Anda dapat membuka setiap contoh respons untuk melihat skemanya.
File OpenAPI
Apollo.io menerbitkan seluruh API sebagai satu file OpenAPI 3 di https://docs.apollo.io/openapi/apollo-rest-api.json. File tersebut dibuat ulang setiap kali dokumentasi berubah. Muat file ini ke Postman atau klien API lainnya, dan setiap endpoint akan muncul bersama parameternya. Anda juga dapat memasukkannya ke generator kode untuk membuat klien bertipe dalam bahasa Anda sendiri.
Di Postman, simpan kunci di otorisasi API Key yang telah dikonfigurasi sebelumnya dan tetapkan variabel apiKey. Dokumentasi memperingatkan bahwa menempelkan kunci sebagai token Bearer akan menghasilkan 401. Token Bearer ditujukan untuk mitra OAuth.
Indeks yang dapat dibaca mesin
Dokumentasi tersebut juga menerbitkan indeks teks biasa di docs.apollo.io/llms.txt. Indeks ini mencantumkan setiap halaman sebagai tautan Markdown. Alat coding AI dapat membacanya untuk menemukan halaman endpoint yang tepat tanpa menjelajahi situs.
Cara Mendapatkan Kunci API Apollo.io
Kunci API Apollo.io dibuat di dalam aplikasi, bukan di situs dokumentasi. Jalurnya adalah Settings, lalu Integrations, kemudian API Keys. Hanya admin yang dapat melakukannya, begitu juga pengguna yang profil izinnya mencakup kunci.
Berikut cara mendapatkan akses kunci API Apollo.io langkah demi langkah:
- Buka Apollo.io dan klik Settings > Integrations > API Keys. Dasbor developer di developer.apollo.io menampilkan halaman yang sama.
- Klik Create new key.
- Masukkan nama dan deskripsi.
- Centang setiap endpoint yang boleh dipanggil oleh kunci tersebut, atau aktifkan Set as master key.
- Klik Create API key.
- Klik Copy lalu tempelkan kunci di tempat yang aman.

Tangkapan layar: dialog Create new API key di portal developer Apollo.io, dari dokumentasi Apollo.io.
Apollo.io menampilkan kunci lengkap di bagian akhir. Salin saat itu juga. Jika Anda kehilangannya, buat ulang dari dasbor.
Di mana menemukan kunci API Apollo.io yang sudah ada
Jika Anda perlu menemukan kunci API Apollo.io yang dibuat sebelumnya, kembali ke dasbor developer dan buka API keys. Setiap kunci yang Anda buat ada dalam daftar tersebut. Bilah sisi portal juga berisi halaman Quick Start, Usage, dan Subscription. Bilah sisi yang sama memiliki halaman OAuth Registration untuk mitra.
Apollo.io memungkinkan Anda melakukan dua hal dengan kunci yang sudah ada. Regenerate memberikan rahasia baru dan menyalinnya. Delete menghapus kunci secara permanen. Anggap keduanya sebagai tindakan satu arah, karena setiap skrip yang menggunakan kunci lama akan berhenti berfungsi.
Kunci master atau kunci dengan cakupan?
Pilihan ini lebih penting daripada pilihan lainnya saat Anda membuat kunci API Apollo.io.
| Jenis | Yang dapat diakses | Gunakan untuk |
|---|---|---|
| Kunci dengan cakupan (default) | Hanya endpoint yang Anda centang | Sebagian besar integrasi |
| Kunci master | Setiap endpoint | Endpoint yang memerlukannya, dan server MCP melalui kunci |
Kunci dengan cakupan yang memanggil endpoint yang tidak Anda centang akan mendapatkan 403. Beberapa endpoint, seperti daftar pengguna workspace, hanya berfungsi dengan kunci master. Apollo.io meminta Anda memperlakukan kunci master seperti kata sandi. Kunci ini dapat melakukan tindakan API apa pun yang diizinkan oleh akun Anda.
Sebagai pengguna mana sebuah kunci bertindak?
Kunci API Apollo.io mengidentifikasi workspace Anda, bukan seseorang. Apollo.io tidak dapat mengetahui rekan satu tim mana yang menggunakannya. Setiap permintaan bertindak sebagai admin aktif dengan masa keanggotaan terlama di workspace tersebut, dan pengguna itu memiliki apa pun yang dibuat oleh panggilan tersebut. Untuk mengetahui siapa pengguna itu, panggil endpoint profil pengguna saat ini, yang tidak memerlukan kredit.
Hal ini mengejutkan tim yang membuat kunci dari login dengan izin terbatas. Kunci tersebut tidak membatasi apa yang dapat diakses oleh kode.
Pemeriksaan Kesehatan API Apollo.io
Cara tercepat untuk menguji key baru adalah dengan satu health call. Ini adalah satu permintaan GET ke auth/health, dan tidak ada kredit yang digunakan.
curl --request GET \ --url 'https://api.apollo.io/api/v1/auth/health' \ --header 'Content-Type: application/json' \ --header 'x-api-key: YOUR_API_KEY'
Jika semuanya telah disiapkan dengan benar, pemeriksaan kesehatan API Apollo.io mengembalikan dua nilai:
{ "healthy": true, "is_logged_in": true }
Jika keduanya bernilai true, key tersebut berfungsi. Jika salah satunya bernilai false, periksa spasi atau baris baru yang tidak sengaja tertinggal setelah key, lalu kirim permintaan lagi. Di Postman, atur jenis Authorization ke No Auth dan tambahkan key sebagai header.
Apakah API Apollo.io sedang down?
Orang yang mencari istilah ini terkadang menginginkan jawaban yang berbeda. Mereka ingin tahu apakah layanan itu sendiri sedang down. Panggilan auth/health menguji key dan proses sign-in Anda, bukan seluruh platform. Untuk gangguan, Apollo.io menyediakan halaman status di status.apollo.io.
Respons 429 dengan kode USAGE.RATE_LIMIT.PLATFORM_RATE_LIMIT berarti platform menolak traffic karena beban tinggi secara keseluruhan. Hal ini tidak berkaitan dengan paket Anda. Dokumentasi menyarankan untuk menunggu 60 detik lalu mencoba lagi.
Grup Endpoint Utama di Apollo.io API
Referensi ini mencantumkan puluhan endpoint. Semuanya terbagi menjadi enam grup.
| Grup | Cakupan | Contoh |
|---|---|---|
| Pencarian dan pengayaan | Menemukan orang dan perusahaan, melengkapi data | Pencarian People API, pengayaan orang, pencarian organisasi |
| Mengelola data | Akun, kontak, kesepakatan, daftar, catatan | Membuat kontak, memperbarui akun secara massal, menambahkan data ke daftar |
| Berinteraksi dengan prospek | Urutan, email, panggilan, tugas, percakapan | Menambahkan kontak ke urutan, mengirim email sekarang |
| Asisten AI | Menyerahkan tugas kepada asisten bawaan | Menjalankan tugas asisten, memeriksa status tugas asisten |
| Ruang kerja | Pengguna, kotak surat, bidang khusus | Mendapatkan daftar pengguna, membuat bidang khusus |
| Analitik dan penggunaan | Laporan, statistik penggunaan, hasil webhook | Meminta laporan analitik, melihat statistik penggunaan |
Pengelolaan data, urutan, dan sebagian besar panggilan ruang kerja menggunakan 0 kredit. Biayanya terdapat pada pencarian dan pengayaan, yang kami bahas di bawah.
Pencarian bukan pengayaan
Perbedaan ini sering membingungkan pengguna baru. Pencarian di basis data orang Apollo.io mengembalikan profil. Hasilnya tidak memuat email atau nomor telepon. Anda memerlukan panggilan kedua, ke endpoint pengayaan, untuk mendapatkannya. Pencarian kontak tersimpan milik Anda sendiri menggunakan kumpulan endpoint yang berbeda, dan batasannya juga berbeda.
Dokumentasi Pencarian Orang API Apollo.io
Dokumentasi pencarian orang API Apollo.io mencakup satu endpoint POST: /mixed_people/api_search. Apollo.io mendeskripsikan orang sebagai prospek baru yang belum Anda simpan sebagai kontak.
curl --request POST \ --url 'https://api.apollo.io/api/v1/mixed_people/api_search?person_titles[]=sales%20director&person_locations[]=california&per_page=10' \ --header 'accept: application/json' \ --header 'x-api-key: YOUR_API_KEY'
Parameter dimasukkan ke dalam string kueri. Anda dapat mempersempit pencarian berdasarkan:
- Jabatan:
person_titles[], sertaperson_not_titles[]untuk mengecualikan beberapa jabatan. - Senioritas:
person_seniorities[]. - Lokasi:
person_locations[]untuk tempat tinggal orang,organization_locations[]untuk kantor pusat perusahaan. - Ukuran dan pendapatan perusahaan:
organization_num_employees_ranges[]danrevenue_range[min]. - Teknologi: filter untuk lebih dari 1.500 teknologi yang digunakan perusahaan.
- Sinyal perekrutan:
q_organization_job_titles[]dan jumlah lowongan pekerjaan. - Status email:
contact_email_status[], dengan nilai seperti terverifikasi, belum terverifikasi, kemungkinan berinteraksi, dan tidak tersedia. - Penomoran halaman:
pagedanper_page.
Endpoint pencarian orang menggunakan 0 kredit. Endpoint ini mengembalikan hingga 100 catatan per halaman. Endpoint ini juga memiliki batas tampilan 50.000 catatan, yaitu 500 halaman. Tambahkan filter agar tetap di bawah batas tersebut.
Apa yang dikembalikan oleh pencarian orang API Apollo.io
Respons pencarian orang berisi jumlah total_entries dan daftar people. Respons ini tidak menyertakan email dan nomor telepon. Untuk mendapatkan detail kontak, teruskan setiap hasil ke endpoint pengayaan.
Pencarian memiliki batasnya sendiri, yang tercantum di bagian batas laju di bawah ini.
Jika Anda mencari berdasarkan contact_email_status[], ingat dari mana nilai tersebut berasal. Nilai itu menjelaskan catatan Apollo.io sendiri mengenai alamat tersebut. Nilai itu bukan pengujian kotak surat secara langsung.
Cara membaca dokumentasi pencarian orang API Apollo.io dengan lebih cepat
Mulailah dari kotak informasi penting endpoint. Periksa baris penggunaan kredit dan akses akun gratis. Kemudian, pindai daftar parameter untuk filter yang Anda perlukan. Terakhir, jalankan satu permintaan kecil dengan per_page=10 sebelum menelusuri ribuan hasil halaman demi halaman.
Memperkaya Data Orang dengan API Apollo.io
Pengayaan memperbarui catatan yang sudah Anda miliki. Apollo.io menyediakan dua endpoint untuk data orang:
- Pengayaan orang:
POST /people/match, satu orang per panggilan. - Pengayaan orang secara massal: hingga 10 orang dalam satu permintaan.
Apollo.io memerlukan detail yang cukup untuk mencocokkan orang yang tepat. Alamat email saja sudah cukup. Begitu juga nama ditambah domain perusahaan. Endpoint ini juga menerima URL LinkedIn, nama organisasi, atau ID orang Apollo.io. Jika Anda hanya mengirim nama, Anda mungkin menerima respons 200 yang tidak memperkaya apa pun.
Periksa match_confidence dalam setiap respons. Nilainya adalah high, medium, low, atau none.
curl --request POST \ --url 'https://api.apollo.io/api/v1/people/match?email=mark%40sumware.com' \ --header 'accept: application/json' \ --header 'x-api-key: YOUR_API_KEY'
Respons tersebut memuat jabatan orang, riwayat pekerjaan, data perusahaan, dan email_status, seperti verified. Status tersebut adalah label milik Apollo.io sendiri. Pemeriksaan kita nanti dalam panduan ini menguji alamatnya secara langsung.
Nomor telepon, alamat pribadi, dan waterfall
Tiga opsi tambahan mengubah data yang Anda terima:
reveal_personal_emails=truemenambahkan alamat pribadi. Apollo.io tidak akan mengungkapkannya untuk orang-orang di wilayah GDPR.reveal_phone_number=truemenambahkan semua nomor telepon, termasuk nomor seluler. Opsi ini memerlukanwebhook_url. Apollo.io memeriksa nomor-nomor tersebut secara asinkron dan mengirimkannya ke webhook Anda, yang dapat memerlukan waktu beberapa menit.run_waterfall_emaildanrun_waterfall_phonemencari di Apollo.io terlebih dahulu, lalu di penyedia data eksternal yang telah Anda konfigurasi. Hasil akhir juga diterima melalui webhook.
Hindari pembayaran dua kali
Jika Anda memperkaya orang yang sama lagi nanti, Anda mungkin menghabiskan kredit lagi untuk data yang sama. Apollo.io menyarankan untuk mengubah orang yang telah diperkaya menjadi kontak. Kontak menjadi milik organisasi Anda, sehingga datanya tetap dapat diakses.
Batas Laju API Apollo.io
Batas laju berlaku per tim, bukan per key atau per pengguna. Batas ini juga berlaku per endpoint, dan berjalan dalam tiga jendela sekaligus: menit, jam, dan hari. Anda harus tetap berada dalam setiap jendela yang berlaku.
| Batas | Gratis | Dasar | Profesional | Organisasi |
|---|---|---|---|---|
| Permintaan per menit | 50 | 200 | 200 | 200 |
| Permintaan per jam | 200 | 400 | 400 | 600 |
| Permintaan per hari | 600 | 2.000 | 2.000 | 6.000 |
Tabel tersebut adalah nilai default. Endpoint pencarian dan enrichment mendapatkan batas yang lebih tinggi pada paket berbayar:
- Endpoint enrichment: 1.000 permintaan per menit pada paket berbayar, tanpa batas per jam atau per hari. Akun gratis mendapatkan 50 per menit, dan 20 pada endpoint bulk.
- Endpoint pencarian: 200 per menit, 6.000 per jam, dan 50.000 per hari pada paket berbayar.
- Batas lebih rendah: laporan analitik kueri mengizinkan 5 permintaan per jam.
Dokumentasi Apollo.io menunjukkan bahwa batas enrichment yang tinggi bukanlah izin untuk mengirim panggilan tanpa batas. Saldo kredit Anda tetap mengontrol seberapa banyak data yang dapat Anda enrich.

Tangkapan layar: halaman Usage di portal pengembang Apollo.io, dengan batas harian dan per jam untuk endpoint enrichment, dari dokumentasi Apollo.io.
Header respons dan error 429
Apollo.io menambahkan header pada panggilan terautentikasi. Header tersebut menunjukkan batas, penggunaan sejauh ini, dan jumlah permintaan yang tersisa untuk setiap jendela:
x-rate-limit-minute,x-rate-limit-hourly, danx-rate-limit-24-hourx-minute-usage,x-hourly-usage, danx-24-hour-usagex-minute-requests-left,x-hourly-requests-left, danx-24-hour-requests-leftretry-after, yang dikirim bersama429, memberikan jumlah detik hingga jendela direset
Ketika Anda melewati batas, Anda akan mendapatkan 429. Baca retry-after dan tunggu. Jendela dimulai pada permintaan pertama Anda dan tidak terikat pada jam. Isi error memuat objek error_details. Nilai code-nya adalah USAGE.RATE_LIMIT.API_RATE_LIMIT_EXCEEDED untuk batas Anda sendiri.
Untuk membaca batas tim Anda saat ini dalam kode, panggil endpoint view API usage stats. Satu panggilan dapat mencakup hingga 74 jalur endpoint, dan tidak ada biaya kredit.
Kredit API Apollo.io: Apa yang Memerlukan Biaya
Banyak panggilan tidak dikenai biaya. Apollo.io menyatakan bahwa endpoint yang membuat, memperbarui, mencantumkan, atau mengelola rekaman menggunakan 0 kredit. Kredit digunakan untuk endpoint pengayaan, pencarian organisasi, pencarian berita, dan wawasan AI, dan hanya ketika endpoint tersebut mengembalikan data yang memenuhi syarat.
| Endpoint | Biaya kredit |
|---|---|
| Pengayaan orang | 1 hingga 9 per orang: 1 untuk demografi atau email, ditambah 8 jika nomor telepon seluler tersedia |
| Pengayaan orang secara massal | Logika yang sama, hingga 10 orang per permintaan |
| Pengayaan organisasi | 1 per organisasi |
| Pencarian organisasi | 1 per halaman, hingga 100 hasil per halaman |
| Pencarian artikel berita | 1 per halaman, hingga 25 hasil per halaman |
| Lowongan pekerjaan organisasi | 1 per halaman |
| Mendapatkan informasi lengkap seseorang | 1 per orang |
| Tugas asisten | Bervariasi, ditentukan oleh tindakan yang dilakukan asisten |
Pencarian orang gratis, jadi pendekatan yang masuk akal adalah mencari terlebih dahulu lalu hanya melakukan pengayaan pada hasil terbaik. Membuka halaman berikutnya pada endpoint yang menggunakan kredit akan menghabiskan kredit untuk setiap halaman. Apollo.io menyarankan uji coba kecil dan pemeriksaan penggunaan sebelum Anda meningkatkan skala.
Pengayaan waterfall dapat menelan lebih banyak biaya. Waterfall email biasanya menggunakan 1 hingga 4 kredit, dan beberapa konfigurasi menggunakan 20 kredit atau lebih. Waterfall telepon biasanya menggunakan 8 hingga 25 kredit, dan beberapa konfigurasi menggunakan 45 kredit atau lebih.
Untuk melacak pengeluaran, buka Pengaturan > Penagihan dan kredit > Penggunaan kredit di aplikasi. Tab Penggunaan di dasbor pengembang menampilkan kredit telepon dan email yang digunakan dalam siklus penagihan saat ini. Paket lama dapat berbeda, jadi periksa halaman Tentang kredit untuk workspace Anda.
Kesalahan dan Kode Status
Sebagian besar endpoint API Apollo.io menggunakan daftar kode status yang singkat:
| Kode | Arti | Penyebab umum |
|---|---|---|
401 | Tidak diotorisasi | Kunci tidak ada, tidak valid, atau berasal dari akun yang tidak aktif |
403 | Dilarang | Paket tidak memiliki akses API, atau kunci dengan cakupan tertentu tidak memiliki akses ke endpoint |
404 | Tidak ditemukan | Rekaman tidak ada atau tidak terlihat oleh Anda |
422 | Tidak dapat diproses | Parameter tidak valid atau tidak ada |
429 | Terlalu banyak permintaan | Anda telah melewati batas laju |
500 | Kesalahan server | Gangguan di sisi Apollo.io, jadi coba lagi |
Apollo.io sedang memindahkan kesalahan ke satu format. Jika sebuah endpoint telah dipindahkan, responsnya menyertakan objek error_details dengan code yang stabil, message, suggestions, dan context. Buat percabangan kode berdasarkan error_details.code, jangan berdasarkan teks pesan. Apollo.io berencana menghapus kolom kesalahan lama di tingkat root pada 16 Februari 2027, jadi gunakan objek baru ini mulai sekarang.
Server MCP Apollo.io
MCP adalah standar yang memungkinkan alat AI memanggil layanan eksternal. Server MCP Apollo.io menghubungkan Claude, ChatGPT, dan klien serupa dengan akun Apollo.io Anda. Anda kemudian dapat meminta dengan bahasa biasa: temukan pemimpin pemasaran tingkat VP di perusahaan SaaS, atau perkaya sepuluh prospek ini.

Tangkapan layar: halaman MCP Apollo.io dalam dokumentasi pengembang, Oktober 2026.
Tiga cara untuk terhubung
| Rute | Cara kerjanya |
|---|---|
| Konektor AI | Integrasi bawaan pada ChatGPT, Claude, Perplexity, Replit, dan Cursor. Tidak perlu menyiapkan server. |
| Plug-in pengodean | Plug-in pihak pertama untuk alat seperti Codex. |
| Server MCP mandiri | Arahkan klien MCP apa pun yang mendukung server jarak jauh ke satu URL. |
Pengaturan mandiri cukup singkat:
| Pengaturan | Nilai |
|---|---|
| Endpoint | https://mcp.apollo.io/mcp |
| Transportasi | Streamable HTTP |
| Masuk | OAuth 2.0 |
| Instalasi lokal | Tidak diperlukan |
| API key | Tidak diperlukan, kecuali klien tidak memiliki browser |
Di Claude Code, satu perintah menambahkan server. Jalankan perintah tersebut, lalu ketik /mcp dan selesaikan proses masuk OAuth:
claude mcp add --transport http apollo https://mcp.apollo.io/mcp
Jika Anda mengelola beberapa ruang kerja, tambahkan URL yang sama dengan nama berbeda untuk masing-masing ruang kerja. Masuk ke setiap koneksi secara terpisah.
Server tanpa browser
OAuth memerlukan jendela browser. Tugas cron atau pipeline CI tidak memilikinya. Untuk kasus tersebut, server menerima API key yang dikirim sebagai X-Api-Key. Key tersebut harus berupa master key. Key dengan cakupan tertentu akan menghasilkan 403 dengan kode API_INACCESSIBLE, karena server MCP bukan salah satu endpoint yang dapat Anda centang.
Simpan key tersebut seperti rahasia produksi lainnya. Key ini bertindak sebagai admin ruang kerja dan menggunakan kredit ruang kerja. Alat MCP baru langsung dapat mengakses master key, tetapi klien Anda mungkin menyimpan daftar alat dalam cache. Hubungkan kembali dan panggil tools/list untuk memperbaruinya.
Kemampuan server MCP Apollo.io
Daftar alat mencakup pencarian dan pencarian prospek, pengayaan data orang dan perusahaan, kontak, daftar, rangkaian, email satu kali, tugas, pemeriksaan domain email, dan analitik. Tindakan pengayaan menggunakan kredit. Sebagian besar tindakan lainnya tidak menggunakan kredit. Apollo.io memperingatkan bahwa pencarian orang tidak mengembalikan email atau nomor telepon, jadi asisten Anda harus menjalankan langkah pengayaan untuk mendapatkannya.
Batas praktis dari dokumentasi:
- Tidak ada biaya tambahan untuk menghubungkan. Paket, izin, dan kredit Anda tetap berlaku.
- Tindakan destruktif, seperti penghapusan massal, tidak didukung.
- Server mengikuti izin Anda. Dengan OAuth, server bertindak sebagai pengguna yang masuk.
- MCP Apollo.io menggunakan batas laju terpisah dan tidak mengembalikan header batas laju.
- Apollo.io melarang pelatihan model AI menggunakan data MCP-nya, jadi nonaktifkan pelatihan terlebih dahulu di klien AI Anda.
Apollo.io merekomendasikan agar tindakan yang menggunakan kredit diatur ke Perlu persetujuan, sehingga asisten yang terlalu banyak mengobrol tidak dapat menghabiskan kredit sendiri.
Cara Lain Menggunakan API Apollo.io
- Apollo.io CLI. Alat baris perintah dengan akses ke seluruh API. Instal dengan Homebrew, biner siap pakai, atau dari kode sumber. Alat ini menggunakan OAuth, sehingga tidak memerlukan kunci.
- OAuth 2.0. Mitra menggunakannya untuk memanggil API bagi pelanggan bersama, dan dokumentasi mencantumkan aplikasi marketplace untuk integrasi siap pakai.
- Ekstensi Chrome. Untuk mengeklik alih-alih menulis kode, baca panduan ekstensi Chrome Apollo.
Periksa Alamat dari API Apollo.io Sebelum Anda Mengirim
Apa pun rute yang Anda pilih, data tersebut memiliki satu titik lemah. Data itu berasal dari sebuah database. Orang berganti pekerjaan, dan perusahaan berpindah ke domain baru. Kolom email_status adalah label milik Apollo.io sendiri, bukan hasil pengujian terbaru. Email dingin ke alamat yang sudah tidak aktif akan terpental, dan email terpental merusak reputasi pengirim Anda.
Jadi, lakukan pemeriksaan di antara enrichment dan sequence Anda. BillionVerify menguji setiap alamat tanpa mengirim pesan. Layanan ini memeriksa sintaks, domain, catatan MX, dan, jika Anda memintanya, mailbox melalui SMTP. Layanan ini menandai alamat sekali pakai dan alamat berbasis peran. Catch-all dilaporkan sebagai hasil tersendiri, bukan dihitung sebagai valid. Hasil unknown tidak dikenai biaya, dan pemeriksaan ulang dalam 24 jam gratis. Sebelum menghubungkan API, Anda dapat memeriksa apakah alamat email ada secara manual melalui pemeriksa web gratis.

BillionVerify mengembalikan status, penanda dapat dikirim, dan alasan untuk setiap alamat.
Pipeline sederhana
Pipeline sederhana memiliki empat langkah:
- Jalankan pencarian orang gratis melalui API.
- Lakukan enrichment hanya pada kecocokan terbaik.
- Kirim setiap alamat ke REST API BillionVerify.
- Tambahkan hanya alamat yang dapat dikirim ke sequence Anda.
Panggilan BillionVerify adalah satu POST. Kirimkan key di header BV-API-KEY, dan atur check_smtp ke true untuk pengujian mailbox secara langsung:
curl -X POST https://api.billionverify.com/v1/verify/single \
-H "BV-API-KEY: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"email":"mark@sumware.com","check_smtp":true}'
Balasan tersebut berisi status, is_deliverable, is_catchall, is_role, is_disposable, dan reason. Untuk hingga 50 alamat dalam satu panggilan, gunakan rute bulk. Untuk seluruh ekspor, unggah file CSV, TXT, atau XLSX dan unduh hasilnya nanti. Referensi lengkap tersedia di dokumentasi BillionVerify.
Verifikasi dari klien AI
Jika Anda sudah menghubungkan setup MCP Apollo.io ke klien AI, tambahkan server MCP ter-host BillionVerify di sebelahnya. Server ini berada di https://mcp.billionverify.com/mcp dan menggunakan OAuth untuk masuk. Asisten Anda kemudian dapat melakukan enrichment terhadap prospek melalui Apollo.io dan memeriksa alamat tersebut dalam satu percakapan. Beri tahu kebijakan Anda, seperti status mana yang diterima dan apa yang harus dilakukan terhadap catch-all.
Pemeriksaan lainnya
- Halaman verifikasi email Apollo kami membahas alur kerja ekspor.
- Kontak yang mencurigakan dapat diperiksa melalui pencarian balik email gratis kami, yang menunjukkan informasi apa yang secara publik terkait dengan sebuah alamat.
- Nomor telepon yang dikembalikan melalui webhook juga perlu diuji. Validator nomor telepon gratis kami menunjukkan apakah sebuah nomor valid untuk negaranya dan jenis salurannya.
BillionVerify memberikan 20 kredit gratis setiap hari saat Anda menggunakan akun, hingga 600 per bulan. Kredit tersebut tidak pernah kedaluwarsa, dan Anda tidak memerlukan kartu kredit.
Kiat Membangun dengan API Apollo.io
- Mulai dengan satu kunci yang cakupannya terbatas untuk setiap integrasi. Jika satu kunci bocor, Anda hanya mencabut kunci itu.
- Jalankan pemeriksaan kesehatan terlebih dahulu. Ini menyingkirkan masalah kunci sebelum Anda men-debug kode.
- Baca kotak Esensi Endpoint. Dokumentasi pencarian orang Apollo.io API menampilkan biaya kredit sejak awal.
- Lakukan pencarian sebelum memperkaya data. Pencarian gratis, sedangkan pengayaan data tidak.
- Uji dengan
per_page=10. Proses dalam jumlah kecil menunjukkan biaya kredit sebelum menjadi masalah. - Patuhi
retry-after. Membanjiri endpoint yang dibatasi hanya akan memperpanjang waktu tunggu. - Baca
error_details.code. Teks pesan dapat berubah tanpa pemberitahuan. - Verifikasi sebelum mengirim. Kredit yang digunakan untuk alamat yang gagal terkirim terbuang dua kali.
Pertanyaan Umum
Apakah Apollo.io memiliki API?
Ya, Apollo.io memiliki REST API. API ini memungkinkan Anda mencari orang dan perusahaan, memperkaya kontak, serta memperbarui akun, deal, dan sequence. Akses dasar tersedia di setiap paket. Paket Anda menentukan endpoint yang dapat dipanggil, kecepatannya, dan biaya setiap panggilan.
Bagaimana cara mendapatkan API key Apollo.io?
Key Apollo.io berasal dari area Integrations di Settings: buka API Keys dan pilih Create new key. Beri nama, centang endpoint yang boleh dipanggil, lalu konfirmasi dan segera salin secret tersebut. Admin, atau pengguna dengan profil izin yang sesuai, dapat melakukannya.
Di mana saya dapat menemukan API key Apollo.io?
Daftar API key Apollo.io berada di halaman API Keys, yang dapat Anda akses dari aplikasi atau developer dashboard. Secret lengkap ditampilkan saat Anda membuat key. Secret yang hilang mengharuskan Anda membuat ulang key, yang akan menerbitkan key baru.
Apakah API Apollo.io gratis?
Panggilan API Apollo.io yang membuat, mencantumkan, atau memperbarui record tidak dikenai biaya, begitu juga pencarian orang. Enrichment dan beberapa endpoint pencarian menggunakan kredit saat mengembalikan data. Akun gratis dapat memanggil API dalam batas paket gratis, tetapi beberapa endpoint memerlukan email kerja.
Berapa batas laju API Apollo.io?
Pada paket berbayar, sebagian besar endpoint API Apollo.io menerima 200 panggilan per menit, dengan batas per jam dan per hari yang berbeda-beda menurut paket. Paket gratis menerima 50 panggilan per menit, 200 per jam, dan 600 per hari. Batas berlaku per tim dan per endpoint, dan respons 429 berarti Anda telah melewati salah satunya.
Bagaimana cara menguji pemeriksaan kesehatan API Apollo.io?
Pemeriksaan kesehatan Apollo.io adalah permintaan GET ke path auth/health dengan header key yang telah diatur. Respons healthy: true dan is_logged_in: true berarti key tersebut berfungsi. Tidak ada kredit yang digunakan.
Apakah pencarian orang melalui API Apollo.io mengembalikan email?
Tidak, endpoint pencarian orang Apollo.io hanya mengembalikan profil, tanpa email atau nomor telepon. Jalankan endpoint people enrichment atau bulk people enrichment pada hasil tersebut untuk mendapatkan detail kontak, yang memerlukan kredit.
Di mana dokumentasi API Apollo.io?
Dokumentasi API Apollo.io tersedia di docs.apollo.io. Setiap endpoint memiliki halaman sendiri dengan parameter, panel pengujian, dan contoh respons. Anda juga dapat mengunduh file OpenAPI dan mengimpornya ke Postman.
Apa itu server MCP Apollo.io?
Server MCP Apollo.io menghubungkan klien AI dengan workspace Anda melalui Model Context Protocol. URL-nya adalah https://mcp.apollo.io/mcp, menggunakan Streamable HTTP dan OAuth, serta tidak memerlukan instalasi lokal. Paket, izin, dan kredit Anda tetap berlaku.
Apa server MCP terbaik untuk Apollo.io?
Apollo.io menerbitkan satu server MCP resmi, dan itulah server yang dijelaskan dalam dokumentasinya. Kami tidak menguji opsi pihak ketiga. Pilih server resmi jika Anda ingin menggunakan izin dan aturan kredit yang sama seperti di aplikasi.
Haruskah saya memverifikasi email yang berasal dari API Apollo.io?
Ya, periksa setiap alamat email dari API Apollo.io sebelum menjalankan kampanye. Kolom email_status mencerminkan catatan Apollo.io sendiri, dan orang dapat berganti pekerjaan. Pemeriksaan singkat melalui API BillionVerify menghapus alamat yang tidak aktif dan melindungi reputasi pengirim Anda.
Tonton video: Cara memvalidasi nomor telepon: validator nomor telepon gratis
Tonton video: Cara memverifikasi email Apollo sebelum mengirim
