# Event Lead Monitor (`itayekk1/event-lead-monitor`) Actor

Find public Eventbrite and Meetup events by keyword and location. Export event names, URLs, dates, locations, organizers, and other public details.

- **URL**: https://apify.com/itayekk1/event-lead-monitor.md
- **Developed by:** [Itay Elgazar](https://apify.com/itayekk1) (community)
- **Categories:** Agents, Lead generation, Developer tools
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN 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/platform/actors/running/actors-in-store#pay-per-usage

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
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.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use 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

## Event Lead Monitor

Find public events on Eventbrite and Meetup by keyword and location.

Use it when you want a simple list of events for sponsorship research, partnerships, recruiting, field marketing, or market research.

### What you get

Each result can include:

- event source: Eventbrite or Meetup
- event title
- event URL
- event date and time text
- location
- organizer or group name
- price text, when visible
- public attendee signal, when visible
- search keyword and location used
- scrape status and error details, when something is unavailable

### Quick start

Use one keyword and one location first.

```json
{
  "keywords": ["startup"],
  "locations": ["Boston, MA"],
  "sources": ["eventbrite", "meetup"],
  "maxResultsPerSource": 10,
  "includeDetails": false
}
````

Turn on `includeDetails` if you want the Actor to open event pages and collect more fields.

### Input fields

- `keywords` — search terms, such as `startup`, `ai`, or `marketing`.
- `locations` — city or location strings, such as `Boston, MA`.
- `sources` — choose `eventbrite`, `meetup`, or both.
- `maxResultsPerSource` — result limit per source.
- `includeDetails` — open event detail pages for more data.
- `dedupe` — remove duplicate events.
- `eventbriteSearchUrls` — optional direct Eventbrite search URLs.
- `meetupSearchUrls` — optional direct Meetup search URLs.

### Output

The Actor saves results to the default Apify dataset. Each row is one public event or one structured error row.

### Limits

This Actor only reads public event pages. It does not scrape attendee lists, member lists, private communities, emails, phone numbers, social profiles, or hidden data.

# Actor input Schema

## `keywords` (type: `array`):

Search terms such as tech, startup, marketing, AI, business.

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

Optional alias for keywords. If provided, these are merged with keywords.

## `locations` (type: `array`):

Locations such as Boston, MA. Leave empty to search online/default events.

## `startDate` (type: `string`):

Optional start date, for example 2026-05-23.

## `endDate` (type: `string`):

Optional end date, for example 2026-07-31.

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

Sources to search.

## `eventbriteSearchUrls` (type: `array`):

Optional direct Eventbrite search/listing URLs for precise source control.

## `meetupSearchUrls` (type: `array`):

Optional direct Meetup search/listing URLs for precise source control.

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

Maximum events to return per source.

## `includeDetails` (type: `boolean`):

Fetch event detail pages for cleaner descriptions, organizer, dates, and location when available.

## `dedupe` (type: `boolean`):

Skip duplicate event records based on URL/title/date/location hash.

## `maxConcurrency` (type: `integer`):

Maximum number of requests to run at the same time.

## `requestDelayMs` (type: `integer`):

Polite delay before requests.

## Actor input object example

```json
{
  "keywords": [
    "tech"
  ],
  "locations": [
    "Boston, MA"
  ],
  "sources": [
    "eventbrite",
    "meetup"
  ],
  "maxResultsPerSource": 50,
  "includeDetails": true,
  "dedupe": true,
  "maxConcurrency": 6,
  "requestDelayMs": 500
}
```

# Actor output Schema

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

No description

## `runSummary` (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 = {
    "keywords": [
        "tech"
    ],
    "locations": [
        "Boston, MA"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("itayekk1/event-lead-monitor").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 = {
    "keywords": ["tech"],
    "locations": ["Boston, MA"],
}

# Run the Actor and wait for it to finish
run = client.actor("itayekk1/event-lead-monitor").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "keywords": [
    "tech"
  ],
  "locations": [
    "Boston, MA"
  ]
}' |
apify call itayekk1/event-lead-monitor --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=itayekk1/event-lead-monitor",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Event Lead Monitor",
        "description": "Find public Eventbrite and Meetup events by keyword and location. Export event names, URLs, dates, locations, organizers, and other public details.",
        "version": "0.1",
        "x-build-id": "pExgKgVX6IuBtamfN"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/itayekk1~event-lead-monitor/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-itayekk1-event-lead-monitor",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/itayekk1~event-lead-monitor/runs": {
            "post": {
                "operationId": "runs-sync-itayekk1-event-lead-monitor",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/itayekk1~event-lead-monitor/run-sync": {
            "post": {
                "operationId": "run-sync-itayekk1-event-lead-monitor",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "properties": {
                    "keywords": {
                        "title": "Keywords",
                        "type": "array",
                        "description": "Search terms such as tech, startup, marketing, AI, business.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "queries": {
                        "title": "Queries (alias for keywords)",
                        "type": "array",
                        "description": "Optional alias for keywords. If provided, these are merged with keywords.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "locations": {
                        "title": "Locations",
                        "type": "array",
                        "description": "Locations such as Boston, MA. Leave empty to search online/default events.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "startDate": {
                        "title": "Start date",
                        "type": "string",
                        "description": "Optional start date, for example 2026-05-23."
                    },
                    "endDate": {
                        "title": "End date",
                        "type": "string",
                        "description": "Optional end date, for example 2026-07-31."
                    },
                    "sources": {
                        "title": "Sources",
                        "type": "array",
                        "description": "Sources to search.",
                        "items": {
                            "type": "string",
                            "enum": [
                                "eventbrite",
                                "meetup"
                            ],
                            "enumTitles": [
                                "Eventbrite",
                                "Meetup"
                            ]
                        },
                        "default": [
                            "eventbrite",
                            "meetup"
                        ]
                    },
                    "eventbriteSearchUrls": {
                        "title": "Eventbrite search URLs",
                        "type": "array",
                        "description": "Optional direct Eventbrite search/listing URLs for precise source control.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "meetupSearchUrls": {
                        "title": "Meetup search URLs",
                        "type": "array",
                        "description": "Optional direct Meetup search/listing URLs for precise source control.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "maxResultsPerSource": {
                        "title": "Max results per source",
                        "minimum": 1,
                        "maximum": 1000,
                        "type": "integer",
                        "description": "Maximum events to return per source.",
                        "default": 50
                    },
                    "includeDetails": {
                        "title": "Fetch detail pages",
                        "type": "boolean",
                        "description": "Fetch event detail pages for cleaner descriptions, organizer, dates, and location when available.",
                        "default": true
                    },
                    "dedupe": {
                        "title": "Dedupe results",
                        "type": "boolean",
                        "description": "Skip duplicate event records based on URL/title/date/location hash.",
                        "default": true
                    },
                    "maxConcurrency": {
                        "title": "Max concurrency",
                        "minimum": 1,
                        "maximum": 25,
                        "type": "integer",
                        "description": "Maximum number of requests to run at the same time.",
                        "default": 6
                    },
                    "requestDelayMs": {
                        "title": "Request delay (ms)",
                        "minimum": 0,
                        "maximum": 5000,
                        "type": "integer",
                        "description": "Polite delay before requests.",
                        "default": 500
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
