Bereit für API und KI-Agenten

Zwei Arten von Schlüsseln, klarer Wirkungsradius

Schlüssel leben unter Einstellungen → API-Schlüssel und sind mit einem Klick erstellt. Website-Schlüssel (lk_…) sind öffentlich: Sie können nur Kontakte anlegen und sind in einem Formular auf Ihrer Website sicher. Geheime Schlüssel (sk_…) schalten die Verifizierungs-API und den Phasen-Hook frei, werden gehasht gespeichert und lassen sich jederzeit pausieren, neu erzeugen oder löschen. Bei jedem Schlüssel sehen Sie, wann er zuletzt verwendet wurde.

Die Endpunkte

Senden Sie den geheimen Schlüssel im Header x-api-key. Alle Antworten sind JSON; Fehler tragen einen kurzen Code wie rate_limited oder bad_input.

POST /api/v1/verify            { "email": "jane@example.com" }
POST /api/v1/verify/bulk       { "emails": ["…"], "name": "expo-2026" }   → job id
GET  /api/v1/verify/jobs/{id}  → progress and valid / risky / invalid counts; ?results=1 adds per-address results
POST /api/v1/find              { "name": "Jane Doe", "domain": "example.com" }
GET  /api/v1/credits           → credits left this month
POST /api/hooks/lead           email, name, company, phone, message, tag   (lk_ website key)
POST /api/hooks/stage          { "email": "jane@example.com", "stage": "customer" }
GET  /api/v1/leads?domain=example.com   → contacts already in your own CRM (0 credits)
POST /api/mcp                  MCP for AI agents: search_leads, verify_email

Limits: 120 Anfragen pro Minute und Schlüssel · 5 parallele Aufträge · 5 000 Adressen pro Auftrag · 1 Credit pro geprüfter Adresse oder Adresssuche

An einen KI-Agenten anschließen

Die Spezifikation unter /api/v1/openapi.json (OpenAPI 3.1) beschreibt die /api/v1-Endpunkte mit Schemas (die beiden Hooks oben sind einfache HTTP-Aufrufe), sodass ein Agent sie ohne eigenen Code aufrufen kann:

• ChatGPT: Ein GPT erstellen, die Spezifikation als Action importieren, API-Key-Authentifizierung mit dem Header x-api-key einstellen.
• Claude und jedes Modell mit Function Calling: Tool-Definitionen aus der Spezifikation erzeugen, den Lead-Hook ergänzen und das Modell in einer Unterhaltung prüfen, finden und übergeben lassen.
• Copilot Studio, n8n, Make, Zapier: Ein HTTP-Knoten mit demselben Header genügt; dank der Auftrags-ID sind lange Listen ein Zwei-Schritte-Ablauf.
• Ein typischer Agentenlauf: eine Liste aus einer Tabelle nehmen, prüfen, ungültige Adressen verwerfen, gültige mit einem Tag ins CRM übergeben und einen Kontakt beim Abschluss auf „Kunde“ setzen.

Node.js-SDK und MCP-Server

Auf GitHub liegen zwei Open-Source-Clients für diese API unter der MIT-Lizenz, installiert wird direkt von dort. Das Node.js-SDK ist ein typisierter Client für Node 20 oder neuer. Der MCP-Server lässt Claude Desktop, Cursor, VS Code und andere MCP-Clients, die einen lokalen Server starten können, Cold Leads als Tool nutzen.

Agenten mit MCP über HTTP brauchen keine Installation: Sie verbinden sich mit https://coldleads.app/api/mcp und senden den geheimen Schlüssel im Header Authorization: Bearer.

• code Node.js-SDK — github.com/anttka4cz/coldleads-node-sdk
• code MCP-Server — github.com/anttka4cz/mcp-server-coldleads

Automatisierung nach dem Aufruf

Über einen Schlüssel übergebene Kontakte können nach einer von Ihnen gesetzten Verzögerung eine Auto-Kampagne starten: Die Willkommens- oder Nachfass-E-Mail geht aus Ihrem eigenen Postfach raus, mit Probelauf, Tageslimits und menschlichem Tempo. Mit dem Phasen-Hook markiert Ihr Abrechnungs- oder CRM-System einen Kontakt in dem Moment als Kunde, in dem der Abschluss fällt, sodass der Funnel stimmt, ohne dass jemand Datensätze bearbeitet.

Tarife und Limits

Website-Schlüssel funktionieren in jedem Tarif. Geheime Schlüssel — Verifizierungs- und Such-API sowie der Phasen-Hook — gehören zu Business (99 €/Monat) mit 10.000 Credits im Monat; zusätzliche Pakete kosten 5 € pro 1 000. Ergebnisse werden 30 Tage zwischengespeichert (jede Prüfung kostet trotzdem 1 Credit), und alle Prüfungen laufen von den Servern von Cold Leads, nie von Ihrer Domain.

FAQ