Luma

Event discovery platform — events, search, calendars, categories, and places.

Events: Get event details or browse events by city
Search: Search events by keyword within a city
Calendars: Browse events from a specific community calendar
Categories: List all event categories
Places: Get city/place info

Events

`GET /luma/events/:eventId` — 2 credits

Get a Luma event by its API ID.

Param	Type	Required	Default	Description
`eventId`	string	Yes	—	Event API ID (e.g. `evt-HcF3lY9ocKFrEuC`)

cURL


curl -H "x-api-key: sk_byc_xxx" \
  https://api.bycrawl.com/luma/events/evt-HcF3lY9ocKFrEuC

Python


import requests
 
response = requests.get(
    "https://api.bycrawl.com/luma/events/evt-HcF3lY9ocKFrEuC",
    headers={"x-api-key": "sk_byc_xxx"},
    timeout=30,
)
print(response.json())

JavaScript


const response = await fetch(
  "https://api.bycrawl.com/luma/events/evt-HcF3lY9ocKFrEuC",
  {
    headers: { "x-api-key": "sk_byc_xxx" },
  },
);
console.log(await response.json());

Response


{
  "id": "evt-HcF3lY9ocKFrEuC",
  "url": "https://luma.com/dw0ocvt7",
  "name": "Building a Better Social Media with Retro",
  "coverUrl": "https://images.lumacdn.com/event-covers/ml/...",
  "startAt": "2026-03-18T10:30:00.000Z",
  "endAt": "2026-03-18T12:00:00.000Z",
  "timezone": "Asia/Taipei",
  "locationType": "offline",
  "location": {
    "type": "offline",
    "address": "Taipei Municipal Stadium",
    "city": "Songshan District",
    "region": "Songshan District, Taipei City"
  },
  "guestCount": 50,
  "ticketInfo": {
    "isFree": true,
    "price": null,
    "isSoldOut": false,
    "spotsRemaining": 20
  },
  "hosts": [
    {
      "id": "usr-abc",
      "name": "Carter Wang",
      "username": "carterwang",
      "bio": "associate at 886 Studios"
    }
  ],
  "calendar": {
    "id": "cal-YDazDmfi5UlPvrC",
    "name": "886 Studios",
    "slug": "886"
  }
}

`GET /luma/places/:placeId/events` — 2 credits

Get events for a city/place.

Param	Type	Required	Default	Description
`placeId`	string	Yes	—	Discover place ID (e.g. `discplace-fi7MDZq99wfKWfa`)
`count`	integer	No	25	Number of events (max 50)
`cursor`	string	No	—	Pagination cursor

cURL


curl -H "x-api-key: sk_byc_xxx" \
  "https://api.bycrawl.com/luma/places/discplace-fi7MDZq99wfKWfa/events?count=10"

Python


import requests
 
response = requests.get(
    "https://api.bycrawl.com/luma/places/discplace-fi7MDZq99wfKWfa/events",
    params={"count": 10},
    headers={"x-api-key": "sk_byc_xxx"},
    timeout=30,
)
print(response.json())

JavaScript


const response = await fetch(
  "https://api.bycrawl.com/luma/places/discplace-fi7MDZq99wfKWfa/events?count=10",
  {
    headers: { "x-api-key": "sk_byc_xxx" },
  },
);
console.log(await response.json());

Response


{
  "events": [
    {
      "id": "evt-HcF3lY9ocKFrEuC",
      "name": "Building a Better Social Media with Retro",
      "startAt": "2026-03-18T10:30:00.000Z",
      "guestCount": 50
    }
  ],
  "nextCursor": "eyJzdiI6...",
  "hasMore": true
}

Search

`GET /luma/events/search` — 2 credits

Search events by keyword within a city/place.

Param	Type	Required	Default	Description
`place_id`	string	Yes	—	Discover place ID (city)
`q`	string	Yes	—	Search query
`count`	integer	No	25	Number of results (max 50)
`cursor`	string	No	—	Pagination cursor

