Apollo
Person and company enrichment, people search, company job postings and news. Requires Felo administrative permission.
Carian People API
Cari orang yang sepadan dengan kriteria dan bukan memperkaya data seseorang yang telah anda kenal pasti. Tapis mengikut jawatan, kekananan, lokasi, domain syarikat, bilangan pekerja dan industri, kemudian halaman dengan page dan per_page. Memulangkan total_entries dan array people. Perhatikan perkara yang sengaja tidak diberikan oleh carian: entri membawa last_name_obfuscated dan bendera boolean — has_email, has_direct_phone, has_city, has_state, has_country — dan bukan nilainya sendiri. Carian memberitahu anda padanan wujud; pengayaan mendedahkan butiran hubungan. Masukkan id ke post_apollo_people_match atau post_apollo_people_bulk_match untuk mendapatkan e-mel dan nombor telefon, yang juga menjadi tempat kredit dibelanjakan. Memerlukan kebenaran pentadbir Felo.
Rujukan harga
- Pemeteran: Asas kos tetap bagi setiap permintaan berjaya.
- Anggaran rujukan setiap permintaan: USD 0.012.
Metadata rujukan sahaja, bukan sebut harga akaun, harga terjamin atau had perbelanjaan. Kredit sumber bukan kredit Felo. Caj akhir mengikut rekod pengebilan Felo.
- Jenis: array string[]contact
_email _status[] Status e-mel orang yang ingin anda cari. Anda boleh menambah berbilang status untuk meluaskan carian. Status yang boleh dicari termasuk: verified unverified likely to engage unavailable
- Jenis: array string[]currently
_not _using _any _of _technology _uids[] Kecualikan orang daripada carian anda berdasarkan mana-mana teknologi yang digunakan oleh majikan semasa mereka. Apollo menyokong penapisan mengikut 1,500+ teknologi. Apollo mengira data teknologi daripada pelbagai sumber. Data ini dikemas kini secara berkala. Lihat senarai penuh teknologi yang disokong dengan memuat turun fail CSV ini. Gunakan garis bawah (_) untuk menggantikan ruang dan noktah bagi teknologi yang tersenarai dalam fail CSV. Contoh: salesforce; google_analytics; wordpress_org
- Jenis: array string[]currently
_using _all _of _technology _uids[] Cari orang berdasarkan semua teknologi yang digunakan oleh majikan semasa mereka. Apollo menyokong penapisan mengikut 1,500+ teknologi. Apollo mengira data teknologi daripada pelbagai sumber. Data ini dikemas kini secara berkala. Lihat senarai penuh teknologi yang disokong dengan memuat turun fail CSV ini. Gunakan garis bawah (_) untuk menggantikan ruang dan noktah bagi teknologi yang tersenarai dalam fail CSV. Contoh: salesforce; google_analytics; wordpress_org
- Jenis: array string[]currently
_using _any _of _technology _uids[] Cari orang berdasarkan mana-mana teknologi yang digunakan oleh majikan semasa mereka. Apollo menyokong penapisan mengikut 1,500+ teknologi. Apollo mengira data teknologi daripada pelbagai sumber. Data ini dikemas kini secara berkala. Lihat senarai penuh teknologi yang disokong dengan memuat turun fail CSV ini. Gunakan garis bawah (_) untuk menggantikan ruang dan noktah bagi teknologi yang tersenarai dalam fail CSV. Contoh: salesforce; google_analytics; wordpress_org
- Jenis: booleaninclude
_similar _titles Parameter ini menentukan sama ada orang dengan jawatan serupa dengan jawatan yang anda tetapkan dalam parameter person_titles[] dipulangkan dalam respons. Tetapkan parameter ini kepada false apabila menggunakan person_titles[] untuk memulangkan hanya padanan ketat bagi jawatan.
- Jenis: array string[]organization
_ids[] ID Apollo bagi syarikat (majikan) yang ingin anda sertakan dalam hasil carian. Setiap syarikat dalam pangkalan data Apollo diberikan ID unik. Untuk mencari ID, panggil endpoint Organization Search dan kenal pasti nilai organization_id. Contoh: 5e66b6381e05b4008c8331b8
- Jenis: array string[]organization
_job _locations[] Lokasi pekerjaan yang sedang aktif diambil oleh majikan orang itu. Contoh: atlanta; japan
- Jenis: stringorganization
_job _posted _at _range[max] Tarikh terkini apabila iklan pekerjaan disiarkan oleh majikan semasa orang itu. Gunakan parameter ini bersama organization_job_posted_at_range[min] untuk menetapkan julat tarikh penyiaran iklan. Contoh: 2025-09-25
- Jenis: stringorganization
_job _posted _at _range[min] Tarikh paling awal apabila iklan pekerjaan disiarkan oleh majikan semasa orang itu. Gunakan parameter ini bersama organization_job_posted_at_range[max] untuk menetapkan julat tarikh penyiaran iklan. Contoh: 2025-07-25
- Jenis: array string[]organization
_locations[] Lokasi ibu pejabat syarikat bagi majikan semasa seseorang. Anda boleh mencari merentas bandar, negeri AS dan negara. Jika syarikat mempunyai beberapa lokasi pejabat, hasil tetap berdasarkan lokasi ibu pejabat. Contohnya, jika anda mencari chicago tetapi lokasi ibu pejabat syarikat berada di boston, orang yang bekerja untuk syarikat yang berpangkalan di Boston tidak akan muncul dalam hasil anda, walaupun mereka sepadan dengan parameter lain. Untuk mencari orang berdasarkan lokasi peribadi mereka, gunakan parameter person_locations. Contoh: texas; tokyo; spain
- Jenis: array string[]organization
_num _employees _ranges[] Julat bilangan pekerja yang bekerja di syarikat semasa orang itu. Ini membolehkan anda mencari orang berdasarkan bilangan pekerja majikan mereka. Anda boleh menambah berbilang julat untuk meluaskan hasil carian. Setiap julat mesti rentetan, dengan nombor atas dan bawah dipisahkan hanya dengan koma. Contoh: 1,10; 250,500; 10000,20000
- Jenis: integerorganization
_num _jobs _range[max] Bilangan maksimum iklan pekerjaan aktif di majikan semasa orang itu. Gunakan parameter ini bersama organization_num_jobs_range[min] untuk menetapkan julat iklan pekerjaan. Contoh: 50; 500
- Jenis: integerorganization
_num _jobs _range[min] Bilangan minimum iklan pekerjaan aktif di majikan semasa orang itu. Gunakan parameter ini bersama organization_num_jobs_range[max] untuk menetapkan julat iklan pekerjaan. Contoh: 50; 500
- Jenis: integerpage
Nombor halaman data Apollo yang ingin anda ambil. Gunakan parameter ini bersama parameter per_page supaya hasil carian boleh dinavigasi dan meningkatkan prestasi endpoint. Contoh: 4
- Jenis: integerper
_page Bilangan hasil carian yang perlu dipulangkan bagi setiap halaman. Menghadkan bilangan hasil setiap halaman meningkatkan prestasi endpoint. Gunakan parameter page untuk mencari merentas halaman data yang berbeza. Contoh: 10
- Jenis: array string[]person
_locations[] Lokasi tempat orang tinggal. Anda boleh mencari merentas bandar, negeri AS dan negara. Untuk mencari orang berdasarkan lokasi ibu pejabat majikan semasa mereka, gunakan parameter organization_locations. Contoh: california; ireland; chicago
- Jenis: array string[]person
_seniorities[] Kekananan jawatan yang dipegang orang dalam majikan semasa mereka. Ini membolehkan anda mencari orang yang kini memegang jawatan pada tahap pelaporan tertentu, seperti tahap Director atau IC kanan. Untuk seseorang dimasukkan dalam hasil carian, mereka hanya perlu sepadan dengan 1 daripada kekananan yang anda tambah. Menambah lebih banyak kekananan meluaskan hasil carian. Carian hanya memulangkan hasil berdasarkan jawatan semasa, jadi mencari pekerja tahap Director hanya memulangkan orang yang kini memegang jawatan tahap Director. Jika seseorang dahulunya Director tetapi kini VP, mereka tidak akan dimasukkan dalam hasil carian. Gunakan parameter ini bersama parameter person_titles[] untuk mencari orang berdasarkan fungsi kerja dan tahap kekananan tertentu. Pilihan berikut boleh digunakan untuk parameter ini: owner founder c_suite partner vp head director manager senior entry intern
- Jenis: array string[]person
_titles[] Jawatan yang dipegang oleh orang yang ingin anda cari. Untuk seseorang dimasukkan dalam hasil carian, mereka hanya perlu sepadan dengan 1 daripada jawatan yang anda tambah. Menambah lebih banyak jawatan meluaskan hasil carian. Hasil juga merangkumi jawatan dengan istilah yang sama, walaupun bukan padanan tepat. Contohnya, mencari marketing manager mungkin memulangkan orang dengan jawatan content marketing manager. Gunakan parameter ini bersama parameter person_seniorities[] untuk mencari orang berdasarkan fungsi kerja dan tahap kekananan tertentu. Contoh: sales development representative; marketing manager; research analyst
- Jenis: stringq
_keywords Rentetan perkataan yang digunakan untuk menapis hasil.
- Jenis: array string[]q
_organization _domains _list[] Nama domain majikan orang itu. Ini boleh jadi majikan semasa atau bekas majikan. Jangan sertakan www., simbol @ atau seumpamanya. Parameter ini menerima sehingga 1,000 domain dalam satu permintaan. Contoh: apollo.io; microsoft.com
- Jenis: array string[]q
_organization _job _titles[] Jawatan yang tersenarai dalam iklan pekerjaan aktif di majikan semasa orang itu. Contoh: sales manager; research analyst
- Jenis: integerrevenue
_range[max] Pendapatan maksimum yang dijana oleh majikan semasa orang itu. Gunakan parameter ini bersama revenue_range[min] untuk menetapkan julat pendapatan. Jangan masukkan simbol mata wang, koma atau titik perpuluhan dalam angka itu. Contoh: 500000; 1500000
- Jenis: integerrevenue
_range[min] Pendapatan minimum yang dijana oleh majikan semasa orang itu. Gunakan parameter ini bersama revenue_range[max] untuk menetapkan julat pendapatan. Jangan masukkan simbol mata wang, koma atau titik perpuluhan dalam angka itu. Contoh: 500000; 1500000
- Jenis: object200
Respons berjaya
- Jenis: array string[]people
Array respons
- Jenis: integertotal
_entries Medan respons
application/json - 400
Permintaan tidak dapat diproses. Semak parameter permintaan.
- 401
Kunci API Felo yang sah diperlukan.
- 402
Permintaan tidak dapat diteruskan kerana keperluan pengebilan tidak dipenuhi.
- 403
Akaun tidak dibenarkan melakukan operasi ini.
- 429
Had permintaan atau had perbelanjaan telah dicapai.
- 502
Perkhidmatan tidak dapat menyelesaikan permintaan.
- 503
API atau perkhidmatan pengebilan tidak tersedia buat sementara waktu.
- 504
Perkhidmatan tamat masa semasa memproses permintaan.
- default
Respons ralat; respons passthrough huluan mungkin menggunakan format penyedia
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"
]
}