Zum Hauptinhalt springen
Die API arbeitet mit denselben Konten, Seats und Limits wie die App. Sie können sie aus Ihrem eigenen Code, einer Pipeline oder von einem KI-Agenten wie Claude Code, Codex oder Cursor aus nutzen. Die vollständige Referenz mit allen Endpunkten finden Sie in Swagger. Dort können Sie auch das OpenAPI-JSON herunterladen und Ihrem KI-Agenten übergeben.

Base URL und Authentifizierung

Alle Anfragen gehen an:
Senden Sie Ihren Gologin-API-Token bei jeder Anfrage im Authorization-Header:
Dieser Aufruf listet Ihre verbundenen Konten auf, das neueste zuerst. Getrennte Konten sind nicht enthalten. Ohne gültigen Token antwortet die API mit 401. Erstellen Sie einen Token in der Gologin-App: API & MCP > API > New Token, oder im Bereich API unter Connected accounts im AI Assistant. Ein Token kann mit einem kostenpflichtigen Tarif erstellt werden, wenn in Gologin die Zwei-Faktor-Authentifizierung aktiviert ist.

Senden ist standardmäßig ein Testlauf

Einladungen, Nachrichten, Kommentare und Antworten werden nur gesendet, wenn Sie "send": true übergeben. Ohne diesen Parameter ist die Anfrage ein Testlauf (Dry Run): Sie prüft das Ziel und zeigt, was passieren würde – wer der Empfänger ist, ob eine Einladung möglich ist, ob bereits eine Unterhaltung besteht – und sendet nichts. Führen Sie zuerst den Testlauf aus und wiederholen Sie dann die Anfrage mit "send": true. Das Veröffentlichen von Beiträgen, Reaktionen und das Annehmen von Einladungen verwenden eigene Flags: publish, react und accept.

Konto verbinden

  1. Ermitteln Sie Ihre Workspace-ID: GET https://api.gologin.com/workspaces mit demselben Token gibt Ihre Workspaces und deren id zurück.
  2. Erstellen Sie das Konto:
  • Für die Anmeldung übergeben Sie eine der folgenden Optionen: credentials (login und password), cookies oder browserProfileId – ein Gologin-Profil, das bereits bei LinkedIn angemeldet ist.
  • Für die IP übergeben Sie proxyCountry (die Codes liefert GET /available-countries) oder Ihren eigenen proxy (host, port und optional protocol, username, password). Ein verknüpftes Gologin-Profil verwendet seinen eigenen Proxy.
  • Um bestehende Unterhaltungen zu importieren, fügen Sie "importHistory": true hinzu.
  1. Das Konto wird mit dem Status pending zurückgegeben, während die Einrichtung läuft. Prüfen Sie GET /accounts/{id}, bis sich status ändert:
Jedes Warten dauert bis zu 10 Minuten. Ein nicht gesendeter Code oder eine nicht bestätigte Anmeldung endet danach mit auth_failed.

Personen finden und Einladung senden

  1. Suchen. GET /linkedin/people/search?accountId=ACCOUNT_ID&query=head%20of%20growth gibt für jede Person profile_url und profile_id zurück. Statt query können Sie url übergeben – einen LinkedIn-Suchlink mit seinen Filtern.
  2. Profil prüfen. GET /linkedin/profile?accountId=ACCOUNT_ID&profileUrl=PROFILE_URL zeigt is_connected, is_pending und is_available_to_connect.
  3. Einladen. Führen Sie zuerst einen Testlauf aus:
connectable_dry_run bedeutet, dass die Einladung versendet würde. not_connectable nennt den Grund: already_connected, invite_pending oder connect_unavailable. Wiederholen Sie die Anfrage mit "send": true. sent_verified bedeutet, dass LinkedIn die Einladung erstellt hat.

Nachricht senden

POST /linkedin/messages/send erwartet accountId, message und eines der folgenden Felder:
  • profileUrl – um eine Person anzuschreiben. Die Unterhaltung mit ihr wird gefunden oder neu eröffnet, falls keine existiert; die Antwort lautet existing_conversation oder new_conversation. Wenn die Person nur über eine kostenpflichtige InMail erreichbar ist, erhalten Sie not_messageable mit paid_inmail_required. Eine kostenpflichtige InMail wird nie stillschweigend verbraucht.
  • conversationId – um eine Unterhaltung fortzusetzen: die conversation_id aus /linkedin/inbox, eine Thread-ID im Format 2-… oder eine Thread-URL.
Eine gesendete Nachricht gibt sent_verified mit message_id und conversation_id zurück.

Unterhaltungen lesen

  • GET /linkedin/inbox?accountId=ACCOUNT_ID listet die Unterhaltungen des Kontos auf, die neueste zuerst.
  • GET /linkedin/messages/conversation?accountId=ACCOUNT_ID&conversationId=CONVERSATION_ID gibt die Nachrichten zurück, die älteste zuerst. Mit limit behalten Sie nur die neuesten.
  • GET /workspaces/{workspaceId}/conversations listet die Unterhaltungen aller Konten im Workspace auf, und GET /workspaces/{workspaceId}/inbox/unread gibt die Anzahl ungelesener Nachrichten zurück.

Neue Nachrichten per Webhook erhalten

Jedes neue Update der Konten des Workspace wird als JSON an diese URL gesendet: { accountId, workspaceId, event }. Bei Fehlern wird die Zustellung wiederholt, und dasselbe Event kann zweimal ankommen. Deduplizieren Sie daher anhand von event.id. Um den Webhook zu entfernen, senden Sie {"url": null}. Localhost und interne Adressen werden nicht akzeptiert.

Limits

API-Aktionen zählen zu denselben Limits wie in der App.
  • GET /accounts/{id}/limits gibt die Stufe des Kontos und alle Limits zurück: den empfohlenen Wert, Ihren eigenen Wert, den angewendeten Wert, den bisherigen Verbrauch und resetsAt – den Zeitpunkt, an dem im Zeitfenster wieder Platz für eine weitere Aktion ist.
  • PUT /accounts/{id}/limits ändert die stage oder Ihre eigenen Werte in customLimits. Ein Wert von null entfernt Ihren eigenen Wert.
  • DELETE /accounts/{id}/limits/custom setzt alle Limits auf die empfohlenen Werte zurück.
  • GET /workspaces/{workspaceId}/accounts-usage zeigt, wie viele Konten Ihr Workspace verbinden kann und wie viele Seats belegt sind.

Wichtige Fehlermeldungen

Aufwärmen vor einem Batch

Eine ungenutzte Sitzung veraltet, und der erste Aufruf danach dauert mehrere Sekunden. Rufen Sie POST /accounts/{id}/warmup vor einem Batch von Aufrufen oder direkt nach einer erneuten Anmeldung auf. Das Konto muss active sein.