Search Luma events
TL;DR
About
Developers looking for a Luma API to search public events by topic or city usually find there is none they can use: Luma's official API is for hosts managing their own events and has no public event search. This script fills that gap. It works like an API endpoint — one call with typed arguments, a JSON response — but runs through a real browser, yours or a hosted one, so it needs no Luma developer account, API key or app review.
Input
city optionalCurated Luma city slug to filter by (e.g. "paris", "london", "new-york"). Mutually exclusive with topic.
limit optionalMax events to return per call. Default 25.
Default: 25topic optionalCategory slug to filter by (e.g. "crypto", "arts-culture", "fitness"). Mutually exclusive with city. Some categories are only served per place and cannot be browsed globally; those fail naming the slug, and the way to browse them is `city`.
cursor optionalPagination cursor from a previous call's next_cursor.
latitude optionalOptional latitude to sort results by proximity. It only changes the order; it does not satisfy a category that Luma serves per place.
longitude optionalOptional longitude to sort results by proximity. It only changes the order; it does not satisfy a category that Luma serves per place.
Output
events requiredhas_more requirednext_cursor optionalExample output
Shape only: placeholder values generated from the output schema, not a real run.
{
"events": [
{
"city": "…",
"name": "Example",
"slug": "…",
"end_at": "2026-01-15T09:30:00Z",
"address": "…",
"is_free": true,
"event_id": "abc123",
"start_at": "2026-01-15T09:30:00Z",
"timezone": "…",
"cover_url": "https://example.com/item/123",
"guest_count": 3,
"calendar_name": "…",
"calendar_slug": "…",
"location_type": "…",
"show_guest_list": true,
"require_approval": true,
"registration_availability": "…"
}
],
"has_more": true,
"next_cursor": "…"
}FAQ
Register for a free Luma event
Register the signed-in Luma account for a free public event by its slug. Custom registration questions are answered from what you pass in `answers`, and a phone number from `phone_number`; nothing is invented, so an unanswered required question is refused rather than guessed at. Required terms and agreement boxes are ticked only when you pass accept_terms:true; optional marketing opt-ins are never ticked. Fails on events that are not free or not open for registration. This signs you up as an attendee under your real identity, so confirm the event with the person you're helping before running it; cancelling afterward is a separate action.
Cancel registration for a Luma event
Cancel the signed-in Luma account's registration for an event by its slug. A registration already cancelled is reported as such rather than an error; an event the account was never registered for is refused, since there is nothing to cancel. This notifies the event organizer that you won't attend, so confirm the event with the person you're helping before running it — re-registering afterward is a separate action.
Get Luma event attendees
Get the attendees of a Luma event. When the signed-in account is an approved guest and the organizer has the guest list switched on, this returns the full roster — every guest, paginated, with their public profile and social handles. Otherwise it returns the featured preview Luma shows on the event page and explains why in roster_note, so a short list is never mistaken for an empty event. Check roster_scope to tell the two apart. Returns public profile fields only — no email addresses — but it is still a list of real people, so treat the output as personal data.