Apollo.io API 讓您自己的程式碼搜尋人員、豐富記錄並管理銷售工作流程。您可以使用 Apollo.io API 金鑰,透過 HTTPS 呼叫它。您也可以略過金鑰,讓 AI 用戶端透過 Apollo.io MCP 伺服器存取相同的資料。這兩種方式都會消耗您方案中的點數,並遵循方案限制。
本指南將帶您了解 Apollo.io API,從第一次點擊到第一次呼叫。內容說明如何建立金鑰以及在哪裡找到金鑰,並涵蓋 Apollo.io API 文件、健康檢查、人員搜尋、資料豐富、速率限制與點數成本。最後介紹 Apollo.io 的官方 MCP 伺服器,以及檢查 API 回傳地址的例行流程。所有內容皆來自 docs.apollo.io 的官方開發者文件,於 2026 年 10 月閱讀整理。Apollo.io 將數個頁面標示為近期更新,因此請在建置當天確認詳細資訊。
我們與 Apollo.io 沒有關聯。BillionVerify 是電子郵件驗證服務。若要更全面了解此平台,請閱讀我們的 Apollo.io 指南。
關鍵事實(2026 年 10 月確認):
- 每個方案都提供某種程度的 API 存取權,包括免費方案。免費帳號在使用某些端點時需要工作電子郵件地址。
- Apollo.io API 會在
x-api-key標頭中傳送金鑰,基礎 URL 為https://api.apollo.io/api/v1。 - 具有限定範圍的 Apollo.io API 金鑰只能存取您勾選的端點。主金鑰則可存取所有端點。
- 付費方案中的大多數端點每分鐘可接受 200 次呼叫,而免費方案為 50 次。
- Apollo.io MCP 伺服器位於
https://mcp.apollo.io/mcp,並使用 OAuth 登入。
Apollo.io API 的功能
Apollo.io 將其 API 描述為一種以程式方式搜尋、豐富、建立及管理資料的方法。其背後擁有超過 2.4 億筆聯絡人資料和 3,000 萬家公司資料庫。文件將這些工作分為三類:
- 建立整合。 將您的產品連接至 Apollo.io 資料,建立帳號並推動序列。
- 豐富資料。 一次填寫一筆或批次填寫人員與公司記錄。
- 尋找人員。 依據職稱、地點、資歷及許多其他篩選條件進行搜尋。
您的方案決定您可以使用哪些端點、呼叫速度,以及每次呼叫的費用。Apollo.io 也表示,其工具無法執行您在應用程式中無法完成的任何操作。如果您的帳號缺少某項功能,API 也不會解鎖該功能。
哪些方案包含 API?
開發者常見問題指出,每個級別都具備基本存取權限。更進階的功能僅適用於特定級別。我們的 Apollo.io 定價指南 列出了各級別及其點數配額。
免費帳號有一項限制。部分人員搜尋、資料豐富及記錄端點,需要使用工作電子郵件地址註冊的帳號。每個受影響的端點頁面都會說明這一點。付費帳號不受影響。
Apollo.io API 適合哪些人?
最常使用它的是以下三類使用者:
- 銷售和 RevOps 團隊,希望將豐富後的資料推送至 CRM 或資料倉儲。
- 軟體公司的開發者,將 Apollo.io 資料嵌入自己的產品。
- 合作夥伴,建立市場整合。他們使用 OAuth 2.0 登入,而不是使用金鑰。
Apollo.io 另外附帶一項授權說明。若要將其資料分享、公開或轉售給非 Apollo.io 使用者,則需要簽訂客製化合約。
Apollo.io API 文件:所有內容的位置
Apollo.io API 文件位於 docs.apollo.io。頂部列將內容分為開始使用、API、MCP、CLI、OpenAPI 和變更日誌。API 區段為每個端點提供一個頁面。

