Open data
All the data is free to use as JSON and calendar feeds, with no API key. You are welcome to use it in sites, apps or articles; please credit "OpenMO Events" with a link.
JSON endpoints
| URL | Main fields |
|---|---|
| /api/v1/events.json | id, title{4}, category, status, start, end, window, permanent, impact, venueIds, summary{4}, image, url |
/api/v1/events/{id}.json | … + sessions, milestones, ticket, traffic, sources, maps |
| /api/v1/days.json | date, level(0–3), score, reasons[{kind, label{4}, points, eventId}], inboundPeak, outboundPeak, eventIds |
| /api/v1/holidays.json | region(MO|CN|HK), date, name{4}, kind, golden, status |
| /api/v1/hotspots.json | id, name{4}, kind, area, lat, lng, peaks{4}, tips{4}, maps |
| /api/v1/venues.json | id, name{4}, operatorId, capacity, area, lat, lng, hotspotIds, maps |
| /api/v1/operators.json | id, name{4} |
Responses carry a schemaVersion. Fields are only ever added; any breaking change bumps the version. Cross-origin requests are allowed (CORS).
Calendar feeds (.ics)
- https://event.openmo.org/calendar/en/all.ics
- https://event.openmo.org/calendar/en/confirmed.ics
- https://event.openmo.org/calendar/en/holidays.ics
- https://event.openmo.org/calendar/en/category-concert.ics
- https://event.openmo.org/calendar/en/category-sports.ics
- https://event.openmo.org/calendar/en/category-festival.ics
- https://event.openmo.org/calendar/en/category-exhibition.ics
- https://event.openmo.org/calendar/en/category-culture.ics
- https://event.openmo.org/calendar/en/category-religious.ics
Embed card
Paste this into your page to show upcoming events in Macao; it updates by itself every week.
<iframe src="https://event.openmo.org/embed/en/upcoming" title="Upcoming in Macao" width="100%" height="420" style="border:0;border-radius:16px" loading="lazy"></iframe>