Clay-API und Integrationen: Datenflüsse von Hand verdrahten

Das Wichtigste in Kürze Clay hat eine öffentliche API. Sie liegt unter https://api.clay.com/public/v0, authentifiziert wird über den Header clay-api-key, und sie umfasst 13 dokumentierte Operationen. Die zugehörige OpenAPI-3.1.0-Spezifikation lag am 29. August 2026 unter developers.clay.com/openapi.json und war 67.151 Bytes groß. Fünf weitere Dinge heißen im Alltag „die Clay-API“ und sind es nicht: die HTTP-Spalte, die eingehende Webhook-Quelle, der ausgehende signierte Webhook, die native Anbieteraktion, der MCP-Server. Andere Tarife, andere Obergrenzen. Wo Clay ein Verhalten beschreibt, aber keine Zahl dazu veröffentlicht, sagt diese Seite das offen.

Letzten Monat hat mir ein RevOps-Verantwortlicher einen Blogbeitrag geschickt, als Beleg dafür, dass Clay keine API habe. Viele Texte behaupten das immer noch. Sie beschreiben ein Produkt, das sich inzwischen weiterentwickelt hat. Die Basis-URL ist öffentlich, und die Spezifikation lässt sich problemlos herunterladen. Ich habe sie am 29. August gezogen: 67.151 Bytes, OpenAPI 3.1.0, 13 Operationen.

Die Entwicklerplattform hat nie einen eigenen Changelog-Eintrag bekommen. Auch deshalb hält sich die veraltete Antwort so hartnäckig in den Suchergebnissen. Was jetzt kommt, ist die Verdrahtung: was Zeilen anlegt, was Zellen füllt, woran dein Code herankommt und jede Obergrenze, die Clay veröffentlicht hat.

Hat Clay eine API?

Ja. Clays öffentliche API liegt unter https://api.clay.com/public/v0. Authentifiziert wird über den Header clay-api-key; den Schlüssel dafür stellst du unter Settings → Account → API keys aus (der Bereich ist dort noch als Beta gekennzeichnet). Dahinter stehen 13 Operationen: eine Identitätsprüfung, Routine-Läufe, Batch-Läufe, Searches und Tabellenabfragen. Auf einen abgelehnten Schlüssel antwortet Clay mit {"message": "Authentication failed"}. Der Schlüssel gehört auf den Server, nicht in den Browser.

Die Spezifikation ist maschinenlesbar, deinen Client kannst du dir also automatisch erzeugen lassen. In openapi.json stehen info.title „Clay Public API“, info.version „0“ und ein einziges Schema namens ClayApiKey. Eine openapi.yaml gibt es nicht.

Clay-Integrationen: zehn Schnittstellen und wie du die richtige findest

Zeilen kommen über eine Quelle herein oder gar nicht – die öffentliche API liest Tabellen, baut aber keine.

Die meisten Tickets, in denen „wir brauchen die Clay-API“ steht, meinen eigentlich eine Quelle oder eine Spalte. Davon hängt ab, ob ein Sprint fällig ist oder ein Tarifwechsel.

Bevor du mit der Entwicklerplattform planst, solltest du einen Widerspruch kennen. university.clay.com/docs/clay-api-cli schreibt, die Entwicklerplattform sei „available across all Clay plans, including free and trial plans“, und API- wie CLI-Aufrufe verbrauchten „the same credits and actions as the equivalent work done in-product“. Die Preis-FAQ dagegen führt „Clay API access“ als Enterprise-Punkt, und in der Vergleichstabelle taucht überhaupt keine API-Zeile auf. Prüf das zuerst in deinem eigenen Workspace. Zwei Randnotizen aus derselben Doku: CLI und API laufen in der offenen Beta auf Mac und Linux, nicht auf Windows, und das Agent-Plugin ist in der Beta auf den aktuellen Tarifen verfügbar, auf den alten noch bis Ende 2026.

