Gemlead dans ton CRM, ta stack et ton IA.

Une API de génération de leads sur X permet à tes propres outils de recevoir les acheteurs trouvés sur X, et d'agir dessus, sans que personne n'exporte une liste à la main. L'API de Gemlead te donne les leads que ses agents trouvent et scorent sur X, chacun avec son score et la raison de ce score, ainsi que les personas, les campagnes, les conversations et les DM qui vont avec. Des webhooks signés appellent ton serveur dès qu'un lead devient chaud ou répond, et un serveur MCP permet à Claude, ChatGPT ou Cursor de piloter ton Gemlead en langage courant. Les trois sont inclus dans le plan Business, avec une seule clé.

L'enjeu, c'est la vitesse : un lead chaud qui attend dans un onglet que quelqu'un le recopie dans le CRM est un lead qui refroidit. Au programme : ce que coûte ce délai, ce que fait chaque brique, et une vraie requête.

Pourquoi tes leads X doivent arriver dans tes outils

Un lead qui reste dans un outil à part est traité en retard, ou jamais.

• Les outils déconnectés ralentissent tout. Plus de la moitié des dirigeants commerciaux qui utilisent l'IA, 51 %, disent que des systèmes déconnectés ralentissent leurs projets d'IA, et 74 % des professionnels de la vente se concentrent sur le nettoyage de leurs données, selon le State of Sales 2026 de Salesforce, une enquête menée auprès de 4 050 professionnels de la vente.
• Recopier des données mange le temps de vente. Le commercial moyen passe 40 % de son temps à vendre. Les commerciaux de la génération Z tombent à 35 %, et perdent environ deux heures par semaine en saisie manuelle, d'après le même rapport.
• Les leads chauds refroidissent vite. Dans une étude de la Harvard Business Review portant sur 1,25 million de leads, les entreprises qui essayaient de joindre un lead dans l'heure avaient près de sept fois plus de chances de le qualifier que celles qui attendaient plus longtemps.
• La recherche passe par l'IA. Gartner prévoit que d'ici 2027, 95 % des workflows de recherche des commerciaux commenceront par l'IA, contre moins de 20 % en 2024.

Ce que font l'API de génération de leads sur X, le serveur MCP et les webhooks de Gemlead

L'API REST

Tous les endpoints sont sous https://gemlead.ai/api/v1 et parlent JSON. Dans Gemlead, ouvre API dans le menu, choisis le compte X, nomme la clé et choisis ses scopes, read seul ou read et write. La clé commence par gl_live_, ne s'affiche qu'une fois et ne voit que les données de ce compte X.

Ce qu'elle couvre :

• Leads : les lister avec des filtres comme hot, score_min, un persona ou une date, voir d'où vient un lead, le rescorer, le suivre, ou y enregistrer tes propres metadata, comme un identifiant CRM.
• Personas et sources : créer un persona, ajouter des sources, changer ses réglages, le partager avec tes autres comptes X.
• Campagnes : créer un brouillon à partir d'un template, la lancer ou la mettre en pause, suivre ses stats et ses tendances jour par jour.
• Conversations : lire les échanges, envoyer un DM avec du texte, une image, un GIF, une vidéo ou un message vocal, réagir, déplacer une conversation dans ton pipeline.
• Exports et statistiques : un export CSV ou JSON Lines de tes leads, et les graphiques de ton Dashboard.
• Julien AI : interroger l'assistant IA de Gemlead sur ton compte, depuis ton code.

Tes leads chauds, les plus récents d'abord :

curl -G https://gemlead.ai/api/v1/leads \
  -H "Authorization: Bearer $GEMLEAD_API_KEY" \
  -d hot=true \
  -d limit=10

Chaque lead revient avec son profil X, son score de 0 à 100, son score_reason en une phrase, son persona et son statut. Une clé fait 120 requêtes par minute. Les DM envoyés par l'API sont limités à 10 par minute et 300 par jour pour chaque compte X, ou moins quand X fixe un quota plus bas.

Les webhooks

Enregistre une URL HTTPS publique dans l'app, sous API, ou avec POST /v1/webhook_endpoints, et choisis tes événements :