螢幕擷取畫面:Apollo.io 開發者文件中的 People API 搜尋頁面,取自 Apollo.io 關於測試金鑰的指南。
每個端點頁面都遵循相同的模式。頂部的「端點要點」方塊會列出主要存取路徑、OAuth 範圍、可使用者員,以及所需的信用額度。下方則是參數。右側提供語言選擇器、憑證欄位、cURL 請求和範例回應。
你可以直接在頁面上進行即時測試。將金鑰貼到標頭欄位中,填入必要參數,然後按下「試用」。200 表示呼叫成功。即使沒有金鑰,你仍可開啟每個範例回應來查看結構描述。
OpenAPI 檔案
Apollo.io 將完整 API 發布為一個 OpenAPI 3 檔案,位於 https://docs.apollo.io/openapi/apollo-rest-api.json。文件變更時,該檔案也會重新建立。將它載入 Postman 或其他 API 用戶端後,每個端點及其參數都會一併匯入。你也可以將它提供給程式碼產生器,以使用自己的程式語言建立具型別的用戶端。
在 Postman 中,將金鑰保留在預先設定的 API Key 授權中,並設定 apiKey 變數。文件提醒,將金鑰貼上為 Bearer token 會傳回 401。Bearer token 僅供 OAuth 合作夥伴使用。
可供機器讀取的索引
文件也會在 docs.apollo.io/llms.txt 發布純文字索引。索引會將每個頁面列為 Markdown 連結。AI 程式碼工具可以讀取它,以尋找正確的端點頁面,而不必爬取整個網站。
如何取得 Apollo.io API 金鑰
Apollo.io API 金鑰是在應用程式內建立,而不是在文件網站上建立。路徑為「設定」,接著選擇「整合」,再選擇「API 金鑰」。只有管理員可以執行此操作,權限設定檔涵蓋金鑰的使用者也可以。
以下是逐步取得 Apollo.io API 金鑰存取權的方法:
- 開啟 Apollo.io,然後點選 設定 > 整合 > API 金鑰。developer.apollo.io 上的開發人員儀表板會顯示相同頁面。
- 點選 建立新金鑰。
- 輸入名稱和描述。
- 勾選金鑰可以呼叫的每個端點,或開啟 設為主金鑰。
- 點選 建立 API 金鑰。
- 點選 複製,並將金鑰貼到安全的位置。

