---
title: Betrugsprävention — Daten-API
---

# Betrugsprävention Daten-API

Die Daten-API ist das serverseitige Gegenstück zum [Web-SDK](./web-sdk). Nutzen Sie
sie, um Urteile abzurufen, Statistiken zu aggregieren und Daten für **Reporting und
Abstimmung** zu exportieren — um die Zahlen abzurufen, auf die sich Ihre eigenen
Systeme einigen.

## Basis-URL

```
https://apiv1.captcha.la
```

## Authentifizierung

Alle Daten-API-Anfragen werden mit Ihren Betrugsprävention-Anwendungsanmeldedaten
authentifiziert, gesendet als Header:

```
X-App-Key:    YOUR_APP_KEY
X-App-Secret: YOUR_APP_SECRET
```

::: warning
`X-App-Secret` ist **nur serverseitig**. Geben Sie es niemals an Browser, mobile Apps
oder öffentliche Repositories weiter. Das Seiten-SDK verwendet stets nur den
öffentlichen `appKey`.
:::

## Endpunkte

### Ein Urteil abrufen

Rufen Sie das Urteil für einen einzelnen Besuch ab (z. B. um einen bestimmten Besuch
abzustimmen).

```bash
GET /v1/bot/verdict?cid=CID_OF_THE_VISIT
X-App-Key: YOUR_APP_KEY
X-App-Secret: YOUR_APP_SECRET
```

Die Antwort `data` ist ein [`BotVerdict`](./verdict-reference)-Objekt:

```json
{
  "code": 0,
  "data": {
    "is_bot": true,
    "score": 87,
    "level": "high",
    "action": "flag",
    "consistency": { "ok": false },
    "degraded": false
  }
}
```

### Aggregierte Statistiken

Rufen Sie gebündelte Zählungen über einen Zeitraum ab — Gesamtwerte, Bot-Anteil und
die Aufschlüsselung nach `action`/`level` — für Dashboards und Qualitätsberichte.

```bash
GET /v1/bot/stats?from=2026-06-01&to=2026-06-30
X-App-Key: YOUR_APP_KEY
X-App-Secret: YOUR_APP_SECRET
```

```json
{
  "code": 0,
  "data": {
    "from": "2026-06-01",
    "to": "2026-06-30",
    "total": 124500,
    "bots": 18230,
    "bot_rate": 0.146,
    "by_action": { "record_only": 102100, "flag": 19800, "challenge": 2600 },
    "by_level":  { "low": 100300, "medium": 16900, "high": 6200, "critical": 1100 }
  }
}
```

### Export

Exportieren Sie Urteilszeilen pro Besuch für einen Zeitraum, für Offline-Abstimmung.

```bash
GET /v1/bot/export?from=2026-06-01&to=2026-06-30&format=csv
X-App-Key: YOUR_APP_KEY
X-App-Secret: YOUR_APP_SECRET
```

Jede Zeile trägt den Bezeichner des Besuchs, den Zeitstempel und die Urteilsfelder
(`is_bot`, `score`, `level`, `action`), sodass Sie sie wieder mit Ihren eigenen Logs
verknüpfen können.

::: tip Per-Klick-Abstimmung
Für Szenarien mit bezahltem Datenverkehr kann ein einzelner Besuch auf einen
bestimmten gelieferten Klick zurückgeführt werden, sodass zwei Parteien sich darauf
einigen können. Das nutzt ein Click-Token und wird im Leitfaden
[Anzeigenbetrug](./scenarios/ad-fraud) behandelt.
:::

## Nächste Schritte

- [Verdict-Referenz](./verdict-reference) — die von diesen Endpunkten zurückgegebenen Felder
- [Web-SDK](./web-sdk) — Urteile auf Ihrer Seite sammeln