网淘吧来吧，欢迎您！

返回首页 微信
微信
手机版
手机版
  • 当前位置：
  • 网淘吧
  • >
  • openclaw小龙虾
    • Apollo

    Apollo

    2026-03-27 新闻来源：网淘吧 围观:12
    电脑广告
    手机广告

    阿波罗

    通过托管的OAuth认证访问Apollo.io API。搜索个人和组织，丰富联系人信息，并管理您的销售流程。

    快速开始

    # Search for people at a company
python <<'EOF'
import urllib.request, os, json
data = json.dumps({'q_organization_name': 'Google', 'per_page': 10}).encode()
req = urllib.request.Request('https://gateway.maton.ai/apollo/v1/mixed_people/api_search', data=data, method='POST')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

    基础URL

    https://gateway.maton.ai/apollo/{native-api-path}

    替换{native-api-path}为实际的Apollo API端点路径。网关将请求代理至api.apollo.io并自动注入您的API密钥。

    认证

    所有请求都需要在Authorization头部中包含Maton API密钥：

    Authorization: Bearer $MATON_API_KEY

    环境变量：将您的API密钥设置为MATON_API_KEY：

    export MATON_API_KEY="YOUR_API_KEY"

    获取您的API密钥

    1. 登录或在maton.ai
    2. 创建账户前往
    3. maton.ai/settings

    复制您的API密钥

    在以下网址管理您的Apollo连接https://ctrl.maton.ai。

    列出连接

    python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://ctrl.maton.ai/connections?app=apollo&status=ACTIVE')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

    创建连接

    python <<'EOF'
import urllib.request, os, json
data = json.dumps({'app': 'apollo'}).encode()
req = urllib.request.Request('https://ctrl.maton.ai/connections', data=data, method='POST')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
req.add_header('Content-Type', 'application/json')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

    获取连接

    python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://ctrl.maton.ai/connections/{connection_id}')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

    响应：

    {
  "connection": {
    "connection_id": "21fd90f9-5935-43cd-b6c8-bde9d915ca80",
    "status": "ACTIVE",
    "creation_time": "2025-12-08T07:20:53.488460Z",
    "last_updated_time": "2026-01-31T20:03:32.593153Z",
    "url": "https://connect.maton.ai/?session_token=...",
    "app": "apollo",
    "metadata": {}
  }
}

    在浏览器中打开返回的网址以完成OAuth授权。

    删除连接

    python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://ctrl.maton.ai/connections/{connection_id}', method='DELETE')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

    指定连接

    如果您有多个Apollo连接，请使用Maton-Connection请求头指定要使用的连接：

    python <<'EOF'
import urllib.request, os, json
data = json.dumps({'q_organization_name': 'Google', 'per_page': 10}).encode()
req = urllib.request.Request('https://gateway.maton.ai/apollo/v1/mixed_people/api_search', data=data, method='POST')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
req.add_header('Maton-Connection', '21fd90f9-5935-43cd-b6c8-bde9d915ca80')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

    如果省略，网关将使用默认（最早创建的）活动连接。

    API参考

    人员

    搜索人员

    POST /apollo/v1/mixed_people/api_search
Content-Type: application/json

{
  "q_organization_name": "Google",
  "page": 1,
  "per_page": 25
}

    通过邮箱丰富人员信息

    POST /apollo/v1/people/match
Content-Type: application/json

{
  "email": "john@example.com"
}

    通过LinkedIn丰富人员信息

    POST /apollo/v1/people/match
Content-Type: application/json

{
  "linkedin_url": "https://linkedin.com/in/johndoe"
}

    组织

    搜索组织

    POST /apollo/v1/organizations/search
Content-Type: application/json

{
  "q_organization_name": "Google",
  "page": 1,
  "per_page": 25
}

    丰富组织信息

    POST /apollo/v1/organizations/enrich
Content-Type: application/json

{
  "domain": "google.com"
}

    联系人

    搜索联系人

    POST /apollo/v1/contacts/search