Launch kostet 185 $ im Monat, bei jährlicher Zahlung 167 $, Growth 495 $ beziehungsweise 446 $ – Clay veröffentlicht diese Preise in Dollar, deshalb stehen sie auch hier in Dollar. Alle Preisstufen stehen im Artikel Clay-Preise. Die Größe seines Anbieterverzeichnisses gibt Clay auf drei Arten an: „200+ providers“ in der Navigation, „150+ data partners“ in der Preis-FAQ und 157 eindeutige /integrations/data-provider/-URLs, verteilt auf 24 Kategorien, als ich am 29. August auf clay.com/integrations nachgezählt habe.

Routines: die Arbeitseinheit, die dein Code aufrufen kann

Eine Routine ist Clay-Logik mit einer Adresse. Du legst in der Oberfläche eine eigene Funktion an, schaltest ihre API-Integration frei, nimmst die t_...-ID und stellst function: davor.

Kleine Aufgaben laufen direkt durch. POST /routines/{routine_id}/run nimmt ein items-Array mit mindestens einem und höchstens 100 Einträgen entgegen. Clay hat die Referenzseite dazu „Execute a routine against 1-100 items“ betitelt, die Obergrenze steht also schon in der Überschrift. Zurück kommt ein 202 mit einer routine_run_id, dazu optional eine webhook_id.

Größere Aufgaben brauchen vier Aufrufe. Erst holst du dir eine vorsignierte URL von run-batch/upload-url, dann schiebst du die JSONL-Datei per PUT als application/x-ndjson hoch, Zeilen in der Form {"id": "row-1", "inputs": {"domain": "clay.com"}}, danach POST auf run-batch/start und zum Schluss GET /routines/run-batch/{id}/results. Die CLI fasst alle vier zu clay routines runs start function:t_abc123 --bulk rows.jsonl zusammen, und clay login --device meldet dich auf einem Rechner ohne Browser an.

Searches fragt Clays eigene GTM-Datenbank ab, entweder über die erweiterte Suche (Beta, verschachtelte boolesche Ausdrücke) oder über strukturierte Filter, innerhalb der Grenzen aus der Tabelle weiter unten. Überschreitest du eine davon, kommt HTTP 402 zurück und nennt sie beim Namen. Ein Vorbehalt dazu: university.clay.com/docs/clay-api-cli nennt 10.000 Ergebnisse je Anfrage für die zahlenden Self-Serve-Tarife, developers.clay.com/searches dagegen 500. Ich halte mich an die Entwicklerdoku.

Fehlt noch die Grenze, die auf Seite eins der Suchergebnisse niemand nennt. Clay schreibt, es gebe „no current plans to support table building via the developer platform“. Tables erlaubt nur Lesezugriffe, und das ausschließlich auf Enterprise, über POST /public/v0/tables/query; einen Endpoint zum Auflisten der Tabellen gibt es nicht. Zeilen kommen über eine Quelle herein oder gar nicht. In welcher Reihenfolge du die Quellen einrichtest, steht in So nutzt du Clay.

Was Clay dir sagt, wenn ein Aufruf scheitert

Clay dokumentiert sein Verhalten im Fehlerfall gründlich und veröffentlicht keine einzige Zahl dazu, ab wann die Drosselung greift. Kläre das, bevor du einen Job dimensionierst.

Das Rate-Limit für Anfragen gilt je Workspace. Reißt du es, kommt HTTP 429, dazu Retry-After in Sekunden und die Header X-RateLimit-Limit, X-RateLimit-Remaining und X-RateLimit-Reset, „when available“. Die CLI endet mit Exit-Code 4. Clay rät, 429 als wiederholbar zu behandeln und Batch- und Async-Endpoints engen Polling-Schleifen vorzuziehen („prefer batch and async endpoints over tight polling loops“).

