用途:提供一个最小的 Apollo.io API 可用示例,适合在新建 Apollo 集成、验证配置或学习基本 Apollo API 用法时参考。前置条件:已完成 apollo-install-auth 设置,并在 APOLLO_API_KEY 环境变量中配置有效 API 密钥。
主要能力与用法:
- 人员搜索:POST /mixed_people/api_search,在 Apollo 数据库中按组织域名、职位、职级等条件检索联系人,可翻页。该端点免费,不消耗补全额度,但不会返回邮箱或电话。
- 人员补全:POST /people/match,按邮箱、LinkedIn URL 或姓名加域名组合查询,返回姓名、职位、邮箱、公司、LinkedIn 等完整联系方式,每次消耗 1 个额度。
- 组织补全:GET /organizations/enrich,按域名查询,返回公司名称、行业、员工数、营收、总部地点、技术栈等,每次消耗 1 个额度。
请求统一使用 POST/GET 到 https://api.apollo.io/api/v1,请求头需含 Content-Type: application/json 与 x-api-key。资料同时给出 TypeScript(axios)与 Python(requests)两种实现。
限制与错误处理:401 表示 x-api-key 缺失或无效;422 表示请求体格式错误;429 表示超出每分钟请求数,应退避重试;people 数组为空表示过滤条件无匹配,可放宽条件或更换域名。示例建议先对有权研究的组织执行免费人员搜索,确认凭据、响应结构与分页;首次消耗额度的检查使用公开组织域名并设置 1 个额度的测试预算,仅保留验证集成所需的公司级字段。不要将真实个人邮箱用作教程样例,也不要打印含个人联系数据的响应。若鉴权失败、响应为空或预算保护不可用,应在补全前停止并修正配置。后续步骤为 apollo-local-dev-loop;其余细节暂未提供。