Melkweg APImelkweg.nl ↗
Access Melkweg Amsterdam's full event agenda, filter by category or genre, search artists, and retrieve detailed event info including timetables and ticket links.
What is the Melkweg API?
The Melkweg API exposes 8 endpoints covering the full event schedule at Amsterdam's Melkweg venue, from agenda browsing to per-event detail. get_event_detail returns timetable text, ticket purchase URLs, venue room names, and genre tags for any event identified by its slug. Filter the agenda by category, genre, or date, or pull newly announced shows and member-free events directly.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/fd5cffad-9bf6-495f-be3d-cb70aa398c6e/get_agenda' \ -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 melkweg-nl-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.
"""
Melkweg Events API - Usage Example
Get your API key from: https://parse.bot/settings
"""
from parse_apis.melkweg_events_api import Melkweg, Category, EventSummary
melkweg = Melkweg()
# List all upcoming events
for event in melkweg.eventsummaries.list():
print(event.title, event.date, event.category)
# Filter events by category using the Category enum
for concert in melkweg.eventsummaries.by_category(category=Category.CONCERT):
print(concert.title, concert.slug, concert.genres)
# Get full detail for a specific event
detail = melkweg.events.get(slug="the-story-so-far-10-06-2026")
print(detail.title, detail.date, detail.timetable)
# Search for events by keyword
for hit in melkweg.eventhits.search(query="jazz"):
print(hit.title, hit.category, hit.image_url)
# Navigate from summary to full detail via sub-resource
for summary in melkweg.eventsummaries.free_for_members():
full = summary.detail.get()
print(full.title, full.is_free_for_members, full.ticket_url)
Get the full agenda of upcoming events at Melkweg. Returns all scheduled events with summary details including title, date, category, genres, and ticket status. No filtering applied.
No input parameters required.
{
"type": "object",
"fields": {
"total": "integer total count of events",
"events": "array of event summary objects"
},
"sample": {
"data": {
"total": 225,
"events": [
{
"id": "26928",
"url": "https://www.melkweg.nl/en/agenda/the-story-so-far-10-06-2026",
"date": "2026-06-10T17:00:00.000000Z",
"slug": "the-story-so-far-10-06-2026",
"title": "The Story So Far",
"genres": [
"Pop punk",
"Hardcore punk"
],
"category": "Concert",
"subtitle": "Support: Drain",
"image_url": "https://assets.melkweg.nl/eventpages/ee89ed8b-5ff1-4d3b-8934-4e89d20e39bf/CMS-bannner-TSSF-(1).png",
"announced_at": "2026-02-02T17:00:00.000000Z",
"ticket_status": "Gepubliceerd",
"is_just_announced": false,
"is_free_for_members": false
}
]
},
"status": "success"
}
}About the Melkweg API
Agenda and Filtering
get_agenda returns the complete list of upcoming Melkweg events, each with an id, slug, title, subtitle, date, category, genres, ticket_status, is_free_for_members, and an is_just flag indicating recent announcement. From there, get_agenda_by_category accepts a case-insensitive category string — verified values include Concert, Clubnacht, Film, Expositie, and Festival — and get_agenda_by_genre filters by genre tags such as Pop, Hiphop, Electronic, Heavy, Indie, Jazz, Funk, Soul, or Punk. get_agenda_by_date takes a YYYY-MM-DD date string and matches events whose start datetime begins with that date; it returns total: 0 with an empty array when no events are scheduled.
Event Detail and Search
get_event_detail accepts a slug from any agenda response and returns the full event record: ISO datetime date, location as an array of venue room names, timetable schedule text, ticket_url, image_url, genres, and status. search_events supports keyword queries — artist name, event name, or genre — and returns paginated results with nbHits, nbPages, and per-result date as a Unix timestamp, content_preview, and image_url. Pages are 0-indexed; requesting page >= nbPages returns an empty results array.
Convenience Endpoints
get_just_announced returns events announced within the last 14 days, identified by the is_just flag on each event object. get_free_for_members returns only events where is_free_for_members is true. Both share the same summary event object shape used across all agenda endpoints, so slugs from either can be passed directly to get_event_detail for the full record.
The Melkweg API is a managed, monitored endpoint for melkweg.nl — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when melkweg.nl 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 melkweg.nl 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 concert calendar app that displays upcoming Melkweg shows filtered by genre (e.g. Electronic or Jazz) using
get_agenda_by_genre. - Send automated alerts when new events are announced by polling
get_just_announcedand comparing against a stored list of slugs. - Display member-exclusive free events on a Melkweg membership benefits page using
get_free_for_members. - Power an artist search feature that queries
search_eventsby artist name and links out to Melkweg ticket pages viaticket_url. - Aggregate daily event schedules for a city guide by calling
get_agenda_by_datewith each target date. - Scrape timetable and venue room data from
get_event_detailto feed a structured event-listing database. - Filter Clubnacht events via
get_agenda_by_categoryto track nightlife programming trends across a season.
| 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 Melkweg have an official public developer API?+
What does `get_event_detail` return beyond what the agenda endpoints provide?+
get_event_detail adds fields not present in agenda summaries: timetable (schedule text), ticket_url (direct purchase link), location (array of venue room names), image_url, and subtitle. The agenda endpoints return only summary objects with ticket_status rather than a direct URL.How does pagination work in `search_events`?+
nbPages indicating the total number of pages. Requesting a page value equal to or greater than nbPages returns an empty results array rather than an error, so always check nbPages before incrementing the page counter.Does the API cover past events or a historical archive?+
Are presale or sold-out ticket details exposed beyond the ticket_status field?+
ticket_status string and get_event_detail provides a ticket_url, but granular inventory counts, presale windows, or dynamic availability data are not part of the response. You can fork this API on Parse and revise it to add an endpoint that tracks status changes over time.