Luma luma Events API

Scrape upcoming Luma events in a city

curl --request POST \
  --url https://api.stophy.dev/v1/luma/events \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "city": "San Francisco",
  "category": "tech"
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({city: 'San Francisco', category: 'tech'})
};

fetch('https://api.stophy.dev/v1/luma/events', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.stophy.dev/v1/luma/events"

payload = {
    "city": "San Francisco",
    "category": "tech"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "success": true,
  "data": {
    "results": [
      {
        "eventUrl": "<string>",
        "startsAt": "2023-11-07T05:31:56Z",
        "isOnline": true,
        "guestCount": 0,
        "isFree": true,
        "isSoldOut": true,
        "needsApproval": true,
        "hasWaitlist": true,
        "eventId": "<string>",
        "name": "<string>",
        "endsAt": "2023-11-07T05:31:56Z",
        "timezone": "<string>",
        "city": "<string>",
        "address": "<string>",
        "latitude": 123,
        "longitude": 123,
        "calendarName": "<string>",
        "hosts": [
          "<string>"
        ],
        "price": 123,
        "currency": "<string>",
        "spotsRemaining": 0,
        "imageUrl": "<string>"
      }
    ],
    "city": "<string>",
    "cursor": "<string>"
  },
  "creditsUsed": 123,
  "requestId": "<string>"
}

{
  "success": false,
  "error": {
    "code": "cliSessionCompleted",
    "message": "<string>",
    "retryable": true,
    "requestId": "<string>",
    "retryAfterSeconds": 123,
    "requiredCredits": 123,
    "availableCredits": 123,
    "billingUrl": "https://stophy.dev/billing"
  }
}

{
  "success": false,
  "error": {
    "code": "cliSessionCompleted",
    "message": "<string>",
    "retryable": true,
    "requestId": "<string>",
    "retryAfterSeconds": 123,
    "requiredCredits": 123,
    "availableCredits": 123,
    "billingUrl": "https://stophy.dev/billing"
  }
}

POST

luma

events

Scrape upcoming Luma events in a city

curl --request POST \
  --url https://api.stophy.dev/v1/luma/events \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "city": "San Francisco",
  "category": "tech"
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({city: 'San Francisco', category: 'tech'})
};

