{ "openapi": "3.0.1", "info": { "title": "Eventbrite Events Scraper: Search by City, Category & Date", "description": "Search Eventbrite events by city or online, keyword, category, event type, date range and free/paid, or read event URLs. One clean row per event: start/end with time zone, venue with coordinates, organizer, ticket price range, sales status, optional full description. $1 per 1,000 events.", "version": "1.0", "x-build-id": "h0LfhiON1iaLtlWwM" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fairfetch~eventbrite-events-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fairfetch-eventbrite-events-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/fairfetch~eventbrite-events-scraper/runs": { "post": { "operationId": "runs-sync-fairfetch-eventbrite-events-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/fairfetch~eventbrite-events-scraper/run-sync": { "post": { "operationId": "run-sync-fairfetch-eventbrite-events-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": { "locations": { "title": "Locations", "type": "array", "description": "Where to search, one per line. Accepted forms:\n- City or place name: London, Austin, TX, Paris, France, Berlin. A US state or a country after the name must match (\"Paris, KY\" never gives Paris, France); a code can mean several places (WA: Washington or Western Australia; SK: Saskatchewan or Slovakia), so each is tried, US states first, and the first with a matching place that has events is used (\"Richmond, CA\" is California, \"Perth, WA\" Western Australia). English names of big cities work (Munich, Vienna, Rome).\n- Eventbrite place slug (from a search URL): ny--new-york, united-kingdom--london, ca--san-francisco\n- online (online events only)\n- An Eventbrite place ID (number)\nEach location is searched once for every combination of keyword, category and event type below. Eventbrite includes nearby events for small towns.", "items": { "type": "string" } }, "keywords": { "title": "Keywords (optional)", "type": "array", "description": "Search words, one search per line, e.g. \"python\", \"yoga\", \"startup pitch\". Leave empty for all events of the location. Eventbrite's keyword search is broad (it also matches descriptions and tags).", "items": { "type": "string" } }, "categories": { "title": "Categories (optional)", "type": "array", "description": "Eventbrite categories. Each selected category is a separate search; leave empty for all categories.", "items": { "type": "string", "enum": [ "business", "science-and-tech", "music", "film-and-media", "arts", "fashion", "health", "sports-and-fitness", "travel-and-outdoor", "food-and-drink", "charity-and-causes", "government", "community", "spirituality", "family-and-education", "holiday", "home-and-lifestyle", "auto-boat-and-air", "hobbies", "school-activities", "other" ], "enumTitles": [ "Business & Professional", "Science & Technology", "Music", "Film, Media & Entertainment", "Performing & Visual Arts", "Fashion & Beauty", "Health & Wellness", "Sports & Fitness", "Travel & Outdoor", "Food & Drink", "Charity & Causes", "Government & Politics", "Community & Culture", "Religion & Spirituality", "Family & Education", "Seasonal & Holiday", "Home & Lifestyle", "Auto, Boat & Air", "Hobbies & Special Interest", "School Activities", "Other" ] } }, "eventTypes": { "title": "Event types (optional)", "type": "array", "description": "Eventbrite event formats, e.g. conferences or workshops. Each selected type is a separate search (combined with the categories above); leave empty for all types.", "items": { "type": "string", "enum": [ "conference", "seminar", "expo", "convention", "festival", "performance", "screening", "gala", "class", "networking", "party", "rally", "tournament", "game", "race", "tour", "attraction", "retreat", "appearance", "other" ], "enumTitles": [ "Conference", "Seminar or Talk", "Tradeshow, Consumer Show or Expo", "Convention", "Festival or Fair", "Concert or Performance", "Screening", "Dinner or Gala", "Class, Training or Workshop", "Meeting or Networking Event", "Party or Social Gathering", "Rally", "Tournament", "Game or Competition", "Race or Endurance Event", "Tour", "Attraction", "Camp, Trip or Retreat", "Appearance or Signing", "Other" ] } }, "dateFilter": { "title": "When", "enum": [ "any", "today", "tomorrow", "this_weekend", "this_week", "next_week", "this_month", "next_month" ], "type": "string", "description": "Eventbrite's date filter, in each location's own time zone. Ignored when a start or end date is set below.", "default": "any" }, "startDate": { "title": "From date (optional)", "pattern": "^(\\d{4}-\\d{2}-\\d{2})?$", "type": "string", "description": "Only events on or after this date, YYYY-MM-DD (e.g. 2026-11-01). Without an end date the range is one year." }, "endDate": { "title": "To date (optional)", "pattern": "^(\\d{4}-\\d{2}-\\d{2})?$", "type": "string", "description": "Only events on or before this date, YYYY-MM-DD. Without a start date the range starts today. Multi-day events that overlap the range are included." }, "priceFilter": { "title": "Price", "enum": [ "any", "free", "paid" ], "type": "string", "description": "Free events only, paid events only, or both.", "default": "any" }, "maxEventsPerSearch": { "title": "Max events per search", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum events returned for each search (each location / keyword / category / event type combination, and each search URL). Eventbrite itself stops at 1,000 events per search; split big cities by date range or category for more.", "default": 100 }, "maxEvents": { "title": "Max events in total", "minimum": 0, "type": "integer", "description": "Stop the whole run after this many events. 0 = no limit (the maximum cost per run you set when starting the run also stops it cleanly).", "default": 0 }, "includeDetails": { "title": "Include event page details", "type": "boolean", "description": "Also open each event's page for the full description (plain text), refund policy, age restriction, event status and organizer stats. One extra request per event and charged as \"event with details\". Rows from event URLs always include details.", "default": false }, "searchUrls": { "title": "Eventbrite search URLs (optional)", "type": "array", "description": "Search pages copied from your browser, e.g. https://www.eventbrite.com/d/ny--new-york/free--music--events--this-weekend/ or https://www.eventbrite.com/d/online/business--conferences/. The location and filters are read from the URL (the filters above don't apply to them).", "items": { "type": "string" } }, "eventUrls": { "title": "Event URLs (optional)", "type": "array", "description": "Event pages to read in full, e.g. https://www.eventbrite.com/e/some-event-tickets-1234567890123 (any Eventbrite country domain), or bare event IDs. Each returns one row with details.", "items": { "type": "string" } }, "maxConcurrency": { "title": "Searches in parallel", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many searches run at the same time. Requests to Eventbrite are spaced out in any case.", "default": 3 }, "requestTimeoutSecs": { "title": "Request timeout (seconds)", "minimum": 5, "maximum": 120, "type": "integer", "description": "Timeout for a single HTTP request.", "default": 30 }, "maxRetries": { "title": "Max retries per request", "minimum": 0, "maximum": 8, "type": "integer", "description": "Retries for network errors, HTTP 5xx and blocks, with exponential backoff.", "default": 4 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Requests go to Eventbrite directly first. If Eventbrite blocks them (its \"Human Verification\" page), the run switches to this proxy, in the searched city's country when it is Apify residential (default, included in the price). Turn it off only for local runs.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }, "alwaysUseProxy": { "title": "Always use the proxy", "type": "boolean", "description": "Send every request through the proxy from the start, instead of only after Eventbrite blocks a direct request. Slower and uses proxy traffic; only useful if direct requests keep getting blocked.", "default": false } } }, "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 } } } } } } } } } }