Apollo
Person and company enrichment, people search, company job postings and news. Requires Felo administrative permission.
People API Araması
Zaten belirlediğiniz bir kişiyi zenginleştirmek yerine ölçütlere uyan kişileri bulur. İş unvanı, kıdem, konum, şirket alan adı, çalışan sayısı ve sektöre göre filtreleyin, page ve per_page ile sayfalayın. total_entries ve bir people dizisi döndürür. Aramanın bilinçli olarak neleri vermediğine dikkat edin: kayıtlar değerlerin kendisi yerine last_name_obfuscated ve boole bayrakları — has_email, has_direct_phone, has_city, has_state, has_country — taşır. Arama bir eşleşmenin var olduğunu söyler; zenginleştirme iletişim bilgilerini ortaya çıkarır. E-posta ve telefon numaralarını almak için kimlikleri post_apollo_people_match veya post_apollo_people_bulk_match adresine verin; krediler de burada harcanır. Felo yönetici izni gerektirir.
Fiyatlandırma referansı
- Ölçümlendirme: başarılı istek başına sabit maliyet esası.
- Referans istek tahmini: USD 0.012.
Yalnızca referans üst verisidir; hesap teklifi, garantili fiyat veya harcama üst sınırı değildir. Kaynak kredileri Felo kredisi değildir. Nihai ücretler Felo faturalandırma kayıtlarını izler.
- Tür: array string[]contact
_email _status[] Bulmak istediğiniz kişilerin e-posta durumları. Aramanızı genişletmek için birden çok durum ekleyebilirsiniz. Arayabileceğiniz durumlar: verified unverified likely to engage unavailable
- Tür: array string[]currently
_not _using _any _of _technology _uids[] Kişileri, mevcut işverenlerinin kullandığı teknolojilerden herhangi birine göre aramanızdan hariç tutar. Apollo 1.500'den fazla teknolojiye göre filtrelemeyi destekler. Apollo teknoloji verilerini birden çok kaynaktan hesaplar. Bu veriler düzenli olarak güncellenir. Desteklenen teknolojilerin tam listesini bu CSV dosyasını indirerek görün. CSV dosyasında listelenen teknolojiler için boşlukları ve noktaları alt çizgi (_) ile değiştirin. Örnekler: salesforce; google_analytics; wordpress_org
- Tür: array string[]currently
_using _all _of _technology _uids[] Kişileri, mevcut işverenlerinin kullandığı teknolojilerin tamamına göre bulur. Apollo 1.500'den fazla teknolojiye göre filtrelemeyi destekler. Apollo teknoloji verilerini birden çok kaynaktan hesaplar. Bu veriler düzenli olarak güncellenir. Desteklenen teknolojilerin tam listesini bu CSV dosyasını indirerek görün. CSV dosyasında listelenen teknolojiler için boşlukları ve noktaları alt çizgi (_) ile değiştirin. Örnekler: salesforce; google_analytics; wordpress_org
- Tür: array string[]currently
_using _any _of _technology _uids[] Kişileri, mevcut işverenlerinin kullandığı teknolojilerden herhangi birine göre bulur. Apollo 1.500'den fazla teknolojiye göre filtrelemeyi destekler. Apollo teknoloji verilerini birden çok kaynaktan hesaplar. Bu veriler düzenli olarak güncellenir. Desteklenen teknolojilerin tam listesini bu CSV dosyasını indirerek görün. CSV dosyasında listelenen teknolojiler için boşlukları ve noktaları alt çizgi (_) ile değiştirin. Örnekler: salesforce; google_analytics; wordpress_org
- Tür: booleaninclude
_similar _titles Bu parametre, person_titles[] parametresinde tanımladığınız unvanlara benzer iş unvanlarına sahip kişilerin yanıtta döndürülüp döndürülmeyeceğini belirler. Yalnızca iş unvanları için katı eşleşmeler döndürmek üzere person_titles[] kullanırken bu parametreyi false olarak ayarlayın.
- Tür: array string[]organization
_ids[] Arama sonuçlarınıza dahil etmek istediğiniz şirketlerin (işverenlerin) Apollo kimlikleri. Apollo veritabanındaki her şirkete benzersiz bir kimlik atanır. Kimlikleri bulmak için Organization Search uç noktasını çağırın ve organization_id değerlerini belirleyin. Örnek: 5e66b6381e05b4008c8331b8
- Tür: array string[]organization
_job _locations[] Kişinin işvereninin aktif olarak işe alım yaptığı işlerin konumları. Örnekler: atlanta; japan
- Tür: stringorganization
_job _posted _at _range[max] Kişinin mevcut işvereninin iş ilanlarını yayımladığı en son tarih. İlanların yayımlandığı tarih aralığını belirlemek için bu parametreyi organization_job_posted_at_range[min] ile birlikte kullanın. Örnek: 2025-09-25
- Tür: stringorganization
_job _posted _at _range[min] Kişinin mevcut işvereninin iş ilanlarını yayımladığı en erken tarih. İlanların yayımlandığı tarih aralığını belirlemek için bu parametreyi organization_job_posted_at_range[max] ile birlikte kullanın. Örnek: 2025-07-25
- Tür: array string[]organization
_locations[] Kişinin mevcut işvereni olan şirketin genel merkez konumu. Şehirler, ABD eyaletleri ve ülkeler arasında arama yapabilirsiniz. Bir şirketin birden çok ofis konumu varsa sonuçlar yine genel merkez konumuna göre belirlenir. Örneğin chicago araması yaparsanız ancak şirketin genel merkezi boston'daysa, diğer parametrelerle eşleşseler bile Boston merkezli şirkette çalışan kişiler sonuçlarınızda görünmez. Kişileri kişisel konumlarına göre bulmak için person_locations parametresini kullanın. Örnekler: texas; tokyo; spain
- Tür: array string[]organization
_num _employees _ranges[] Kişinin mevcut şirketinde çalışan kişi sayısı aralığı. İşverenlerinin çalışan sayısına göre kişileri bulmanızı sağlar. Arama sonuçlarınızı genişletmek için birden çok aralık ekleyebilirsiniz. Eklediğiniz her aralık, aralığın üst ve alt sayılarının yalnızca virgülle ayrıldığı bir dize olmalıdır. Örnekler: 1,10; 250,500; 10000,20000
- Tür: integerorganization
_num _jobs _range[max] Kişinin mevcut işverenindeki aktif iş ilanlarının maksimum sayısı. İş ilanı aralığı belirlemek için bu parametreyi organization_num_jobs_range[min] ile birlikte kullanın. Örnekler: 50; 500
- Tür: integerorganization
_num _jobs _range[min] Kişinin mevcut işverenindeki aktif iş ilanlarının minimum sayısı. İş ilanı aralığı belirlemek için bu parametreyi organization_num_jobs_range[max] ile birlikte kullanın. Örnekler: 50; 500
- Tür: integerpage
Almak istediğiniz Apollo verilerinin sayfa numarası. Arama sonuçlarında gezinmeyi kolaylaştırmak ve uç noktanın performansını artırmak için bu parametreyi per_page parametresiyle birlikte kullanın. Örnek: 4
- Tür: integerper
_page Her sayfa için döndürülmesi gereken arama sonucu sayısı. Sayfa başına sonuç sayısını sınırlamak uç noktanın performansını artırır. Verilerin farklı sayfalarında arama yapmak için page parametresini kullanın. Örnek: 10
- Tür: array string[]person
_locations[] Kişilerin yaşadığı konum. Şehirler, ABD eyaletleri ve ülkeler arasında arama yapabilirsiniz. Kişileri mevcut işverenlerinin genel merkez konumlarına göre bulmak için organization_locations parametresini kullanın. Örnekler: california; ireland; chicago
- Tür: array string[]person
_seniorities[] Kişilerin mevcut işverenlerindeki iş kıdemi. Belirli raporlama düzeylerinde, örneğin Director düzeyinde veya kıdemli IC düzeyinde, görev yapan kişileri bulmanızı sağlar. Bir kişinin arama sonuçlarına girmesi için eklediğiniz kıdemlerden yalnızca 1 tanesiyle eşleşmesi yeterlidir. Daha fazla kıdem eklemek arama sonuçlarınızı genişletir. Aramalar sonuçları yalnızca mevcut iş unvanına göre döndürür; bu nedenle Director düzeyindeki çalışanları aramak yalnızca hâlâ Director düzeyinde unvana sahip kişileri döndürür. Daha önce Director olan ancak şu anda VP olan biri arama sonuçlarınıza dahil edilmez. Kişileri belirli iş fonksiyonlarına ve kıdem düzeylerine göre bulmak için bu parametreyi person_titles[] parametresiyle birlikte kullanın. Bu parametre için aşağıdaki seçenekler kullanılabilir: owner founder c_suite partner vp head director manager senior entry intern
- Tür: array string[]person
_titles[] Bulmak istediğiniz kişilerin sahip olduğu iş unvanları. Bir kişinin arama sonuçlarına girmesi için eklediğiniz iş unvanlarından yalnızca 1 tanesiyle eşleşmesi yeterlidir. Daha fazla iş unvanı eklemek arama sonuçlarınızı genişletir. Sonuçlar, tam eşleşme olmasa bile aynı terimleri içeren iş unvanlarını da kapsar. Örneğin marketing manager araması, content marketing manager unvanına sahip kişileri döndürebilir. Kişileri belirli iş fonksiyonlarına ve kıdem düzeylerine göre bulmak için bu parametreyi person_seniorities[] parametresiyle birlikte kullanın. Örnekler: sales development representative; marketing manager; research analyst
- Tür: stringq
_keywords Sonuçları filtrelemek istediğimiz kelime dizisi.
- Tür: array string[]q
_organization _domains _list[] Kişinin işvereninin alan adı. Mevcut veya önceki işveren olabilir. www., @ simgesi veya benzerlerini eklemeyin. Bu parametre tek istekte 1.000'e kadar alan adı kabul eder. Örnekler: apollo.io; microsoft.com
- Tür: array string[]q
_organization _job _titles[] Kişinin mevcut işverenindeki aktif iş ilanlarında listelenen iş unvanları. Örnekler: sales manager; research analyst
- Tür: integerrevenue
_range[max] Kişinin mevcut işvereninin elde ettiği maksimum gelir. Gelir aralığı belirlemek için bu parametreyi revenue_range[min] ile birlikte kullanın. Rakama para birimi simgeleri, virgüller veya ondalık noktalar girmeyin. Örnekler: 500000; 1500000
- Tür: integerrevenue
_range[min] Kişinin mevcut işvereninin elde ettiği minimum gelir. Gelir aralığı belirlemek için bu parametreyi revenue_range[max] ile birlikte kullanın. Rakama para birimi simgeleri, virgüller veya ondalık noktalar girmeyin. Örnekler: 500000; 1500000
- Tür: object200
Başarılı yanıt
- Tür: array string[]people
Yanıt dizisi
- Tür: integertotal
_entries Yanıt alanı
application/json - 400
İstek işlenemedi. İstek parametrelerini kontrol edin.
- 401
Geçerli bir Felo API anahtarı gerekir.
- 402
Faturalandırma koşulu karşılanmadığı için istek devam edemiyor.
- 403
Hesabın bu işlemi gerçekleştirme izni yok.
- 429
İstek veya harcama sınırına ulaşıldı.
- 502
Hizmet isteği tamamlayamadı.
- 503
API veya faturalandırma hizmeti geçici olarak kullanılamıyor.
- 504
İstek işlenirken hizmet zaman aşımına uğradı.
- default
Hata yanıtı; upstream sağlayıcıdan doğrudan aktarılan yanıtlar sağlayıcı biçimlerini kullanabilir
application/json
curl https://openapi.felo.ai/v1/beta/apollo/mixed_people/api_search \
--request POST \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"total_entries": 1,
"people": [
"string"
]
}