跳转到主要内容
该 API 使用与应用相同的账号、席位和限制。你可以在自己的代码、数据管道中使用它,也可以通过 Claude Code、Codex 或 Cursor 等 AI 代理使用。 包含所有接口的完整参考文档请见 Swagger。你也可以在那里下载 OpenAPI JSON,并将其提供给你的 AI 代理。

基础 URL 与身份验证

所有请求都发送到:
在每个请求的 Authorization 请求头中携带你的 Gologin API 令牌:
此调用会列出你已连接的账号,按最新优先排序。已断开连接的账号不会包含在内。如果没有有效的令牌,API 会返回 401。 在 Gologin 应用中创建令牌:API & MCP > API > 新代币,或者在 AI 助手中的 已连接账号 下的 API 部分创建。令牌只能在付费套餐中创建,并且需要在 Gologin 中开启双重验证。

默认情况下,发送操作只是试运行

只有在传入 "send": true 时,才会真正发送邀请、消息、评论和回复。如果不传该参数,请求就是一次试运行:它会检查目标,并告诉你将会发生什么——收件人是谁、是否可以发送邀请、对话是否已经存在——但不会发送任何内容。请先进行试运行,然后再带上 "send": true 重复该请求。 发布帖子、点赞互动和接受邀请使用各自的参数:publish、react 和 accept。

连接账号

  1. 获取你的工作区 ID:使用同一个令牌调用 GET https://api.gologin.com/workspaces,即可返回你的工作区及其 id。
  2. 创建账号:
  • 登录时,请传入以下其中一项:credentials(login 和 password)、cookies,或 browserProfileId——即已登录 LinkedIn 的 Gologin 浏览器配置文件。
  • 对于 IP,请传入 proxyCountry(国家代码来自 GET /available-countries)或你自己的 proxy(host、port,以及可选的 protocol、username、password)。关联的 Gologin 配置文件会使用它自己的代理。
  • 如需导入已有对话,请添加 "importHistory": true。
  1. 在设置进行期间,账号会以 pending 状态返回。请持续检查 GET /accounts/{id},直到 status 发生变化:
每次等待最长持续 10 分钟。如果验证码未发送或登录未确认,最终会变为 auth_failed。

查找人员并发送邀请

  1. 搜索。 GET /linkedin/people/search?accountId=ACCOUNT_ID&query=head%20of%20growth 会返回每个人的 profile_url 和 profile_id。你也可以用 url 代替 query——即带有筛选条件的 LinkedIn 搜索链接。
  2. 检查个人资料。 GET /linkedin/profile?accountId=ACCOUNT_ID&profileUrl=PROFILE_URL 会显示 is_connected、is_pending 和 is_available_to_connect。
  3. 邀请。 请先进行试运行:
connectable_dry_run 表示邀请可以发出。not_connectable 会说明原因:already_connected、invite_pending 或 connect_unavailable。请带上 "send": true 重复该请求。sent_verified 表示 LinkedIn 已创建该邀请。

发送消息

POST /linkedin/messages/send 需要 accountId、message,以及以下其中一项:
  • profileUrl——用于给某个人发消息。系统会查找与对方的对话,如果没有则新建一个;返回结果会显示 existing_conversation 或 new_conversation。如果只有付费 InMail 才能联系到该人,你会收到 not_messageable 和 paid_inmail_required。系统绝不会在你不知情的情况下消耗付费 InMail。
  • conversationId——用于继续某个对话:可以是来自 /linkedin/inbox 的 conversation_id、2-… 格式的会话 ID,或会话 URL。
消息发送成功后会返回 sent_verified,并附带 message_id 和 conversation_id。

读取对话

  • GET /linkedin/inbox?accountId=ACCOUNT_ID 会列出该账号的对话,按最新优先排序。
  • GET /linkedin/messages/conversation?accountId=ACCOUNT_ID&conversationId=CONVERSATION_ID 会返回消息,按最早优先排序。limit 参数用于只保留最近的消息。
  • GET /workspaces/{workspaceId}/conversations 会列出工作区内所有账号的对话,GET /workspaces/{workspaceId}/inbox/unread 会返回未读数量。

通过 webhook 接收新消息

工作区内各账号的每条新动态都会以 JSON 形式发送到该 URL:{ accountId, workspaceId, event }。出错时会重试投递,同一事件可能会收到两次,因此请按 event.id 去重。如需移除 webhook,请发送 {"url": null}。不接受 localhost 和内部地址。

限制

通过 API 执行的操作与应用内的操作计入相同的限制。
  • GET /accounts/{id}/limits 会返回账号所处的阶段以及每项限制:推荐值、你自己设置的值、实际生效的值、已使用的数量,以及 resetsAt——即时间窗口可再容纳一次操作的时间。
  • PUT /accounts/{id}/limits 用于修改 stage,或修改 customLimits 中你自己设置的值。将值设为 null 即可移除你自己设置的值。
  • DELETE /accounts/{id}/limits/custom 会将所有限制重置为推荐值。
  • GET /workspaces/{workspaceId}/accounts-usage 会显示你的工作区可以连接多少个账号,以及已占用多少个席位。

需要了解的常见错误

批量调用前先预热

长时间闲置的会话会失效,之后的第一次调用会耗时数秒。请在批量调用之前,或在重新登录后立即调用 POST /accounts/{id}/warmup。账号必须处于 active 状态。