# Schnellstart

> Ihre ersten Aufrufe der nebty API mit curl, von der Liste Ihrer Brands bis zur Takedown-Anfrage.

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](https://docs.nebty-id.com/de/api/access/)) und `curl`.

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

## 1. Key speichern

```bash
export NEBTY_API_KEY="nbty_your_key"
```

## 2. Key prüfen

```bash
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:

```json
{
  "id": "baaa409d-985c-41d8-8153-7f137fb70a57",
  "username": "jane.doe",
  "email": "jane.doe@example.com",
  "account_type": "standard"
}
```

## 3. Brands auflisten

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

```json
{
  "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

```bash
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"
```

```json
{
  "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

```bash
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:

```json
{
  "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

```bash
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](https://docs.nebty-id.com/de/api/basics/): Seitenaufteilung, kompakte Antworten und Fehler.
- [API-Referenz](https://docs.nebty-id.com/api/reference/): alle Felder jedes Endpunkts (auf Englisch).