Apollo
Person and company enrichment, people search, company job postings and news. Requires Felo administrative permission.
People API 搜尋
找出符合條件的人員，而不是補全你已經確認的對象。可依職稱、資歷、地點、公司網域、員工人數與產業篩選，並以 page 與 per_page 分頁。傳回 total_entries 與 people 陣列。請注意搜尋刻意保留的資訊：項目帶有 last_name_obfuscated 與布林旗標——has_email、has_direct_phone、has_city、has_state、has_country——而不是實際值。搜尋只告訴你存在相符對象；補全才會揭露聯絡細節。將這些 id 傳入 post_apollo_people_match 或 post_apollo_people_bulk_match 以取得電子郵件與電話號碼，額度也是在那裡消耗。需要 Felo 管理權限。
定價參考
- 計量方式：以成功請求為固定成本基礎。
- 參考請求預估：USD 0.012。
僅供參考的中繼資料，並非帳戶報價、保證價格或消費上限。資源額度並非 Felo 額度。最終費用依 Felo 計費記錄為準。
- 類型: array string[]contact
_email _status[] 想尋找之人員的電子郵件狀態。可新增多個狀態以擴大搜尋範圍。可搜尋的狀態包括：verified unverified likely to engage unavailable
- 類型: array string[]currently
_not _using _any _of _technology _uids[] 依人員目前雇主使用的任一技術，將其從搜尋中排除。Apollo 支援依 1,500 多種技術篩選。Apollo 從多個來源計算技術資料，並定期更新。下載此 CSV 檔案即可查看支援技術的完整清單。對於 CSV 檔案中列出的技術，請用底線 (_) 取代空格和句點。範例：salesforce; google_analytics; wordpress_org
- 類型: array string[]currently
_using _all _of _technology _uids[] 依人員目前雇主使用的所有技術尋找人員。Apollo 支援依 1,500 多種技術篩選。Apollo 從多個來源計算技術資料，並定期更新。下載此 CSV 檔案即可查看支援技術的完整清單。對於 CSV 檔案中列出的技術，請用底線 (_) 取代空格和句點。範例：salesforce; google_analytics; wordpress_org
- 類型: array string[]currently
_using _any _of _technology _uids[] 依人員目前雇主使用的任一技術尋找人員。Apollo 支援依 1,500 多種技術篩選。Apollo 從多個來源計算技術資料，並定期更新。下載此 CSV 檔案即可查看支援技術的完整清單。對於 CSV 檔案中列出的技術，請用底線 (_) 取代空格和句點。範例：salesforce; google_analytics; wordpress_org
- 類型: booleaninclude
_similar _titles 此參數決定是否在回應中傳回職稱與你透過 person_titles[] 參數定義之名稱相似的人員。使用 person_titles[] 僅傳回職稱的嚴格相符結果時，請將此參數設為 false。
- 類型: array string[]organization
_ids[] 要納入搜尋結果之公司（雇主）的 Apollo ID。Apollo 資料庫中的每家公司都會被指派唯一 ID。若要尋找 ID，請呼叫 Organization Search 端點並確認 organization_id 的值。範例：5e66b6381e05b4008c8331b8
- 類型: array string[]organization
_job _locations[] 人員雇主正在積極招募的職缺地點。範例：atlanta; japan
- 類型: stringorganization
_job _posted _at _range[max] 人員目前雇主發布職缺的最新日期。與 organization_job_posted_at_range[min] 搭配使用可設定職缺發布日期範圍。範例：2025-09-25
- 類型: stringorganization
_job _posted _at _range[min] 人員目前雇主發布職缺的最早日期。與 organization_job_posted_at_range[max] 搭配使用可設定職缺發布日期範圍。範例：2025-07-25
- 類型: array string[]organization
_locations[] 人員目前雇主的公司總部位置。可跨城市、美國各州和國家搜尋。如果公司有多個辦公地點，結果仍以總部位置為準。例如搜尋 chicago，但公司總部位於 boston，則在這家波士頓公司工作的人員不會出現在結果中，即使他們符合其他參數。若要依人員的個人所在地尋找，請使用 person_locations 參數。範例：texas; tokyo; spain
- 類型: array string[]organization
_num _employees _ranges[] 人員目前公司的員工人數範圍。可據此依雇主的員工人數尋找人員。可新增多個範圍以擴大搜尋結果。新增的每個範圍都必須是字串，範圍的上下限之間只用逗號分隔。範例：1,10; 250,500; 10000,20000
- 類型: integerorganization
_num _jobs _range[max] 人員雇主目前活躍的職缺數量上限。與 organization_num_jobs_range[min] 搭配使用可設定職缺數量範圍。範例：50; 500
- 類型: integerorganization
_num _jobs _range[min] 人員雇主目前活躍的職缺數量下限。與 organization_num_jobs_range[max] 搭配使用可設定職缺數量範圍。範例：50; 500
- 類型: integerpage
要擷取的 Apollo 資料頁碼。與 per_page 參數搭配使用，可讓搜尋結果支援翻頁並提升端點效能。範例：4
- 類型: integerper
_page 每頁應傳回的搜尋結果數量。限制每頁結果數可提升端點效能。使用 page 參數可搜尋不同頁的資料。範例：10
- 類型: array string[]person
_locations[] 人員居住的地點。可跨城市、美國各州和國家搜尋。若要依人員目前雇主的總部位置尋找人員，請使用 organization_locations 參數。範例：california; ireland; chicago
- 類型: array string[]person
_seniorities[] 人員在目前雇主中擔任的職位資歷。可據此尋找目前處於特定匯報層級的人員，例如總監級或資深 IC 級。人員只要符合你新增的任一資歷，就會納入搜尋結果。新增更多資歷會擴大搜尋結果。搜尋僅依目前職稱傳回結果，因此搜尋總監級員工只會傳回目前持有總監級職稱的人員。如果某人過去是總監，但目前是副總裁，就不會納入搜尋結果。將此參數與 person_titles[] 參數搭配使用，可依特定職能與資歷層級尋找人員。此參數可使用下列選項：owner founder c_suite partner vp head director manager senior entry intern
- 類型: array string[]person
_titles[] 想尋找之人員持有的職稱。人員只要符合你新增的任一職稱，就會納入搜尋結果。新增更多職稱會擴大搜尋結果。結果也會包含使用相同詞語的職稱，即使並非完全相符。例如搜尋 marketing manager 可能會傳回職稱為 content marketing manager 的人員。將此參數與 person_seniorities[] 參數搭配使用，可依特定職能與資歷層級尋找人員。範例：sales development representative; marketing manager; research analyst
- 類型: stringq
_keywords 用來篩選結果的字詞字串。
- 類型: array string[]q
_organization _domains _list[] 人員雇主的網域名稱。可以是目前雇主或前雇主。請勿包含 www.、@ 符號或類似內容。此參數在單一請求中最多接受 1,000 個網域。範例：apollo.io; microsoft.com
- 類型: array string[]q
_organization _job _titles[] 人員目前雇主的活躍職缺中列出的職稱。範例：sales manager; research analyst
- 類型: integerrevenue
_range[max] 人員目前雇主的營收上限。與 revenue_range[min] 搭配使用可設定營收範圍。數字中請勿輸入貨幣符號、逗號或小數點。範例：500000; 1500000
- 類型: integerrevenue
_range[min] 人員目前雇主的營收下限。與 revenue_range[max] 搭配使用可設定營收範圍。數字中請勿輸入貨幣符號、逗號或小數點。範例：500000; 1500000
- 類型: object200
成功回應
- 類型: array string[]people
回應陣列
- 類型: integertotal
_entries 回應欄位
application/json - 400
無法處理該要求。請檢查請求參數。
- 401
需要有效的 Felo API 金鑰。
- 402
由於未符合計費要求，要求無法繼續。
- 403
該帳戶無權執行此操作。
- 429
已達到要求或支出上限。
- 502
服務無法完成該要求。
- 503
API 或計費服務暫時無法使用。
- 504
服務在處理要求時逾時。
- default
錯誤回應；上游透傳回應可能採用供應商格式
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"
]
}