melkweg.nl 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.
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'
Get the full agenda of upcoming events at Melkweg. Returns all scheduled events with basic details including title, date, category, genres, and ticket status.
No input parameters required.
{
"type": "object",
"fields": {
"total": "integer total count of events",
"events": "array of event summary objects with id, title, subtitle, slug, date, category, genres, ticket_status, is_free_for_members, is_just_announced, announced_at, image_url, url"
},
"sample": {
"data": {
"total": 211,
"events": [
{
"id": "27098",
"url": "https://www.melkweg.nl/en/agenda/amsterdelics-13-05-2026",
"date": "2026-05-13T17:30:00.000000Z",
"slug": "amsterdelics-13-05-2026",
"title": "The Amsterdelics",
"genres": [
"Psychedelic",
"Funk",
"Soul"
],
"category": "Concert",
"subtitle": "special guests: Def P / Pieter Both / Maikal X",
"image_url": "https://assets.melkweg.nl/eventpages/a31c51b7-d481-4a4d-9a85-778f637d0300/488571077_1248181260439602_4803838792680089190_n.jpg",
"announced_at": "2026-01-23T14:00:00.000000Z",
"ticket_status": "Gepubliceerd",
"is_just_announced": false,
"is_free_for_members": false
}
]
},
"status": "success"
}
}About the melkweg.nl 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.
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.
- 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 | 250 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.