Public API / v1
Festivalbeats API für Entwickler
Baue eigene Festivalübersichten, Kalender und Suchen mit den freigegebenen Daten von festivalbeats.de. Die API liefert JSON, benötigt keinen Schlüssel und ist kostenlos nutzbar.
Zugang
Kostenlos
Kein API-Key, nur lesende Anfragen.
Rate limit / IP
20 / min
20 Anfragen pro Minute, 200 Anfragen pro Stunde.
Datenformat
JSON · REST
Paginierte Listen, editionsgenaue Details.
In 30 Sekunden starten
GET /api/v1/public/festivalsDieses Beispiel liefert die nächsten freigegebenen Electronic-Festivals in Deutschland. Du kannst den Aufruf direkt im Browser öffnen oder in deinem Backend verwenden.
curl -sS -H 'Accept: application/json' 'https://festivalbeats.de/api/v1/public/festivals?land=DE&kategorie=electronic&per_page=5'Das Ergebnis enthält data[], links und meta. Die Standardgröße beträgt 25 Einträge, maximal 100 pro Seite.
Wichtig für deine Integration
Nur freigegebene Einträge
Listen enthalten standardmäßig kommende Festival-Ausgaben. include_past=1 ergänzt frühere Ausgaben. Eine Freigabe garantiert nicht, dass eine Veranstaltung stattfindet: Beachte event_status und event_status_note.
Schonend abrufen
Beide Endpunkte teilen sich die Grenzen je IP. Speichere Antworten zwischen, nutze die Seitennavigation und warte bei HTTP 429 die Sekunden aus Retry-After ab.
Sprache und Alternativen
Beschreibungen und FAQ-Texte sind deutsch. Für eine fertige Website-Einbindung mit eigenem Design und Backlink gibt es alternativ unser Festival-Widget.
OpenAPI 3.0
Interaktive Referenz
Parameter ausprobieren und echte Antworten ansehen.
API-Referenz wird geladen…