SuperAPI AI 工具集

apollo

营销与增长

查看项目

更新于 10-16 07:25

技能介绍

用途:通过 Apollo.io API 完成 B2B 潜在客户开发与冷启动外联自动化,适用于人物搜索、企业搜索、邮箱补全以及将联系人加入邮件序列等场景。

认证:所有请求需在请求头传入 API 密钥 x-api-key: $APOLLO_TOKEN。API 密钥获取路径为 Apollo 仪表盘 → Settings → Integrations → API → Create API Key。注意:将联系人加入序列需要 Master API Key,而非标准密钥。

主要能力与用法:基础地址为 https://api.apollo.io。人物搜索 POST /api/v1/mixed_people/api_search,可按 person_titles、person_locations、organization_num_employees_ranges、q_keywords 等筛选,返回 id、name、title、organization_name、linkedin_url,但不返回邮箱。企业搜索 POST /api/v1/mixed_companies/search,可按 organization_locations、organization_num_employees_ranges、q_organization_keyword_tags 筛选。人物补全 POST /api/v1/people/match,传入 first_name、last_name、organization_name 或 linkedin_url,reveal_personal_emails 设为 true 可包含个人邮箱(消耗更多额度),会消耗 credits,返回 person.email 与完整联系信息。批量补全 POST /api/v1/people/bulk_match,单次最多 10 条,返回 matches 数组。将联系人加入序列 POST /api/v1/emailer_campaigns/{sequence_id}/add_contact_ids,请求体含 contact_ids、emailer_campaign_id、send_email_from_email_account_id;序列 ID 可通过 POST /api/v1/emailer_campaigns/search 获取。

典型流程:先搜索目标人物,再对目标执行 Enrich 获取邮箱,最后将联系人加入邮件序列。

限制与排查:人物搜索不返回邮箱,需配合补全接口;加入序列需 Master API Key;批量补全每请求最多 10 条;序列中使用的 contact ID 在补全人物时自动创建。请求失败时可运行 zero doctor check-connector --env-name APOLLO_TOKEN,或 zero doctor check-connector --url https://api.apollo.io/api/v1/mixed_people/api_search --method POST 排查。