Openbare event- en locatie-API

De openbare informatie uit onze agenda, als JSON. Alleen lezen, zonder account of API-sleutel. De agenda is een selectie van komende clubnachten, dancefestivals en events overdag, hoofdzakelijk in Nederland. Dit is geen volledig overzicht van iedere organisator of locatie.

Documentatie bijgewerkt op 9 oktober 2026. Dit is niet de controledatum van alle events.

Feeds

Bekijk events komende 30 dagen · Bekijk beschikbare guestlists. Deze overzichten laden zonder JavaScript. RSS-links leveren altijd RSS-XML, ook aan Google en browsers. JSON-links leveren altijd JSON. Gebruik de bovenstaande overzichtslinks voor een leesbare pagina. De RSS-feeds kunnen in Search Console als aanvullende sitemaps worden ingediend; /sitemap.xml blijft de volledige sitemap.

Events komende 30 dagen — RSS · JSON
Beschikbare guestlists — RSS · JSON

De eventfeed loopt van vandaag tot en met de volgende 29 kalenderdagen in Europe/Amsterdam en neemt lopende meerdaagse events mee. De guestlistfeed bevat alle komende events met een laatst gecontroleerde groepslink. Afgelopen en geannuleerde events zijn uitgesloten. Alle resultaten staan in één antwoord, zonder paginering. Alleen raw=1 wordt als parameter ondersteund. De feeds gebruiken dezelfde actuele gegevens als de agenda en ondersteunen ETag en korte caching. Een groepslink garandeert geen plek: controleer voorwaarden en bevestiging. JSON bevat de eventgegevens, absolute afbeeldingslinks en broncontroles; RSS bevat naam, datum, locatie, organisator, eventlink, beschikbare afbeelding en guestlistvoorwaarden.

Events opvragen

GET /api/events · OpenAPI-specificatie · Open JSON

Voorbeelden: Amsterdam in oktober 2026, zoeken naar Club Roto en events met een laatst gecontroleerde guestlistgroep.

Dit zijn alle ondersteunde parameters. Onbekende, herhaalde of ongeldige parameters geven status 400 met error en documentation. Niet-ondersteunde HTTP-methoden geven 405.

Paginering en eventidentiteit

Het antwoord bevat schemaVersion, documentation, filters, total, page, limit, pages, next, previous en events. Volg de volledige URL in next totdat deze null is. De eerste pagina bevat niet automatisch alle events. total telt alleen resultaten binnen de filters, niet alle events van een organisator.

Gebruik slug om hetzelfde event te herkennen en te ontdubbelen. Citeer de canonieke eventpagina met url. Er is geen snapshotsleutel: gegevens kunnen tussen pagina-aanvragen veranderen. Vermeld wanneer je de gegevens hebt geraadpleegd. Een leeg resultaat betekent alleen dat onze selectie binnen deze filters geen passend event bevat.

Organisatoren, steden en maanden

De agenda heeft een aparte organisatorfilter en links naar pagina’s per organisator, stad en maand. Deze staan ook in de sitemap: /events/organisator/{slug}, /events/stad/{slug} en /events/maand/{YYYY-MM}. Volg bestaande links; verzin geen slugs.

De API heeft geen aparte organizer-parameter of organisator-API. Zoek een organisator via q; daarbij kunnen ook andere tekstmatches verschijnen. Het veld organizer is tekst en kan meerdere organisatoren bevatten. Eventpagina’s linken naar bekende organisatoren; als de organisator niet afzonderlijk bevestigd is, kan een eventbron of locatie worden getoond. Een locatie is niet automatisch de organisator. Een vermelding bevestigt geen samenwerking, guestlistactie of volledige dekking van alle events van die partij.

Eén eventrecord, meerdere bronnen

ticketOptions is de centrale lijst van reguliere ticketfases en The List-aanbiedingen. Alle weergaven gebruiken dezelfde gegevens. Iedere optie bevat id, kind, name, url, currency en evidence. Prijs, servicekosten, vergelijkingsprijs, voorwaarden, beschikbaarheid en current zijn optioneel. Iedere ingevulde waarde heeft eigen bewijs in evidence, met bronlink, bronrol, echte controledatum en eventueel publicatiedatum. Een oude datum wordt niet vernieuwd door een algemene agenda-update.

current=true betekent alleen een expliciet bevestigde huidige fase. Een optie met conflicts heeft een onopgeloste tegenstrijdigheid; daarvoor publiceren we geen numerieke prijs of gestructureerde aanbieding. ticketDeal, regularTicket en ticketOffer zijn compatibiliteitssamenvattingen als centrale opties aanwezig zijn. Gebruik de centrale opties voor details en bronbewijs per onderdeel.

factSources bevat bewijs per basisgegeven. practicalFacts bevat praktische aanvullingen met eigen bron. enrichmentReview registreert werkelijk gecontroleerde onderdelen, ontbrekende informatie, conflicten en mislukte bronnen. Een poging is geen geslaagde broncontrole. Het afgeleide guestlist-blok bevat groepslink en voorwaarden; de controledatum van de groepslink bevestigt geen nieuwe prijs- of voorwaardencontrole.

Tickets, prijzen en voorwaarden

