API
Mit der Webmetic-API rufen Sie Besuche, Unternehmen und Ansprechpartner aus Ihren eigenen Systemen ab und erhalten neue Besuche per Webhook.
Ihr CRM holt zum Beispiel jede Nacht die Unternehmen ab, die Ihre Website besucht haben. Die REST-API liegt unter https://hub.webmetic.de, und jede Anfrage braucht einen API-Schlüssel im Header Authorization.
Jeden Endpunkt probieren Sie direkt aus: Die Seiten unter Playground beschreiben Anfrage und Antwort und senden auf Knopfdruck eine echte Anfrage, ohne Konto mit dem Demo-Schlüssel wmtc_demo. Der Schnellstart führt Sie zur ersten Anfrage aus Ihrem eigenen Code und erklärt die Antwort.
curl "https://hub.webmetic.de/company?domain=ihre-website.de&page_size=3" \
-H "Authorization: wmtc_IHR_API_SCHLUESSEL"Die Antwort enthält bis zu drei Unternehmen, die in den letzten 30 Tagen auf Ihrer Website waren.
API-Schlüssel
Admins finden die Schlüssel unter Menü > Integrationen > API, wo das Fenster API-Schlüssel drei Schlüssel zeigt:
- Visitor Intelligence: Besuche und Unternehmen, Ansprechpartner und Webhooks.
- Enrichment: alle Endpunkte unter
/enrichment/*. Sie erzeugen diesen Schlüssel in der Testphase, in Growth und in Enterprise. - Data Layer: die Unternehmens-Erkennung für das Matomo-Plugin.
Authentifizierung beschreibt, wie Sie den Schlüssel mitsenden und was ein neuer Schlüssel bewirkt.
Was die API kann
Visitor Intelligence
Unternehmen abrufen, die Ihre Website besucht haben, mit Besuchen, Seitenaufrufen und Branche. Außerdem liefert die API Auswertungen zu intensiven, wiederkehrenden und neuen Besuchen.
Enrichment
Unternehmensdaten zu einer Domain abrufen, einzeln oder als Liste mit CSV-Export. Für neue Listen und Abfragen brauchen Sie den Plan Growth.
Contacts
Ansprechpartner bei einem erkannten Unternehmen suchen und E-Mail-Adresse oder Telefonnummer freischalten. Das Freischalten kostet Credits.
Webhooks
Besuche und neue Segment-Treffer an Ihren Server melden lassen, und zwar wenige Minuten, nachdem der Besuch im Dashboard erscheint.
Die API sucht Ansprechpartner erst, wenn Sie Ansprechpartner einrichten einmal im Dashboard abgeschlossen haben. Vorher antwortet sie mit CONTACTS_SETUP_REQUIRED.
Grundlagen
- Schnellstart: die erste Anfrage senden und die Antwort lesen.
- Authentifizierung: den Schlüssel mitsenden und Fehler beim Schlüssel beheben.
- Fehler: alle Fehlercodes mit Ursache und Lösung.
- Paginierung: große Antworten seitenweise abrufen.
- Zeiträume und Zeitzonen: Zeiträume angeben und Zeitstempel lesen.
- Anfragelimits: wie viele Anfragen die API annimmt.
- Credits in der API: welche Anfragen Credits kosten.
- Asynchrone Ergebnisse: auf Enrichment-Ergebnisse warten.
- Webhooks: Ereignisse empfangen und die Signatur prüfen.
Referenz und Playground
Jede Seite der Referenz zeigt Parameter, Antworten und Code-Beispiele. Mit der Schaltfläche Try in Playground senden Sie direkt von der Seite eine Anfrage an die API.
Mit Ihrem eigenen Schlüssel ist jede Anfrage echt
Der Playground startet mit dem Demo-Schlüssel wmtc_demo und der Domain website.example. Der Demo-Schlüssel liefert erfundene Daten, speichert nichts und kostet keine Credits. Wenn Sie ihn durch Ihren eigenen Schlüssel ersetzen, arbeitet der Playground mit Ihrem echten Konto. /contacts/reveal und /contacts/find verbrauchen dann echte Credits. POST /webhooks legt einen echten Webhook an, und DELETE /webhooks/{endpoint_id} löscht ihn. Die schreibenden Enrichment-Anfragen legen echte Listen an und fügen Domains hinzu.
Für Automatisierungen und KI
- Für n8n, Make und Zapier stehen fertige Webmetic-Anbindungen bereit. Sie brauchen dafür nur Ihren API-Schlüssel, keinen eigenen Code.
- Der KI-Assistent beantwortet Fragen zu Ihren Besuchen per MCP, ohne eigenen Code.
- Diese Dokumentation steht als llms.txt bereit, und jede Seite erhalten Sie als Markdown, wenn Sie
.mdan ihre Adresse hängen.