# Event Scraper — Eventbrite, Lu.ma, Partiful & Humanitix (`avinashchby/event-scraper`) Actor

Scrape events from 5 major platforms (Eventbrite, Lu.ma, Partiful, Humanitix) with 8 filter dimensions: keywords, location, date range, event type, industry, format, price, and language. Deduplicates across sources.

- **URL**: https://apify.com/avinashchby/event-scraper.md
- **Developed by:** [Avinash](https://apify.com/avinashchby) (community)
- **Categories:** Lead generation, Marketing, Automation
- **Security:** Limited permissions
- **Stats:** 1 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

Pay per usage

This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have.

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

## 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

## Event Scraper: Eventbrite, Luma and Humanitix

Search three event platforms at once and get one list of upcoming events, with duplicates removed and every row in the same flat format: dates, venue and street address, ticket prices, organizer and the full description.

The actor reads the public pages and JSON that eventbrite.com, lu.ma and humanitix.com load in your browser. No login, API key or browser is needed. A default run takes about 15 seconds.

### Input

| Field | What it does | Default |
|-------|--------------|---------|
| `sources` | Any of `eventbrite`, `luma`, `humanitix` | all three |
| `query` | Keyword, e.g. `tech conference`, `AI meetup` | `tech` |
| `location` | `{"city": "Austin", "country": "US"}`. Use `{"city": "online"}` for online events. | Austin, US |
| `dateFrom`, `dateTo` | Day range (YYYY-MM-DD) | none |
| `eventTypes` | `conference`, `meetup`, `workshop`, `hackathon`, `webinar`, `summit`, `other` | all |
| `industries` | Words that must appear in the title, description or category | none |
| `format` | `online`, `in-person` or `both` | `both` |
| `priceType` | `free`, `paid` or `both` | `both` |
| `maxResults` | Total events across sources | 20 |
| `maxResultsPerSource` | Cap per platform | same as `maxResults` |

```json
{
  "sources": ["eventbrite", "luma", "humanitix"],
  "query": "tech conference",
  "location": { "city": "Austin", "country": "US" },
  "maxResults": 6,
  "maxResultsPerSource": 3
}
```

Events that already ended are never returned. Results are merged so every source gets a fair share, duplicates (same title on the same day) are dropped, and the list is sorted by start time.

### Output

| Field | Notes |
|-------|-------|
| `source` | `eventbrite`, `luma` or `humanitix` |
| `title`, `url` | Event name and page, tracking parameters removed |
| `startDate`, `endDate` | UTC ISO timestamps |
| `timezone` | Event's local time zone |
| `description` | Full description as plain text |
| `eventType` | Detected from the title and description |
| `isOnline` | `true` for online events |
| `venueName`, `address` | Null for online events, and for Luma events whose host hides the address until you register |
| `city`, `region`, `country` | Filled for in-person events |
| `isFree`, `minPrice`, `maxPrice`, `currency` | Ticket price range. `currency` is null for free events. |
| `organizerName` | Organizer or host |
| `organizerUrl` | Organizer profile on Eventbrite or Luma. Humanitix search does not publish one, so it is null for Humanitix rows. |
| `imageUrl` | Cover image |
| `scrapedAt` | When the row was collected |

### How each source is searched

- Eventbrite: its city search pages, plus the public event and description endpoints for prices, venue and organizer.
- Luma: its city discovery feed for about 90 cities. Other cities are located with OpenStreetMap and searched by coordinates. A Luma city covers its metro area.
- Humanitix: its city search page (up to about 30 events per run). It needs a two-letter country code in `location.country`. Humanitix matches keywords loosely, so the actor keeps only events whose title contains a keyword word.

### Changes from earlier versions

- Partiful was removed. Its public explore page lists only five trending parties per city and has no search, so it almost never matched a keyword.
- The `language` filter and the latitude/longitude radius option were removed because the platforms do not publish data that supports them reliably.
- Output is now one flat row per event instead of nested `venue` objects, and `location: "Unknown"`-style placeholders are gone. Missing values are `null`.
- If nothing matches, the run ends with a failed status rather than an empty "successful" dataset.

# Actor input Schema

## `sources` (type: `array`):

Platforms to search.

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

What to search for, e.g. 'tech conference', 'AI meetup', 'yoga'. Leave empty for all events in the city.

## `location` (type: `object`):

City and two-letter country code, e.g. {"city": "Austin", "country": "US"}. Humanitix needs the country code. Use {"city": "online"} for online events.

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

Only events starting on or after this day (YYYY-MM-DD).

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

Only events starting on or before this day (YYYY-MM-DD).

## `eventTypes` (type: `array`):

Keep only these types, detected from the title and description. Leave empty for all.

## `industries` (type: `array`):

Keep events whose title, description or category mentions any of these words.

## `format` (type: `string`):

Online, in person, or both.

## `priceType` (type: `string`):

Free, paid, or both.

## `maxResults` (type: `integer`):

Maximum events returned across all sources.

## `maxResultsPerSource` (type: `integer`):

Cap per platform so one source does not fill the whole list. Defaults to Max total results.

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

Optional. All three platforms serve these public pages without a proxy.

## Actor input object example

```json
{
  "sources": [
    "eventbrite",
    "luma",
    "humanitix"
  ],
  "query": "tech conference",
  "location": {
    "city": "Austin",
    "country": "US"
  },
  "industries": [
    "AI",
    "Fintech"
  ],
  "format": "both",
  "priceType": "both",
  "maxResults": 6,
  "maxResultsPerSource": 3,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

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

All scraped events with venue details, pricing, and source attribution.

# 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 = {
    "sources": [
        "eventbrite",
        "luma",
        "humanitix"
    ],
    "query": "tech conference",
    "location": {
        "city": "Austin",
        "country": "US"
    },
    "maxResults": 6,
    "maxResultsPerSource": 3,
    "proxyConfiguration": {
        "useApifyProxy": false
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("avinashchby/event-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 = {
    "sources": [
        "eventbrite",
        "luma",
        "humanitix",
    ],
    "query": "tech conference",
    "location": {
        "city": "Austin",
        "country": "US",
    },
    "maxResults": 6,
    "maxResultsPerSource": 3,
    "proxyConfiguration": { "useApifyProxy": False },
}

# Run the Actor and wait for it to finish
run = client.actor("avinashchby/event-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 '{
  "sources": [
    "eventbrite",
    "luma",
    "humanitix"
  ],
  "query": "tech conference",
  "location": {
    "city": "Austin",
    "country": "US"
  },
  "maxResults": 6,
  "maxResultsPerSource": 3,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}' |
apify call avinashchby/event-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,avinashchby/event-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/5npoXNsOPcXPColEd/builds/6OUEeIupTub5zgJII/openapi.json
