Schnellstart

Diese Seite führt Sie Schritt für Schritt von Ihrem API-Key zu einer Takedown-Anfrage und ihrem Status. Sie brauchen einen API-Key (siehe API-Zugang) und curl.

Die Antworten unten sind gekürzt. Die IDs sind Beispiele; verwenden Sie die IDs aus Ihren eigenen Antworten.

1. Key speichern

export NEBTY_API_KEY="nbty_your_key"

2. Key prüfen

curl -s https://app.nebty.de/core/api/users/profile/ \
  -H "Authorization: Api-Key $NEBTY_API_KEY"

Funktioniert der Key, bekommen Sie den Benutzer, zu dem er gehört:

{
  "id": "baaa409d-985c-41d8-8153-7f137fb70a57",
  "username": "jane.doe",
  "email": "[email protected]",
  "account_type": "standard"
}

3. Brands auflisten

curl -s "https://app.nebty.de/core/api/brands/?compact=true" \
  -H "Authorization: Api-Key $NEBTY_API_KEY"

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "id": "f5705d11-6786-4f60-b52c-59a882ecf305",
      "name": "Solara",
      "domain": "solara.example",
      "plan": "free",
      "monitoring_enabled": true
    }
  ]
}

Kopieren Sie die id der Brand, mit der Sie arbeiten möchten.

4. Domains der Brand auflisten

BRAND_ID="f5705d11-6786-4f60-b52c-59a882ecf305"

curl -s "https://app.nebty.de/core/api/brands/$BRAND_ID/domains/?compact=true" \
  -H "Authorization: Api-Key $NEBTY_API_KEY"

{
  "count": 3,
  "next": null,
  "previous": null,
  "results": [
    {
      "id": "a4ac4f4c-5d7f-44b2-9ec3-8f51e4c097e3",
      "name": "solara-login.example",
      "source": "VARIATION",
      "latest_scan": null,
      "open_takedown": null
    }
  ]
}

latest_scan enthält das neueste Scan-Ergebnis der Domain, und open_takedown zeigt einen Takedown, der für sie schon läuft. Die vollständigen Belege zu einer Domain bekommen Sie mit GET /brands/{id}/domains/{domain_id}/.

5. Takedown anfordern

curl -s https://app.nebty.de/core/api/takedowns/ \
  -H "Authorization: Api-Key $NEBTY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "target_website": "https://solara-login.example/",
    "brand": "f5705d11-6786-4f60-b52c-59a882ecf305",
    "user_comment": "Phishing page copying our login"
  }'

Die API antwortet mit 201 Created und dem neuen Takedown:

{
  "id": "ba4486fa-e8b3-48a6-9c39-6c92fb9393e4",
  "target_website": "https://solara-login.example/",
  "brand": "f5705d11-6786-4f60-b52c-59a882ecf305",
  "brand_display": "Solara",
  "status": "OPEN",
  "status_display": "Open",
  "is_open": true,
  "created_at": "2026-10-02T07:24:39.314682Z"
}

Bei einer Brand mit aktivem Monitoring startet der Takedown als OPEN, und das nebty-Team beginnt mit der Arbeit. Ohne brand oder bei einer Brand ohne aktives Monitoring startet er als REQUESTED und wartet auf die Freigabe durch nebty.

6. Takedown verfolgen

TAKEDOWN_ID="ba4486fa-e8b3-48a6-9c39-6c92fb9393e4"

curl -s https://app.nebty.de/core/api/takedowns/$TAKEDOWN_ID/ \
  -H "Authorization: Api-Key $NEBTY_API_KEY"

curl -s https://app.nebty.de/core/api/takedowns/$TAKEDOWN_ID/events/ \
  -H "Authorization: Api-Key $NEBTY_API_KEY"

Der erste Aufruf liefert den aktuellen status. Der zweite liefert die Ereignis-Chronik des Falls, dieselbe, die Sie im Dashboard sehen.

Nächste Schritte

• Grundlagen: Seitenaufteilung, kompakte Antworten und Fehler.
• API-Referenz: alle Felder jedes Endpunkts (auf Englisch).