URL de base et authentification
Toutes les requêtes sont envoyées à :Authorization de chaque requête :
401.
Créez un jeton dans l’application Gologin : API & MCP > API > Nouveau jeton, ou dans la section API sous Comptes connectés dans l’assistant IA. Un jeton peut être créé avec un forfait payant et l’authentification à deux facteurs activée dans Gologin.
Les envois sont des simulations par défaut
Les invitations, messages, commentaires et réponses ne sont envoyés que si vous passez"send": true. Sans ce paramètre, la requête est une simulation : elle vérifie la cible et vous indique ce qui se passerait (qui est le destinataire, si une invitation est possible, si une conversation existe déjà) sans rien envoyer. Faites d’abord la simulation, puis répétez la requête avec "send": true.
La publication de posts, les réactions et l’acceptation d’invitations utilisent leurs propres paramètres : publish, react et accept.
Connecter un compte
- Récupérez l’ID de votre espace de travail :
GET https://api.gologin.com/workspacesavec le même jeton renvoie vos espaces de travail et leurid. - Créez le compte :
- Pour vous connecter, passez l’un des éléments suivants :
credentials(loginetpassword),cookies, oubrowserProfileId(un profil Gologin déjà connecté à LinkedIn). - Pour l’IP, passez
proxyCountry(les codes proviennent deGET /available-countries) ou votre propreproxy(host,port, et éventuellementprotocol,username,password). Un profil Gologin lié utilise son propre proxy. - Pour importer les conversations existantes, ajoutez
"importHistory": true.
- Le compte est renvoyé avec le statut
pendingpendant la configuration. InterrogezGET /accounts/{id}jusqu’à ce questatuschange :
Chaque attente dure jusqu’à 10 minutes. Un code non envoyé ou une connexion non confirmée aboutit alors à
auth_failed.
Trouver des personnes et envoyer une invitation
- Rechercher.
GET /linkedin/people/search?accountId=ACCOUNT_ID&query=head%20of%20growthrenvoieprofile_urletprofile_idpour chaque personne. Au lieu dequery, vous pouvez passerurl: un lien de recherche LinkedIn avec ses filtres. - Vérifier le profil.
GET /linkedin/profile?accountId=ACCOUNT_ID&profileUrl=PROFILE_URLafficheis_connected,is_pendingetis_available_to_connect. - Inviter. Faites d’abord une simulation :
connectable_dry_run signifie que l’invitation partirait. not_connectable indique pourquoi ce n’est pas possible : already_connected, invite_pending ou connect_unavailable. Répétez la requête avec "send": true. sent_verified signifie que LinkedIn a créé l’invitation.
Envoyer un message
POST /linkedin/messages/send prend accountId, message et l’un des éléments suivants :
profileUrl: pour écrire à une personne. La conversation avec elle est retrouvée, ou ouverte s’il n’y en a pas ; la réponse indiqueexisting_conversationounew_conversation. Si seul un InMail payant permet de joindre la personne, vous obteneznot_messageableavecpaid_inmail_required. Un InMail payant n’est jamais utilisé à votre insu.conversationId: pour poursuivre une conversation : leconversation_idprovenant de/linkedin/inbox, un ID de fil2-…ou une URL de fil.
sent_verified avec message_id et conversation_id.
Lire les conversations
GET /linkedin/inbox?accountId=ACCOUNT_IDliste les conversations du compte, de la plus récente à la plus ancienne.GET /linkedin/messages/conversation?accountId=ACCOUNT_ID&conversationId=CONVERSATION_IDrenvoie les messages, du plus ancien au plus récent.limitne conserve que les plus récents.GET /workspaces/{workspaceId}/conversationsliste les conversations de tous les comptes de l’espace de travail, etGET /workspaces/{workspaceId}/inbox/unreadrenvoie le nombre de messages non lus.
Recevoir les nouveaux messages sur un webhook
{ accountId, workspaceId, event }. La livraison est retentée en cas d’erreur et un même événement peut arriver deux fois ; dédupliquez donc avec event.id. Pour supprimer le webhook, envoyez {"url": null}. Les adresses localhost et internes ne sont pas acceptées.
Limites
Les actions effectuées via l’API comptent dans les mêmes limites que celles de l’application.GET /accounts/{id}/limitsrenvoie l’étape du compte et chaque limite : la valeur recommandée, votre propre valeur, la valeur appliquée, la quantité utilisée etresetsAt, c’est-à-dire le moment où la fenêtre aura de la place pour une action supplémentaire.PUT /accounts/{id}/limitsmodifie lestageou vos propres valeurs danscustomLimits. Une valeurnullsupprime votre propre valeur.DELETE /accounts/{id}/limits/customrétablit toutes les limites aux valeurs recommandées.GET /workspaces/{workspaceId}/accounts-usageindique combien de comptes votre espace de travail peut connecter et combien de places sont occupées.
Erreurs à connaître
Préchauffer avant un lot d’appels
Une session inutilisée devient obsolète, et le premier appel qui suit prend plusieurs secondes. AppelezPOST /accounts/{id}/warmup avant un lot d’appels ou juste après une nouvelle connexion. Le compte doit être active.