# Lu.ma Event Scraper (`anyxsolutions/lu-ma-scraper`) Actor

The Lu.ma Event Scraper extracts structured event data from Lu.ma: names, dates, locations, hosts, cover images, and full event details. It's built for event aggregators, researchers, marketers, and anyone tracking online and in-person events worldwide.

- **URL**: https://apify.com/anyxsolutions/lu-ma-scraper.md
- **Developed by:** [Anyx Solutions](https://apify.com/anyxsolutions) (community)
- **Categories:** Automation, Developer tools, Lead generation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $5.00 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

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

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.
Actors are written with capital "A".

## 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.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

![banner](https://i.ibb.co/fYRCLggT/lu-ma-scraper.png)

## Lu.ma Event Scraper

**Collect public events from Lu.ma at scale — by keyword, location, and date.**

The Lu.ma Event Scraper extracts structured event data from [Lu.ma](https://lu.ma): names, dates,
locations, hosts, cover images, and full event details. It's built for event aggregators,
researchers, marketers, and anyone tracking online and in-person events worldwide.

### ⚡ Quick start

```json
{
  "query": "party",
  "maxItems": 5
}
```

Or search several keywords with a location filter:

```json
{
  "queries": ["party", "meetup"],
  "location": "Paris, Île-de-France",
  "maxItems": 5
}
```

### 🧩 Input

| Field | Type | Required | Default | Description |
|---|---|---|---|---|
| `query` | string | one of `query`/`queries` | — | Primary search keyword(s). Merged with `queries`; duplicates removed (case-insensitive). |
| `queries` | array | one of `query`/`queries` | `[]` | Additional search keywords. Merged with `query`; duplicates removed (case-insensitive). |
| `location` | string | no | — | Location string that must appear on the event page. The more specific, the better (e.g. `Paris, Île-de-France`). |
| `indexedDateAfter` | string | no | — | Only events indexed by Google after this date, `YYYY-MM-DD` (indexing date, not event date). |
| `indexedDateBefore` | string | no | — | Only events indexed by Google before this date, `YYYY-MM-DD` (indexing date, not event date). |
| `maxItems` | integer | no | `5` | Maximum results per search keyword. |
| `proxyConfiguration` | object | no | `{ "useApifyProxy": false }` | Apify proxy settings. |

You must provide at least one keyword: use `query`, `queries`, or both. Values are merged in order
(`query` first, then each entry in `queries`); duplicates are removed (case-insensitive), and each
remaining keyword runs as its own search.

#### How to find a good value for `location`

1. Open an example event page you'd like to scrape.
2. Find the location section on the event page.
3. Copy the location string.
4. Paste it into the `location` field.

A more concrete string (full address, venue name) yields more relevant matches.

### 📤 Output

Each scraped event is pushed to the dataset as one flat record. Lu.ma's own page data carries about
fifty keys, most of them page furniture — payment-processor and analytics IDs, tint colours, font
names, wallet-address requirements. The dataset keeps the event and drops the rest. Fields an event
does not provide are returned as `null` rather than omitted, so the columns stay stable.

Every item includes the `query` field so you can tell which keyword produced it when running
multiple searches.

#### Fields

| Field | Type | Description |
|---|---|---|
| `apiId` | string | Lu.ma event ID. |
| `url` | string | Public Lu.ma event URL. |
| `name` | string | Event name. |
| `description` | string | null | Event description as plain text. |
| `mainImageUrl` | string | null | Event cover image URL. |
| `startAt` | string | Event start time (ISO 8601, UTC). |
| `endAt` | string | null | Event end time (ISO 8601, UTC). |
| `timezone` | string | null | IANA timezone the organiser set, e.g. `America/Los_Angeles`. |
| `locationType` | string | null | `offline` or `online`. |
| `venue` | string | null | Street address, when the organiser publishes it. |
| `city` / `region` / `country` / `countryCode` | string | null | Where the event takes place. |
| `latitude` / `longitude` | number | null | Approximate coordinates. |
| `addressIsHidden` | boolean | `true` when Lu.ma withholds the exact address until you register — `venue` is then `null` while the city still resolves. |
| `hosts` | array | Organisers: `name`, `avatarUrl`, `bio`, `twitterHandle`, `linkedinHandle`, `instagramHandle`, `website`. |
| `calendarName` / `calendarUrl` | string | null | The Lu.ma calendar the event belongs to. |
| `categories` | array | Category names, e.g. `["AI"]`. |
| `isFree` | boolean | null | Whether attendance is free. |
| `price` / `maxPrice` | number | null | Ticket price range in the major unit of `currency`. |
| `currency` | string | null | Currency of `price`. |
| `requiresApproval` | boolean | null | Whether the organiser approves each registration. |
| `isSoldOut` | boolean | Whether registration is closed for capacity. |
| `spotsRemaining` | number | null | Places left, when the organiser publishes a capacity. |
| `ticketTypes` | array | Tiers: `name`, `description`, `cents`, `currency`, `maxCapacity`, `isSoldOut`. |
| `guestCount` / `ticketCount` | number | null | Registered guests, and tickets issued. |
| `query` | string | Search keyword that produced this event. |
| `fetchedAt` | string | When the event was scraped (ISO 8601). |

<details><summary>Example output</summary>

```json
{
  "apiId": "evt-5HAZ5BKAHuQ1WqF",
  "url": "https://lu.ma/durable-ai-august",
  "name": "Durable AI: Agent Context is Everything",
  "description": "Your AI agent is only as good as the context it has.",
  "mainImageUrl": "https://images.lumacdn.com/uploads/9c/e0e864cd-385f-4e30-bafe-4316676e38a7.png",
  "startAt": "2026-08-27T00:30:00.000Z",
  "endAt": "2026-08-27T03:00:00.000Z",
  "timezone": "America/Los_Angeles",
  "locationType": "offline",
  "venue": null,
  "city": "San Francisco",
  "region": "California",
  "country": "United States",
  "countryCode": "US",
  "latitude": 37.792839256356146,
  "longitude": -122.39731580127149,
  "addressIsHidden": true,
  "hosts": [
    {
      "name": "Temporal Team",
      "avatarUrl": "https://images.lumacdn.com/avatars/4w/9ad8b96a-9bec-4038-b227-f45a2debd5a4",
      "bio": "Here's where you can find Temporal or Temporal-hosted events!",
      "twitterHandle": "temporalio",
      "linkedinHandle": "/company/temporal-technologies",
      "instagramHandle": null,
      "website": "https://temporal.io"
    }
  ],
  "calendarName": "Temporal Community",
  "calendarUrl": "https://lu.ma/temporalio",
  "categories": [
    "AI"
  ],
  "isFree": true,
  "price": null,
  "maxPrice": null,
  "currency": null,
  "requiresApproval": true,
  "isSoldOut": false,
  "spotsRemaining": 59,
  "ticketTypes": [
    {
      "name": "Standard",
      "description": null,
      "cents": null,
      "currency": null,
      "maxCapacity": null,
      "isSoldOut": null
    }
  ],
  "guestCount": 241,
  "ticketCount": 241,
  "query": "ai meetup",
  "fetchedAt": "2026-08-24T08:12:44.301Z"
}
```

</details>

### 💡 Use cases

- **Aggregators** keep an events directory fresh across cities and topics.
- **Researchers** analyze event volumes, themes, and locations.
- **Marketers** track niche meetups and community events.
- **Developers** power calendar and discovery apps with structured data.

### ❓ FAQ

- **What is Lu.ma?** A fast-growing platform for organizing and discovering online and in-person events.
- **What can be scraped?** Any public Lu.ma event surfaced by keyword search, with optional location and date filters.
- **What if Lu.ma changes its site?** We maintain the scraper and update it when major changes affect functionality.

### 🔗 More scrapers by Anyx

- [Dice.fm Event Scraper](https://apify.com/anyxsolutions/dice-fm-scraper)
- [TikTok Trending Hashtags Scraper](https://apify.com/anyxsolutions/tiktok-trending-hashtags-scraper)

### 🤝 Anyx Solutions

We build custom scrapers and data-extraction pipelines.

- Email: tantosthor@gmail.com

### 🖼 Image credit

Image credit: [lu.ma](https://lu.ma)

# Actor input Schema

## `query` (type: `string`):

Primary search keyword, for example "ai hackathon". Combined with "Search queries"; duplicates are removed (case-insensitive). You can use only this field, only "Search queries", or both.

## `queries` (type: `array`):

Additional search keywords, for example "web3 meetup" and "founder dinner". Combined with "Search query"; duplicates are removed (case-insensitive).

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

Maximum number of events to extract per search keyword.

## `indexedDateAfter` (type: `string`):

Only include events indexed by Google on or after this date, for example 2026-01-31 (format: YYYY-MM-DD). This is the Google indexing date, not the event date.

## `indexedDateBefore` (type: `string`):

Only include events indexed by Google on or before this date, for example 2026-06-30 (format: YYYY-MM-DD). This is the Google indexing date, not the event date.

## `location` (type: `string`):

Location to narrow the search, for example a city or region. The value is matched against the event page, so a more specific location yields better results.

## `proxyConfiguration` (type: `object`):

Apify proxy settings used for the run, for example { "useApifyProxy": true, "apifyProxyGroups": \["RESIDENTIAL"] }.

## Actor input object example

```json
{
  "query": "party",
  "queries": [],
  "maxItems": 5,
  "location": "Paris, Île-de-France",
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

## `overview` (type: `string`):

No description

# 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 = {
    "query": "party",
    "queries": [],
    "location": "Paris, Île-de-France"
};

// Run the Actor and wait for it to finish
const run = await client.actor("anyxsolutions/lu-ma-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 = {
    "query": "party",
    "queries": [],
    "location": "Paris, Île-de-France",
}

# Run the Actor and wait for it to finish
run = client.actor("anyxsolutions/lu-ma-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 '{
  "query": "party",
  "queries": [],
  "location": "Paris, Île-de-France"
}' |
apify call anyxsolutions/lu-ma-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,anyxsolutions/lu-ma-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/k7UcGwPPkpoZFVPDt/builds/KSx6XVSbzPn1oFDMR/openapi.json