# Eventbrite Events Scraper (`bovi/eventbrite-events`) Actor Extract structured event data from Eventbrite discovery pages (location/topic, online and in-person) or direct event URLs, with mandatory Apify residential proxy transport. - **URL**: https://apify.com/bovi/eventbrite-events.md - **Developed by:** [Vitalii Bondarev](https://apify.com/bovi) (community) - **Categories:** Travel, Marketing - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $4.37 / 1,000 event listings This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## 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/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 ## Eventbrite Scraper — Events by Location & Topic ### What does Eventbrite Scraper — Events by Location & Topic do Eventbrite Scraper — Events by Location & Topic collects publicly available Eventbrite event listings. It can discover events through Eventbrite search results using a location, topic, or both, and it can collect details from a specific public Eventbrite event URL. For each event, the actor saves the information displayed by Eventbrite when available. Output can include the event name, Eventbrite URL, date, time, location, organizer, price, image URL, and description. Use location-based search to collect events in a city, region, or country. Add a topic to narrow results to a subject such as technology, music, business, fitness, or food and drink. Use a direct event URL when you need information about a known event rather than a list of search results. The actor processes public Eventbrite pages only. Available event details can differ between listings. For example, online events may not have a physical venue, free events may not display a ticket price range, and some organizers may provide limited descriptions. Collected records are saved to the Apify dataset for the run. Dataset data can be viewed in the Apify Console, exported in supported formats, or accessed through the Apify API. ### Input Configure the actor with the following fields: | Field | Description | | --- | --- | | `location` | Location for the Eventbrite event search. Enter a city, region, country, or another location recognized by Eventbrite. | | `topic` | Topic or keyword used to narrow search results. Examples include `technology`, `music`, `business`, and `food and drink`. | | `event_url` | Full URL of a public Eventbrite event page to scrape directly. | | `max_events` | Maximum number of event records to collect and save. | Provide `location`, `topic`, or both to search Eventbrite listings. Use `event_url` for a specific event page. The actor may return fewer records than `max_events` if there are fewer matching public events or if event information is unavailable. Example input for a location and topic search: ```json { "location": "Austin, TX", "topic": "technology", "max_events": 25 } ```` Example input for a known event: ```json { "event_url": "https://www.eventbrite.com/e/austin-tech-networking-meetup-tickets-123456789012", "max_events": 1 } ``` ### Output example Each dataset item represents one Eventbrite event. Fields can be empty when the corresponding information is not displayed on the source page. ```json { "event_name": "Austin Tech Networking Meetup", "event_url": "https://www.eventbrite.com/e/austin-tech-networking-meetup-tickets-123456789012", "event_date": "Thursday, June 20", "event_time": "6:00 PM - 8:00 PM CDT", "location": "Capital Factory, 701 Brazos St, Austin, TX 78701", "organizer": "Austin Technology Community", "price": "Free", "image_url": "https://img.evbuc.com/https%3A%2F%2Fcdn.evbuc.com%2Fimages%2F123456789%2Fexample.jpg", "description": "An in-person networking event for technology professionals, founders, and developers in Austin." } ``` For online events, `location` may contain an online-event label rather than a street address. The `price` value may be `Free`, a single ticket price, or a price range. ### Use cases - Build event calendars for a city, region, or event topic. - Collect public listings for conferences, workshops, meetups, and networking events. - Research local event activity for business, technology, music, education, food, fitness, and other topics. - Monitor event dates and URLs for editorial calendars, newsletters, or internal planning. - Identify public organizers and recurring events in a selected location. - Export event records to a spreadsheet, database, or API-based workflow. - Retrieve structured details from a specific public Eventbrite event page. ### Pricing This actor uses pay-per-event pricing. You are charged for the event records collected by the actor. You also pay for your own Apify platform compute usage while the actor runs. Compute charges depend on the resources and runtime required for the run. # Actor input Schema ## `searchQueries` (type: `array`): Eventbrite discovery-page path segments to scrape, e.g. "united-states/events--tech", "ny--new-york/music". These cover both online and in-person events — a bare topic slug ("online/all-events") only returns virtual events. ## `urls` (type: `array`): Public Eventbrite event URLs to scrape directly. ## `maxItems` (type: `integer`): Maximum number of event records to save to the Dataset. ## `enrichDetails` (type: `boolean`): Fetch each event's own page for ticket pricing and full description (discovery-page listings don't include price). Adds one extra request per event. ## `proxyConfiguration` (type: `object`): Apify Proxy configuration. Residential proxies are enabled by default. ## Actor input object example ```json { "searchQueries": [], "urls": [], "maxItems": 100, "enrichDetails": true, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = {}; // Run the Actor and wait for it to finish const run = await client.actor("bovi/eventbrite-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = {} # Run the Actor and wait for it to finish run = client.actor("bovi/eventbrite-events").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 '{}' | apify call bovi/eventbrite-events --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=bovi/eventbrite-events", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Eventbrite Events Scraper", "description": "Extract structured event data from Eventbrite discovery pages (location/topic, online and in-person) or direct event URLs, with mandatory Apify residential proxy transport.", "version": "0.1", "x-build-id": "ny8s4aFBkAJNHc8Da" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/bovi~eventbrite-events/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-bovi-eventbrite-events", "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/bovi~eventbrite-events/runs": { "post": { "operationId": "runs-sync-bovi-eventbrite-events", "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/bovi~eventbrite-events/run-sync": { "post": { "operationId": "run-sync-bovi-eventbrite-events", "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": { "searchQueries": { "title": "Location/topic discovery paths", "type": "array", "description": "Eventbrite discovery-page path segments to scrape, e.g. \"united-states/events--tech\", \"ny--new-york/music\". These cover both online and in-person events — a bare topic slug (\"online/all-events\") only returns virtual events.", "default": [], "items": { "type": "string" } }, "urls": { "title": "Event URLs", "type": "array", "description": "Public Eventbrite event URLs to scrape directly.", "default": [], "items": { "type": "string" } }, "maxItems": { "title": "Maximum items", "minimum": 1, "type": "integer", "description": "Maximum number of event records to save to the Dataset.", "default": 100 }, "enrichDetails": { "title": "Enrich with full event details", "type": "boolean", "description": "Fetch each event's own page for ticket pricing and full description (discovery-page listings don't include price). Adds one extra request per event.", "default": true }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy configuration. Residential proxies are enabled by default.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } } ```