City Scout 🔭 - Universal Event Intelligence

Your personal event radar for tech meetups, parties, and workshops

Stop tab-hopping. Get events from Luma, Posh, and Eventbrite in one query—clean, fast, and AI-ready.

---

✨ What You Get

This Actor aggregates events from three popular platforms and returns standardized, structured data perfect for:

• 🤖 AI training datasets
• 📊 Market research & analytics
• 📱 Building event discovery apps
• 🔍 Personalized event recommendations

Platforms Scraped

• Luma (lu.ma) - Tech community events
• Posh (posh.vip) - Parties, mixers, social events
• Eventbrite (eventbrite.com) - General event marketplace

---

🚀 How It Works

1. Enter your search terms (e.g., "Tech Networking", "Startup Pitch")
2. Specify a location (e.g., "San Francisco", "New York")
3. Set max results (1-100 per platform)
4. Get clean JSON with normalized event data

⚡ Concurrent Scraping

All three platforms are scraped simultaneously using Promise.all, so you get results 3x faster.

---

📥 Input

{
  "queries": ["Tech Networking", "AI Meetup"],
  "location": "San Francisco",
  "maxResults": 20
}

Field	Type	Description	Default
queries	string[]	Keywords to search (e.g., "Rust Meetup")	Required
location	string	City or region to search	Required
maxResults	number	Max events per platform (1-100)	20

---

📤 Output

Each event includes:

{
  "id": "abc123",
  "title": "AI & Machine Learning Mixer",
  "startIso": "2026-01-15T19:00:00Z",
  "endIso": "2026-01-15T22:00:00Z",
  "locationName": "The Battery SF",
  "address": "717 Battery St, San Francisco, CA 94111",
  "url": "https://lu.ma/ai-ml-mixer",
  "platform": "luma",
  "imageUrl": "https://cdn.lu.ma/event-image.jpg"
}

Output Fields

Field	Type	Description
id	string	Unique event identifier
title	string	Event name
startIso	string	Start time (ISO 8601)
endIso	string?	End time (ISO 8601, if available)
locationName	string	Venue or location name
address	string?	Full address (if available)
url	string	Event page URL
platform	string	Source platform (luma, posh, eventbrite)
imageUrl	string?	Event image/flyer URL

---

💡 Use Cases

For Developers

• Build a personalized event discovery app
• Create automated event newsletters
• Train LLMs on event data

For Marketers

• Competitive analysis of events in your city
• Track industry event trends
• Find sponsorship opportunities

For Community Builders

• Discover where your audience hangs out
• Find partner events to cross-promote
• Monitor local event landscape

---

🔧 Development

Built with:

• Apify SDK - Actor framework
• Crawlee - Web scraping library
• got-scraping - HTTP client with stealth
• TypeScript - Type-safe development

Local Testing

npm install
npm run start:dev

---

📊 Performance

• Speed: ~10-15 seconds for 60 events (20 per platform)
• Accuracy: Direct API access (no brittle HTML parsing)
• Cost: ~$0.02 per run (Apify Free tier)

---

🎯 Why This Actor?

Feature	City Scout	Manual Search
Platforms	3 at once	1 at a time
Speed	15 seconds	15 minutes
Format	Structured JSON	Copy-paste chaos
AI-Ready	✅ Yes	❌ No

---

📝 Notes

• No authentication required - Public data only
• Rate limits respected - Polite scraping
• Fresh data - Real-time event listings

---

🆘 Troubleshooting

No results found?

• Try broader search terms
• Check that the location is recognized (use city names)
• Some platforms may have limited events in certain areas

Events missing fields?

• Not all events have complete data (e.g., no end time)
• Platform differences: Luma has richer address data than Posh

---

📬 Feedback

Found a bug or have a feature request? Open an issue!

---