截圖:Apollo.io 開發人員入口網站中的「建立新 API 金鑰」對話方塊,來源為 Apollo.io 的文件。
Apollo.io 會在最後顯示完整金鑰。請在此時複製金鑰。如果遺失金鑰,請從儀表板重新產生。
在哪裡找到現有的 Apollo.io API 金鑰
如果你需要尋找先前建立的 Apollo.io API 金鑰,請返回開發人員儀表板並開啟 API 金鑰頁面。你建立的每個金鑰都會列在其中。入口網站側邊欄也包含「快速入門」、「使用量」和「訂閱」頁面。同一個側邊欄還有供合作夥伴使用的 OAuth 註冊頁面。
Apollo.io 允許你對現有金鑰執行兩項操作。重新產生會提供新的密鑰並將其複製。刪除會永久移除金鑰。請將這兩項操作都視為單向操作,因為所有使用舊金鑰的指令碼都會失效。
主金鑰或限定範圍金鑰?
建立 Apollo.io API 金鑰時,這項選擇比其他任何選擇都重要。
| 類型 | 可存取的範圍 | 適用情境 |
|---|---|---|
| 限定範圍金鑰(預設) | 只有你勾選的端點 | 大多數整合 |
| 主金鑰 | 所有端點 | 要求主金鑰的端點,以及透過金鑰使用的 MCP 伺服器 |
如果限定範圍金鑰呼叫了你未勾選的端點,就會收到 403。某些端點,例如工作區使用者清單,只能使用主金鑰。Apollo.io 建議你將主金鑰視同密碼管理。它可以執行帳號允許的任何 API 操作。
金鑰會代表哪位使用者執行操作?
Apollo.io API 金鑰會識別你的工作區,而不是某個人。Apollo.io 無法判斷是哪位團隊成員使用金鑰。每個請求都會以工作區中任職最久且目前啟用的管理員身分執行,而該使用者會擁有呼叫所建立的任何項目。若要查看該使用者,請呼叫取得目前使用者設定檔的端點,此操作不會消耗點數。
對於使用權限受限的登入帳號建立金鑰的團隊來說,這一點可能令人意外。金鑰不會縮小程式碼可以存取的範圍。
Apollo.io API 健康檢查
測試新金鑰最快的方法,是執行一次健康檢查呼叫。這是對 auth/health 發出的單一 GET 請求,不會消耗任何額度。
curl --request GET \ --url 'https://api.apollo.io/api/v1/auth/health' \ --header 'Content-Type: application/json' \ --header 'x-api-key: YOUR_API_KEY'
如果所有設定都正確,Apollo.io API 健康檢查會回傳兩個值:
{ "healthy": true, "is_logged_in": true }
當兩者都是 true 時,金鑰即可正常運作。如果其中任何一個是 false,請檢查金鑰後方是否有多餘的空格或換行,然後再次傳送請求。在 Postman 中,將 Authorization 類型設為 No Auth,並改為將金鑰新增為標頭。
Apollo.io API 是否中斷?
搜尋這個詞的人有時想知道的是另一個答案。他們想確認服務本身是否中斷。auth/health 呼叫會測試你的金鑰和登入狀態,而不是整個平台。若發生中斷,Apollo.io 會在 status.apollo.io 提供狀態頁面。
回應 429 且代碼為 USAGE.RATE_LIMIT.PLATFORM_RATE_LIMIT,表示平台因整體負載過高而拒絕流量。這與你的方案無關。文件指出,請等待 60 秒後重試。
Apollo.io API 的主要端點群組
參考文件列出了數十個端點,這些端點可分為六個群組。
| 群組 | 涵蓋內容 | 範例 |
|---|---|---|
| 搜尋與擴充 | 尋找人員與公司、填入記錄 | People API 搜尋、人員資料擴充、組織搜尋 |
| 管理記錄 | 帳戶、聯絡人、交易、清單、備註 | 建立聯絡人、批次更新帳戶、將記錄新增至清單 |
| 與潛在客戶互動 | 序列、電子郵件、通話、工作、對話 | 將聯絡人新增至序列、立即傳送電子郵件 |
| AI 助理 | 將工作交給內建助理 | 執行助理工作、輪詢助理工作 |
| 工作區 | 使用者、信箱、自訂欄位 | 取得使用者清單、建立自訂欄位 |
| 分析與使用量 | 報告、使用量統計、webhook 結果 | 查詢分析報告、檢視使用量統計 |
記錄管理、序列以及大多數工作區呼叫都使用 0 點數。費用集中在搜尋與資料擴充功能上,以下將介紹這些內容。
搜尋不等於資料擴充
這項區分常讓新使用者感到困惑。搜尋 Apollo.io 的人員資料庫會傳回個人檔案,但結果不包含電子郵件或電話。你需要再呼叫一次資料擴充端點,才能取得這些資訊。搜尋你自行儲存的聯絡人則使用另一組端點,而且限制也有所不同。
Apollo.io API 人員搜尋文件
Apollo.io API 人員搜尋文件涵蓋一個 POST 端點:/mixed_people/api_search。Apollo.io 將尚未儲存為聯絡人的全新潛在客戶稱為人員。
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'
參數會放在查詢字串中。您可以透過以下方式縮小搜尋範圍:
- 職稱:
person_titles[],以及用於排除部分職稱的person_not_titles[]。 - 職級:
person_seniorities[]。 - 地點:
person_locations[]用於人員居住地,organization_locations[]用於公司總部所在地。 - 公司規模與營收:
organization_num_employees_ranges[]和revenue_range[min]。 - 技術: 篩選公司使用的超過 1,500 項技術。
- 招募訊號:
q_organization_job_titles[]和職缺刊登數量。 - 電子郵件狀態:
contact_email_status[],值包括已驗證、未驗證、可能互動及無法使用。 - 分頁:
page和per_page。
人員搜尋端點使用 0 個點數。每頁最多會傳回 100 筆記錄。此外,它還有 50,000 筆記錄的顯示上限,也就是 500 頁。請新增篩選條件以維持在此上限以下。
Apollo.io API 人員搜尋會傳回什麼
人員搜尋回應包含 total_entries 計數和 people 清單。回應不包含電子郵件地址和電話號碼。若要取得聯絡詳細資料,請將每筆結果傳送至資料豐富化端點。
搜尋有自己的限制,列於下方的速率限制章節中。
如果您使用 contact_email_status[] 搜尋,請記住該值的來源。它描述 Apollo.io 自身對該地址的記錄,而不是即時信箱測試結果。
如何更快閱讀 Apollo.io API 人員搜尋文件
先查看端點要點方塊。確認點數使用量和免費帳戶存取權限列。接著掃描參數清單,找出您需要的篩選條件。最後,先使用 per_page=10 執行一個小型請求,再逐頁瀏覽數千筆結果。
使用 Apollo.io API 豐富人員資料
資料豐富會更新您已持有的記錄。Apollo.io 為人員提供兩個端點:
- 人員資料豐富:
POST /people/match,每次呼叫處理一位人員。 - 批次人員資料豐富: 單一請求最多處理 10 位人員。
Apollo.io 需要足夠的詳細資料,才能比對出正確的人員。單獨使用電子郵件地址即可。姓名加上公司網域也可以。此端點也接受 LinkedIn URL、組織名稱或 Apollo.io 人員 ID。如果您只傳送姓名,可能會收到 200 回應,但沒有豐富任何資料。
請檢查每個回應中的 match_confidence。其值為 high、medium、low 或 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'
回應會包含該人員的職稱、任職歷史、公司資料,以及例如 verified 的 email_status。該狀態是 Apollo.io 自有的標籤。本指南稍後的檢查會測試該地址本身。
電話、個人地址與瀑布式搜尋
三個選用的開關會改變您收到的資料:
reveal_personal_emails=true會加入個人地址。對於位於 GDPR 地區的人員,Apollo.io 不會揭露這些地址。reveal_phone_number=true會加入所有電話號碼,包括手機號碼。此功能需要webhook_url。Apollo.io 會非同步檢查這些號碼,並將結果發送至您的 webhook,可能需要幾分鐘。run_waterfall_email和run_waterfall_phone會先搜尋 Apollo.io,接著搜尋您設定的外部資料提供者。最終結果也會透過 webhook 傳送。
避免重複付費
如果您稍後再次豐富同一位人員的資料,可能會再次為相同資料消耗點數。Apollo.io 建議將已豐富資料的人員轉換為聯絡人。聯絡人隸屬於您的組織,因此其資料會持續可供存取。
Apollo.io API 速率限制
速率限制是以團隊為單位,而不是以金鑰或使用者為單位。限制也依端點區分,並同時套用三個時間視窗:分鐘、小時和一天。您必須遵守所有適用的時間視窗。
| 限制 | 免費版 | 基本版 | 專業版 | 組織版 |
|---|---|---|---|---|
| 每分鐘請求數 | 50 | 200 | 200 | 200 |
| 每小時請求數 | 200 | 400 | 400 | 600 |
| 每日請求數 | 600 | 2,000 | 2,000 | 6,000 |
上述表格是預設值。付費方案的搜尋和資料擴充端點享有更高的限制:
- **資料擴充端點:**付費方案每分鐘可發出 1,000 個請求,且沒有每小時或每日上限。免費帳號每分鐘可發出 50 個請求,批次端點則為 20 個。
- **搜尋端點:**付費方案每分鐘 200 個請求、每小時 6,000 個請求,以及每日 50,000 個請求。
- **較低的限制:**查詢分析報告每小時允許 5 個請求。
Apollo.io 的文件指出,高資料擴充限制並不代表可以無限制地發送呼叫。您的點數餘額仍會控制可進行資料擴充的量。

