{ "openapi": "3.0.1", "info": { "title": "Eventbrite Events Scraper — Dates, Venues, Tickets & Organizers", "description": "Scrape eventbrite.com events by keyword, place or event URL. Each row has start and end dates with local times, venue address with coordinates, ticket price with sales status and organizer details. Ready for a CRM or spreadsheet.", "version": "0.1", "x-build-id": "UNmzM3nwmuKEtyMDk" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/blackfalcondata~eventbrite-com-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-blackfalcondata-eventbrite-com-scraper", "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/blackfalcondata~eventbrite-com-scraper/runs": { "post": { "operationId": "runs-sync-blackfalcondata-eventbrite-com-scraper", "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/blackfalcondata~eventbrite-com-scraper/run-sync": { "post": { "operationId": "run-sync-blackfalcondata-eventbrite-com-scraper", "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": { "query": { "title": "🔍 Search Term(s)", "type": "string", "description": "Event search keywords (e.g. \"tech networking\", \"yoga workshop\", \"live jazz\"). Use a JSON array for several searches in one run. Required if no startUrls provided." }, "location": { "title": "📍 Location", "type": "string", "description": "Eventbrite place slug — e.g. \"ny--new-york\", \"united-kingdom--london\", \"ca--san-francisco\", or \"online\" for online-only events. A plain city name is slugified automatically. Defaults to online events. Use a JSON array for several locations." }, "maxResults": { "title": "💯 Max Results", "minimum": 0, "maximum": 1000, "type": "integer", "description": "Maximum total results (0 = unlimited).", "default": 100 }, "maxPages": { "title": "📄 Max Pages per Search", "minimum": 0, "type": "integer", "description": "Stop each search after this many result pages (20 events per page). 0 = no page limit; Max Results still applies.", "default": 0 }, "startUrls": { "title": "🔗 Start URLs", "type": "array", "description": "Paste raw search URLs from the target site. Each URL becomes its own search task; results are merged and deduped by event ID across all URLs. When provided, startUrls REPLACE the query/location fields (each supported URL becomes one task; unsupported URLs are skipped, and if none is supported the run stops with an input error).", "items": { "type": "string" }, "default": [] }, "category": { "title": "🎯 Category", "enum": [ "music", "business", "food-and-drink", "community", "arts", "film-and-media", "sports-and-fitness", "health", "science-and-tech", "travel-and-outdoor", "charity-and-causes", "family-and-education", "fashion", "home-and-lifestyle", "auto-boat-and-air", "hobbies", "holiday", "government", "spirituality", "school-activities", "other" ], "type": "string", "description": "Only events in this Eventbrite category. Combines with the search term, location and the other filters. Leave empty for all categories." }, "eventFormat": { "title": "🎪 Event Format", "enum": [ "classes", "conferences", "festivals", "parties", "performances", "seminars", "networking", "expos", "tours", "screenings", "attractions", "retreats", "conventions", "galas", "games", "races", "rallies", "tournaments", "appearances" ], "type": "string", "description": "Only events of this format (class, conference, party, ...). Leave empty for every format." }, "dateFilter": { "title": "📅 Date Window", "enum": [ "today", "tomorrow", "this-weekend", "this-week", "next-week", "this-month", "next-month" ], "type": "string", "description": "Only events in this window, relative to the day of the run. Ignored when a Start Date or End Date is set." }, "startDate": { "title": "📆 Start Date", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Only events on or after this day (YYYY-MM-DD). Overrides the Date Window." }, "endDate": { "title": "📆 End Date", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Only events on or before this day (YYYY-MM-DD). Overrides the Date Window." }, "priceFilter": { "title": "💲 Price", "enum": [ "free", "paid" ], "type": "string", "description": "Free events only, or paid events only. Leave empty for both." }, "onlineOnly": { "title": "🌐 Online Events Only", "type": "boolean", "description": "Search online events only. Overrides the Location field.", "default": false }, "sortBy": { "title": "↕️ Sort By", "enum": [ "relevance", "date" ], "type": "string", "description": "Relevance is Eventbrite's default ranking; Date lists the soonest events first.", "default": "relevance" }, "includeDetails": { "title": "📋 Include Full Details", "type": "boolean", "description": "Fetch full event details (description body, ticket price range, organizer profile).", "default": true }, "retrieveOrganizerData": { "title": "🏢 Retrieve Organizer Data", "type": "boolean", "description": "Add the organizer's profile to every event: description, logo, past and upcoming event counts, website and social links. One extra request per distinct organizer per run. Needs Include Full Details.", "default": false }, "harvestOrganizerEmails": { "title": "✉️ Harvest Organizer Emails", "type": "boolean", "description": "Visit the organizer's own website (home page and contact page) and collect the public email addresses found there into organizerEmails. Needs Retrieve Organizer Data. Slower; organizers without a website return none.", "default": false }, "descriptionMaxLength": { "title": "✂️ Description Max Length", "minimum": 0, "type": "integer", "description": "Truncate description to N chars. 0 = no truncation.", "default": 0 }, "compact": { "title": "📦 Compact Output", "type": "boolean", "description": "Core fields only (for AI-agent/MCP workflows).", "default": false }, "descriptionFormat": { "title": "Description format", "enum": [ "all", "text", "html", "markdown" ], "type": "string", "description": "Pick a single description representation. `all` keeps every variant; `text` / `html` / `markdown` drop the others.", "default": "all" }, "excludeEmptyFields": { "title": "Exclude empty fields from output", "type": "boolean", "description": "Drop null, empty-string, and empty-array fields from each record before push. Smaller payloads for AI agents and dashboards.", "default": false }, "incrementalMode": { "title": "♻️ Incremental Mode", "type": "boolean", "description": "Compare against previous run state. stateKey is optional — defaults to a value derived from search inputs (queries, locations, startUrls, country) so different filter sets never share state.", "default": false }, "stateKey": { "title": "🔑 State Key", "type": "string", "description": "Optional. Stable identifier for the tracked search universe. Leave empty to auto-generate from search inputs." }, "skipReposts": { "title": "🚫 Skip Reposts", "type": "boolean", "description": "When incremental, skip events whose content matches an expired event from a prior run (cross-run duplicate detection).", "default": false }, "emitUnchanged": { "title": "🔄 Emit Unchanged Events", "type": "boolean", "description": "When incremental mode is on, also emit events whose content has not changed since the last run.", "default": false }, "emitExpired": { "title": "⚰️ Emit Expired Events", "type": "boolean", "description": "When incremental mode is on, also emit events that were seen before but are no longer found.", "default": false }, "notifyOnlyChanges": { "title": "🔄 Notify Only New/Updated", "type": "boolean", "description": "When Incremental Mode is on, only send notifications for NEW and UPDATED events. Has no effect outside incremental mode.", "default": false }, "notificationLimit": { "title": "📊 Max Events Per Notification", "minimum": 1, "maximum": 20, "type": "integer", "description": "Maximum number of events included in each notification message (1–20).", "default": 5 }, "telegramToken": { "title": "🔑 Telegram Bot Token", "type": "string", "description": "Telegram bot token (from @BotFather). Required for Telegram notifications." }, "telegramChatId": { "title": "💬 Telegram Chat ID", "type": "string", "description": "Telegram chat or channel ID (e.g. \"-100123456789\"). Required when telegramToken is set." }, "discordWebhookUrl": { "title": "🎮 Discord Webhook URL", "type": "string", "description": "Discord incoming webhook URL. Server Settings → Integrations → Webhooks → New Webhook." }, "slackWebhookUrl": { "title": "💼 Slack Webhook URL", "type": "string", "description": "Slack incoming webhook URL. api.slack.com/messaging/webhooks." }, "whatsappPhoneNumberId": { "title": "📞 WhatsApp Phone Number ID", "type": "string", "description": "Your WhatsApp Business phone-number ID (numeric, from Meta dashboard). Required when whatsappAccessToken is set." }, "whatsappAccessToken": { "title": "📱 WhatsApp Access Token", "type": "string", "description": "WhatsApp Cloud API permanent access token (System User token from Meta Business). Recipient must have messaged the business number within the last 24h (service-conversation window — free since Nov 2024)." }, "whatsappTo": { "title": "📲 WhatsApp Recipient", "type": "string", "description": "Recipient phone in E.164 format without + (e.g. \"436641234567\"). Recipient must have messaged your business number within last 24h." }, "webhookUrl": { "title": "🪝 Generic Webhook URL", "type": "string", "description": "Receives a JSON POST with {metadata, items} after each run. Universal escape hatch for n8n / Make / Zapier / custom backends." }, "webhookHeaders": { "title": "📋 Webhook Headers", "type": "object", "description": "Optional JSON object of custom headers (e.g. {\"Authorization\":\"Bearer ...\"})." }, "appConnector": { "title": "Send results to a connected app", "type": "string", "description": "Optional. Pick a connected app under Settings → API & Integrations to receive your results (including any contact details). Best-effort across MCP connectors as Apify expands its catalog." }, "mcpIssueTeam": { "title": "Issue tracker team", "type": "string", "description": "Only when the connected app is an issue tracker: the team (name or ID) the summary issue is created under, if that app requires one." } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }