基础 URL 与身份验证
所有请求都发送到:Authorization 请求头中携带你的 Gologin API 令牌:
401。
在 Gologin 应用中创建令牌:API & MCP > API > 新代币,或者在 AI 助手中的 已连接账号 下的 API 部分创建。令牌只能在付费套餐中创建,并且需要在 Gologin 中开启双重验证。
默认情况下,发送操作只是试运行
只有在传入"send": true 时,才会真正发送邀请、消息、评论和回复。如果不传该参数,请求就是一次试运行:它会检查目标,并告诉你将会发生什么——收件人是谁、是否可以发送邀请、对话是否已经存在——但不会发送任何内容。请先进行试运行,然后再带上 "send": true 重复该请求。
发布帖子、点赞互动和接受邀请使用各自的参数:publish、react 和 accept。
连接账号
- 获取你的工作区 ID:使用同一个令牌调用
GET https://api.gologin.com/workspaces,即可返回你的工作区及其id。 - 创建账号:
- 登录时,请传入以下其中一项:
credentials(login和password)、cookies,或browserProfileId——即已登录 LinkedIn 的 Gologin 浏览器配置文件。 - 对于 IP,请传入
proxyCountry(国家代码来自GET /available-countries)或你自己的proxy(host、port,以及可选的protocol、username、password)。关联的 Gologin 配置文件会使用它自己的代理。 - 如需导入已有对话,请添加
"importHistory": true。
- 在设置进行期间,账号会以
pending状态返回。请持续检查GET /accounts/{id},直到status发生变化:
每次等待最长持续 10 分钟。如果验证码未发送或登录未确认,最终会变为
auth_failed。
查找人员并发送邀请
- 搜索。
GET /linkedin/people/search?accountId=ACCOUNT_ID&query=head%20of%20growth会返回每个人的profile_url和profile_id。你也可以用url代替query——即带有筛选条件的 LinkedIn 搜索链接。 - 检查个人资料。
GET /linkedin/profile?accountId=ACCOUNT_ID&profileUrl=PROFILE_URL会显示is_connected、is_pending和is_available_to_connect。 - 邀请。 请先进行试运行:
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 接收新消息
{ 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 状态。