Erste Schritte

Gemlead-API

Bring die heißen Leads, die Gemlead auf X findet, in deine eigenen Tools. Eine REST-API, signierte Webhooks und ein MCP-Server für KI-Assistenten, alles mit einem Schlüssel.

Bevor du loslegst

API und MCP-Server sind in den Tarifen Business und Enterprise enthalten, auch in der Testphase. Jeder Endpoint liegt unter https://gemlead.ai/api/v1, nimmt und liefert JSON mit Feldern in snake_case und schreibt jedes Datum und jede Uhrzeit in ISO 8601, in UTC.

Basis-URL

https://gemlead.ai/api/v1

API-Schlüssel holen

Öffne in Gemlead im Menü API. Wähle das X-Konto, für das der Schlüssel gedacht ist, gib ihm einen Namen und wähle seine Scopes, nur read oder read und write.

Der Schlüssel beginnt mit gl_live_ und wird nur einmal angezeigt, lege ihn also sofort in deinem Secret Manager oder in einer Umgebungsvariable ab. Ein Schlüssel gehört zu genau einem X-Konto und sieht immer nur dessen Daten.

Terminal

export GEMLEAD_API_KEY="gl_live_..."

Deine erste Anfrage

Prüfe den Schlüssel mit Konto abrufen. Jede Anfrage sendet den Schlüssel im Header Authorization, als Bearer Token.

Als Antwort erhältst du das X-Konto, zu dem der Schlüssel gehört, samt Tarif.

GET/v1/account

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

Antwort200

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

Heiße Leads auflisten

Ein Lead ist heiß, wenn Dana AI ihn mit 60 oder mehr bewertet. Rufe die neuesten mit hot=true ab und grenze die Liste mit persona, score_min oder einem Datum ein.

Listen werden seitenweise geliefert. Folge next_cursor, solange has_more true ist, wie unter Paginierung gezeigt.

GET/v1/leads

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

Antwort200

{
  "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"
}

Deinen ersten Webhook empfangen

Webhooks schicken Ereignisse an deinen Server, sobald sie eintreten, du musst also nie pollen. Registriere eine öffentliche HTTPS-URL für lead.hot und reply.received, bewahre das secret aus der Antwort auf und sende dir dann ein Testereignis. lead.created meldet jeden neuen Lead, ob heiß oder nicht.

Prüfe jede Anfrage anhand ihres Headers Gemlead-Signature, wie unter Signaturen prüfen gezeigt. Du kannst den Endpoint auch in der App unter API hinzufügen.

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"

KI-Assistenten verbinden

Mit dem MCP-Server von Gemlead unter https://gemlead.ai/mcp durchsuchen Claude, ChatGPT und Cursor deine Leads, lesen deine Unterhaltungen und steuern deine Kampagnen, direkt im Chat.

In Claude Code verbindet ihn ein einziger Befehl mit deinem Schlüssel. Für die anderen folge dem MCP-Setup.

Claude Code

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

Nächste Schritte

AuthentifizierungSchlüssel, Scopes und wie du sie sicher aufbewahrst.LeadsAlle Filter der Lead-Liste und das Lead-Objekt.WebhooksEreignisse, Payloads, Signaturen und Wiederholungen.MCP-ServerClaude, ChatGPT, Cursor und Claude Code einrichten.