截圖:Apollo.io 開發者入口網站的 Usage 頁面,顯示資料擴充端點的每日與每小時限制,內容來自 Apollo.io 的文件。
回應標頭與 429 錯誤
Apollo.io 會在已驗證的呼叫中加入標頭。這些標頭會顯示每個時間視窗的限制、目前使用量,以及剩餘請求數:
x-rate-limit-minute、x-rate-limit-hourly和x-rate-limit-24-hourx-minute-usage、x-hourly-usage和x-24-hour-usagex-minute-requests-left、x-hourly-requests-left和x-24-hour-requests-leftretry-after會與429一起傳送,提供距離時間視窗重設前的秒數
當您超過限制時,會收到 429。讀取 retry-after 並等待。時間視窗會在您的第一次請求時開始,而不是依照時鐘時間計算。錯誤主體包含 error_details 物件。對於您自己的限制,其 code 為 USAGE.RATE_LIMIT.API_RATE_LIMIT_EXCEEDED。
若要在程式碼中讀取團隊目前的限制,請呼叫 view API usage stats 端點。單次呼叫最多可涵蓋 74 個端點路徑,而且完全不會消耗點數。
Apollo.io API 點數:哪些項目需要付費
許多呼叫完全免費。Apollo.io 表示,建立、更新、列出或管理記錄的端點會消耗 0 點數。點數會用於資料豐富、組織搜尋、新聞搜尋和 AI 洞察端點,而且只有在這些端點回傳符合條件的資料時才會消耗。
| 端點 | 點數成本 |
|---|---|
| 人員資料豐富 | 每人 1 至 9 點:人口統計資料或電子郵件各需 1 點,若回傳手機號碼則額外需要 8 點 |
| 批次人員資料豐富 | 相同邏輯,每次請求最多 10 人 |
| 組織資料豐富 | 每個組織 1 點 |
| 組織搜尋 | 每頁 1 點,每頁最多 100 筆結果 |
| 新聞文章搜尋 | 每頁 1 點,每頁最多 25 筆結果 |
| 組織職缺 | 每頁 1 點 |
| 取得完整人員資訊 | 每人 1 點 |
| 助理任務 | 不固定,由助理執行的動作決定 |
人員搜尋免費,因此合理的做法是先搜尋,再只為最符合條件的結果進行資料豐富。對會消耗點數的端點進行分頁時,每一頁都會消耗點數。Apollo.io 建議先進行小規模測試,並在擴大規模前查看使用量。
瀑布式資料豐富可能會產生更高成本。電子郵件瀑布式資料豐富通常使用 1 至 4 點,某些設定可能使用 20 點以上。電話瀑布式資料豐富通常使用 8 至 25 點,某些情況可能使用 45 點以上。
若要追蹤支出,請在應用程式中開啟「設定 > 帳單與點數 > 點數使用量」。開發者儀表板的「使用量」分頁會顯示目前帳單週期中已使用的電話和電子郵件點數。舊版方案可能有所不同,因此請查看工作區的「點數說明」頁面。
錯誤與狀態碼
大多數 Apollo.io API 端點共用一份簡短的狀態碼清單:
| 代碼 | 意義 | 常見原因 |
|---|---|---|
401 | 未授權 | 缺少金鑰、金鑰無效,或來自未啟用的帳號 |
403 | 禁止存取 | 方案不具備 API 存取權,或具範圍限制的金鑰缺少該端點的存取權 |
404 | 找不到 | 紀錄不存在,或您無法檢視該紀錄 |
422 | 無法處理 | 參數無效或缺少參數 |
429 | 請求過多 | 您已超過速率限制 |
500 | 伺服器錯誤 | Apollo.io 端發生故障,因此請重試 |
Apollo.io 正在將錯誤統一為一種格式。端點完成遷移後,回應會包含 error_details 物件,其中有穩定的 code、message、suggestions 和 context。請根據 error_details.code 來分支處理程式碼,絕不要根據訊息文字判斷。Apollo.io 計畫於 2027 年 2 月 16 日移除舊有的根層級錯誤欄位,因此請立即開始使用新的物件。
Apollo.io MCP 伺服器
MCP 是一項標準,可讓 AI 工具呼叫外部服務。Apollo.io MCP 伺服器會將 Claude、ChatGPT 及類似的用戶端連結至您的 Apollo.io 帳號。接著,您可以使用一般語言提出要求:找出 SaaS 公司中 VP 級別的行銷主管,或豐富這十位潛在客戶的資料。

