Base URL und Authentifizierung
Alle Anfragen gehen an:Authorization-Header:
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
- Ermitteln Sie Ihre Workspace-ID:
GET https://api.gologin.com/workspacesmit demselben Token gibt Ihre Workspaces und derenidzurück. - Erstellen Sie das Konto:
- Für die Anmeldung übergeben Sie eine der folgenden Optionen:
credentials(loginundpassword),cookiesoderbrowserProfileId– ein Gologin-Profil, das bereits bei LinkedIn angemeldet ist. - Für die IP übergeben Sie
proxyCountry(die Codes liefertGET /available-countries) oder Ihren eigenenproxy(host,portund optionalprotocol,username,password). Ein verknüpftes Gologin-Profil verwendet seinen eigenen Proxy. - Um bestehende Unterhaltungen zu importieren, fügen Sie
"importHistory": truehinzu.
- Das Konto wird mit dem Status
pendingzurückgegeben, während die Einrichtung läuft. Prüfen SieGET /accounts/{id}, bis sichstatusä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
- Suchen.
GET /linkedin/people/search?accountId=ACCOUNT_ID&query=head%20of%20growthgibt für jede Personprofile_urlundprofile_idzurück. Stattquerykönnen Sieurlübergeben – einen LinkedIn-Suchlink mit seinen Filtern. - Profil prüfen.
GET /linkedin/profile?accountId=ACCOUNT_ID&profileUrl=PROFILE_URLzeigtis_connected,is_pendingundis_available_to_connect. - 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 lautetexisting_conversationodernew_conversation. Wenn die Person nur über eine kostenpflichtige InMail erreichbar ist, erhalten Sienot_messageablemitpaid_inmail_required. Eine kostenpflichtige InMail wird nie stillschweigend verbraucht.conversationId– um eine Unterhaltung fortzusetzen: dieconversation_idaus/linkedin/inbox, eine Thread-ID im Format2-…oder eine Thread-URL.
sent_verified mit message_id und conversation_id zurück.
Unterhaltungen lesen
GET /linkedin/inbox?accountId=ACCOUNT_IDlistet die Unterhaltungen des Kontos auf, die neueste zuerst.GET /linkedin/messages/conversation?accountId=ACCOUNT_ID&conversationId=CONVERSATION_IDgibt die Nachrichten zurück, die älteste zuerst. Mitlimitbehalten Sie nur die neuesten.GET /workspaces/{workspaceId}/conversationslistet die Unterhaltungen aller Konten im Workspace auf, undGET /workspaces/{workspaceId}/inbox/unreadgibt die Anzahl ungelesener Nachrichten zurück.
Neue Nachrichten per Webhook erhalten
{ 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}/limitsgibt die Stufe des Kontos und alle Limits zurück: den empfohlenen Wert, Ihren eigenen Wert, den angewendeten Wert, den bisherigen Verbrauch undresetsAt– den Zeitpunkt, an dem im Zeitfenster wieder Platz für eine weitere Aktion ist.PUT /accounts/{id}/limitsändert diestageoder Ihre eigenen Werte incustomLimits. Ein Wert vonnullentfernt Ihren eigenen Wert.DELETE /accounts/{id}/limits/customsetzt alle Limits auf die empfohlenen Werte zurück.GET /workspaces/{workspaceId}/accounts-usagezeigt, 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 SiePOST /accounts/{id}/warmup vor einem Batch von Aufrufen oder direkt nach einer erneuten Anmeldung auf. Das Konto muss active sein.