ベース URL と認証
すべてのリクエストは次の URL に送信します。Authorization ヘッダーに、Gologin の API トークンを指定します。
401 を返します。
トークンは Gologin アプリで作成します。API & MCP > API > 新しいトークン の順に進むか、AI Assistant の Connected accounts にある 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として返されます。statusが変わるまでGET /accounts/{id}を確認してください。
各待機時間は最長 10 分です。コードを送信しなかった場合やサインインを承認しなかった場合は、その後
auth_failed になります。
人物を検索して招待を送る
- 検索します。
GET /linkedin/people/search?accountId=ACCOUNT_ID&query=head%20of%20growthを呼び出すと、各人物のprofile_urlとprofile_idが返されます。queryの代わりに、フィルター付きの LinkedIn 検索リンクであるurlを指定することもできます。 - プロフィールを確認します。
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 でしか連絡できない相手の場合は、paid_inmail_requiredを伴うnot_messageableが返されます。有料の InMail が自動的に消費されることはありません。conversationId- 既存の会話を続ける場合に指定します。/linkedin/inboxのconversation_id、2-…形式のスレッド ID、またはスレッドの URL を使用できます。
message_id と conversation_id を含む sent_verified が返されます。
会話を読み取る
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 } という JSON が送信されます。エラーが発生した場合は再送され、同じイベントが 2 回届くことがあるため、event.id で重複を排除してください。Webhook を削除するには、{"url": null} を送信します。localhost や内部アドレスは指定できません。
制限
API での操作は、アプリと同じ制限の対象としてカウントされます。GET /accounts/{id}/limitsは、アカウントのステージとすべての制限を返します。内容は、推奨値、ユーザーが設定した値、適用されている値、使用量、そしてresetsAt(ウィンドウにあと 1 回分の余裕ができる時刻)です。PUT /accounts/{id}/limitsは、stageまたはcustomLimits内のユーザー設定値を変更します。値をnullにすると、ユーザー設定値が削除されます。DELETE /accounts/{id}/limits/customは、すべての制限を推奨値にリセットします。GET /workspaces/{workspaceId}/accounts-usageは、ワークスペースで連携できるアカウント数と、使用中のシート数を表示します。
知っておきたいエラー
まとめて処理する前にウォームアップする
長時間使用されていないセッションは古くなり、その後の最初の呼び出しに数秒かかります。まとめて呼び出す前、または再度サインインした直後に、POST /accounts/{id}/warmup を呼び出してください。アカウントは active である必要があります。