螢幕擷取畫面:開發者文件中的 Apollo.io MCP 頁面,2026 年 10 月。
三種連線方式
| 路徑 | 運作方式 |
|---|---|
| AI 連接器 | ChatGPT、Claude、Perplexity、Replit 和 Cursor 上的內建整合。不需要設定伺服器。 |
| 程式設計外掛程式 | 適用於 Codex 等工具的第一方外掛程式。 |
| 獨立 MCP 伺服器 | 將任何支援遠端伺服器的 MCP 用戶端指向一個 URL。 |
獨立設定很簡短:
| 設定 | 值 |
|---|---|
| Endpoint | https://mcp.apollo.io/mcp |
| Transport | Streamable HTTP |
| Sign-in | OAuth 2.0 |
| Local install | 不需要 |
| API key | 不需要,除非用戶端沒有瀏覽器 |
在 Claude Code 中,一個指令即可新增伺服器。執行指令後,輸入 /mcp 並完成 OAuth 登入:
claude mcp add --transport http apollo https://mcp.apollo.io/mcp
如果您管理多個工作區,請為每個工作區使用不同名稱新增相同的 URL。分別登入每個連線。
沒有瀏覽器的伺服器
OAuth 需要瀏覽器視窗。cron 工作或 CI 管線都沒有瀏覽器。對於這些情況,伺服器接受以 X-Api-Key 傳送的 API key。該金鑰必須是 master key。範圍限定金鑰會收到代碼為 API_INACCESSIBLE 的 403,因為 MCP 伺服器不是您可以勾選的端點之一。
請像儲存任何正式環境密鑰一樣儲存該金鑰。它會以工作區管理員的身分運作,並消耗工作區點數。新的 MCP 工具會立即接觸到 master key,但您的用戶端可能會保留快取的工具清單。重新連線並呼叫 tools/list 以重新整理清單。
Apollo.io MCP 伺服器可以做什麼
工具清單涵蓋搜尋和潛在客戶開發、人員與公司資料豐富化、聯絡人、清單、序列、一次性電子郵件、工作、電子郵件網域檢查和分析。資料豐富化操作會使用點數。大多數其他操作不會使用點數。Apollo.io 警告,人員搜尋不會回傳電子郵件或電話,因此您的助理必須針對這些資料執行豐富化步驟。
文件中的實際限制:
- 連線不會產生額外費用。您的方案、權限和點數仍然適用。
- 不支援破壞性操作,例如大量刪除。
- 伺服器會遵循您的權限。使用 OAuth 時,它會以登入使用者的身分運作。
- Apollo.io MCP 使用獨立的速率限制,且不會回傳速率限制標頭。
- Apollo.io 禁止使用其 MCP 資料訓練 AI 模型,因此請先在您的 AI 用戶端中關閉訓練功能。
Apollo.io 建議將會消耗點數的操作設定為需要核准,讓健談的助理無法自行耗盡點數。
使用 Apollo.io API 的其他方式
- Apollo.io CLI。 可存取完整 API 的命令列工具。您可以使用 Homebrew、預先建置的二進位檔,或從原始碼安裝。它使用 OAuth,因此不需要金鑰。
- OAuth 2.0。 合作夥伴使用它為共同客戶呼叫 API,而文件列出了可供已完成整合使用的 Marketplace 應用程式。
- Chrome 擴充功能。 如果您偏好點擊操作而非撰寫程式碼,請閱讀我們的 Apollo Chrome 擴充功能指南。
在發送前先從 Apollo.io API 檢查地址
無論您選擇哪種方式,資料都有一個弱點:它來自資料庫。人們會更換工作,公司也會移至新的網域。email_status 欄位是 Apollo.io 自己的標籤,不是最新的測試結果。向失效地址發送冷郵件會退信,而退信會損害您的寄件者信譽。
因此,請在資料豐富與序列之間加入檢查。BillionVerify 會測試每個地址,而不會發送訊息。它會檢查語法、網域、MX 紀錄,以及在您要求時透過 SMTP 檢查信箱。它會標示拋棄式地址和角色地址。它會將 catch-all 回報為獨立結果,而不是將其計入有效地址。未知結果不收取費用,且在 24 小時內重新檢查免費。在串接 API 前,您可以先在免費網頁檢查工具上手動檢查電子郵件地址是否存在。

