# API (https://webmetic.de/docs/api)

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](https://webmetic.de/docs/api/referenz/visitor-intelligence/company) beschreiben Anfrage und Antwort und senden auf Knopfdruck eine echte Anfrage, ohne Konto mit dem Demo-Schlüssel `wmtc_demo`. Der [Schnellstart](https://webmetic.de/docs/api/schnellstart) führt Sie zur ersten Anfrage aus Ihrem eigenen Code und erklärt die Antwort.

```bash title="Terminal"
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 [#api-schlüssel]

Admins finden die Schlüssel unter [**Menü** > **Integrationen** > **API**](https://app.webmetic.de/?menu=api_details), 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](https://webmetic.de/docs/integrationen/matomo-plugin).

[Authentifizierung](https://webmetic.de/docs/api/authentifizierung) beschreibt, wie Sie den Schlüssel mitsenden und was ein neuer Schlüssel bewirkt.

## Was die API kann [#was-die-api-kann]

- [Visitor Intelligence](https://webmetic.de/docs/api/referenz/visitor-intelligence/company-sessions): 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](https://webmetic.de/docs/api/referenz/enrichment/company): Unternehmensdaten zu einer Domain abrufen, einzeln oder als Liste mit CSV-Export. Für neue Listen und Abfragen brauchen Sie den Plan Growth.
- [Contacts](https://webmetic.de/docs/api/referenz/contacts/search): Ansprechpartner bei einem erkannten Unternehmen suchen und E-Mail-Adresse oder Telefonnummer freischalten. Das Freischalten kostet Credits.
- [Webhooks](https://webmetic.de/docs/api/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](https://webmetic.de/docs/ansprechpartner/einrichten) einmal im Dashboard abgeschlossen haben. Vorher antwortet sie mit `CONTACTS_SETUP_REQUIRED`.

## Grundlagen [#grundlagen]

- [Schnellstart](https://webmetic.de/docs/api/schnellstart): die erste Anfrage senden und die Antwort lesen.
- [Authentifizierung](https://webmetic.de/docs/api/authentifizierung): den Schlüssel mitsenden und Fehler beim Schlüssel beheben.
- [Fehler](https://webmetic.de/docs/api/fehler): alle Fehlercodes mit Ursache und Lösung.
- [Paginierung](https://webmetic.de/docs/api/paginierung): große Antworten seitenweise abrufen.
- [Zeiträume und Zeitzonen](https://webmetic.de/docs/api/zeitraeume-und-zeitzonen): Zeiträume angeben und Zeitstempel lesen.
- [Anfragelimits](https://webmetic.de/docs/api/anfragelimits): wie viele Anfragen die API annimmt.
- [Credits in der API](https://webmetic.de/docs/api/credits): welche Anfragen Credits kosten.
- [Asynchrone Ergebnisse](https://webmetic.de/docs/api/asynchrone-ergebnisse): auf Enrichment-Ergebnisse warten.
- [Webhooks](https://webmetic.de/docs/api/webhooks): Ereignisse empfangen und die Signatur prüfen.

## Referenz und Playground [#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.

<Callout type="warn" title="Mit Ihrem eigenen Schlüssel ist jede Anfrage echt">
Der Playground startet mit dem [Demo-Schlüssel](https://webmetic.de/docs/api/schnellstart#ohne-konto-testen) `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.
</Callout>

## Für Automatisierungen und KI [#für-automatisierungen-und-ki]

- Für [n8n](https://webmetic.de/docs/integrationen/n8n), [Make und Zapier](https://webmetic.de/docs/integrationen/make-und-zapier) stehen fertige Webmetic-Anbindungen bereit. Sie brauchen dafür nur Ihren API-Schlüssel, keinen eigenen Code.
- Der [KI-Assistent](https://webmetic.de/docs/ki-assistent) beantwortet Fragen zu Ihren Besuchen per MCP, ohne eigenen Code.
- Diese Dokumentation steht als [llms.txt](https://webmetic.de/docs/llms.txt) bereit, und jede Seite erhalten Sie als Markdown, wenn Sie `.md` an ihre Adresse hängen.
