🎟️ Luma Event Scraper

Search lu.ma for public events by keyword, location, and date window — or paste event URLs directly — and export the complete event record (organizers, venue, schedule, tickets, cover art, description, and more) to a clean dataset.

No login, no cookies, no headless browser. The scraper talks to Luma's public JSON API and only reaches for a proxy if Luma starts pushing back.

---

✨ Why Choose This Actor?

• ⭐ Works out of the box, no proxy needed — the default Luma engine queries Luma directly.
• 🧠 Smart proxy ladder — starts direct, and only escalates to a datacenter → residential proxy if Luma blocks you. Once it escalates, it sticks to the working tier.
• 📍 Precise geo-filtering — resolves your location to Luma's internal place id for server-side accuracy (with a text-match fallback).
• 📅 Date-window filtering — narrow results to a forward window (Luma engine) or Google indexed dates (Google engine).
• 🔗 Bulk URL mode — already have event links? Paste them and skip search entirely.
• 💾 Live saving + de-duplication — every event is written the moment it's fetched, de-duplicated by event id.
• 📊 Four ready-made views — Overview, Location, Schedule, and Content.

---

🔧 Input

Field	Type	Description
query	string	Primary search keyword (e.g. party).
queries	array	Extra keywords, searched separately and merged.
startUrls	array	Bulk lu.ma event URLs to fetch directly (skips search).
location	string	City / region filter, e.g. Paris, Île-de-France.
maxItems	integer	Max events per keyword (default 10).
searchEngine	string	luma (default) · google · auto.
indexedDateAfter / indexedDateBefore	string	YYYY-MM-DD date bounds.
resolvePlaceId	boolean	Precise server-side geo-filtering (default true).
eventConcurrency	integer	Parallel detail fetches (default 8).
maxRetries	integer	Retries per request (default 3).
httpTimeoutSec	number	Per-request timeout seconds (default 30).
proxyConfiguration	object	Apify proxy — keep enabled so fallbacks are available.

Example input

{
  "query": "party",
  "queries": ["meetup"],
  "location": "Paris, Île-de-France",
  "maxItems": 10,
  "searchEngine": "luma",
  "proxyConfiguration": { "useApifyProxy": true }
}

---

📦 Output

Each dataset item is the full Luma event record plus convenience top-level fields. Abbreviated example:

{
  "api_id": "evt-Z959tNsLqyaX0Xm",
  "event": {
    "name": "Champions & Founders by Experts Entreprendre & Pennylane",
    "start_at": "2026-06-09T16:00:00.000Z",
    "end_at": "2026-06-09T21:00:00.000Z",
    "cover_url": "https://images.lumacdn.com/event-covers/.../cover.png",
    "geo_address_info": { "city": "Saint-Ouen-sur-Seine", "country": "France" }
  },
  "hosts": [{ "name": "Guillaume Allaux" }],
  "query": "party",
  "name": "Champions & Founders by Experts Entreprendre & Pennylane",
  "url": "https://lu.ma/dkphsos2",
  "start_at": "2026-06-09T16:00:00.000Z",
  "end_at": "2026-06-09T21:00:00.000Z",
  "city": "Saint-Ouen-sur-Seine",
  "country": "France",
  "description": "…",
  "mainImageUrl": "https://images.lumacdn.com/event-covers/.../cover.png"
}

Convenience field	Meaning
query	The keyword that surfaced this event.
name	Event title.
url	Public event URL.
start_at / end_at	Event start / end (ISO-8601).
city / region / country / full_address	Flattened venue info.
location_type	offline / online / hybrid.
description	Plain-text description (flattened from Luma's rich text).
mainImageUrl	Cover image.

---

🚀 How to Use (Apify Console)

1. Log in at https://console.apify.com → Actors.
2. Open Luma Event Scraper.
3. Enter a query (and optionally location, maxItems, dates).
4. Leave Proxy on the default.
5. Click Start and watch events stream into the log in real time.
6. Open the Output tab — switch between the Overview / Location / Schedule / Content views.
7. Export to JSON / CSV / XLSX.

🤖 Use via API

curl -X POST "https://api.apify.com/v2/acts/<ACTOR_ID>/run-sync-get-dataset-items?token=$APIFY_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"query":"party","location":"Paris","maxItems":10}'

---

💡 Best Use Cases

• 📈 Event lead generation & market research.
• 🗺️ Tracking what's happening in a specific city.
• 🤝 Finding meetups, conferences, and networking events by topic.
• 🧾 Building event datasets for analytics or aggregation.

---

💳 Pricing

This actor uses pay-per-event billing: you are charged once per event-scraped record written to the dataset, plus standard Apify platform usage. The Luma engine needs no proxy, keeping runs cheap.

---

❓ FAQ

Do I need a proxy? No. The default Luma engine works direct. A proxy is only used automatically if Luma blocks you.

Why 0 results with a past date window? Luma's discover API only surfaces upcoming events, so a window entirely in the past returns nothing on the Luma engine. Use a future window, or searchEngine: "google" for indexed-date (historical) search.

Can I scrape specific events I already know? Yes — paste their URLs into startUrls.

---

⚖️ Notes & Compliance

Data is collected only from publicly available Luma pages. You are responsible for compliance with applicable laws (GDPR, CCPA, anti-spam) and Luma's Terms of Service.

🛟 Support

Found a bug or need a new field? Open an issue on the actor's Issues tab.