# Luma Events Scraper (lu.ma): City Events, Prices & Organizers (`datasmithlab/luma-events-scraper`) Actor

Luma (lu.ma) events from any of its ~90 city pages with ticket price, sold-out status, guest count and organizer calendar with website. Venue coordinates and full description; keyword, date and price filters, new-events-only mode. No login.

- **URL**: https://apify.com/datasmithlab/luma-events-scraper.md
- **Developed by:** [Datasmithlab](https://apify.com/datasmithlab) (community)
- **Categories:** Lead generation, Travel
- **Stats:** 2 total users, 1 monthly users, 93.8% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.60 / 1,000 events

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Luma Events Scraper (lu.ma): City Events, Prices & Organizers

Get **Luma (lu.ma) events** for your city in a clean table: date and time, venue with coordinates, **ticket price**, sold-out status, **guest count**, **organizer calendar with its website**, and the **full description**. No login, no browser, no proxy.

### Why this one

- **Full descriptions** for every event, at no extra charge.
- **Prices and guest counts** in every row; filter by free / paid, max price and min guests.
- **Type a city name.** The nearest Luma city page is picked for you (Luma covers about 90 major cities).
- **Organizers without personal data.** Company and community calendars come with their name, Luma page and website. Events hosted from a personal calendar come without an organizer, and host names are never collected.
- **Calendar file.** Every run also saves `events.ics`, a calendar file with all returned events (start, end, venue, link, cancelled status). Download it and import it into Google Calendar, Apple Calendar or Outlook.
- **New events only.** Switch on *Only new events since last run* and schedule it for a clean daily or weekly feed.
- **Never a silent empty run.** A `SEARCHES` report shows every city × keyword search with its status (`ok`, `empty`, `blocked`, `error`, `not_found`).
- **Hard limit.** *Max events* is a hard stop for what you pay.

### Input

```json
{
  "locations": ["San Francisco", "London"],
  "keywords": ["AI", "founders"],
  "price": "free",
  "minAttendees": 20,
  "onlyNewSinceLastRun": true,
  "maxItems": 300
}
```

**Tips**

- Leave *Keywords* empty to get every event on the city page. Keywords match the event title and organizer calendar name.
- Luma city pages are curated and usually cover the next 4–5 weeks. A city more than 60 km from the nearest Luma city is reported as `not_found`.

### Output

```json
{
  "id": "luma:evt-1nbA8in6sqXolfi",
  "platform": "luma",
  "title": "Afrotech Berlin meetup",
  "startAt": "2026-10-06T15:00:00Z",
  "endAt": "2026-10-06T18:00:00Z",
  "startTimestamp": 1791298800,
  "startLocal": "2026-10-06T17:00+02:00",
  "timezone": "Europe/Berlin",
  "isOnline": false,
  "isCancelled": false,
  "venueName": "Ampere Garden",
  "address": "Ampere Garden, Sonnenburger Str. 73, 10437 Berlin, Germany",
  "city": "Berlin",
  "region": "Berlin",
  "country": "DE",
  "latitude": 52.5486632,
  "longitude": 13.406850799999999,
  "priceMin": 0.0,
  "priceMax": 0.0,
  "currency": null,
  "isFree": true,
  "isSoldOut": false,
  "attendeeCount": 0,
  "organizerName": "GetYourGuide",
  "organizerUrl": "https://luma.com/supply-getyourguide",
  "organizerWebsite": "https://getyourguide.com",
  "organizerFollowers": null,
  "organizerRating": null,
  "categories": [],
  "imageUrl": "https://images.lumacdn.com/uploads/wc/10...",
  "url": "https://luma.com/gsa10b6c",
  "ticketUrl": "https://luma.com/gsa10b6c",
  "summary": null,
  "descriptionHtml": "<p>...</p>",
  "descriptionText": "...",
  "duplicateOf": null,
  "searchLocation": "Berlin",
  "searchKeyword": "tech"
}
```

`startAt` and `endAt` are UTC; `startLocal` is the start in the event's own local time. Addresses that Luma shows to registered guests only are `null`. Export as JSON, CSV, Excel or via API.

### Pricing

Pay per result: **$1 per 1,000 events** ($0.001 each), full description included, plus $0.001 per run start. Only events that pass your filters are charged.

### Notes

- Only public event listings are collected. **No personal data:** host names, attendee lists and personal social profiles are not collected.
- Not affiliated with Luma. Use the data in line with applicable laws and the site's terms.
- Need Eventbrite, Luma and Meetup in one run, with cross-platform duplicates removed? See **[Events Scraper: Eventbrite, Luma & Meetup](https://apify.com/datasmithlab/events-scraper)**.
- Found a bug or need a field? Open an issue in the Issues tab.

# Actor input Schema

## `locations` (type: `array`):

One city per line, e.g. San Francisco, London, Berlin. The nearest Luma city page within 60 km is used (Luma covers about 90 major cities).

## `keywords` (type: `array`):

Keep events whose title or organizer calendar name contains one of these words (e.g. AI, founders, crypto). Leave empty for every event on the city page.

## `dateRange` (type: `string`):

Events starting from now until this far ahead. Ignored when a start or end date is set below.

## `dateFrom` (type: `string`):

Only events on or after this day (UTC), e.g. 2026-11-01.

## `dateTo` (type: `string`):

Only events on or before this day (UTC).

## `eventType` (type: `string`):

Keep only in-person or only online events.

## `price` (type: `string`):

Keep only free or only paid events (by the cheapest ticket).

## `maxPrice` (type: `integer`):

Drop events whose cheapest ticket costs more than this (in the event's own currency).

## `minAttendees` (type: `integer`):

Drop events with fewer attendees than this.

## `excludeKeywords` (type: `array`):

Drop events whose title contains any of these words (e.g. webinar, yoga).

## `strictKeywordMatch` (type: `boolean`):

Platforms search loosely (Eventbrite returns 'Techno' for 'tech'). Turn on to keep only events whose title, summary or description contains a keyword as a whole word.

## `includeCancelled` (type: `boolean`):

Also return events the organizer has cancelled (isCancelled = true).

## `onlyNewSinceLastRun` (type: `boolean`):

Returns only events you have not received before with the same cities, keywords and filters. Ideal for a scheduled daily or weekly feed.

## `includeDescription` (type: `boolean`):

Adds the full event description (HTML and plain text). Turn off for faster, smaller exports. Same price either way.

## `maxItems` (type: `integer`):

Hard stop: you are never charged for more events than this.

## Actor input object example

```json
{
  "locations": [
    "San Francisco"
  ],
  "dateRange": "any",
  "eventType": "any",
  "price": "any",
  "strictKeywordMatch": false,
  "includeCancelled": false,
  "onlyNewSinceLastRun": false,
  "includeDescription": true,
  "maxItems": 100
}
```

# Actor output Schema

## `events` (type: `string`):

Events table (JSON/CSV/Excel export available).

## `calendar` (type: `string`):

All returned events in one calendar file: open it or import it into Google Calendar, Apple Calendar or Outlook.

## `allFields` (type: `string`):

Every field of every event, including descriptions.

## `searches` (type: `string`):

For each city × keyword × platform: status (ok/empty/blocked/error/not_found), events found and matched.

## `health` (type: `string`):

Events per platform, duplicates removed, empty-field ratios and platform warnings.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "locations": [
        "San Francisco"
    ],
    "maxItems": 100
};

// Run the Actor and wait for it to finish
const run = await client.actor("datasmithlab/luma-events-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "locations": ["San Francisco"],
    "maxItems": 100,
}

# Run the Actor and wait for it to finish
run = client.actor("datasmithlab/luma-events-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "locations": [
    "San Francisco"
  ],
  "maxItems": 100
}' |
apify call datasmithlab/luma-events-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,datasmithlab/luma-events-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/tVf10Rhqof86OvwwQ/builds/elu9CI4115HEG2eyU/openapi.json