luma.com APIluma.com ↗
Access public Luma (lu.ma) event data by location. Search events, get host details, ticket availability, coordinates, and guest info via 2 structured endpoints.
curl -X GET 'https://api.parse.bot/scraper/c6dfcba3-0e2a-48c5-8e21-f562868d7bf2/search_events?limit=3&location=New+York' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for events by location. Supports city names (with built-in coordinates for popular cities), custom lat/lng, or Luma place IDs. Returns paginated results with cursor-based pagination.
| Param | Type | Description |
|---|---|---|
| limit | integer | Maximum number of events to return (max 50 per page) |
| cursor | string | Pagination cursor from previous response's next_cursor field |
| latitude | string | Custom latitude (use with longitude instead of location) |
| location | string | City name. Built-in coordinates supported for major cities including New York, San Francisco, London, Tokyo, and others; or provide a custom city name. |
| place_id | string | Luma discover place API ID (e.g., 'discplace-G0tGUVYwl7T17Sb') |
| longitude | string | Custom longitude (use with latitude instead of location) |
{
"type": "object",
"fields": {
"events": "array of event objects with event_api_id, name, description, start_at, end_at, timezone, url, cover_url, location_type, address, city, city_state, country, calendar_name, hosts, guest_count, ticket_price, ticket_currency, is_free",
"has_more": "boolean indicating if more results are available",
"next_cursor": "string pagination cursor for the next page",
"total_returned": "integer count of events in this response"
},
"sample": {
"data": {
"events": [
{
"url": "nhvmcczj",
"city": "San Francisco",
"name": "Agent Builders Breakfast - Founders & Builders in SOMA, SF",
"hosts": [
{
"name": "Michael Ducker",
"avatar_url": "https://images.lumacdn.com/avatars/ia/3cb4863f-518b-431a-91cc-689520986d2d.jpg"
}
],
"end_at": "2026-05-14T16:30:00.000Z",
"address": "",
"country": "United States",
"is_free": true,
"start_at": "2026-05-14T15:00:00.000Z",
"timezone": "America/Los_Angeles",
"cover_url": "https://images.lumacdn.com/event-covers/6f/d3db823e-c18e-4ba1-a677-4435832050ff.jpg",
"city_state": "San Francisco, California",
"description": "",
"guest_count": 100,
"event_api_id": "evt-DmSmWL7HBwk4xNd",
"ticket_price": 0,
"calendar_name": "Personal",
"location_type": "offline",
"ticket_currency": ""
}
],
"has_more": true,
"next_cursor": "eyJzdiI6IjIwMjYtMDUtMTQgMTU6MzA6MDArMDAiLCJmYiI6ImV2dC1JRWJNZjN0eUJncHJiczAifQ",
"total_returned": 1
},
"status": "success"
}
}About the luma.com API
The Luma API exposes 2 endpoints for discovering and inspecting public events on lu.ma. search_events returns paginated event listings filtered by city name, custom lat/lng, or Luma place ID, while get_event_details delivers per-event data including host profiles, ticket availability, sold-out status, full address, and ISO 8601 start/end times.
Search Events by Location
search_events accepts a location string (e.g., "San Francisco" or "Tokyo") with built-in coordinate resolution for major cities, or raw latitude/longitude values for any geographic point. You can also pass a place_id (e.g., discplace-G0tGUVYwl7T17Sb) to target a specific Luma discovery area. Results are paginated: each response includes a next_cursor string and a has_more boolean. Pass the cursor back as the cursor parameter to fetch the next page. Each page returns up to 50 events, and total_returned tells you how many came back in the current response.
Event Search Response Fields
Each object in the events array includes event_api_id, name, description, start_at, end_at, timezone, url, cover_url, location_type, and address. The event_api_id value (e.g., evt-DmSmWL7HBwk4xNd) is the key input to get_event_details for retrieving full event data.
Event Detail Fields
get_event_details takes a single required parameter, event_api_id, and returns a richer record: hosts (array with name, username, avatar_url, and bio), sold_out boolean, country, city, address, start_at, end_at, timezone, and url. This is where you get host identity data and ticket availability signals not present in the search results.
- Build a local event discovery app that filters lu.ma events by city using the
locationparameter. - Aggregate event host profiles (name, bio, avatar) for speaker or organizer research.
- Monitor sold-out status on specific events using the
sold_outfield fromget_event_details. - Pull event coordinates and addresses for plotting public events on a map.
- Paginate through all upcoming events in a metro area by chaining
next_cursorvalues. - Feed event start/end times and timezone into a calendar or scheduling tool.
- Identify events by a specific Luma place ID to scope results to a defined discovery region.
| 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 Luma have an official developer API?+
What does `get_event_details` return beyond what `search_events` includes?+
get_event_details adds host objects (with name, username, avatar_url, and bio), a sold_out boolean, and country and city fields. The search results give you enough to identify an event; the detail endpoint gives you the host identity and ticket availability data needed to act on it.Does the API cover private or invite-only Luma events?+
Does the API return attendee lists or RSVP counts?+
How does pagination work with `search_events`?+
has_more boolean and a next_cursor string. When has_more is true, pass the next_cursor value as the cursor parameter in your next request to retrieve the following page. Each page returns at most 50 events, and total_returned reflects the count in the current page only, not the total across all pages.