fetch('https://api.stophy.dev/v1/luma/events', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.stophy.dev/v1/luma/events"

payload = {
    "city": "San Francisco",
    "category": "tech"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "success": true,
  "data": {
    "results": [
      {
        "eventUrl": "<string>",
        "startsAt": "2023-11-07T05:31:56Z",
        "isOnline": true,
        "guestCount": 0,
        "isFree": true,
        "isSoldOut": true,
        "needsApproval": true,
        "hasWaitlist": true,
        "eventId": "<string>",
        "name": "<string>",
        "endsAt": "2023-11-07T05:31:56Z",
        "timezone": "<string>",
        "city": "<string>",
        "address": "<string>",
        "latitude": 123,
        "longitude": 123,
        "calendarName": "<string>",
        "hosts": [
          "<string>"
        ],
        "price": 123,
        "currency": "<string>",
        "spotsRemaining": 0,
        "imageUrl": "<string>"
      }
    ],
    "city": "<string>",
    "cursor": "<string>"
  },
  "creditsUsed": 123,
  "requestId": "<string>"
}

{
  "success": false,
  "error": {
    "code": "cliSessionCompleted",
    "message": "<string>",
    "retryable": true,
    "requestId": "<string>",
    "retryAfterSeconds": 123,
    "requiredCredits": 123,
    "availableCredits": 123,
    "billingUrl": "https://stophy.dev/billing"
  }
}

{
  "success": false,
  "error": {
    "code": "cliSessionCompleted",
    "message": "<string>",
    "retryable": true,
    "requestId": "<string>",
    "retryAfterSeconds": 123,
    "requiredCredits": 123,
    "availableCredits": 123,
    "billingUrl": "https://stophy.dev/billing"
  }
}

Scrape upcoming Luma events in a city.

Request

city is required.

import { Stophy } from "stophy";

const stophy = new Stophy({ apiKey: process.env.STOPHY_API_KEY });
const result = await stophy.luma.events({ city: "San Francisco", category: "tech" });
console.log(result.data.results);

from stophy import Stophy

stophy = Stophy()  # reads STOPHY_API_KEY
result = stophy.luma.events(city="San Francisco", category="tech")
print(result["data"]["results"])

curl -X POST https://api.stophy.dev/v1/luma/events \
  -H "Authorization: Bearer $STOPHY_API_KEY" \
  -H "content-type: application/json" \
  -d '{"city":"San Francisco","category":"tech"}'

stophy luma events "San Francisco" --category tech

Response

If successful, the response body contains the standard envelope. data.results[] contains the events, soonest first, each with its time, place, hosts and how many are going. The following example is a real response, truncated: each list shows one item and long strings are cut.

{
  "success": true,
  "data": {
    "city": "San Francisco",
    "results": [
      {
        "eventId": "evt-zdM9M2LyH31iaVi",
        "eventUrl": "https://luma.com/d8y4gf2p",
        "name": "Not so European Fridays at European Startup Embassy",
        "startsAt": "2026-10-30T17:00:00.000Z",
        "endsAt": "2026-10-31T01:00:00.000Z",
        "timezone": "America/Los_Angeles",
        "isOnline": false,
        "city": "San Francisco, CA",
        "address": "European Startup Embassy, 461 Bryant St, San Francisco, CA 94107, USA",
        "latitude": 37.7819145,
        "longitude": -122.39486069999998,
        "calendarName": "European Startup Embassy",
        "hosts": ["European Startup Embassy", "Krishaaaaa"],
        "guestCount": 13,
        "isFree": true,
        "isSoldOut": false,
        "spotsRemaining": 37,
        "needsApproval": true,
        "hasWaitlist": false,
        "imageUrl": "https://images.lumacdn.com/uploads/j4/56efb675-6ede-4874-ae94-df9c76b4c867.png"
      }
    ],
    "cursor": "u3ZE_CUpeyJzdiI6IjIwMjYtMTEtMDQgMjM6MDA6MDArMDAiLCJmYiI6ImV2dC1CdjlabFJMM0ZXZ25ZbGUifQ"
  },
  "creditsUsed": 1,
  "requestId": "2fe9dbad-fc48-4890-9751-0b24b596035b"
}

Field	Type	Description
`cursor`	string	The pagination token. Pass it as `cursor` to retrieve the next page. Omitted on the last page.

For every field, see the response schema on this page.

Luma has no keyword search, so narrow with category.

Optional parameters

Parameter	Type	Description
`category`	string	Restricts results to events in this Luma category. Accepts one of 12 values, such as `ai`, `arts` and `books`.
`cursor`	string	The pagination token from the previous response.

Billing

Each successful request consumes 1 credit, regardless of the number of items returned. Requests that fail, or that return no items, are not billed.

Pagination

Results are paginated. To retrieve the next page, pass the value of data.cursor as cursor in a subsequent request. A response that omits cursor is the last page.

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

maxTextLength

integer

Cut every text value in the response to this many characters. A value that was cut ends with …, and a page whose text was cut has isTruncated set to true. A screenshot is never cut. Leave it out to get the full text.

Required range: x >= 1

Body

application/json

city

string

required

A city Luma lists (e.g., "San Francisco", "London", "Tokyo")

Required string length: 2 - 100

Response

The data, and the credits this call used.

success

any

required

data

object

required

Show child attributes

creditsUsed

integer

required

requestId

string

required

Using the API

Catalog

Account

Search and AI answers

Video

Social

Places and travel

Jobs

Shopping

Apps

Real estate

Ads

Luma luma Events API

Request

Response

Optional parameters

Billing

Authorizations

Query Parameters

Body

Response

​Request

​Response

​Optional parameters

​Billing

​Pagination

Authorizations

Query Parameters

Body

Response

Request

Response

Optional parameters

Billing

Pagination