Alles außerhalb von 2xx kommt als JSON mit einer lesbaren message zurück. Clay hält fest: „Error response bodies do not currently include stable error codes.“ Unterscheiden kannst du die Fälle also nur am Statuscode – 401 und 403 Authentifizierung, 404 nicht vorhanden, 409 und 422 Validierung, 429 Rate-Limit, 5xx vorübergehend. Ein 202 auf einem asynchronen Endpoint ist übrigens kein Erfolg. Es heißt nur, dass der Lauf noch nicht fertig ist.

Die HTTP-API-Spalte: eine Quelle anbinden, von der Clay nie gehört hat

Mit dieser Spalte bindest du etwas an, das nicht in Clays Verzeichnis steht. Über GET, POST, PUT und DELETE schickt sie Daten an ein beliebiges Werkzeug oder eine beliebige Datenbank oder holt Daten von dort ab, „even when Clay doesn't offer a native integration“. Jeder Statuscode, den Clay dafür dokumentiert, beschreibt den Endpoint, den du aufgerufen hast, nicht Clay selbst. Wird eine Spalte rot, schaust du deshalb zuerst dorthin.

Die letzte Zeile dreht die übliche Ordnung um. Die Drossel stellst du selbst ein, Clay legt sie dir nicht auf. Dafür gibt es zwei Felder, Request limit und Duration (ms), und Clays eigenes Beispiel mit 10 auf 1.000 ms ergibt zehn Anfragen pro Sekunde.

Zwei Warnungen zu Zugangsdaten, beide von Clay. Tippst du einen Schlüssel direkt ins Feld Headers, liegt er im Klartext offen für jeden, der die Spalte sehen darf („visible in plain text to anyone with access to the table column“). Nimm also ein gespeichertes Konto. Der Haken ist nur: Änderst du das Konto später, betrifft es „every HTTP API enrichment column across your workspace that uses it“.

Clay-Webhooks zeigen in zwei Richtungen und haben nur den Namen gemeinsam

Die Tabelle zu leeren gibt keine der 50.000 Übermittlungen zurück, und ein ausgehender Webhook kommt womöglich nie an.

Der eingehende Webhook ist eine Quelle. Unten im Workbook auf + Add, nach Webhooks suchen, Monitor webhook wählen, URL kopieren. Den Auth-Token siehst du genau einmal: „Make sure to copy the token immediately, as you can only access authentication tokens once.“ Dann kommt die Grenze, an der es Teams erwischt. Eine Webhook-Quelle nimmt 50.000 Übermittlungen an, und dieser Zähler wird nicht zurückgesetzt, auch wenn du Zeilen löschst („persists even after deleting rows“). Die Tabelle zu leeren bringt nichts; unterhalb von Enterprise legst du eine neue Quelle an. Der Leitfaden ist außerdem mit einem Tarif namens „Explorer“ gekennzeichnet, den die Preisseite gar nicht mehr führt – prüf die Stufe also in deinem eigenen Workspace nach.

Der ausgehende Webhook gehört zur Entwicklerplattform. clay webhooks create https://example.com/hooks/clay liefert id, url, createdAt und ein signingSecret, das du sofort sichern musst – „store immediately, it can't be retrieved later“. Jede Zustellung enthält webhookId, createdAt und ein data-Objekt, signiert als X-Clay-Signature: sha256= plus HMAC-SHA256 über den Body. Dann steht dort ein Satz, der deine Architektur bestimmen sollte, nicht bloß deine Fehlerbehandlung: „Webhook delivery is not guaranteed. Use webhooks to react faster, but keep polling the run's results as a fallback.“

Clay und LinkedIn: die Grenzen von Find People und was die Chrome-Extension wirklich tut

Listen nach LinkedIn-Muster fangen meistens bei Find People an; dafür gelten die Grenzen aus der Tabelle weiter unten. Dazu kommen Ausschlüsse: 300.000 Personen insgesamt und 100.000 je Quelle, verteilt auf drei Listen und abgeglichen über LinkedIn-URLs. Woher die Daten dahinter stammen, sagt Clays Dokumentation nirgends. Also sage ich es auch nicht.

