Gemlead nel tuo CRM, nel tuo stack e nella tua IA.

Un'API di lead generation su X fa arrivare ai tuoi strumenti gli acquirenti trovati sulla piattaforma, e ti permette di agire su di loro, senza che nessuno debba esportare una lista a mano. L'API di Gemlead ti dà i lead che i suoi agenti trovano e valutano su X, ciascuno con il suo punteggio e il motivo, oltre alle buyer persona, alle campagne, alle conversazioni e ai DM che ci sono dietro. I webhook firmati chiamano il tuo server appena un lead diventa caldo o risponde, e un server MCP permette a Claude, ChatGPT o Cursor di gestire il tuo Gemlead con parole semplici. Tutti e tre sono inclusi nel piano Business, con una sola chiave.

Il punto è la velocità: un lead caldo che resta in una scheda finché qualcuno non lo copia nel CRM è un lead che si raffredda. Qui sotto trovi quanto costa questo ritardo, cosa fa ogni componente e una richiesta reale.

Perché i tuoi lead di X devono arrivare nel tuo stack

I lead che restano in uno strumento separato vengono lavorati tardi, o per niente.

• Gli strumenti scollegati rallentano tutto. Più della metà dei responsabili vendite che usano l'IA, il 51%, dice che i sistemi scollegati rallentano i loro progetti di IA, e il 74% dei professionisti delle vendite si sta concentrando sulla pulizia dei dati, secondo lo State of Sales 2026 di Salesforce, un sondaggio su 4 050 professionisti delle vendite.
• Copiare dati mangia tempo di vendita. In media un commerciale passa il 40% del suo tempo a vendere. I commerciali della Gen Z scendono al 35% e perdono circa due ore intere a settimana a inserire dati a mano, nello stesso report.
• I lead caldi si raffreddano in fretta. In uno studio della Harvard Business Review su 1,25 milioni di lead, le aziende che provavano a contattare un lead entro un'ora avevano quasi sette volte più probabilità di qualificarlo rispetto a quelle che aspettavano di più.
• La ricerca si sposta nell'IA. Gartner prevede che entro il 2027 il 95% dei flussi di ricerca dei venditori partirà dall'IA, contro meno del 20% nel 2024.

Cosa fanno l'API di lead generation su X, il server MCP e i webhook di Gemlead

L'API REST

Ogni endpoint si trova sotto https://gemlead.ai/api/v1 e parla JSON. In Gemlead, apri API nel menu, scegli l'account X, dai un nome alla chiave e scegli i suoi scope, solo read oppure read e write. La chiave inizia con gl_live_, compare una sola volta e vede sempre e solo i dati di quell'account X.

Cosa copre:

• Lead: elencali con filtri come hot, score_min, una buyer persona o una data, leggi da dove arriva un lead, rivalutalo, seguilo, o salva sul lead i tuoi metadata, come un ID del CRM.
• Buyer persona e fonti: crea una buyer persona, aggiungi fonti, cambia le impostazioni, condividila con gli altri tuoi account X.
• Campagne: crea una bozza da un template, avviala o mettila in pausa, leggi le sue statistiche e i trend giorno per giorno.
• Conversazioni: leggi le conversazioni, invia un DM con testo, un'immagine, una GIF, un video o un messaggio vocale, reagisci, sposta una conversazione nella tua pipeline.
• Export e analytics: un export dei tuoi lead in CSV o JSON Lines, e i grafici della tua Dashboard.
• Julien AI: fai domande sul tuo account all'assistente IA di Gemlead dal tuo codice.

I tuoi lead caldi, dal più recente:

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

Ogni lead torna con il suo profilo X, il suo score da 0 a 100, il suo score_reason in una frase, la sua buyer persona e il suo stato. Una chiave fa 120 richieste al minuto. I DM inviati tramite l'API sono limitati a 10 al minuto e 300 al giorno per account X, o meno quando X impone una quota più bassa.

Webhook

Registra un URL HTTPS pubblico nell'app sotto API, oppure con POST /v1/webhook_endpoints, e scegli i tuoi eventi:

Ogni richiesta porta un header Gemlead-Signature, un HMAC SHA256 che verifichi con il segreto del tuo endpoint. Una consegna fallita viene ritentata 7 volte, nell'arco di circa 45 ore. Puoi avere fino a 10 endpoint per account, e limitarne uno ai lead di alcune buyer persona. La guida ai webhook mostra la verifica in Node.js e Python.

Il server MCP

Il Model Context Protocol è uno standard open source per collegare le applicazioni di IA a sistemi esterni. Il server di Gemlead su https://gemlead.ai/mcp dà a Claude, ChatGPT, Cursor e Claude Code oltre 60 strumenti, uno per ogni cosa che fa l'API: search_leads, get_campaign_stats, list_conversations, send_message, create_export e altri. Claude e ChatGPT si collegano con OAuth, senza chiavi da copiare. In Claude Code basta un comando:

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

Poi chiedi: "Mostrami i lead caldi di oggi per la mia buyer persona Tipsters, con il motivo del punteggio alto di ciascuno." Gli strumenti di scrittura richiedono lo scope write, e l'assistente ti chiede conferma prima di inviare, avviare o eliminare qualsiasi cosa. Per lavorare su più account X, aggiungi una connessione per account. La configurazione completa è nella documentazione.

Perché funziona

• Il push batte il polling. Un webhook raggiunge il tuo server appena un lead diventa caldo, così il tuo CRM o il tuo commerciale lo riceve entro quella prima ora, senza spendere richieste per controllare.
• Un solo record per lead. Salva l'ID del CRM nei metadata del lead, e ogni evento successivo rimanda allo stesso record. Meno duplicati, meno pulizia.
• Gli assistenti IA parlano già MCP. Anthropic riporta più di 10 000 server MCP pubblici attivi e oltre 97 milioni di download mensili degli SDK, con MCP adottato da ChatGPT, Cursor, Gemini, Microsoft Copilot e Visual Studio Code. Gartner prevede che entro il 2028 il 60% del lavoro dei venditori B2B passerà da interfacce di IA conversazionale.
• Gli agenti hanno bisogno di buoni dati. Gartner prevede che entro il 2028 meno del 40% dei venditori dirà che gli agenti IA hanno migliorato la sua produttività. Dare ai tuoi agenti lead valutati, con il motivo di ogni punteggio, invece di una lista grezza, è il modo per stare tra i venditori che vedono il guadagno.

Export manuali o API di Gemlead

Per chi è l'API

• Sviluppatori e RevOps che sincronizzano i lead di X in HubSpot, Salesforce, Pipedrive, Attio, Notion o Google Sheets, con il proprio codice o con uno strumento di automazione che riceve webhook.
• Founder che lavorano in Claude o ChatGPT e vogliono i loro lead caldi e le risposte nella stessa chat.
• Agenzie che fanno report ai clienti dagli endpoint di analytics, con una chiave per ogni account X dei clienti.
• Team che costruiscono i propri agenti IA, e danno loro i lead valutati di Gemlead e i suoi strumenti per i DM invece di uno scraper.
• Venditori B2C, come un tipster sportivo o un creator con una community a pagamento, che vogliono ogni lead caldo nello strumento del proprio team.

Come vengono trovati questi lead è spiegato in come trovare lead su X. Prima che un agente scriva loro, leggi cosa possono e non possono fare gli AI SDR.

Buone pratiche

1. Una chiave per strumento, tenuta sul tuo server in una variabile d'ambiente come GEMLEAD_API_KEY. Dai write solo agli strumenti che modificano dati.
2. Verifica ogni webhook. Controlla la firma sul body grezzo e rifiuta i timestamp più vecchi di 5 minuti.
3. Rispondi subito, elabora dopo. Rispondi 2xx entro 10 secondi, poi elabora l'evento in una coda. La consegna avviene almeno una volta, quindi salta un id di evento che hai già gestito.
4. Esporta per i volumi grandi. Un solo export batte centinaia di pagine.
5. Leggi prima di autorizzare. Un assistente può essere ingannato dal testo che legge. Controlla cosa sta per fare uno strumento di scrittura prima di approvarlo.

Domande frequenti