BillionVerify 會為每個地址回傳狀態、可投遞旗標和原因。
一個小型管線
簡單的管線包含四個步驟:
- 透過 API 執行免費的人員搜尋。
- 只對最佳匹配結果進行資料豐富。
- 將每個地址傳送至 BillionVerify REST API。
- 只將可投遞地址加入您的序列。
BillionVerify 呼叫只需要一個 POST。將金鑰放在 BV-API-KEY 標頭中,並將 check_smtp 設為 true,以執行即時信箱測試:
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}'
回覆會包含 status、is_deliverable、is_catchall、is_role、is_disposable 和 reason。若要在一次呼叫中處理最多 50 個地址,請使用批次路由。若要處理完整匯出檔案,請上傳 CSV、TXT 或 XLSX 檔案,稍後再下載結果。完整參考資料請參閱 BillionVerify 文件。
從 AI 用戶端驗證
如果您已將 Apollo.io 的 MCP 設定連接至 AI 用戶端,請在旁邊加入 BillionVerify 託管的 MCP 伺服器。其位於 https://mcp.billionverify.com/mcp,並使用 OAuth 登入。如此一來,您的助理便能在同一段對話中,透過 Apollo.io 豐富潛在客戶資料並檢查地址。告訴它您的政策,例如要接受哪些狀態,以及如何處理 catch-all。
其他檢查
- 我們的 Apollo 電子郵件驗證頁面涵蓋匯出流程。
- 可疑聯絡人可以使用我們免費的反向電子郵件查找,查看公開資訊中與該地址相關的內容。
- 透過 webhook 回傳的電話號碼也值得測試。我們免費的電話號碼驗證工具會顯示號碼在其所在國家是否有效,以及它屬於哪種線路類型。
BillionVerify 每天在您使用帳號時提供 20 個免費點數,每月最多 600 個。這些點數永不過期,也不需要信用卡。
建立 Apollo.io API 的技巧
- 每個整合一開始使用一個限定範圍的金鑰。 如果其中一個洩漏,只需撤銷該金鑰。
- 先執行健康檢查。 在偵錯程式碼前,先排除金鑰問題。
- 閱讀「端點要點」方框。 Apollo.io API 的人員搜尋文件會預先顯示信用額度成本。
- 先搜尋,再進行資料豐富。 搜尋免費,但資料豐富並非免費。
- 使用
per_page=10進行測試。 小批次執行可在成本造成影響前,先了解信用額度消耗。 - 遵守
retry-after。 持續對受限端點發送大量請求,只會延長等待時間。 - 閱讀
error_details.code。 訊息文字可能在未通知的情況下變更。 - 寄送前先驗證。 花費信用額度在退信地址上,等於浪費兩次。
常見問題
Apollo.io 有 API 嗎?
有,Apollo.io 提供 REST API。它可讓您搜尋人員與公司、豐富聯絡人資料,以及更新帳戶、交易與序列。每個方案層級都包含基本存取權。您的方案會決定您可呼叫哪些端點、呼叫速度,以及每次呼叫的費用。
如何取得 Apollo.io API 金鑰?
Apollo.io 金鑰可從設定的整合區域取得:開啟 API Keys,然後選擇 Create new key。為金鑰命名、勾選它可呼叫的端點並確認,接著立即複製密鑰。管理員或具備適當權限設定檔的使用者都可以執行此操作。
我可以在哪裡找到 Apollo.io API 金鑰?
您的 Apollo.io API 金鑰清單位於 API Keys 頁面,您可以從應用程式或開發者儀表板進入。完整密鑰會在建立金鑰時顯示。若遺失密鑰,就必須重新產生金鑰,系統會核發新的金鑰。
Apollo.io API 免費嗎?
建立、列出或更新記錄的 Apollo.io API 呼叫不收費,人員搜尋也不收費。豐富資料功能與部分搜尋端點會在傳回資料時收取點數。免費帳戶可在免費方案的限制內呼叫 API,但部分端點需要工作電子郵件。
Apollo.io API 的速率限制是多少?
在付費方案層級中,大多數 Apollo.io API 端點每分鐘可接受 200 次呼叫,另有依方案層級而異的每小時與每日上限。免費方案每分鐘可接受 50 次、每小時 200 次、每日 600 次。限制會套用至每個團隊與端點,而 429 回應表示您已超過限制。
如何測試 Apollo.io API 健康檢查?
Apollo.io 健康檢查是向 auth/health 路徑發出的 GET 請求,並設定金鑰標頭。若回應為 healthy: true 和 is_logged_in: true,表示金鑰可正常運作。此操作不會消耗點數。
Apollo.io API 的人員搜尋會傳回電子郵件嗎?
不會,Apollo.io 人員搜尋端點只會傳回個人檔案,不包含電子郵件或電話。請對搜尋結果執行人員資料豐富或大量人員資料豐富端點,以取得聯絡詳細資料;此操作會消耗點數。
Apollo.io API 文件在哪裡?
Apollo.io API 文件位於 docs.apollo.io。每個端點都有自己的頁面,包含參數、測試面板與範例回應。您也可以下載 OpenAPI 檔案並匯入 Postman。
什麼是 Apollo.io MCP 伺服器?
Apollo.io MCP 伺服器透過 Model Context Protocol 將 AI 用戶端連結至您的工作區。其 URL 為 https://mcp.apollo.io/mcp,使用 Streamable HTTP 和 OAuth,且不需要本機安裝。您的方案、權限與點數仍然適用。
Apollo.io 最佳的 MCP 伺服器是哪一個?
Apollo.io 只發布一個官方 MCP 伺服器,這也是其文件所描述的伺服器。我們沒有測試第三方選項。如果您希望使用與應用程式相同的權限和點數規則,請選擇官方伺服器。
我應該驗證來自 Apollo.io API 的電子郵件嗎?
是,請在進行行銷活動前檢查來自 Apollo.io API 的每個電子郵件地址。email_status 欄位反映 Apollo.io 自身的記錄,而人員可能會更換工作。透過 BillionVerify API 快速檢查可移除失效地址,並保護您的寄件者信譽。
觀看影片:如何驗證電話號碼:免費電話號碼驗證器
觀看影片:如何在傳送前驗證 Apollo 信箱