Bei der Chrome-Extension liegen die meisten Suchenden daneben, deshalb ganz nüchtern: Clays Dokumentation beschreibt beide Erweiterungen als Werkzeuge zum Auslesen von Seiten, nicht zum Freischalten von Kontaktdaten. Clay for Chrome zieht strukturierte Daten von einer Seite und legt Felder wie Name, Website, LinkedIn oder Crunchbase in einer Tabelle ab. Clip to Clay speichert ganze Seiten. Der Store-Eintrag kommt auf 4,4 von 5 Sternen aus neun Bewertungen und 10.000 Nutzer; die Version 1.0.0 wurde zuletzt am 10. April 2025 aktualisiert.

Clay-MCP: dein Workspace im Assistenten

Clays MCP-Server verbindet einen Workspace mit Claude, ChatGPT, Microsoft Copilot und Glean; verwaltet wird das unter Settings → MCP users. Die Credit-Steuerung gibt es auf Launch, Growth und Enterprise, die Steuerung der Zielgruppe ausschließlich auf Enterprise. Abgerechnet wird exakt wie im Produkt: „If a Function that finds someone's email and phone number costs 12 credits in a Clay table, it costs 12 credits when a rep triggers it from Claude or ChatGPT.“ Das Agent-Plugin ist noch einmal etwas anderes. Laut Clays Entwicklerdoku bringt es Clays Skills samt clay-CLI zu Coding-Agenten wie Claude Code, Codex und Cursor; es läuft also im Terminal, nicht in einem Chat-Client.

Jede Grenze, die Clay schriftlich festhält

Fast jede Grenze bei Clay liegt bei 50.000. Am meisten Planung verlangt die Webhook-Quelle, weil ihr Zähler das Löschen überlebt.

Massenanreicherung über 50.000 Datensätze hinaus gibt es nur auf Enterprise. Vor einem großen Import lohnt sich außerdem ein Blick auf einen Satz aus Clays Doku zu den Quellen. Zur Zeilengrenze steht dort: „Clay imports records up to the limit and stops automatically. No error message is displayed.“ Clay schlägt selbst vor, die Datei nach Filter oder Zeitraum zu teilen oder auf Enterprise zu wechseln, wo Tabellen mit automatischer Löschung und Massenanreicherung bereitstehen.

Enrow als Spalte in deiner Tabelle

Weder Clay noch Enrow berechnet eine leere Suche – eine Kette mit Wiederholungen kostet nur dann etwas, wenn ein Ergebnis kommt.

Enrow steht seit dem 1. September 2024 in Clays Verzeichnis, unter Contact Data und Contact Data Verification, als von Clay entwickelte Integration mit dem Vermerk „Included in All Plans“. Drei Aktionen laufen als Spalten, und jede liefert neben dem Ergebnis einen Qualifizierungsstatus mit.

Für diese Verifizierung hält Enrows eigene Doku Kosten in Clay-Credits fest, während Clays Eintrag sie kostenlos nennt. Klär das in der App, bevor du damit rechnest. Mit deinem eigenen Schlüssel richtest du eine HTTP-API-Spalte auf https://api.enrow.io/email/find/single, Header x-api-key und Content-Type: application/json, Body {"company_domain": /company_domain, "fullname": "/first_name /last_name"}. Die Antwort kommt asynchron, du übergibst also eine Clay-Webhook-URL in settings.webhook oder fragst die Such-ID am passenden GET-Endpoint ab, bis das Ergebnis da ist. Setz Request limit auf 10 und Duration auf 1000, das passt genau zu Enrow: Jeder POST-Endpoint von Enrow erlaubt zehn Anfragen in der Sekunde je Schlüssel, und ein Bulk-POST zählt als eine einzige Anfrage, selbst wenn 5.000 E-Mail-Einträge darin stecken.

