Passer au contenu principal
L’API fonctionne avec les mêmes comptes, les mêmes places et les mêmes limites que l’application. Utilisez-la depuis votre propre code, un pipeline ou un agent IA tel que Claude Code, Codex ou Cursor. La référence complète avec tous les endpoints se trouve dans Swagger. Vous pouvez aussi y télécharger le JSON OpenAPI et le donner à votre agent IA.

URL de base et authentification

Toutes les requêtes sont envoyées à :
Envoyez votre jeton d’API Gologin dans l’en-tête Authorization de chaque requête :
Cet appel liste vos comptes connectés, du plus récent au plus ancien. Les comptes déconnectés n’en font pas partie. Sans jeton valide, l’API répond 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

  1. Récupérez l’ID de votre espace de travail : GET https://api.gologin.com/workspaces avec le même jeton renvoie vos espaces de travail et leur id.
  2. Créez le compte :
  • Pour vous connecter, passez l’un des éléments suivants : credentials (login et password), cookies, ou browserProfileId (un profil Gologin déjà connecté à LinkedIn).
  • Pour l’IP, passez proxyCountry (les codes proviennent de GET /available-countries) ou votre propre proxy (host, port, et éventuellement protocol, username, password). Un profil Gologin lié utilise son propre proxy.
  • Pour importer les conversations existantes, ajoutez "importHistory": true.
  1. Le compte est renvoyé avec le statut pending pendant la configuration. Interrogez GET /accounts/{id} jusqu’à ce que status change :
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

  1. Rechercher. GET /linkedin/people/search?accountId=ACCOUNT_ID&query=head%20of%20growth renvoie profile_url et profile_id pour chaque personne. Au lieu de query, vous pouvez passer url : un lien de recherche LinkedIn avec ses filtres.
  2. Vérifier le profil. GET /linkedin/profile?accountId=ACCOUNT_ID&profileUrl=PROFILE_URL affiche is_connected, is_pending et is_available_to_connect.
  3. 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 indique existing_conversation ou new_conversation. Si seul un InMail payant permet de joindre la personne, vous obtenez not_messageable avec paid_inmail_required. Un InMail payant n’est jamais utilisé à votre insu.
  • conversationId : pour poursuivre une conversation : le conversation_id provenant de /linkedin/inbox, un ID de fil 2-… ou une URL de fil.
Un message envoyé renvoie sent_verified avec message_id et conversation_id.

Lire les conversations

  • GET /linkedin/inbox?accountId=ACCOUNT_ID liste les conversations du compte, de la plus récente à la plus ancienne.
  • GET /linkedin/messages/conversation?accountId=ACCOUNT_ID&conversationId=CONVERSATION_ID renvoie les messages, du plus ancien au plus récent. limit ne conserve que les plus récents.
  • GET /workspaces/{workspaceId}/conversations liste les conversations de tous les comptes de l’espace de travail, et GET /workspaces/{workspaceId}/inbox/unread renvoie le nombre de messages non lus.

Recevoir les nouveaux messages sur un webhook

Chaque nouvelle mise à jour des comptes de l’espace de travail est envoyée à cette URL au format JSON : { 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}/limits renvoie l’étape du compte et chaque limite : la valeur recommandée, votre propre valeur, la valeur appliquée, la quantité utilisée et resetsAt, c’est-à-dire le moment où la fenêtre aura de la place pour une action supplémentaire.
  • PUT /accounts/{id}/limits modifie le stage ou vos propres valeurs dans customLimits. Une valeur null supprime votre propre valeur.
  • DELETE /accounts/{id}/limits/custom rétablit toutes les limites aux valeurs recommandées.
  • GET /workspaces/{workspaceId}/accounts-usage indique 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. Appelez POST /accounts/{id}/warmup avant un lot d’appels ou juste après une nouvelle connexion. Le compte doit être active.