API-Zugang

Mit der nebty API bekommen Ihre eigenen Tools dieselben Daten, die Sie im Dashboard sehen. Sie können Ihre Brands, deren überwachte Domains und Scans sowie Ihre Takedowns lesen. Außerdem können Sie einen neuen Takedown anfordern.

Basis-URL: https://app.nebty.de/core/api/
Format: JSON hin, JSON zurück
Referenz: Alle Endpunkte stehen in der API-Referenz (auf Englisch).
OpenAPI-Dokument: Laden Sie openapi.json herunter, um einen Client zu erzeugen oder die API in ein Tool wie Postman zu importieren.

Die API ist für Ihre eigenen Skripte und Integrationen. Wenn Sie stattdessen einem KI-Assistenten wie Claude in normaler Sprache Fragen zu Ihren nebty-Daten stellen möchten, brauchen Sie keinen API-Key: siehe nebty mit Claude verbinden.

API-Key bekommen

Ihren Key erstellen Sie selbst im Dashboard. Das können Brand-Admins sowie Partner- und Enterprise-Konten; Ihre E-Mail-Adresse muss bestätigt sein. Wenn Sie keinen Key erstellen können, fragen Sie einen Admin Ihrer Brand oder schreiben Sie an [email protected].

Öffnen Sie im Dashboard die Einstellungen und dort die Karte API-Schlüssel (1). Wählen Sie API-Schlüssel erstellen (2).
Kopieren Sie den neuen Key (1) sofort. Der vollständige Key wird nur einmal angezeigt (2). Speichern Sie ihn in einem Passwort-Manager oder einem Secret Store, nicht im Quellcode.

Jeder Benutzer hat einen Key. Auf derselben Karte sehen Sie, wann er erstellt und zuletzt verwendet wurde. Schlüssel ersetzen (3) erstellt einen neuen Key, und der alte funktioniert sofort nicht mehr. Schlüssel widerrufen (4) schaltet den Key sofort ab. Tools, die noch den alten Key nutzen, schlagen fehl, bis Sie dort den neuen eintragen.

Was der Key darf

Ein Key gehört zu genau einem nebty-Benutzer und handelt als dieser Benutzer:

Er sieht dieselben Brands und Takedowns wie dieser Benutzer im Dashboard. Ändern sich die Rechte des Benutzers, ändern sich auch die Rechte des Keys.
Er darf nicht nur lesen. Er kann über die API alles, was dieser Benutzer kann.
Ein Takedown, den Sie für eine Brand mit aktivem Monitoring anfordern, startet sofort mit dem Status OPEN. Es gibt keinen zusätzlichen Bestätigungsschritt.

Behandeln Sie den Key wie ein Passwort. Wenn Sie glauben, dass er bekannt geworden ist, ersetzen oder widerrufen Sie ihn sofort in den Einstellungen.

Key mitsenden

Senden Sie den Key im Header Authorization mit dem Schema Api-Key:

Authorization: Api-Key nbty_your_key

Verwenden Sie Api-Key, nicht Bearer. Eine Anfrage mit fehlendem, falschem oder inaktivem Key bekommt 401 Unauthorized.

Nächste Schritte

Schnellstart: die ersten Aufrufe mit curl.
Grundlagen: Seitenaufteilung, kompakte Antworten und Fehler.
nebty mit Claude verbinden: nebty aus einem KI-Assistenten nutzen, ohne API-Key.