Jetzt der Teil, der in einer Kette mit Wiederholungen zählt. Clays Regel lautet: „If an enrichment returns no result, you're not charged Data Credits or Actions.“ Auf der Lieferantenseite passt Enrows Regel dazu. Ein Credit verlässt den Topf, wenn ein gültiges Ergebnis zurückkommt, nie bei einem Fehlschlag. Gibt es einen Treffer, kostet eine E-Mail einen Enrow-Credit, eine Direktnummer 40, eine Verifizierung ein Viertel, alles aus einem gemeinsamen Topf. Um die Reihenfolge geht es in Anreicherungs-Wasserfälle in Clay.

Hinter jeder Adresse stehen über zehn Prüfungen, und Catch-all-Domains werden aufgelöst und zugestellt statt als riskant abgestempelt. Gemessen an unseren eigenen Dateien liegt die Trefferquote bei rund 60 %, die Bounce-Rate unter 1 %. Das sind Messwerte von uns, keine Zusage.

Die Liste, die Enrow dir nicht anlegt

Enrow sucht die Kontaktdaten zu Personen, die du schon identifiziert hast. Für eine E-Mail-Adresse braucht es einen vollständigen Namen und eine Domain, für eine Handynummer eine Profil-URL oder einen Namen samt Firmenkontext. Eine Datenbank zum Stöbern steht nicht dahinter, deshalb kommt „alle VP Engineering in Amsterdam bei Series-B-Firmen“ leer zurück. Das ist Absicht. Gespeicherte Zeilen veralten still vor sich hin, eine Abfrage in Echtzeit nicht, und mir ist eine fehlende Suchfunktion lieber als eine mit alten Daten. Innerhalb von Clay kostet dich das ohnehin nichts, weil Find People, ein CRM-Sync oder eine CSV diese Aufgabe schon vorher erledigen. Nach welchen Kriterien du einen Anbieter auswählst, steht in So wählst du einen B2B-Datenanbieter.

Läuft dein Prozess im Code statt in einem Workbook, rufst du dieselben Abfragen direkt auf. Einen Schlüssel für die Enrow-API bekommst du ohne Verkaufsgespräch, und offizielle SDKs gibt es inzwischen für sieben Sprachen – JS/TypeScript, Python, PHP, Go, Java, Swift und Rust, alle im Early Access und als Quellcode auf GitHub. Der MCP-Server EnrowAPI/enrow-mcp macht dieselben drei Abfragen für einen Assistenten verfügbar, sodass Claude oder Cursor Kontaktdaten abrufen können, ohne dass eine Tabelle dazwischensteht. Die Endpoints im Detail stehen in E-Mail-Finder-API.

FAQ

Ist die Clay-API kostenlos?

Für die Entwicklerplattform verlangt Clay keinen Aufschlag. Clays Doku schreibt, sie sei auf allen Tarifen verfügbar, einschließlich Gratis- und Testtarif, und API- wie CLI-Aufrufe verbrauchten dieselben Credits und Actions wie die gleiche Arbeit im Produkt. Die eigentliche Grenze setzen die 500 Actions und 100 Data Credits im Monat auf dem Gratis-Tarif.

Was ist der Unterschied zwischen Clays HTTP-API und Clays öffentlicher API?

Clays HTTP-API und Clays öffentliche API zeigen in entgegengesetzte Richtungen. Die HTTP-API ist eine Spalte in einer Clay-Tabelle, die einen fremden Endpoint aufruft und die Antwort in eine Zeile schreibt; Clays Vergleichstabelle ordnet sie dem Growth-Tarif zu. Die öffentliche API unter https://api.clay.com/public/v0 ist die Schnittstelle, die dein eigener Code von außerhalb von Clay aufruft, um Routinen laufen zu lassen, Batch-Jobs zu starten und Searches abzufragen.

