Private Beta. Watch ist heute mit deinem normalen API-Schlüssel in jedem kostenpflichtigen Tarif aufrufbar, und Watcher kosten keine Ops; im kostenlosen Founding-Tarif lassen sie sich gar nicht anlegen. Angekündigt oder allgemein verfügbar ist Watch nicht: Request- und Response-Formen können sich jederzeit ohne Vorankündigung ändern, und es gibt keine Stabilitäts- oder Supportzusage, baue also noch nichts Tragendes darauf. Die Roadmap steht unter
Demnächst, und jedes Release wird im
Changelog angekündigt.
`POST /v2/watch` ist eine API zur Erkennung von Website-Änderungen: Du registrierst eine Seite
einmal, und ein droplet-lokaler Scheduler rendert sie in festem Takt in
echtem Headless Chrome neu, vergleicht jede Capture per Diff mit der vorherigen und
benachrichtigt dich (per HMAC-signiertem Webhook, E-Mail oder beidem), wenn sich die Seite
tatsächlich ändert. Es wird den Cron-Job plus Diffing plus Alerting-
Unterbau ersetzen, den du sonst rund um
[den perceive-Endpunkt](/de/docs/endpoints/perceive.md) aufbauen müsstest: ein Datensatz statt
Scheduler, Storage-Bucket und Vergleichsskript.
Hier ist der kleinste sinnvolle Aufruf. Sende eine URL und erhalte einen Watcher
zurück, der stündlich geplant ist:
```bash
curl -X POST https://api.enconvert.com/v2/watch \
-H "X-API-Key: sk_your_private_key" \
-H "Content-Type: application/json" \
-d '{
"url": "https://example.com/pricing"
}'
```
Die Antwort ist der vollständige Watcher-Datensatz. Er ist sofort `active`, und
`next_check_at` wird auf den nächsten Tick des Pollers gesetzt:
```json
{
"watcher_id": "wat_3f9a2c1b8e7d4a6f90b1c2d3e4f5a6b7",
"url": "https://example.com/pricing",
"status": "active",
"frequency_minutes": 60,
"diff_mode": "auto",
"track_fields": null,
"webhook_url": null,
"notify_email": true,
"consecutive_errors": 0,
"checks_count": 0,
"last_check_at": null,
"next_check_at": "2026-06-24T18:31:07Z",
"last_change_at": null,
"created_at": "2026-06-24T18:31:07Z",
"updated_at": null
}
```
---
## Endpoints
| Methode | Pfad | Zweck |
|--------|------|---------|
| `POST` | `/v2/watch` | Erstellt einen Watcher für eine URL. Gibt `201` zurück. |
| `GET` | `/v2/watch` | Listet die Watcher dieses Projekts auf, neueste zuerst. |
| `GET` | `/v2/watch/{watcher_id}` | Ruft den vollständigen Datensatz eines Watchers ab. |
| `GET` | `/v2/watch/{watcher_id}/snapshots` | Listet den Prüfverlauf eines Watchers auf, neueste zuerst. |
| `PATCH` | `/v2/watch/{watcher_id}` | Aktualisiert Takt, Diff-Einstellungen oder pausiert/setzt fort. |
| `DELETE` | `/v2/watch/{watcher_id}` | Löscht einen Watcher weich (idempotent). |
**Content-Type:** `application/json` bei `POST` und `PATCH`.
---
## Authentifizierung
Authentifiziere dich mit einem privaten Schlüssel im `X-API-Key`-Header für
Server-zu-Server-Aufrufe. Diesen Weg nutzt jedes Beispiel unten.
```http
X-API-Key: sk_your_private_key
```
Öffentliche Schlüssel mit einem JWT-Bearer-Token funktionieren ebenfalls, nach demselben Ablauf wie
bei jedem anderen Endpunkt: Erzeuge ein Token mit deinem `pk_`-Schlüssel und sende es dann
als `Authorization: Bearer