O Gemlead no seu CRM, no seu stack e na sua IA.

Uma API de geração de leads no X leva os compradores encontrados no X direto para as suas próprias ferramentas, que já podem agir em cima deles, sem ninguém exportar uma lista na mão. A API do Gemlead entrega os leads que os agentes dele encontram e pontuam no X, cada um com a nota e o motivo dela, além das personas, campanhas, conversas e DMs por trás deles. Webhooks assinados chamam o seu servidor assim que um lead fica quente ou responde, e um servidor MCP deixa Claude, ChatGPT ou Cursor comandarem o seu Gemlead em palavras simples. Os três vêm com o plano Business, numa única chave.

O que está em jogo é a velocidade: um lead quente que espera numa aba até alguém copiá-lo para o CRM é um lead esfriando. Abaixo: quanto custa esse atraso, o que cada peça faz e uma requisição real.

Por que os seus leads do X precisam chegar ao seu stack

Leads que ficam numa ferramenta separada são trabalhados tarde, ou nunca.

• Ferramentas desconectadas atrasam tudo. Mais da metade dos líderes de vendas que usam IA, 51%, dizem que sistemas desconectados estão atrasando as suas iniciativas de IA, e 74% dos profissionais de vendas estão focados em limpeza de dados, segundo o State of Sales 2026 da Salesforce, uma pesquisa com 4 050 profissionais de vendas.
• Copiar dados come o tempo de venda. O vendedor médio passa 40% do tempo vendendo. Os vendedores da Geração Z estão em 35%, perdendo cerca de duas horas inteiras por semana com entrada manual de dados, no mesmo relatório.
• Leads quentes esfriam rápido. Em um estudo da Harvard Business Review com 1,25 milhão de leads, empresas que tentaram contatar um lead em até uma hora tiveram quase sete vezes mais chance de qualificá-lo do que as que esperaram mais.
• A pesquisa está migrando para a IA. A Gartner prevê que até 2027, 95% dos fluxos de pesquisa dos vendedores vão começar com IA, contra menos de 20% em 2024.

O que fazem a API de geração de leads no X, o servidor MCP e os webhooks do Gemlead

A API REST

Todos os endpoints ficam em https://gemlead.ai/api/v1 e falam JSON. No Gemlead, abra API no menu, escolha a conta do X, dê um nome à chave e escolha os escopos dela, read sozinho ou read e write. A chave começa com gl_live_, aparece uma vez só e só enxerga os dados daquela conta do X.

O que ela cobre:

• Leads: liste com filtros como hot, score_min, uma persona ou uma data, veja de onde um lead veio, repontue, siga ou salve nele o seu próprio metadata, como o ID do CRM.
• Personas e fontes: crie uma persona, adicione fontes, mude configurações, compartilhe com as suas outras contas do X.
• Campanhas: crie um rascunho a partir de um template, inicie ou pause, leia as estatísticas e as tendências dia a dia.
• Conversas: leia as conversas, envie uma DM com texto, imagem, GIF, vídeo ou mensagem de voz, reaja, mova uma conversa no seu pipeline.
• Exportações e analytics: uma exportação em CSV ou JSON Lines dos seus leads, e os gráficos do seu Painel.
• Julien AI: pergunte ao assistente de IA do Gemlead sobre a sua conta a partir do seu código.

Os seus leads quentes, os mais novos primeiro:

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

Cada lead volta com o perfil do X, o score de 0 a 100, o score_reason em uma frase, a persona e o status. Uma chave faz 120 requisições por minuto. As DMs enviadas pela API têm limite de 10 por minuto e 300 por dia por conta do X, ou menos quando o X define uma cota menor.

Webhooks

Registre uma URL HTTPS pública no app, em API, ou com POST /v1/webhook_endpoints, e escolha os seus eventos:

Cada requisição traz um cabeçalho Gemlead-Signature, um HMAC SHA256 que você verifica com o segredo do seu endpoint. Uma entrega que falha é tentada de novo 7 vezes, ao longo de cerca de 45 horas. Você pode ter até 10 endpoints por conta e limitar um deles aos leads de algumas personas. O guia de webhooks mostra a verificação em Node.js e em Python.

O servidor MCP

O Model Context Protocol é um padrão open source para conectar aplicações de IA a sistemas externos. O servidor do Gemlead em https://gemlead.ai/mcp dá ao Claude, ao ChatGPT, ao Cursor e ao Claude Code mais de 60 ferramentas, uma para cada coisa que a API faz: search_leads, get_campaign_stats, list_conversations, send_message, create_export e outras. Claude e ChatGPT fazem login com OAuth, sem chave para copiar. No Claude Code, basta um comando:

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

Depois, é só pedir: "Mostre os leads quentes de hoje da minha persona Tipsters, com o motivo de cada nota alta." As ferramentas de escrita precisam do escopo write, e o assistente pede a sua confirmação antes de enviar, iniciar ou excluir qualquer coisa. Para trabalhar com várias contas do X, adicione uma conexão por conta. A configuração completa está na documentação.

Por que funciona

• Push vence polling. Um webhook chega ao seu servidor assim que um lead fica quente, então o seu CRM ou o seu vendedor recebe o lead dentro daquela primeira hora, sem gastar requisições para checar.
• Um registro por lead. Salve o ID do CRM no metadata do lead, e todo evento seguinte aponta para o mesmo registro. Menos duplicatas, menos limpeza.
• Os assistentes de IA já falam MCP. A Anthropic relata mais de 10 000 servidores MCP públicos ativos e mais de 97 milhões de downloads mensais dos SDKs, com o MCP adotado por ChatGPT, Cursor, Gemini, Microsoft Copilot e Visual Studio Code. A Gartner espera que 60% do trabalho dos vendedores B2B passe por interfaces de IA conversacional até 2028.
• Agentes precisam de bons dados. A Gartner prevê que até 2028 menos de 40% dos vendedores vão dizer que os agentes de IA melhoraram a sua produtividade. Alimentar os seus agentes com leads pontuados, com um motivo para cada nota, em vez de uma lista crua, é como você fica entre os vendedores que veem o ganho.

Exportações manuais ou a API do Gemlead

Para quem é a API

• Desenvolvedores e RevOps que sincronizam leads do X com HubSpot, Salesforce, Pipedrive, Attio, Notion ou Google Sheets, com código próprio ou com uma ferramenta de automação que recebe webhooks.
• Fundadores que trabalham no Claude ou no ChatGPT e querem os leads quentes e as respostas no mesmo chat.
• Agências que fazem relatórios para os clientes a partir dos endpoints de analytics, com uma chave por conta do X de cliente.
• Times que constroem os próprios agentes de IA, que dão a eles os leads pontuados do Gemlead e as ferramentas de DM em vez de um scraper.
• Vendedores B2C, como um tipster esportivo ou um criador com uma comunidade paga, que querem cada lead quente na ferramenta do próprio time.

Como esses leads são encontrados está explicado em como encontrar leads no X. Antes de um agente escrever para eles, leia o que um SDR de IA consegue e não consegue fazer.

Boas práticas

1. Uma chave por ferramenta, guardada no seu servidor numa variável de ambiente como GEMLEAD_API_KEY. Dê write só às ferramentas que alteram dados.
2. Verifique todo webhook. Confira a assinatura no corpo bruto e recuse timestamps com mais de 5 minutos.
3. Responda rápido, processe depois. Responda 2xx em até 10 segundos e depois processe o evento numa fila. Cada evento é entregue pelo menos uma vez, então ignore um id de evento que você já tratou.
4. Exporte para grandes volumes. Uma exportação vale mais que centenas de páginas.
5. Leia antes de autorizar. Um assistente pode ser enganado por um texto que lê. Confira o que uma ferramenta de escrita vai fazer antes de aprovar.

Perguntas frequentes