Gemlead in je CRM, je stack en je AI.

Met een API voor leadgeneratie op X ontvangen je eigen tools de kopers die op X gevonden worden, en kunnen ze er meteen mee aan de slag, zonder dat iemand met de hand een lijst exporteert. De API van Gemlead geeft je de leads die de agents op X vinden en scoren, elk met de score en de reden ervoor, plus de persona's, campagnes, gesprekken en DM's erachter. Ondertekende webhooks roepen je server aan zodra een lead heet wordt of antwoordt, en met een MCP-server bestuurt Claude, ChatGPT of Cursor je Gemlead in gewone taal. Alle drie zitten in het Business-pakket, met één sleutel.

Het draait om snelheid: een hete lead die in een tabblad wacht tot iemand hem in het CRM kopieert, is een lead die afkoelt. Hieronder: wat die vertraging kost, wat elk onderdeel doet, en een echte request.

Waarom je X-leads in je stack moeten landen

Leads die in een aparte tool blijven staan, worden te laat opgepakt, of helemaal niet.

• Losse tools vertragen alles. Meer dan de helft van de salesleiders met AI, 51%, zegt dat losse systemen hun AI-initiatieven vertragen, en 74% van de salesprofessionals richt zich op het opschonen van data, volgens de State of Sales 2026 van Salesforce, een enquête onder 4 050 salesprofessionals.
• Data kopiëren vreet verkooptijd. De gemiddelde verkoper besteedt 40% van de tijd aan verkopen. Gen Z-verkopers zitten op 35% en verliezen zo'n twee volle uren per week aan handmatige data-invoer, in hetzelfde rapport.
• Hete leads koelen snel af. In een studie van Harvard Business Review naar 1,25 miljoen leads hadden bedrijven die binnen een uur contact probeerden te leggen bijna zeven keer zoveel kans om de lead te kwalificeren als bedrijven die langer wachtten.
• Onderzoek verhuist naar AI. Gartner voorspelt dat 95% van de onderzoeksworkflows van verkopers in 2027 met AI begint, tegenover minder dan 20% in 2024.

Wat de API voor leadgeneratie op X, de MCP-server en de webhooks van Gemlead doen

De REST API

Elk endpoint staat onder https://gemlead.ai/api/v1 en spreekt JSON. Open in Gemlead API in het menu, kies het X-account, geef de sleutel een naam en kies de scopes, alleen read of read en write. De sleutel begint met gl_live_, wordt één keer getoond en ziet alleen de data van dat X-account.

Wat erin zit:

• Leads: lijst ze op met filters zoals hot, score_min, een persona of een datum, lees waar een lead vandaan kwam, scoor hem opnieuw, volg hem, of sla je eigen metadata bij de lead op, zoals een CRM-ID.
• Persona's en bronnen: maak een persona, voeg bronnen toe, wijzig instellingen, deel de persona met je andere X-accounts.
• Campagnes: maak een concept vanuit een template, start of pauzeer de campagne, lees de statistieken en trends per dag.
• Gesprekken: lees de gesprekken, stuur een DM met tekst, een afbeelding, een GIF, een video of een spraakbericht, reageer, verplaats een gesprek in je pipeline.
• Exports en analytics: een export van je leads in CSV of JSON Lines, en de grafieken van je Dashboard.
• Julien AI: stel vanuit je code vragen over je account aan de AI-assistent van Gemlead.

Je hete leads, nieuwste eerst:

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

Elke lead komt terug met het X-profiel, de score van 0 tot 100, de score_reason in één zin, de persona en de status. Een sleutel doet 120 requests per minuut. DM's via de API zijn beperkt tot 10 per minuut en 300 per dag per X-account, of minder als X een lager quotum hanteert.

Webhooks

Registreer een openbare HTTPS-URL in de app onder API, of met POST /v1/webhook_endpoints, en kies je events:

