Authentifizierung

Jede Anfrage an POST /v1/search wird mit einem API-Key authentifiziert, der im x-api-key-Header gesendet wird.

curl -X POST https://api.serp.cheap/v1/search \
  -H "x-api-key: YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{ "q": "coffee makers" }'

Einen Key bekommen

Erstelle und verwalte Keys im Dashboard. Du kannst mehrere Keys pro Konto halten (z. B. einen pro Umgebung) und jeden davon jederzeit deaktivieren. Jeder Key trägt sein eigenes Rate-Limit, abgeleitet von deinem Tarif.

Auth-Fehler

HTTP	`error`	Bedeutung
401	`missing_api_key`	Es wurde kein `x-api-key`-Header gesendet.
401	`unknown_api_key`	Der Key existiert nicht.
403	`inactive_api_key`	Der Key wurde deaktiviert.
403	`account_blocked`	Das Konto ist gesperrt.

Siehe Fehler & Wiederholungen für das vollständige Fehlermodell und die Codes, die du wiederholen solltest.