Bu rehberde: Müşteri adaylarını kişi ve şirket profiliyle zenginleştirmek için Apollo'yu bağlarsınız. Anahtar oluştururken hangi izinlerin gerektiğini öğrenirsiniz.
⏱ 5 dakika
Kimlik kartı
| Alan | Değer |
|---|---|
| Sağlayıcı anahtarı | APOLLO |
| Kategori | Araştırma |
| Kimlik doğrulama | API anahtarı |
| Kapsam | Organizasyon geneli |
| Webhook | Hayır |
| Yetenekler | E-posta bulma, şirket sorgulama |
| Kullanan kutular | Zenginleştir |
| Kullanan ajanlar | Lead Researcher |
Ne işe yarar?
Apollo, 200 milyondan fazla kişi ve 30 milyondan fazla şirket içeren B2B veri tabanıdır. Kişi e-postası ve unvanı, şirket büyüklüğü, sektör, teknoloji yığını, LinkedIn profilleri sağlar. Hunter'a göre profil daha zengindir.
Ön koşullar
- app.apollo.io hesabı. API erişimi ücretsiz planda kısıtlıdır; Basic/Professional ve üstü gerekir.
- Zenginleştirme işlemleri export/enrichment kredisi harcar.
Adım adım kurulum
A) Apollo
- app.apollo.io → Settings → Integrations → API (veya Settings → API Keys) → ① Create New Key. Ad:
orqlabs.
- ① Set as master key: kapalı bırakın. ② Gerekli uç noktaları işaretleyin: People API → Search, Enrichment (Match), Bulk Enrichment; Organizations API → Enrichment, Search.
- Create API Key → ③ anahtarı kopyalayın.
B) OrqLabs'ta bağlama
- Entegrasyonlar → Apollo.io → Bağla. ② Organizasyon geneli.
- ① API key → yapıştırın.
- ③ Bağla. Bağlantıyı test et hafif bir çağrı yapar; kredi harcamaz.
Hunter da bağlıysa Zenginleştir kutusunda hesap seçersiniz.
İzinler
| API izni | Neden gerekli |
|---|---|
| People → Enrichment (Match) | Ad + şirket → e-posta, unvan, LinkedIn |
| People → Search | Şirketteki karar vericileri bulma |
| People → Bulk Enrichment | Toplu çalıştırmalarda 10'lu paketler |
| Organizations → Enrichment | Alan adı → şirket profili |
| Organizations → Search | Profil kriterlerine göre şirket listesi |
Master key tüm uç noktaları açar; gereksizdir ve sızıntı riskini artırır.
Limitler
| Konu | Sınır |
|---|---|
| Plan | Ücretsiz planda API çok sınırlı; Basic+ önerilir |
| Hız sınırı | Tipik 50/dk, 100-200/saat, 600-2.000/gün |
| Kişi araması | Sonuçlar e-posta içermez; e-posta için Enrichment (kredi) |
| Kredi | Kişi başına 1 export kredisi; telefon ayrı (OrqLabs istemez) |
| Toplu | İstek başına 10 kişi |
OrqLabs yalnızca verified ve guessed e-postaları yazar; guessed için güven 60, verified için 95.
Bağlantıyı test etme
② Bağlantıyı test et anahtarı ve kredileri doğrular. İş akışında Zenginleştir kutusuyla deneyin; her başarılı eşleşme 1 kredi harcar.
Kimlik bilgilerini yenileme
- Settings → API Keys → anahtarı Delete, yenisini oluşturun → entegrasyon kartı → Kimlik bilgileri → Güncelle → API key.
- Anahtarı oluşturan kullanıcı ekipten çıkarılırsa anahtar geçersiz olur; yönetici hesabıyla oluşturun.
Veri koruma
Apollo verisi B2B kişi verisidir. Meşru menfaat, ilk temasta kaynak bildirimi ve ret hakkı gerekir. Apollo "do not contact" bayrağı taşıyan kişileri OrqLabs doNotContact: true ile kaydeder; Outreach ve kampanyalar bunları atlar.
Sık karşılaşılan hatalar
| Hata | Olası neden | Çözüm |
|---|---|---|
AUTH – 401 | Anahtar yanlış | Yeni anahtar |
INVALID – 403 "requires a paid plan" | Ücretsiz plan | Plan yükseltin |
INVALID – 403 "does not have permission" | Uç nokta izni işaretlenmemiş | Anahtarı düzenleyip izinleri ekleyin |
RATE_LIMIT – 429 | Sınır | Bekleme 60000 |
| "insufficient credits" | Kredi bitti | Kredi alın; yalnızca gerekenleri zenginleştirin |
INVALID – 422 "domain required" | Web sitesi boş | Alan adı sağlayın |
E-posta unavailable | Doğrulanmış e-posta yok | Hunter ile ikinci deneme |
Sık sorulan sorular
Ücretsiz Apollo hesabıyla çalışır mı? API erişimi ücretsiz planda çok kısıtlıdır. Basic ve üstü önerilir.
Hunter yerine mi, yanında mı? Yanında. Apollo profil verir, Hunter doğrular.