cURL


curl -H "x-api-key: sk_byc_xxx" \
  "https://api.bycrawl.com/luma/events/search?place_id=discplace-fi7MDZq99wfKWfa&q=AI&count=10"

Python


import requests
 
response = requests.get(
    "https://api.bycrawl.com/luma/events/search",
    params={"place_id": "discplace-fi7MDZq99wfKWfa", "q": "AI", "count": 10},
    headers={"x-api-key": "sk_byc_xxx"},
    timeout=30,
)
print(response.json())

JavaScript


const response = await fetch(
  "https://api.bycrawl.com/luma/events/search?place_id=discplace-fi7MDZq99wfKWfa&q=AI&count=10",
  {
    headers: { "x-api-key": "sk_byc_xxx" },
  },
);
console.log(await response.json());

Calendars

`GET /luma/calendars/:calendarId/events` — 2 credits

Get events from a specific calendar/community.

Param	Type	Required	Default	Description
`calendarId`	string	Yes	—	Calendar ID (e.g. `cal-YDazDmfi5UlPvrC`)
`count`	integer	No	25	Number of events (max 50)
`cursor`	string	No	—	Pagination cursor

cURL


curl -H "x-api-key: sk_byc_xxx" \
  "https://api.bycrawl.com/luma/calendars/cal-YDazDmfi5UlPvrC/events?count=10"

Python


import requests
 
response = requests.get(
    "https://api.bycrawl.com/luma/calendars/cal-YDazDmfi5UlPvrC/events",
    params={"count": 10},
    headers={"x-api-key": "sk_byc_xxx"},
    timeout=30,
)
print(response.json())

JavaScript


const response = await fetch(
  "https://api.bycrawl.com/luma/calendars/cal-YDazDmfi5UlPvrC/events?count=10",
  {
    headers: { "x-api-key": "sk_byc_xxx" },
  },
);
console.log(await response.json());

Places

`GET /luma/places/:placeId` — 1 credit

Get city/place info by its discover place ID.

Param	Type	Required	Default	Description
`placeId`	string	Yes	—	Discover place ID

cURL


curl -H "x-api-key: sk_byc_xxx" \
  https://api.bycrawl.com/luma/places/discplace-fi7MDZq99wfKWfa

Python


import requests
 
response = requests.get(
    "https://api.bycrawl.com/luma/places/discplace-fi7MDZq99wfKWfa",
    headers={"x-api-key": "sk_byc_xxx"},
    timeout=30,
)
print(response.json())

JavaScript


const response = await fetch(
  "https://api.bycrawl.com/luma/places/discplace-fi7MDZq99wfKWfa",
  {
    headers: { "x-api-key": "sk_byc_xxx" },
  },
);
console.log(await response.json());

Response


{
  "id": "discplace-fi7MDZq99wfKWfa",
  "name": "Taipei",
  "slug": "taipei",
  "description": "In Taipei, you can find events ranging from...",
  "eventCount": 7,
  "continent": "apac"
}

Luma

Events

GET /luma/events/:eventId — 2 credits

cURL

Python

JavaScript

GET /luma/places/:placeId/events — 2 credits

cURL

Python

JavaScript

Search

GET /luma/events/search — 2 credits

cURL

Python

JavaScript

Calendars

GET /luma/calendars/:calendarId/events — 2 credits

cURL

Python

JavaScript

Categories

GET /luma/categories — 1 credit

cURL

Python

JavaScript

Places

GET /luma/places/:placeId — 1 credit

cURL

Python

JavaScript

`GET /luma/events/:eventId` — 2 credits

`GET /luma/places/:placeId/events` — 2 credits

`GET /luma/events/search` — 2 credits

`GET /luma/calendars/:calendarId/events` — 2 credits

`GET /luma/categories` — 1 credit

`GET /luma/places/:placeId` — 1 credit