Markthalle Hamburg APImarkthalle-hamburg.de ↗
Access upcoming concerts, parties, and shows at Markthalle Hamburg via API. Returns event titles, lineups, dates, ticket links, prices, and images.
What is the Markthalle Hamburg API?
The Markthalle Hamburg API exposes 1 endpoint — get_upcoming_events — that returns the full schedule of upcoming public events at the iconic Hamburg venue. Each response includes up to 17 structured fields per event: title, description, dates, venue room, artist lineup, ticket URLs, image URLs, categories, tags, and price. Results are sorted chronologically by start date, making it straightforward to build event calendars or listing feeds.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/fe111159-1b14-4132-87ce-8028e5dfc089/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 markthalle-hamburg-de-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: Markthalle Hamburg Events SDK — fetch upcoming events."""
from parse_apis.markthalle_hamburg_de_api import Markthalle, Event, ParseError
client = Markthalle()
# List upcoming events with a cap of 5
for event in client.events.list(limit=5):
print(event.title, "|", event.start_date, "|", event.timezone)
if event.venue:
print(" Venue:", event.venue.name)
if event.lineup:
print(" Lineup:", ", ".join(event.lineup))
# Drill into the first event for full details
first = client.events.list(limit=1).first()
if first:
print(f"\nFirst event: {first.title}")
print(f" Starts: {first.start_date} ({first.timezone_abbr})")
print(f" Image: {first.image_url}")
print(f" Ticket: {first.ticket_url}")
print(f" Source: {first.source_url}")
print(f" All day: {first.all_day}")
# Typed error handling
try:
for event in client.events.list(limit=2):
print(event.title, event.start_date)
except ParseError as exc:
print(f"Error fetching events: {exc}")
print("exercised: events.list / event fields / venue sub-object / error handling")
Fetches all upcoming public events from Markthalle Hamburg. Returns the full list of scheduled events with details including title, description, dates, venue, lineup, ticket links, and images. Results are ordered chronologically by start date. Each event includes the venue room (e.g. Grosser Saal, MarX), parsed artist lineup, and external ticket purchase URLs where available.
No input parameters required.
{
"type": "object",
"fields": {
"total": "integer count of events returned",
"events": "array of event objects with id, title, description, dates, venue, lineup, ticket/image/source URLs, categories, tags, price"
},
"sample": {
"data": {
"total": 92,
"events": [
{
"id": 18400,
"tags": [],
"price": null,
"title": "Etterath + Druma + Teryky",
"venue": {
"url": "https://markthalle-hamburg.de/veranstaltungsort/marx/",
"city": null,
"name": "MarX",
"address": null,
"country": null
},
"lineup": [
"Etterath",
"Druma",
"Teryky"
],
"all_day": false,
"end_date": "2026-07-10 20:00:00",
"timezone": "Europe/Berlin",
"image_url": "https://markthalle-hamburg.de/wp-content/uploads/2026/04/banner.jpg",
"categories": [],
"source_url": "https://markthalle-hamburg.de/konzerte/etterath-druma-teryky/",
"start_date": "2026-07-10 19:00:00",
"ticket_url": "https://www.eventim.de/event/etterath-druma-teryky-marx-21570882/",
"description": "Post-metal concert at MarX",
"timezone_abbr": "CEST"
}
]
},
"status": "success"
}
}About the Markthalle Hamburg API
What the API Returns
The get_upcoming_events endpoint returns a total integer and an events array. Each object in the array represents one scheduled event at Markthalle Hamburg and includes fields such as id, title, description, dates, venue, lineup, ticket URL, image URL, source URL, categories, tags, and price. Events span the full range of programming at the venue — concerts, club nights, and live shows — ordered by start date.
Venue and Coverage Details
Markthalle Hamburg is a single-venue event space in Hamburg, Germany. The API reflects its public event calendar at /programm/. The venue field identifies the specific room within the venue where each event is held, which matters for multi-stage nights. The lineup field lists the performing artists or acts. There are no input parameters; the endpoint always returns the complete upcoming schedule.
Data Fields Worth Noting
Each event's dates field carries scheduling data including start date and time. The price field reflects publicly listed ticket pricing. categories and tags allow downstream filtering by genre or event type. The ticket URL points directly to the ticketing page for that event, and the image URL provides the event's promotional artwork. The source URL links back to the event's detail page on markthalle-hamburg.de.
The Markthalle Hamburg API is a managed, monitored endpoint for markthalle-hamburg.de — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when markthalle-hamburg.de 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 markthalle-hamburg.de 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 live event calendar widget showing upcoming Markthalle Hamburg shows with ticket links
- Aggregate Hamburg concert listings by pulling
lineupanddatesfields for a city guide app - Monitor newly added events by comparing
idvalues across daily API calls - Display event poster images using the
imageURL field in a promotional display or digital signage system - Filter by
categoriesortagsto surface only specific genres (e.g. electronic, hip-hop) for niche recommendation tools - Track ticket pricing trends over time using the
pricefield per event - Power a Hamburg nightlife bot that surfaces tonight's events and links users to the
ticketURL
| 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 Markthalle Hamburg have an official developer API?+
What does get_upcoming_events return for each event?+
Does the API support filtering by date range, genre, or artist name?+
dates, categories, tags, and lineup fields. You can fork this API on Parse and revise it to add a filtered endpoint if you need server-side query support.Does the API cover past events or archived shows?+
How fresh is the event data?+
id values is the recommended approach.