Molotow Club APImolotowclub.com ↗
Fetch upcoming events at Molotow Hamburg via API. Returns title, dates, lineup, ticket URLs, pricing, genre tags, and venue space across all 5 club areas.
What is the Molotow Club API?
The Molotow Club API exposes a single endpoint, get_upcoming_events, that returns all publicly listed upcoming events at the Molotow music venue in Hamburg, Germany. Each event object includes up to 12 fields covering title, description, start and end datetimes, ticket URLs, lineup, genre tags, pricing, image URL, and which of the five venue spaces (Club, Top Ten Bar, SkyBar, Karatekeller, or Backyard) is hosting the show.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/aeeafff2-8024-4e4e-bdf8-73092d4ce143/get_upcoming_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 molotowclub-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: Molotow Hamburg Events API — fetch upcoming events at the venue."""
from parse_apis.molotowclub_com_api import Molotow, ParseError
client = Molotow()
# List upcoming events at Molotow, capped to 5
for event in client.events.list(limit=5):
print(event.title, "|", event.start_datetime, "|", event.venue)
# Drill into the first event for full details
first = client.events.list(limit=1).first()
if first:
print(f"Event: {first.title}")
print(f"Date: {first.start_datetime} ({first.timezone})")
print(f"Venue: {first.venue} @ {first.location}")
print(f"Price: {first.price}")
print(f"Lineup: {first.lineup}")
print(f"Tags: {first.tags}")
print(f"Tickets: {first.ticket_urls}")
print(f"Image: {first.image_url}")
print(f"More info: {first.event_url}")
# Typed error handling
try:
for event in client.events.list(limit=3):
print(event.title, event.start_datetime)
except ParseError as exc:
print(f"Error fetching events: {exc}")
print("exercised: events.list")
Retrieves all upcoming public events at Molotow Hamburg. Returns events across all venue spaces (Club, Top Ten Bar, SkyBar, Karatekeller, Backyard) with title, description, start datetime, ticket URLs, image, lineup, genre tags, pricing, and venue information. Events are ordered chronologically. No input parameters required.
No input parameters required.
{
"type": "object",
"fields": {
"events": "array of event objects with id, title, description, start_datetime, end_datetime, timezone, ticket_urls, image_url, event_url, lineup, tags, price, venue, location"
},
"sample": {
"data": {
"events": [
{
"id": "59529",
"tags": [
"Konzert"
],
"price": "VVK: 23EUR zzgl. Gebühren | AK: 27 EUR",
"title": "SHITKID Support: JOY FOREVER",
"venue": "Club",
"lineup": [
"SHITKID Support: JOY FOREVER"
],
"location": "Molotow, Reeperbahn 136, 20359 Hamburg, Germany",
"timezone": "Europe/Berlin",
"event_url": "https://www.molotowclub.com/programm/programm.php?nr=59529",
"image_url": "https://www.molotowclub.com/cp_img/2026-06-30_16683_cl_0_0.57583000_1773851163.jpg",
"description": "ShitKid, live: 28.06.2026 Köln, Blue Shell...",
"ticket_urls": [
"https://www.tixforgigs.com/Event/72836",
"https://www.eventim.de/event/shitkid-molotow-21474026/?affiliate=TUG"
],
"end_datetime": "",
"start_datetime": "2026-06-30T19:00:00"
}
]
},
"status": "success"
}
}About the Molotow Club API
What the API Returns
The get_upcoming_events endpoint returns an array of event objects representing all publicly listed upcoming shows at Molotow Hamburg. Each object carries a unique id, a title, a description, structured start_datetime and end_datetime fields, and a timezone value. Ticket availability is surfaced through ticket_urls, and each event links back to its source page via event_url. A cover image is available at image_url.
Lineup, Genre, and Pricing
For each event, the lineup field lists the performing artists or acts. Genre classification is exposed through genre_tags, which lets you filter or categorize events by musical style. Pricing data is included where publicly available, making it straightforward to display admission costs alongside event details.
Venue Coverage
Molotow operates five distinct spaces: the main Club, Top Ten Bar, SkyBar, Karatekeller, and Backyard. Each event object identifies which venue space it belongs to, so you can build space-specific listings or venue-aware calendar views. All upcoming events across every space are returned in a single call — no pagination parameters are required since the endpoint takes no inputs.
Data Freshness and Scope
The endpoint covers only public upcoming events — past events and private or unlisted bookings are not included in the response. Events are ordered chronologically, which maps directly to a calendar-style display. There are no filter parameters on the endpoint itself; any filtering by date range, genre, or venue space happens client-side against the returned array.
The Molotow Club API is a managed, monitored endpoint for molotowclub.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when molotowclub.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 molotowclub.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 nightlife calendar that groups Molotow events by venue space using the venue field
- Send automated alerts when new events are added that match specific
genre_tagsvalues - Display artist lineups and ticket links in a third-party event discovery app
- Aggregate Molotow pricing data alongside other Hamburg venue admission costs
- Power a Telegram or Discord bot that posts upcoming show announcements with
event_urlandimage_url - Track how far in advance Molotow publishes events by monitoring
start_datetimeat ingestion time - Filter events by genre tag to surface punk, electronic, or indie shows for genre-specific newsletters
| 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 Molotow have an official public developer API?+
What does `get_upcoming_events` return for lineup and genre data?+
lineup array listing the performing acts and a genre_tags array with the musical genre labels associated with the event. Both fields reflect whatever is publicly listed on the event page. Events with no announced lineup or genre will return empty arrays for those fields.Does the endpoint cover past or archived events?+
get_upcoming_events returns only events with future dates that are publicly listed on the site. Past events are not included in the response. The API covers all five Molotow venue spaces for upcoming shows. You can fork it on Parse and revise it to add a past-events endpoint if archival data is needed.Can I filter events by venue space, date range, or genre through the API?+
get_upcoming_events endpoint takes no input parameters, so filtering is not available at the API level. All upcoming events across all five venue spaces are returned in one response. You can fork this API on Parse and revise it to add server-side filter parameters for venue, date range, or genre tag.Are ticket purchase details or sold-out status included?+
ticket_urls linking to ticketing pages and pricing where publicly listed, but real-time availability or sold-out status is not a field in the current response. You can fork this API on Parse and revise it to add availability status if that data is exposed on the ticket pages.