Content-Type: application/json

{
  "page": 1,
  "per_page": 25
}

    创建联系人

    POST /apollo/v1/contacts
Content-Type: application/json

{
  "first_name": "John",
  "last_name": "Doe",
  "email": "john@example.com",
  "organization_name": "Acme Corp"
}

    更新联系人

    PUT /apollo/v1/contacts/{contactId}
Content-Type: application/json

{
  "first_name": "Jane"
}

    账户

    搜索账户

    POST /apollo/v1/accounts/search
Content-Type: application/json

{
  "page": 1,
  "per_page": 25
}

    创建账户

    POST /apollo/v1/accounts
Content-Type: application/json

{
  "name": "Acme Corp",
  "domain": "acme.com"
}

    序列

    搜索序列

    POST /apollo/v1/emailer_campaigns/search
Content-Type: application/json

{
  "page": 1,
  "per_page": 25
}

    添加联系人至序列

    POST /apollo/v1/emailer_campaigns/{campaignId}/add_contact_ids
Content-Type: application/json

{
  "contact_ids": ["contact_id_1", "contact_id_2"]
}

    标签

    列出标签

    GET /apollo/v1/labels

    搜索过滤器

    常用搜索参数：

    • q_organization_name- 公司名称
    • q_person_title- 职位头衔
    • person_locations- 位置数组
    • organization_num_employees_ranges- 员工数量范围
    • q_keywords- 通用关键词搜索

    代码示例

    JavaScript

    const response = await fetch(
  'https://gateway.maton.ai/apollo/v1/mixed_people/api_search',
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': `Bearer ${process.env.MATON_API_KEY}`
    },
    body: JSON.stringify({
      q_organization_name: 'Google',
      per_page: 10
    })
  }
);

    Python

    import os
import requests

response = requests.post(
    'https://gateway.maton.ai/apollo/v1/mixed_people/api_search',
    headers={'Authorization': f'Bearer {os.environ["MATON_API_KEY"]}'},
    json={'q_organization_name': 'Google', 'per_page': 10}
)

    注意事项

    • 分页功能使用page和per_page在POST请求体中
    • 大多数列表接口使用POST请求并带有/search后缀
    • 邮箱信息增强功能会消耗积分
    • people/search和mixed_people/search已弃用 - 请使用mixed_people/api_search
    • 重要提示：使用curl命令时，若URL包含方括号（fields[]、sort[]、records[]），请使用curl -g) 用于禁用通配符解析
    • 重要提示：当通过管道将 curl 输出传递给jq或其他命令时，在某些 shell 环境中，像$MATON_API_KEY这样的环境变量可能无法正确展开。通过管道传递时，您可能会收到“无效的 API 密钥”错误。

    错误处理

    状态码含义
    400缺少 Apollo 连接
    401无效或缺少 Maton API 密钥
    429请求频率受限（每个账户每秒 10 次请求）
    4xx/5xx来自 Apollo API 的透传错误

    故障排除：API 密钥问题

    1. 检查MATON_API_KEY环境变量是否已设置：
    echo $MATON_API_KEY
    1. 通过列出连接来验证 API 密钥是否有效：
    python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://ctrl.maton.ai/connections')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

    故障排除：无效的应用名称

    1. 请确保您的URL路径以apollo开头。例如：
    • 正确示例：https://gateway.maton.ai/apollo/v1/mixed_people/api_search
    • 错误示例：https://gateway.maton.ai/v1/mixed_people/api_search

    资源

    免责申明
    部分文章来自各大搜索引擎，如有侵权，请与我联系删除。
    打赏
    文章底部电脑广告
    手机广告位-内容正文底部
    标签
    上一篇：Square 下一篇：Google Ads

    相关文章

    推荐文章
    图片测量软件工具下载链接

    图片测量软件工具下载链接

    图片测量工具使用帮助

    图片测量工具使用帮助

    热门浏览
    标签列表

    您是本站第290044名访客 今日有234篇新文章/评论