# Find Events (`hypebridge/find-events`) Actor

Queries multiple event platforms for a given city and category, returning a single normalized dataset of scheduled events. Supported platforms include Eventbrite, Meetup, Luma, Dice, Eventnoire, Posh, Prekindle, and Shotgun.

- **URL**: https://apify.com/hypebridge/find-events.md
- **Developed by:** [Hypebridge](https://apify.com/hypebridge) (community)
- **Categories:** E-commerce, Integrations, Automation
- **Features:** Limited permissions
- **Stats:** 12 total users, 6 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.00 / 1,000 orchestration units

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?

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

### What does Find Events do?

Find Events queries multiple primary event platforms for a given city and category, returning a single normalized dataset of scheduled events. Supported platforms include Eventbrite, Meetup, Luma, Partiful, Dice, Eventnoire, Posh, Prekindle, Shotgun, Showpass, Sympla, RunSignup, Eventeny, Resident Advisor, Xceed, and Fever. The actor matches search parameters, fetches listings, and deduplicates identical events across sources.

### Core Capabilities

- **Unified Querying**: Retrieve events across platforms with a single request, eliminating the need to configure and coordinate multiple individual crawlers.
- **Data Standardization**: All outputs use a single schema regardless of the source platform, including standardized ISO UTC timestamps, locations, and pricing fields.
- **Event Deduplication**: The system merges identical listings found on multiple platforms using title, date, city, and venue heuristics.
- **Local-Affinity Routing**: The actor first limits sources to those that serve the requested country or metro, then prioritizes sources that have historically returned useful local results for that city and category.

### What data can Find Events extract?

| Field | Type | Description |
|-------|------|-------------|
| `title` | String | Event name |
| `platform` | String | Source platform (e.g. `meetup`, `dice`) |
| `sourceUrl` | String | Link to the original event page |
| `category` | String | Canonical category you searched for |
| `startDateTimeUtc` | String | Start time in UTC (ISO 8601) |
| `localDate` | String | Event date in the city's timezone |
| `venueName` / `address` | String | Where the event takes place |
| `city` / `state` / `country` | String | Resolved location |
| `requestedCity` / `locationMatchQuality` | String | Requested city and whether the event was an exact or nearby location match |
| `priceMin` / `priceMax` / `isFree` | Number / Boolean | Ticket pricing when available |
| `imageUrl` | String | Event cover image |
| `organizerName` | String | Who is hosting the event (name as given by the source platform; the full record is in `sourceFields`) |
| `description` | String | Event description (richer with details enabled) |
| `conferenceName` / `conferenceMatchConfidence` / `conferenceMatchReason` | String / Number / String | Conference mode only: the conference the event was matched to, how sure the matcher is, and the words that decided it |
| `sourceFields` | Object | The untouched original record from the source platform |

Duplicates appearing on multiple platforms are merged using title, date, city, and venue.

### Run Configuration

1. Enter the target location in the `city` field (e.g., `Dallas, TX` or `Berlin`).
2. Select a `category` (e.g., `music`, `technology`) and a `timeWindow`.
3. Specify the `maxEvents` limit to define the target number of results.
4. Click **Start** to run the actor and retrieve findings from the **Dataset** tab.

### Cost Structure

Total run costs consist of the orchestration fee for this actor and the fees of the platform-specific crawlers executed on your behalf.

#### 1. Orchestration Fee (Pay Per Event)

| Metric | Cost |
|---|---|
| Run Start | $0.005 |
| Event Delivered | $0.002 ($2.00 per 1,000 events) |

#### Conference mode (extra fee)

When you set a **Conference name**, every candidate event from the city is scraped with full details and read by an LLM. That work is billed even for events that turn out not to belong to the conference.

| Metric | Cost |
|---|---|
| Candidate Event Screened | $0.08 ($80 per 1,000 candidates) |
| Matched Event Delivered | $0.002 (same as a normal event) |

At most 600 candidates are screened per run, and your run's maximum charge still applies. A typical 100 to 150 candidate run costs $8 to $12 in screening. Events that cannot be screened (model error) are neither billed nor returned. Automatic source selection leaves out Eventbrite and Shotgun in conference mode because they cost far more per event to scrape; add them under Platforms if you want them.

#### 2. Platform Crawlers (Billed Separately)

This actor triggers child runs of platform crawlers (such as Meetup, Luma, or Dice) using your Apify account resources. Platform crawlers charge their own pay-per-event fees, which typically range from $0.002 to $0.011 per event depending on the platform and whether full event details are retrieved. These appear as separate runs on your Apify usage logs.

#### Estimating Total Cost

Combined estimates vary based on city size, category, and the mix of active sources.

| Request Size | Orchestration Fee | Platform Crawlers | Estimated Total |
|---|---|---|---|
| 10 events | ~$0.03 | ~$0.08 to $0.15 | **~$0.10 to $0.18** |
| 50 events | ~$0.11 | ~$0.30 to $0.50 | **~$0.40 to $0.60** |
| 50 events with details | ~$0.11 | ~$0.60 to $0.95 | **~$0.70 to $1.05** |

#### Volume Controls

- **Max Events**: Set `maxEvents` to limit the volume of processed and delivered items.
- **Event Details**: Setting `getEventDetails` to false reduces platform crawler costs by skipping detailed sub-pages, fetching only the index listing.

Resident Advisor cities are resolved through its public area search or known verified routes. Xceed cities come from its live city directory. Fever cities come from its country directory and city links, with known verified routes for the five market probes. If a source has no exact city match, Find Events skips it. Automatic routing probes at most one of these new sources early per city and category until it has three local observations, then uses the learned affinity score.

You do not need to compare platform prices or classify sources as cheap or expensive. Source selection is based on geographic applicability and learned local yield. The actor still caps child concurrency, child-run count, and requested records so fan-out remains bounded.

### Input

See the **Input** tab for the full schema. Key fields:

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `city` | String | `Dallas, TX` | Free-form city, optionally with state or country. |
| `category` | String | `all` | Event category: `music`, `nightlife`, `technology`, `business`, `food_drink`, `arts_culture`, `comedy`, `sports_fitness`, `wellness`, `community_culture`, `family_education`. |
| `timeWindow` | String | `this_month` | `this_week`, `this_month`, or `all`. |
| `maxEvents` | Integer | `50` | Maximum unique events to return. |
| `platforms` | Array | Auto (empty) | Optional source allowlist. Empty or omitted considers every locally applicable source; selecting values restricts the search. |
| `getEventDetails` | Boolean | `false` | Fetch full event pages for richer data. Shotgun now filters bounded ranges directly from dated listing sections. |
| `childRunTimeoutSecs` | Integer | auto | Max seconds to wait for any one platform. |

#### Conference

Find the events around one conference. Set `city` to where it takes place.

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `conferenceName` | String | empty | Keep only events whose title or description ties them to this conference. Empty means a normal city search. |
| `conferenceContext` | String | empty | Optional hashtag, venue or website to help the matcher. |
| `conferenceStartDate` / `conferenceEndDate` | Date | empty | Conference week (YYYY-MM-DD). Overrides `timeWindow`. Posh (and Eventbrite, when selected) only search the current month, so they are skipped when these dates fall outside it. |

Conference mode always fetches full event details so descriptions can be matched. `maxEvents` limits matched events.

#### Example input

```json
{
  "city": "San Francisco, CA",
  "category": "music",
  "timeWindow": "this_week",
  "maxEvents": 50,
  "platforms": ["dice", "shotgun", "luma"],
  "getEventDetails": true
}
```

### Output

Saved to the **Dataset** tab. Download as JSON, CSV, Excel, or HTML.

Each item includes:

- **Event**: title, description, category, start/end times (UTC and local), status
- **Location**: venue, address, city, state, country, coordinates
- **Pricing**: priceMin, priceMax, currency, isFree
- **Provenance**: platform, sourceUrl, scrapedAt, plus the raw source record in `sourceFields`

#### Sample output

```json
{
  "id": "luma:evt_123",
  "platform": "luma",
  "sourceUrl": "https://lu.ma/ai-builders-dallas",
  "category": "technology",
  "title": "AI Builders Hackathon & Meetup",
  "description": "Join us for an exciting evening of building agentic apps.",
  "startDateTimeUtc": "2026-07-15T23:00:00.000Z",
  "localDate": "2026-07-15",
  "city": "Dallas",
  "state": "TX",
  "venueName": "Capital One Innovation Hub",
  "address": "1900 Pacific Ave, Dallas, TX 75201",
  "priceMin": 0,
  "isFree": true,
  "imageUrl": "https://images.lumacdn.com/event-cover.jpg",
  "scrapedAt": "2026-07-02T23:12:00.000Z"
}
```

### Operational Guidelines

- **Selecting Platforms**: Leave the field empty for Auto. The actor removes sources that do not serve the location and prioritizes affinity in this order: city/category, city/all, region/category, country/category, then static category ranking. Use the field only as an allowlist when you explicitly need a source subset.
- **Freshness and Volume**: Use `timeWindow: "this_week"` for time-sensitive listings, or `all` to capture long-term scheduled data.

### Related event scrapers

Looking for dedicated deep extraction from specific platforms or want to target a single ticketing provider? Explore our specialized event scrapers:

| Actor | Best For | Key Data Extracted |
|---|---|---|
| [Find Events](https://apify.com/hypebridge/find-events) | **All-in-one multi-platform search** across 16+ event sources | Aggregated & deduplicated events, normalized dates, venues, pricing |
| [Eventbrite Scraper](https://apify.com/hypebridge/eventbrite-search) | Global concerts, business conferences, festivals & city life | Event search, categories, ticket tiers, performers, organizer info |
| [Luma Event Scraper](https://apify.com/hypebridge/luma-com-event-scraper) | Tech meetups, hackathons, demo days, startup & Web3 events | Hosts, guest lists, ticket tiers, venue coordinates, calendar links |
| [Meetup Scraper](https://apify.com/hypebridge/meetup-scraper-all-urls) | Local community groups, networking, hobbies & recurring clubs | Groups, member counts, event series, RSVPs, organizers, topics |
| [Partiful Events Scraper](https://apify.com/hypebridge/partiful-events-scraper) | Social parties, creator gatherings, birthday events & private RSVPs | Guest RSVP status, hosts, event themes, questionnaires, venue details |
| [Dice.fm Event Scraper](https://apify.com/hypebridge/dice-fm) | Live music, club nights, concerts & major music festivals | Lineups, ticket tiers, release phases, door policies, promoters |
| [Resident Advisor Scraper](https://apify.com/hypebridge/resident-advisor-scraper) | Electronic music, club culture, underground DJs & festivals | Event lineups, promoters, venue directories, RA picks, ticket tiers |
| [Shotgun.live Event Scraper](https://apify.com/hypebridge/shotgun-live) | Electronic music, nightlife, techno parties & international club tours | Genres, lineups, dated city sections, venue profiles, ticket prices |
| [Posh.vip Event Scraper](https://apify.com/hypebridge/posh-vip) | Nightlife, exclusive social parties, college & influencer events | Lineups, ticket groups, attendance counts, organizer contact info |
| [Xceed Events Scraper](https://apify.com/hypebridge/xceed-events-scraper) | European nightlife, clubs, festivals & electronic music | Ticket tiers, fees, age policies, lineups, venue profiles |
| [Fever Events Scraper](https://apify.com/hypebridge/fever-events-scraper) | Immersive experiences, Candlelight concerts, city tours & exhibits | Sessions, time slots, pricing tiers, user reviews, venue coordinates |
| [Showpass Event Scraper](https://apify.com/hypebridge/showpass-event-scraper) | North American events, regional festivals, comedy & venue ticketing | Ticket types, price breakdowns, venue info, organizer details |
| [Sympla Events Scraper](https://apify.com/hypebridge/sympla-events-scraper) | Brazilian & Latin American concerts, conferences & Bileto events | Ticket tiers, installment plans, Bileto sectors, organizer info |
| [Eventnoire Events Scraper](https://apify.com/hypebridge/eventnoire) | Black culture events, lifestyle, nightlife, comedy & festivals | Event details, ticketing options, organizer bios, venue profiles |
| [Prekindle Event Scraper](https://apify.com/hypebridge/prekindle) | Live music venues, indie concerts, comedy shows & regional arts | Deeplinks, venue profiles, organizer links, event descriptions |
| [Eventeny Vendor & Market Scraper](https://apify.com/hypebridge/eventeny-vendor-market-directory) | Festivals, craft fairs, conventions, artisan markets & vendor expos | Vendor applications, booth pricing, deadlines, sponsor rosters |
| [RunSignup Race Scraper](https://apify.com/hypebridge/runsignup-race-scraper) | Marathons, 5Ks, triathlons, trail runs & charity endurance races | Registration fee ladders, price change dates, sub-events, sponsors |
| [FilmFreeway Festival Scraper](https://apify.com/hypebridge/filmfreeway-festival-scraper) | Film festivals, screenplay contests & creative competitions | Submission deadlines, category entry fees, award badges, venues |

### FAQ

#### Legal and Compliance

Find Events extracts publicly available event listings. Check the Terms of Service for each source platform and ensure your data collection complies with applicable regulations.

#### Cost Variation Across Runs

Platform distribution varies by city. In smaller markets, the actor may try more locally applicable sources to fulfill the requested event limit. Use `maxEvents` and the Apify run charge limit as the bounded controls.

#### Low Event Volume Behavior

If a city contains fewer events than the `maxEvents` value, the crawler terminates after exhausting all active platforms. You are billed for the $0.005 start fee and the events successfully delivered.

### Support and Feedback

- Report bugs or submit feature requests through the **Issues** tab.
- Reference the **API** tab for details on running this actor programmatically.

#### Privacy and Data Protection Disclaimer

This crawler only extracts public event listings. It does not extract private user details such as personal email addresses, gender, or user locations. Depending on the listings, the returned datasets may contain public personal data (e.g., event host names). Users are responsible for ensuring that their data collection and storage complies with GDPR, CCPA, and other local data protection regulations. Consult legal counsel if you are uncertain about compliance requirements.

# Actor input Schema

## `category` (type: `string`):

Canonical event category used to route across supported platforms.

## `city` (type: `string`):

Free-form city, optionally including state or country, for example Dallas, TX or New York.

## `timeWindow` (type: `string`):

Filter events to a simple time window. Resolved to concrete start/end dates internally using the resolved city timezone.

## `maxEvents` (type: `integer`):

Maximum number of normalized events to return across all platforms.

## `getEventDetails` (type: `boolean`):

Ask supported child actors to enrich listings with full event-page details. Unsupported child actors ignore this setting.

## `platforms` (type: `array`):

Optional source allowlist. Leave empty for Auto, which considers every locally applicable source and orders them by local affinity. Choose values only to restrict the search.

## `childRunTimeoutSecs` (type: `integer`):

Maximum seconds to wait for any one downstream actor.

## `debugMode` (type: `boolean`):

Store route plans, child inputs, affinity decisions, and skipped-platform reasons in the key-value store.

## `conferenceName` (type: `string`):

Return only events that belong to this conference, such as its side events and official parties. Each event's title and description is matched to the conference with an LLM. Leave empty for a normal city search.

## `conferenceContext` (type: `string`):

Optional hints for matching: the official hashtag, venue, website, or other names the conference goes by.

## `conferenceStartDate` (type: `string`):

First day to search (YYYY-MM-DD). Use with the end date to cover the conference week. Overrides the time window. Posh (and Eventbrite, when selected) only search the current month, so they are skipped when these dates fall outside it.

## `conferenceEndDate` (type: `string`):

Last day to search (YYYY-MM-DD).

## Actor input object example

```json
{
  "category": "all",
  "city": "Dallas, TX",
  "timeWindow": "this_week",
  "maxEvents": 50,
  "getEventDetails": false,
  "platforms": [],
  "childRunTimeoutSecs": 240,
  "debugMode": false,
  "conferenceName": "SXSW"
}
```

# Actor output Schema

## `dataset` (type: `string`):

Dataset containing aggregated event records from multiple platforms.

## `files` (type: `string`):

Key-value store files created when debug mode is enabled.

# 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 = {
    "category": "all",
    "city": "Dallas, TX",
    "timeWindow": "this_week",
    "maxEvents": 50,
    "conferenceName": "SXSW"
};

// Run the Actor and wait for it to finish
const run = await client.actor("hypebridge/find-events").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 = {
    "category": "all",
    "city": "Dallas, TX",
    "timeWindow": "this_week",
    "maxEvents": 50,
    "conferenceName": "SXSW",
}

# Run the Actor and wait for it to finish
run = client.actor("hypebridge/find-events").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 '{
  "category": "all",
  "city": "Dallas, TX",
  "timeWindow": "this_week",
  "maxEvents": 50,
  "conferenceName": "SXSW"
}' |
apify call hypebridge/find-events --silent --output-dataset

```

## MCP server setup

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

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/XIUAyRsGZ5I3g1kxi/builds/j8dsQlkFMOQcX6iy4/openapi.json