Aan de slag

Gemlead API

Breng de hete leads die Gemlead op X vindt naar je eigen tools. Een REST API, ondertekende webhooks en een MCP-server voor AI-assistenten, allemaal met één sleutel.

Voordat je begint

De API en de MCP-server zitten in de abonnementen Business en Enterprise, proefperiode inbegrepen. Elk endpoint staat onder https://gemlead.ai/api/v1, accepteert en retourneert JSON met velden in snake_case en noteert elke datum en tijd in ISO 8601, in UTC.

Basis-URL

https://gemlead.ai/api/v1

Maak een API-sleutel

Ga in Gemlead naar API in het menu. Kies het X-account waarvoor de sleutel is, geef hem een naam en kies de scopes, alleen read of read en write.

De sleutel begint met gl_live_ en is maar één keer te zien. Zet hem dus meteen in je secret manager of in je omgeving. Een sleutel hoort bij één X-account en ziet alleen de gegevens daarvan.

Terminal

export GEMLEAD_API_KEY="gl_live_..."

Doe je eerste request

Test de sleutel met Het account ophalen. Elk request stuurt de sleutel mee in de header Authorization, als bearer token.

Je krijgt het X-account terug waar de sleutel bij hoort, met het abonnement.

GET/v1/account

curl https://gemlead.ai/api/v1/account \
  -H "Authorization: Bearer $GEMLEAD_API_KEY"

Response200

{
  "object": "account",
  "id": "a9PzK2vRtM",
  "username": "acme",
  "name": "Acme",
  "profile_image_url": "https://pbs.twimg.com/profile_images/1180044592/acme_400x400.jpg",
  "plan": "business"
}

Vraag je hete leads op

Een lead is heet als Dana AI hem een score van 60 of meer geeft. Vraag de nieuwste op met hot=true en voeg persona, score_min of een datum toe om de lijst te verfijnen.

Lijsten komen per pagina. Volg next_cursor zolang has_more true is, zoals Paginering laat zien.

GET/v1/leads

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

Response200

{
  "object": "list",
  "data": [
    {
      "id": "msgOtJ8dvT",
      "object": "lead",
      "profile": {
        "x_user_id": "1460283925",
        "username": "jane_builds",
        "name": "Jane Doe",
        "bio": "Runs a paid trading community. Daily setups, no hype.",
        "followers_count": 12400,
        "following_count": 380,
        "location": "Austin, TX",
        "website": "https://janedoe.com",
        "profile_image_url": "https://pbs.twimg.com/profile_images/1460283925/jane_400x400.jpg",
        "verified": true,
        "url": "https://x.com/jane_builds"
      },
      "score": 86,
      "score_reason": "Runs a paid trading community and asks how to collect payments for it.",
      "hot": true,
      "status": "scored",
      "persona": {
        "id": "lvWBPnytpS",
        "name": "Tipsters"
      },
      "campaign": null,
      "conversation_id": null,
      "locked_to": null,
      "found_at": "2026-11-05T14:02:11.482Z",
      "scored_at": "2026-11-05T14:03:40.117Z",
      "updated_at": "2026-11-05T14:03:40.117Z",
      "metadata": {}
    }
  ],
  "has_more": true,
  "next_cursor": "eyJzIjoiMjAyNi0xMS0wNVQxNDowMzo0MC4xMTdaIn0"
}

Ontvang je eerste webhook

Webhooks sturen gebeurtenissen naar je server zodra ze plaatsvinden, dus je hoeft nooit te pollen. Registreer een publieke HTTPS-URL voor lead.hot en reply.received, bewaar de secret uit de response en stuur jezelf een testgebeurtenis. lead.created stuurt elke nieuwe lead, heet of niet.

Controleer elk request met de header Gemlead-Signature, zoals Handtekeningen verifiëren laat zien. Je kunt het endpoint ook in de app toevoegen, onder API.

POST/v1/webhook_endpoints

curl -X POST https://gemlead.ai/api/v1/webhook_endpoints \
  -H "Authorization: Bearer $GEMLEAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/webhooks/gemlead",
    "events": ["lead.hot", "reply.received"],
    "description": "CRM sync",
    "filters": {
      "persona_ids": ["lvWBPnytpS"]
    }
  }'

POST/v1/webhook_endpoints/:id/test

curl -X POST \
  https://gemlead.ai/api/v1/webhook_endpoints/wh3LpX9dKe/test \
  -H "Authorization: Bearer $GEMLEAD_API_KEY"

Koppel een AI-assistent

Met de MCP-server van Gemlead op https://gemlead.ai/mcp kunnen Claude, ChatGPT en Cursor je leads doorzoeken, je gesprekken lezen en je campagnes aansturen, gewoon in de chat.

In Claude Code koppel je hem met één commando en je sleutel. Voor de andere clients volg je MCP instellen.

Claude Code

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

Volgende stappen

AuthenticatieSleutels, scopes en hoe je ze veilig bewaart.LeadsAlle filters van de leadlijst en het lead-object.WebhooksGebeurtenissen, payloads, handtekeningen en nieuwe pogingen.MCP-serverClaude, ChatGPT, Cursor en Claude Code instellen.