Docks Freiheit 36 APIdocksfreiheit36.com ↗
Access upcoming event data from Docks, Prinzenbar, Grosse Freiheit 36, and Kaiserkeller venues in Hamburg via a single JSON endpoint.
What is the Docks Freiheit 36 API?
The Docks Freiheit 36 API exposes 1 endpoint — GET events — that returns all upcoming confirmed public events across four Hamburg music venues: Docks, Prinzenbar, Grosse Freiheit 36, and Kaiserkeller. Each event object carries up to 12 fields including name, ISO 8601 start and end dates, door time, genre, performers, ticket URL, pricing offers, and a description, covering the full public event calendar in a single request.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/83303448-779a-4201-aa61-b9730b18e73a/events' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace docksfreiheit36-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: DocksFreiheit36 SDK — fetch upcoming events from Hamburg venues."""
from parse_apis.docksfreiheit36_com_api import DocksFreiheit36, Event, ParseError
client = DocksFreiheit36()
# List upcoming events across all venues (Docks, Prinzenbar, Grosse Freiheit 36, Kaiserkeller)
for event in client.events.list(limit=5):
print(event.name, event.startDate, event.type)
# Get the first event and inspect its full details
event = client.events.list(limit=1).first()
if event:
print(f"Event: {event.name}")
print(f" Start: {event.startDate}")
print(f" Door: {event.doorTime}")
print(f" Location: {event.location}")
print(f" Organizer: {event.organizer}")
print(f" Offers: {event.offers}")
print(f" Description: {event.description[:100] if event.description else 'N/A'}")
# Typed error handling
try:
for e in client.events.list(limit=3):
print(e.name, e.sourceUrl)
except ParseError as exc:
print(f"Error fetching events: {exc}")
print("exercised: events.list / event field access / error handling")
Returns all upcoming confirmed public events from all venue pages (Docks, Prinzenbar, Grosse Freiheit 36, Kaiserkeller). Each event includes name, start/end dates in ISO 8601 UTC, door time, description, event type, genre, performers, image URL, ticket URL, price/offers, organizer, age restriction, source URL, and location details. Events are sorted chronologically by start date. Results are auto-iterated as a single page containing all events.
No input parameters required.
{
"type": "object",
"fields": {
"events": "array of event objects with name, startDate, endDate, doorTime, description, type, genre, performers, image, ticketUrl, offers, organizer, ageRestriction, sourceUrl, location"
},
"sample": {
"data": {
"events": [
{
"name": "WM Australien - Aegypten",
"type": "Party",
"genre": null,
"image": "https://images.copilot.events/resize?url=example&width=1920",
"offers": {
"price": "EINTRITT FREI!"
},
"endDate": "2026-07-04T03:00:00.000Z",
"doorTime": "2026-07-03T17:00:00.000Z",
"location": {
"city": "Hamburg",
"name": "DOCKS",
"address": null
},
"organizer": "MTM GmbH",
"sourceUrl": "https://docksfreiheit36.de/event?slug=9fb6b78a-ca0c-45e0-b512-ebe2717beded",
"startDate": "2026-07-03T18:00:00.000Z",
"ticketUrl": null,
"performers": null,
"description": "Hamburgs groesstes Public Viewing im Docks!",
"ageRestriction": null
}
]
},
"status": "success"
}
}About the Docks Freiheit 36 API
What the API Returns
The GET events endpoint returns an array of event objects sourced from all four venue pages on docksfreiheit36.com. Every object in the events array includes name, startDate, and endDate in ISO 8601 UTC format, plus doorTime for arrival planning. You also get description, type (event classification), and genre for filtering by music or event category.
Performer and Ticket Data
Each event object includes a performers field listing the acts on the bill and an image field with a URL to the event artwork. For ticketing integration, ticketUrl links directly to the purchase page, and offers contains structured pricing data so you can surface ticket costs without scraping the booking flow separately.
Coverage and Inputs
The endpoint takes no input parameters — it returns all upcoming confirmed events from all four venues in a single call. There is no venue filter, date range filter, or pagination; the full forward-looking calendar is returned at once. Events are limited to confirmed public shows; private events and unannounced dates are not included.
The Docks Freiheit 36 API is a managed, monitored endpoint for docksfreiheit36.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when docksfreiheit36.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official docksfreiheit36.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a Hamburg live music calendar aggregating events from all four venues in one feed
- Send automated alerts when new events are added for a specific genre or performer
- Compare ticket prices across upcoming shows using the
offersfield - Display door times and event start times in a venue guide or city events app
- Track which performers are booked across Docks, Prinzenbar, Grosse Freiheit 36, and Kaiserkeller
- Populate a city nightlife widget with event images, names, and direct ticket links
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does docksfreiheit36.com have an official developer API?+
Can I filter events by venue or genre in the GET events request?+
genre, type, and startDate fields present in each event object.Does the API include past or cancelled events?+
GET events endpoint returns only upcoming confirmed public events. Historical event archives and cancelled shows are not included. You can fork this API on Parse and revise it to add a historical events endpoint if that coverage is needed.