# Luma Events Discovery API

> Public events on Luma by city or category, and event details with hosts, tickets and venue

- Vendor: `lumaeventsdiscoveryapi` · version 1.0 · category Entertainment · tags luma api, events api, tech events api, meetups api, event discovery api, lu ma api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/lumaeventsdiscoveryapi
- This document: https://apiclay.com/docs/lumaeventsdiscoveryapi.md
- OpenAPI 3.1: https://apiclay.com/api/lumaeventsdiscoveryapi/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `lumaeventsdiscoveryapi`
- Updated: 2026-11-18

## About

## Luma Events Discovery API

Event data from Luma (lu.ma), the event platform used by tech, AI and crypto communities: the cities and categories on its Discover page, upcoming public events for a city or category with name, time, location, hosts, guest count and ticket info, and the full detail of one event.

Data comes from **luma.com** (https://luma.com). Every route calls the source's own public API and returns it unchanged.

Typical flow: `/places` for a city `api_id` (or `/categories`), then `/events?discover_place_api_id=...`, then `/event?event_api_id=evt-...`.

### Routes

#### GET `/places` - Discover places
No parameters.

Returns: `places[]` with `place` (`api_id`, `name`, `slug`, `timezone`, `coordinate`, `event_count`, `geo_continent_name`).

#### GET `/categories` - Categories
No parameters.

Returns: `entries[]` with `category` (`api_id` such as `cat-tech`, `name`, `description`) and `event_count`.

#### GET `/events` - Events
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| discover_place_api_id | query | string | no | City `api_id` from `/places`. |
| category_api_id | query | string | no | Category `api_id`, e.g. `cat-tech`, `cat-ai`. |
| pagination_limit | query | number | no | Events per page. |
| pagination_cursor | query | string | no | `next_cursor` of the previous page. |

Returns: `entries[]` (`event` with `api_id`, `name`, `start_at`, `end_at`, `timezone`, `url`, `geo_address_info`, `coordinate`; `hosts`, `guest_count`, `ticket_info`, `calendar`), `has_more`, `next_cursor`.

#### GET `/event` - Event
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| event_api_id | query | string | yes | Event `api_id`, e.g. `evt-...`. |

Returns: `event`, `calendar`, `hosts`, `guest_count`, `ticket_types`, `categories`, `featured_guests`, `sessions`.

### Caveats

- Only public events are listed. Registration happens on Luma.
- Upstream responses can change over time. Verify fields before relying on them.
- Not affiliated with or endorsed by luma.com.

## Pricing

- Pay as you go: 0.0012 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### GET /places — Discover places
- Gateway: `GET https://api.apiclay.com/v1/api/lumaeventsdiscoveryapi/places`
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /categories — Categories
- Gateway: `GET https://api.apiclay.com/v1/api/lumaeventsdiscoveryapi/categories`
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /events — Events
- Gateway: `GET https://api.apiclay.com/v1/api/lumaeventsdiscoveryapi/events`
- Public query params: `discover_place_api_id` (string), `category_api_id` (string), `pagination_limit` (number), `pagination_cursor` (string)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /event — Event
- Gateway: `GET https://api.apiclay.com/v1/api/lumaeventsdiscoveryapi/event`
- Public query params: `event_api_id` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X GET "https://api.apiclay.com/v1/api/lumaeventsdiscoveryapi/places" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

Index of every published API: https://apiclay.com/llms.txt