Chaque requête porte un en-tête Gemlead-Signature, un HMAC SHA256 que tu vérifies avec le secret de ton endpoint. Une livraison qui échoue est retentée 7 fois, sur environ 45 heures. Tu peux garder jusqu'à 10 endpoints par compte, et limiter l'un d'eux aux leads de certains personas. Le guide des webhooks montre la vérification en Node.js et en Python.

Le serveur MCP

Le Model Context Protocol est un standard open source pour connecter les applications d'IA à des systèmes externes. Le serveur de Gemlead, à l'adresse https://gemlead.ai/mcp, donne à Claude, ChatGPT, Cursor et Claude Code plus de 60 outils, un pour chaque chose que fait l'API : search_leads, get_campaign_stats, list_conversations, send_message, create_export et d'autres. Claude et ChatGPT se connectent en OAuth, sans clé à copier. Dans Claude Code, une seule commande :

claude mcp add --transport http gemlead https://gemlead.ai/mcp \
  --header "Authorization: Bearer $GEMLEAD_API_KEY"

Ensuite, demande : « Montre-moi les leads chauds du jour pour mon persona Tipsters, avec la raison de chaque score. » Les outils d'écriture demandent le scope write, et l'assistant te demande ton accord avant d'envoyer, de lancer ou de supprimer quoi que ce soit. Pour travailler sur plusieurs comptes X, ajoute une connexion par compte. Toute la mise en place est dans la documentation.

Pourquoi ça marche

• Le push bat le polling. Un webhook arrive sur ton serveur dès qu'un lead devient chaud : ton CRM ou ton commercial l'a dans cette première heure, sans dépenser de requêtes à vérifier.
• Une seule fiche par lead. Enregistre ton identifiant CRM dans les metadata du lead, et chaque événement suivant renvoie vers la même fiche. Moins de doublons, moins de nettoyage.
• Les assistants IA parlent déjà MCP. Anthropic recense plus de 10 000 serveurs MCP publics actifs et plus de 97 millions de téléchargements mensuels de ses SDK, et MCP est adopté par ChatGPT, Cursor, Gemini, Microsoft Copilot et Visual Studio Code. Gartner prévoit que 60 % du travail des commerciaux B2B passera par des interfaces d'IA conversationnelle d'ici 2028.
• Les agents ont besoin de bonnes données. Gartner prévoit que d'ici 2028, moins de 40 % des commerciaux diront que les agents IA ont amélioré leur productivité. Donner aux tiens des leads scorés, avec la raison de chaque score, plutôt qu'une liste brute, c'est comme ça que tu te ranges du côté de ceux qui y gagnent.

Exports à la main ou API Gemlead

À qui s'adresse l'API

• Les développeurs et les équipes RevOps qui synchronisent leurs leads X avec HubSpot, Salesforce, Pipedrive, Attio, Notion ou Google Sheets, avec leur propre code ou un outil d'automatisation qui reçoit des webhooks.
• Les fondateurs qui travaillent dans Claude ou ChatGPT et veulent leurs leads chauds et leurs réponses dans la même conversation.
• Les agences qui font leur reporting client à partir des statistiques, avec une clé par compte X client.
• Les équipes qui construisent leurs propres agents IA, et leur donnent les leads scorés de Gemlead et ses outils de DM plutôt qu'un scraper.
• Les vendeurs B2C, comme un tipster de paris sportifs ou un créateur avec une communauté payante, qui veulent chaque lead chaud dans l'outil de leur équipe.

Comment ces leads sont trouvés, c'est dans comment trouver des leads sur X. Avant qu'un agent leur écrive, lis ce que les SDR IA savent faire, et ce qu'ils ne savent pas faire.

Bonnes pratiques

1. Une clé par outil, gardée sur ton serveur dans une variable d'environnement comme GEMLEAD_API_KEY. Ne donne write qu'aux outils qui modifient des données.
2. Vérifie chaque webhook. Contrôle la signature sur le corps brut et refuse les horodatages de plus de 5 minutes.
3. Réponds vite, traite plus tard. Renvoie un 2xx en moins de 10 secondes, puis traite l'événement dans une file. La livraison est garantie au moins une fois : ignore un id d'événement déjà traité.
4. Exporte pour les gros volumes. Un export vaut mieux que des centaines de pages.
5. Lis avant d'autoriser. Un assistant peut être piégé par un texte qu'il lit. Vérifie ce qu'un outil d'écriture s'apprête à faire avant de valider.

FAQ