lu.ma APIlu.ma ↗
Access upcoming events from lu.ma across 79+ cities. Get event titles, dates, venues, organizers, timezones, and registration URLs via two simple endpoints.
curl -X GET 'https://api.parse.bot/scraper/5977a819-cd3b-4786-b111-4cf922e2e657/get_events?city=nyc&limit=3' \ -H 'X-API-Key: $PARSE_API_KEY'
Get upcoming events for a specific city. Returns events with title, date, venue, organizer, timezone, cover image, and registration URL. Results are paginated from the Luma discover API.
| Param | Type | Description |
|---|---|---|
| city | string | City slug as returned by list_cities endpoint (e.g. 'vancouver', 'sf', 'nyc', 'london', 'austin'). Use list_cities to see all available options. |
| limit | integer | Maximum number of events to return. |
{
"type": "object",
"fields": {
"city": "string — the city slug that was queried",
"events": "array of event objects with title, date, end_date, timezone, venue, registration_url, cover_image, organizer, event_api_id",
"total_returned": "integer — number of events returned"
},
"sample": {
"data": {
"city": "sf",
"events": [
{
"date": "2026-05-14T20:00:00.000Z",
"title": "Hello World Launch Party by Anything",
"venue": "Corgi Cafe, San Francisco",
"end_date": "2026-05-15T00:00:00.000Z",
"timezone": "America/Los_Angeles",
"organizer": "Anything",
"cover_image": "https://images.lumacdn.com/uploads/hv/63ec7ec9-1821-44e4-b854-38006128cf4c.png",
"event_api_id": "evt-Q7AP1Plh95Rnp0N",
"registration_url": "https://lu.ma/h06u0dux"
}
],
"total_returned": 50
},
"status": "success"
}
}About the lu.ma API
The Lu.ma API gives developers structured access to upcoming events listed on lu.ma across 79+ cities worldwide via two endpoints: get_events and list_cities. Each event record includes the title, date, end date, timezone, venue, organizer, cover image, and a direct registration URL. City coverage spans multiple continents, and results are paginated with a configurable limit parameter.
Endpoints
The API exposes two endpoints. list_cities returns all supported city slugs grouped by continent, along with each city's name, event count, and timezone — no parameters required. get_events accepts a city slug (as returned by list_cities) and an optional limit integer, then returns an array of event objects for that city.
Event Data
Each object in the events array from get_events includes: title, date, end_date, timezone, venue, registration_url, cover_image, organizer, and event_api_id. The registration_url links directly to the lu.ma event page so end users can register without additional lookups. The event_api_id can be stored for deduplication when polling the same city over time.
City Coverage and Filtering
list_cities reports the total city count and per-city event_count, which is useful for deciding which markets are worth querying. City slugs follow lu.ma conventions (e.g. sf, nyc, london, vancouver, austin). To query multiple cities in sequence, call list_cities first to get the full slug list, then iterate with get_events. There is no cross-city or keyword search endpoint; queries are scoped to one city per request.
Pagination and Freshness
Results from get_events reflect upcoming events at query time. The limit parameter controls how many events are returned per call. The total_returned field confirms the actual count in each response, which may be less than limit if fewer events are available for that city.
- Build a local events calendar app that pulls upcoming lu.ma events by city slug and displays venue and date information.
- Monitor event frequency in specific cities using the
event_countfield fromlist_citiesto identify active markets. - Aggregate organizer activity across cities by collecting the
organizerfield from multipleget_eventsresponses. - Generate weekly digests of tech or community events filtered by timezone and city for a newsletter.
- Store
event_api_idvalues to deduplicate events when polling the same city on a recurring schedule. - Display cover images and registration links in a curated event discovery interface without requiring users to visit lu.ma directly.
- Compare event density across continents by grouping
list_citiesresults by thecontinentfield.
| 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 lu.ma have an official developer API?+
What does `get_events` return, and how do I control the number of results?+
get_events returns an array of event objects under the events key, each containing title, date, end_date, timezone, venue, organizer, cover_image, registration_url, and event_api_id. Pass the limit integer parameter to cap the number of events returned. The total_returned field in the response confirms how many were actually included.Can I search for events by keyword, category, or date range rather than just by city?+
Are private or invite-only lu.ma events included in the results?+
Is there an endpoint to get details for a single event by its ID?+
event_api_id is not available as a separate endpoint. You can fork this API on Parse and revise it to add a single-event detail endpoint.