Zurück zur Übersicht

API-Dokumentation

Interaktive Referenz aller REST-API-Endpunkte. Testen Sie Anfragen direkt in der Dokumentation mit Ihrem API-Schlüssel.

Bearer-Token-Authentifizierung
10 Anfragen/Sekunde (Rate-Limit)
OpenAPI 3.1

Schnellstart

Erstellen Sie einen API-Schlüssel in Ihren Kontoeinstellungen, dann senden Sie Ihre erste Anfrage:

curl -H "Authorization: Bearer zvg_XXXXXXXX_YYYYYYYY..." \
  "https://api.zvg-einfach.de/v1/auctions?land=st&per_page=5"

Kostenlose Sandbox

Jedes Konto, auch ein kostenloses, kann in den Kontoeinstellungen einen Sandbox-Schlüssel erstellen. Eine Registrierung ist nötig, eine Zahlung nicht.

  • Nur Daten aus Sachsen-Anhalt (Bundesland-Kürzel st)
  • 100 Aufrufe pro Tag (Zurücksetzung um 00:00 UTC), 10 Anfragen pro Sekunde
  • Ein Schlüssel pro Konto, ohne Ablaufdatum
  • Anfragen für ein anderes Bundesland liefern 403 sandbox_region_restricted, ein aufgebrauchtes Tageslimit liefert 429 daily_limit_exceeded
  • Die Header X-DailyLimit-Remaining und GET /v1/me zeigen die verbleibenden Aufrufe

Mit einem API-Abo gilt derselbe Schlüssel für alle Bundesländer, ohne Tageslimit.