Elke request bevat een header Gemlead-Signature, een HMAC SHA256 die je controleert met het secret van je endpoint. Een mislukte levering wordt 7 keer opnieuw geprobeerd, over ongeveer 45 uur. Je kunt tot 10 endpoints per account hebben, en een endpoint beperken tot de leads van bepaalde persona's. De webhookgids laat de controle zien in Node.js en Python.

De MCP-server

Het Model Context Protocol is een open-source standaard om AI-applicaties met externe systemen te verbinden. De server van Gemlead op https://gemlead.ai/mcp geeft Claude, ChatGPT, Cursor en Claude Code meer dan 60 tools, één voor alles wat de API doet: search_leads, get_campaign_stats, list_conversations, send_message, create_export en meer. Claude en ChatGPT loggen in met OAuth, zonder sleutel om te kopiëren. In Claude Code is het één commando:

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

Vraag dan: "Toon de hete leads van vandaag voor mijn persona Tipsters, met de reden waarom elk hoog scoorde." Schrijftools hebben de scope write nodig, en de assistent vraagt het je voordat die iets verstuurt, start of verwijdert. Wil je op meerdere X-accounts werken, voeg dan per account een verbinding toe. De volledige setup staat in de docs.

Waarom het werkt

• Pushen wint van pollen. Een webhook bereikt je server zodra een lead heet wordt, zodat je CRM of je verkoper hem binnen dat eerste uur krijgt, zonder requests te verspillen aan controleren.
• Eén record per lead. Sla je CRM-ID op in de metadata van de lead, en elk later event verwijst terug naar hetzelfde record. Minder duplicaten, minder opruimwerk.
• AI-assistenten spreken al MCP. Anthropic meldt meer dan 10 000 actieve openbare MCP-servers en meer dan 97 miljoen SDK-downloads per maand, met MCP in gebruik bij ChatGPT, Cursor, Gemini, Microsoft Copilot en Visual Studio Code. Gartner verwacht dat 60% van het werk van B2B-verkopers in 2028 via conversationele AI-interfaces loopt.
• Agents hebben goede data nodig. Gartner voorspelt dat in 2028 minder dan 40% van de verkopers zal zeggen dat AI-agents hun productiviteit hebben verbeterd. Geef je agents gescoorde leads met een reden bij elke score in plaats van een ruwe lijst, zo hoor je bij de verkopers die de winst wel zien.

Handmatige exports of de API van Gemlead

Voor wie de API is

• Developers en RevOps die X-leads synchroniseren met HubSpot, Salesforce, Pipedrive, Attio, Notion of Google Sheets, met eigen code of een automatiseringstool die webhooks ontvangt.
• Founders die in Claude of ChatGPT werken en hun hete leads en antwoorden in dezelfde chat willen.
• Bureaus die aan klanten rapporteren vanuit de analytics-endpoints, met één sleutel per X-account van een klant.
• Teams die eigen AI-agents bouwen en die agents de gescoorde leads en DM-tools van Gemlead geven in plaats van een scraper.
• B2C-verkopers, zoals een sporttipster of een creator met een betaalde community, die elke hete lead in de eigen tool van hun team willen.

Hoe die leads gevonden worden, staat in hoe je leads vindt op X. Lees wat AI SDR's wel en niet kunnen voordat een agent ze gaat aanschrijven.

Best practices

1. Eén sleutel per tool, op je server bewaard in een omgevingsvariabele zoals GEMLEAD_API_KEY. Geef write alleen aan de tools die data wijzigen.
2. Verifieer elke webhook. Controleer de handtekening op de ruwe body en weiger timestamps die ouder zijn dan 5 minuten.
3. Snel antwoorden, later verwerken. Antwoord binnen 10 seconden met een 2xx en verwerk het event daarna in een queue. Levering gebeurt minstens één keer, dus sla een event-id over die je al hebt afgehandeld.
4. Exporteer voor bulk. Eén export is beter dan honderden pagina's.
5. Lees voordat je toestaat. Een assistent kan misleid worden door tekst die hij leest. Controleer wat een schrijftool gaat doen voordat je het goedkeurt.

Veelgestelde vragen