ticketUrl is de ticket- of bronroute die bij het event staat. Deze kan verschillen van sourceUrl, de bron voor eventinformatie. Bewaar volledige ticketlinks, inclusief queryparameters: die kunnen een aanbieding of specifiek event selecteren.

ticketDeal bevat een The List-aanbieding met prijs, bekende servicekosten, valuta, link en reviewedAt. regularTicket bevat reguliere tickets zonder The List-korting: url, reviewedOn, eventdatum, locatie en phases. Iedere fase bevat name, price, serviceFee en conditions. Tel prijs en bekende servicekosten op voor de totaalprijs en vermeld toegangstijden en fasevoorwaarden. reviewedOn is een leesbare historische controledatum.

ticketOffer kan een bevestigde totaalprijs met valuta en link bevatten. Ontbrekende servicekosten zijn onbekend, niet nul; een ontbrekende prijs betekent niet dat een event gratis is. Een reguliere prijs is geen korting. Een reviewdatum garandeert geen actuele prijs of voorraad. Ticketfases kunnen wijzigen of uitverkopen; controleer de gelinkte shop.

status=tickets betekent dat er een ticketroute is, geen gegarandeerde voorraad. sold-out en tba zijn de laatst opgeslagen status. Neem beschikbaarheid alleen over als die expliciet bevestigd is.

Guestlists en laatst gecontroleerde links

guestlistAvailable en guestlistUrl betekenen dat een laatst gecontroleerde eventgroeplink beschikbaar is. Ze bevestigen geen persoonlijke gastenlijstplek, vrije toegang of ticketvoorraad. Deelname aan een groep is geen toegangsbevestiging. Bekijk per event de promotieafspraken, deelnamevoorwaarden, minimumleeftijd en bevestiging; pas geen algemene vaste volgerseis toe op ieder event.

De linkpagina, openbare eventpagina’s en event-API kunnen bij uitval van de updater de laatst gecontroleerde groepslinks behouden. Deze verdwijnen niet automatisch na twaalf uur. Een oudere kopie is geen nieuwe controle en garandeert niet dat de link nog werkt. Bron- en controledatums blijven belangrijk; volg de organisator en eventgroep voor actuele voorwaarden.

Bronnen, datums en ontbrekende gegevens

checkedAt is een broncontrole. modifiedAt is een bekende inhoudelijke wijziging; pageModifiedAt omvat ook wijzigingen aan praktische informatie en gestructureerde gegevens. Een controle schuift de inhoudelijke wijzigingsdatum niet op. Deze datums zijn geen verkoopstart of eventdatum.

address.sourceUrl en address.checkedAt onderbouwen een bevestigd adres; performerSource en detailsSource onderbouwen specifieke aanvullingen. Ontbrekende tijden, prijzen, leeftijden, adressen en line-ups blijven onbekend. Gebruik bevestigde startDateTime, endDateTime en endDate waar aanwezig. Tijden kunnen over middernacht lopen; verzin geen eindtijd of tijdzone voor buitenlandse events.

Clubs en locaties

GET /api/locaties geeft schemaVersion, documentation, total en locations, zonder paginering. Alleen city en id zijn ondersteunde filters, maximaal 100 tekens. Iedere locatie heeft een stabiel ID, eigen pagina, adres, muziekprofiel, officiële agenda en een compact overzicht van komende events. Gebruik de volledige event-API of eventpagina voor prijzen, guestlists en alle details.

checkedAt is de laatste geslaagde agendacontrole en lastAttemptAt de laatste poging. Bij bronuitval blijft de eerdere controledatum staan en kan sourceError verschijnen. Gebruik een bestaand ID met location in de event-API, bijvoorbeeld TOFFLER. Events krijgen alleen locationId bij een overeenkomstige locatie en stad.

Actualiteit, caching en openbare bronnen

De openbare GET-antwoorden van de event- en locaties-API ondersteunen CORS, ETag en If-None-Match; een ongewijzigd antwoord kan status 304 geven. Antwoorden mogen 30 seconden worden gecachet; onderliggende openbare bronlezingen kunnen daarnaast maximaal 30 seconden oud zijn. Dit is cacheduur, geen belofte dat externe agenda’s iedere 30 seconden opnieuw worden gecontroleerd.

/api/calendar en /api/access-feed zijn ruwe leesfeeds met opgeslagen brongegevens en broncontroles, zonder HTTP-cache. Ze vervangen de verrijkte event-API niet. Een geslaagde feedcontrole bewijst geen volledige of actuele dekking van ieder event en iedere organisator. Bij bronuitval kan een eerdere kopie behouden blijven met de echte controledatum.

Het bronoverzicht voor AI-systemen verwijst naar deze uitleg, de openbare pagina’s, de OpenAPI-specificatie en de sitemap. Eventpagina’s kunnen MusicEvent-gegevens bevatten; dit garandeert geen vermelding in Google-eventresultaten of AI-antwoorden. Privéaanvragen, bezoekersmetingen en schrijf- of synchronisatiehandelingen vallen buiten deze openbare leesdocumentatie.

Gegevens kunnen wijzigen. Volg de officiële bron voor de laatste ticketstatus en voorwaarden. Een correctie doorgeven? Bekijk de contactgegevens.