Welchen Tarif brauche ich für Clays HTTP-API und Webhooks?

Growth. In Clays Vergleichstabelle sind „HTTP API integrations“ und „Automate any signal via webhooks“ auf Free und Launch nicht enthalten; CRM- und Warehouse-Verbindungen liegen auf derselben Stufe. Die öffentliche API, die CLI und der MCP-Server laufen laut Clays Entwicklerdoku auf jedem Tarif.

Wie hoch sind die Rate-Limits der Clay-API?

Clay veröffentlicht das Verhalten, nicht die Zahl. Die öffentliche API begrenzt die Anfragen je Workspace, antwortet mit HTTP 429, schickt Retry-After in Sekunden und ergänzt X-RateLimit-Limit, X-RateLimit-Remaining und X-RateLimit-Reset, sofern verfügbar. Eine Angabe zu Anfragen pro Sekunde steht in der Doku nirgends.

Kann ich mit der API Daten in eine Clay-Tabelle schreiben?

Nein. Clay schreibt, es gebe derzeit keine Pläne, den Aufbau von Tabellen über die Entwicklerplattform zu unterstützen. Tables erlaubt nur Lesezugriffe und steht ausschließlich auf Enterprise zur Verfügung, abgefragt über POST /public/v0/tables/query mit höchstens 100 Zeilen je Seite. Zeilen kommen über eine Quelle herein.

Gibt es in Clay ein Webhook-Limit?

Ja, und es ist dauerhaft. Eine Clay-Webhook-Quelle nimmt 50.000 Übermittlungen an, und Clay dokumentiert, dass die Grenze auch nach dem Löschen von Zeilen bestehen bleibt („persists even after deleting rows“). Die Tabelle zu leeren setzt also nichts zurück. Unterhalb von Enterprise hilft eine neue Quelle; auf Enterprise entfällt die Obergrenze bei Tabellen mit automatischer Löschung.

Was macht die Clay-Chrome-Extension?

Die Clay-Chrome-Extension liest Seiten aus, statt Kontaktdaten freizuschalten. Clay for Chrome zieht strukturierte Daten von einer Webseite, aus einer automatisch erkannten Liste oder von einem einzelnen Profil in eine Clay-Tabelle und legt Felder wie Name, Website, LinkedIn, Twitter oder Crunchbase ab. Clip to Clay, die zweite Erweiterung, speichert ganze Webseiten in einer Tabelle.

Hat Clay einen MCP-Server?

Ja. Er verbindet einen Workspace mit Claude, ChatGPT, Microsoft Copilot und Glean und wird unter Settings → MCP users verwaltet. Ab Launch gibt es eine Credit-Steuerung mit einem Budget, das am 1. jedes Monats um Mitternacht UTC zurückgesetzt wird. Einen MCP-Aufschlag verlangt Clay nicht: 12 Credits in einer Tabelle sind 12 Credits aus einem Assistenten heraus.

Mach also deinen Workspace auf, schreib auf, was bei dir tatsächlich läuft, und ordne jedem Punkt eine Zeile aus der ersten Tabelle zu. Die Antwort auf „Können wir das automatisieren?“ steckt meistens schon im Konto, eine Stufe höher oder eine Spalte weiter.

Fehlt dir dabei die verifizierte E-Mail-Adresse oder die europäische Handynummer, steht Enrow im Verzeichnis als Spalte, die du sofort einschalten kannst. Der Gratis-Tarif schreibt dir zu jedem Monatsanfang 50 Credits gut, dauerhaft, und verlangt dafür keine Kreditkarte, nutzbar in der App, in der Chrome-Erweiterung und in KI-Assistenten. Willst du die Spalte mit deinem eigenen Enrow-Schlüssel betreiben, brauchst du die API, die dir mit jedem Kauf offensteht: einem Tarif ab 15 € im Monat oder einem Credit-Paket ohne Abo.