Public API / v1
Festivalbeats API for developers
Build festival listings, calendars and search tools with approved data from festivalbeats.de. The API returns JSON, requires no key and is free to use.
Access
Free
No API key, read-only requests.
Rate limit / IP
20 / min
20 requests per minute, 200 requests per hour.
Data format
JSON · REST
Paginated lists and edition-specific details.
Start in 30 seconds
GET /api/v1/public/festivalsThis example returns the next approved electronic music festivals in Germany. Open it in your browser or call it from your backend.
curl -sS -H 'Accept: application/json' 'https://festivalbeats.de/api/v1/public/festivals?land=DE&kategorie=electronic&per_page=5'The response contains data[], links and meta. The default page size is 25, with at most 100 entries per page.
Integration notes
Approved entries only
Lists contain upcoming editions by default. include_past=1 adds earlier editions. Approval does not guarantee that an event will take place: check event_status and event_status_note.
Fetch sparingly
Both endpoints share the per-IP limits. Cache responses, follow pagination and, on HTTP 429, wait for the number of seconds in Retry-After.
Language and alternatives
Descriptions and FAQ text are in German. For a ready-to-use embed with its own design and backlink, try our festival widget.
OpenAPI 3.0
Interactive reference
Try parameters and inspect live responses.
Loading API reference…