Eventbrite Event Finder with Venue Geocoordinates
Browse Eventbrite listings by city or category and get event dates, venue address and geocoordinates, cover images, organizer and ticket link for every event.
Input schema
Input fields, types, required flags, descriptions, defaults, and prefills come from the published definition. Prefill examples are distinct from defaults.
| Field | Type | Required | Description |
|---|---|---|---|
startUrls | array | optional | Eventbrite browse URLs (e.g. https://www.eventbrite.com/d/ny--new-york/all-events/), direct event URLs (/e/...), or organizer URLs (/o/...). Accepts URL strings and {"url": ...} objects. When set, this wins over the filter fields. |
location | string | optional | Legacy city/region slug used when startUrls and locations are empty, e.g. ny--new-york, ca--san-francisco, united-states, online. Blank defaults to united-states. |
category | string | optional | Legacy category slug such as music, business, food-and-drink, sports. Kept for backward compatibility: when used alone it runs as a keyword query, matching the old category URL behaviour. Use 'categories' for exact taxonomy filtering. |
Show all input fields
| Field | Type | Required | Description |
|---|---|---|---|
startUrls | array | optional | Eventbrite browse URLs (e.g. https://www.eventbrite.com/d/ny--new-york/all-events/), direct event URLs (/e/...), or organizer URLs (/o/...). Accepts URL strings and {"url": ...} objects. When set, this wins over the filter fields. |
location | string | optional | Legacy city/region slug used when startUrls and locations are empty, e.g. ny--new-york, ca--san-francisco, united-states, online. Blank defaults to united-states. |
category | string | optional | Legacy category slug such as music, business, food-and-drink, sports. Kept for backward compatibility: when used alone it runs as a keyword query, matching the old category URL behaviour. Use 'categories' for exact taxonomy filtering. |
maxItems | integer | optional | Maximum number of unique events to return across all queries. The source caps each query at 1,000 events; above 1,000 the actor splits by date, category, price, and online coverage, or scans the event sitemap when useSitemap is enabled. |
keywords | array | optional | Keyword queries (q). Each value is a separate query slice; results are deduplicated by event ID. |
locations | array | optional | City, region, or place IDs, e.g. ny--new-york, london, united-kingdom--london, 85977539. Multiple locations run as separate queries and are deduplicated. |
country | string | optional | Country filter. Combined with locations when possible; use any to leave it open. |
categories | array | optional | Exact EventbriteCategory filters. Accepts display names, numeric IDs, or EventbriteCategory/<id>. Captured catalog: Business & Professional (101), Science & Technology (102), Music (103), Film, Media & Entertainment (104), Performing & Visual Arts (105), Fashion & Beauty (106), Health & Wellness (107), Sports & Fitness (108), Travel & Outdoor (109), Food & Drink (110), Charity & Causes (111), Community & Culture (113), Religion & Spirituality (114), Family & Education (115), Seasonal & Holiday (116), Home & Lifestyle (117), Auto, Boat & Air (118), Hobbies & Special Interest (119), School Activities (120), Other (199). Unknown values are skipped with a warning. |
format | string | optional | Exact EventbriteFormat filter. Accepts the display name or an EventbriteFormat/<id> value. |
datePreset | string | optional | Date window. today and tomorrow use the browse page; the other presets use the search API. custom requires dateFrom and dateTo. |
dateFrom | string | optional | Start date (YYYY-MM-DD). Used only with datePreset=custom. |
dateTo | string | optional | End date (YYYY-MM-DD). Used only with datePreset=custom. |
priceFilter | string | optional | Free or paid events. Uses the search API's price filter and is checked again client-side. |
eventType | string | optional | Any, in-person, or online. Online uses online_events_only without a place filter; in-person removes online events client-side. |
sort | string | optional | Relevance keeps Eventbrite's default order. date is experimental and ascending only: it sends event_search.sort=date and forces the search API path. Ordering is by start date; same-day times may vary. Descending order is not supported. |
organizerMode | boolean | optional | Add organizer profile metrics and social links from the organizer page. Also implied by organizer URLs in startUrls. Records stay event records. |
includeDetails | boolean | optional | Fetch the event detail page and public event API for description, ticket classes, refunds, age, door time, UTC times, duration, series counts, and the conditional Facebook event ID. Adds one or two requests per event. |
useSitemap | boolean | optional | Only for runs above 1,000. Scan Eventbrite's event sitemaps (about 201,000 event IDs) and hydrate in batches instead of splitting search queries. Filters are applied client-side. Ignored with startUrls or maxItems <= 1,000. |
proxyConfiguration | object | optional | Optional. Never required. The actor works from a datacenter IP by default; an AUTO proxy is supported. No residential proxy or login is used. |
Download the published input schema
View complete JSON
{
"properties": {
"categories": {
"default": [],
"description": "Exact EventbriteCategory filters. Accepts display names, numeric IDs, or EventbriteCategory/<id>. Captured catalog: Business & Professional (101), Science & Technology (102), Music (103), Film, Media & Entertainment (104), Performing & Visual Arts (105), Fashion & Beauty (106), Health & Wellness (107), Sports & Fitness (108), Travel & Outdoor (109), Food & Drink (110), Charity & Causes (111), Community & Culture (113), Religion & Spirituality (114), Family & Education (115), Seasonal & Holiday (116), Home & Lifestyle (117), Auto, Boat & Air (118), Hobbies & Special Interest (119), School Activities (120), Other (199). Unknown values are skipped with a warning.",
"editor": "stringList",
"items": {
"type": "string"
},
"title": "Exact categories",
"type": "array"
},
"category": {
"description": "Legacy category slug such as music, business, food-and-drink, sports. Kept for backward compatibility: when used alone it runs as a keyword query, matching the old category URL behaviour. Use 'categories' for exact taxonomy filtering.",
"editor": "textfield",
"title": "Category (legacy keyword)",
"type": "string"
},
"country": {
"default": "any",
"description": "Country filter. Combined with locations when possible; use any to leave it open.",
"editor": "select",
"enum": [
"any",
"US",
"GB",
"DE",
"CA",
"AU",
"FR",
"ES",
"IT",
"NL",
"IE",
"NZ",
"IN",
"BR",
"MX",
"JP",
"SG",
"ZA",
"AE"
],
"enumTitles": [
"Any country",
"United States",
"United Kingdom",
"Germany",
"Canada",
"Australia",
"France",
"Spain",
"Italy",
"Netherlands",
"Ireland",
"New Zealand",
"India",
"Brazil",
"Mexico",
"Japan",
"Singapore",
"South Africa",
"United Arab Emirates"
],
"title": "Country",
"type": "string"
},
"dateFrom": {
"description": "Start date (YYYY-MM-DD). Used only with datePreset=custom.",
"editor": "datepicker",
"title": "Date from",
"type": "string"
},
"datePreset": {
"default": "any",
"description": "Date window. today and tomorrow use the browse page; the other presets use the search API. custom requires dateFrom and dateTo.",
"editor": "select",
"enum": [
"any",
"today",
"tomorrow",
"this_week",
"this_weekend",
"next_week",
"this_month",
"next_month",
"custom"
],
"enumTitles": [
"Any date",
"Today",
"Tomorrow",
"This week",
"This weekend",
"Next week",
"This month",
"Next month",
"Custom range"
],
"title": "Date preset",
"type": "string"
},
"dateTo": {
"description": "End date (YYYY-MM-DD). Used only with datePreset=custom.",
"editor": "datepicker",
"title": "Date to",
"type": "string"
},
"eventType": {
"default": "any",
"description": "Any, in-person, or online. Online uses online_events_only without a place filter; in-person removes online events client-side.",
"editor": "select",
"enum": [
"any",
"in_person",
"online"
],
"enumTitles": [
"Any type",
"In person",
"Online"
],
"title": "Event type",
"type": "string"
},
"format": {
"default": "any",
"description": "Exact EventbriteFormat filter. Accepts the display name or an EventbriteFormat/<id> value.",
"editor": "select",
"enum": [
"any",
"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",
"Tournament",
"Game or Competition",
"Tour",
"Attraction",
"Appearance or Signing",
"Other"
],
"enumTitles": [
"Any format",
"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",
"Tournament",
"Game or Competition",
"Tour",
"Attraction",
"Appearance or Signing",
"Other"
],
"title": "Format",
"type": "string"
},
"includeDetails": {
"default": false,
"description": "Fetch the event detail page and public event API for description, ticket classes, refunds, age, door time, UTC times, duration, series counts, and the conditional Facebook event ID. Adds one or two requests per event.",
"prefill": false,
"title": "Include details",
"type": "boolean"
},
"keywords": {
"default": [],
"description": "Keyword queries (q). Each value is a separate query slice; results are deduplicated by event ID.",
"editor": "stringList",
"items": {
"type": "string"
},
"title": "Keywords",
"type": "array"
},
"location": {
"description": "Legacy city/region slug used when startUrls and locations are empty, e.g. ny--new-york, ca--san-francisco, united-states, online. Blank defaults to united-states.",
"editor": "textfield",
"title": "Location (legacy)",
"type": "string"
},
"locations": {
"default": [],
"description": "City, region, or place IDs, e.g. ny--new-york, london, united-kingdom--london, 85977539. Multiple locations run as separate queries and are deduplicated.",
"editor": "stringList",
"items": {
"type": "string"
},
"title": "Locations",
"type": "array"
},
"maxItems": {
"default": 50,
"description": "Maximum number of unique events to return across all queries. The source caps each query at 1,000 events; above 1,000 the actor splits by date, category, price, and online coverage, or scans the event sitemap when useSitemap is enabled.",
"maximum": 10000,
"minimum": 1,
"prefill": 3,
"title": "Max Items",
"type": "integer"
},
"organizerMode": {
"default": false,
"description": "Add organizer profile metrics and social links from the organizer page. Also implied by organizer URLs in startUrls. Records stay event records.",
"prefill": false,
"title": "Organizer mode",
"type": "boolean"
},
"priceFilter": {
"default": "any",
"description": "Free or paid events. Uses the search API's price filter and is checked again client-side.",
"editor": "select",
"enum": [
"any",
"free",
"paid"
],
"enumTitles": [
"Any price",
"Free only",
"Paid only"
],
"title": "Price",
"type": "string"
},
"proxyConfiguration": {
"description": "Optional. Never required. The actor works from a datacenter IP by default; an AUTO proxy is supported. No residential proxy or login is used.",
"editor": "proxy",
"title": "Proxy configuration",
"type": "object"
},
"sort": {
"default": "relevance",
"description": "Relevance keeps Eventbrite's default order. date is experimental and ascending only: it sends event_search.sort=date and forces the search API path. Ordering is by start date; same-day times may vary. Descending order is not supported.",
"editor": "select",
"enum": [
"relevance",
"date"
],
"enumTitles": [
"Relevance (default)",
"Date (experimental, ascending)"
],
"title": "Sort",
"type": "string"
},
"startUrls": {
"default": [],
"description": "Eventbrite browse URLs (e.g. https://www.eventbrite.com/d/ny--new-york/all-events/), direct event URLs (/e/...), or organizer URLs (/o/...). Accepts URL strings and {\"url\": ...} objects. When set, this wins over the filter fields.",
"editor": "requestListSources",
"items": {
"properties": {
"url": {
"description": "Page URL to scrape.",
"title": "URL",
"type": "string"
}
},
"type": "object"
},
"prefill": [
{
"url": "https://www.eventbrite.com/d/united-states/all-events/"
}
],
"title": "Start URLs",
"type": "array"
},
"useSitemap": {
"default": false,
"description": "Only for runs above 1,000. Scan Eventbrite's event sitemaps (about 201,000 event IDs) and hydrate in batches instead of splitting search queries. Filters are applied client-side. Ignored with startUrls or maxItems <= 1,000.",
"prefill": false,
"title": "Broad sitemap discovery",
"type": "boolean"
}
},
"required": [],
"schemaVersion": 1,
"title": "Eventbrite Scraper Input",
"type": "object"
}
Output schema
Published result links and storage locations. This schema is not an exhaustive contract for every field in a dataset record.
| Field | Type | Required | Description |
|---|---|---|---|
events | string | optional | Dataset of event records. Fields without a source value are omitted, never null or blank; 0,0 coordinates are never emitted. |
Download the published output schema
View complete JSON
{
"actorOutputSchemaVersion": 1,
"description": "Omit-empty Eventbrite event records with dates, UTC times, venue address and geocoordinates, images, taxonomy, organizer profile, ticket price and availability, and optional detail fields.",
"properties": {
"events": {
"description": "Dataset of event records. Fields without a source value are omitted, never null or blank; 0,0 coordinates are never emitted.",
"template": "{{links.apiDefaultDatasetUrl}}/items",
"title": "Eventbrite Events",
"type": "string"
}
},
"title": "Eventbrite Event Finder with Venue Geocoordinates Output",
"type": "object"
}
Dataset schema
Published dataset views and any declared field definitions. A view can select only a subset of the returned record fields.
Download the published dataset schema
View complete JSON
{
"actorSpecification": 1,
"description": "Event records are omit-empty: fields without a source value are absent, never null, blank, or 0,0 coordinates. Some fields are conditional on includeDetails or organizerMode.",
"fields": {
"properties": {
"ageRestriction": {
"description": "Age restriction; requires includeDetails",
"type": "string"
},
"category": {
"description": "Eventbrite category display name",
"type": "string"
},
"categoryId": {
"description": "Eventbrite category ID",
"type": "string"
},
"changedAt": {
"description": "Last changed timestamp (ISO 8601 UTC); requires includeDetails",
"type": "string"
},
"createdAt": {
"description": "Creation timestamp (ISO 8601 UTC); requires includeDetails",
"type": "string"
},
"descriptionHtml": {
"description": "Full description HTML; requires includeDetails",
"type": "string"
},
"doorTime": {
"description": "Door time; requires includeDetails",
"type": "string"
},
"durationInMinutes": {
"description": "Duration in minutes; requires includeDetails",
"type": "integer"
},
"eid": {
"description": "Short Eventbrite eID when supplied",
"type": "string"
},
"endDate": {
"description": "End date (YYYY-MM-DD, local)",
"type": "string"
},
"endTime": {
"description": "End time (HH:MM, local)",
"type": "string"
},
"endUtc": {
"description": "End timestamp in ISO 8601 UTC with Z",
"type": "string"
},
"facebookEventId": {
"description": "Conditional Facebook event ID from the event API; omitted when null (about 2% fill)",
"type": "string"
},
"faqs": {
"description": "Event FAQs; requires includeDetails",
"items": {
"properties": {
"answer": {
"type": "string"
},
"question": {
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"format": {
"description": "Event format display name",
"type": "string"
},
"formatId": {
"description": "Eventbrite format ID",
"type": "string"
},
"gallery": {
"description": "Event image URLs in descending quality: master, large, medium, small, display",
"items": {
"type": "string"
},
"type": "array"
},
"hasAvailableTickets": {
"description": "Whether tickets are available",
"type": "boolean"
},
"hasBogoTickets": {
"description": "Whether BOGO tickets are offered",
"type": "boolean"
},
"id": {
"description": "Eventbrite event ID",
"type": "string"
},
"imageSizesLarge": {
"description": "Large image variant only when it adds a URL not already present in gallery",
"type": "string"
},
"imageUrl": {
"description": "Highest-resolution cover image; signed CDN URL, never rewritten",
"type": "string"
},
"inventoryType": {
"description": "Inventory type, e.g. limited; requires includeDetails",
"type": "string"
},
"isCancelled": {
"description": "Whether Eventbrite marks the event cancelled; omitted when unknown",
"type": "boolean"
},
"isFree": {
"description": "Whether the event is free; known false is kept",
"type": "boolean"
},
"isListed": {
"description": "Whether the event is listed",
"type": "boolean"
},
"isOnline": {
"description": "Whether the event is online",
"type": "boolean"
},
"isProtected": {
"description": "Whether the event is protected",
"type": "boolean"
},
"isReservedSeating": {
"description": "Whether the event has reserved seating; requires includeDetails",
"type": "boolean"
},
"isSeries": {
"description": "Whether the event belongs to a series",
"type": "boolean"
},
"isShareable": {
"description": "Whether the event is shareable",
"type": "boolean"
},
"isSoldOut": {
"description": "Whether the event is sold out",
"type": "boolean"
},
"language": {
"description": "Listing language code",
"type": "string"
},
"latitude": {
"description": "Venue latitude; omitted unless valid and not part of 0,0",
"type": "number"
},
"locationHierarchy": {
"description": "Eventbrite place hierarchy (continent, country, region, county, locality, neighbourhood)",
"items": {
"properties": {
"name": {
"type": "string"
},
"type": {
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"locationType": {
"description": "in_person, online, or another source value; requires includeDetails",
"type": "string"
},
"longitude": {
"description": "Venue longitude; omitted unless valid and not part of 0,0",
"type": "number"
},
"name": {
"description": "Event name",
"type": "string"
},
"numChildren": {
"description": "Exact series object_count from the series API when expanded; otherwise the source count when greater than one",
"type": "integer"
},
"organizerAttendeesHosted": {
"description": "Organizer attendees hosted as displayed; organizerMode only",
"type": "string"
},
"organizerFacebook": {
"description": "Organizer Facebook page",
"type": "string"
},
"organizerFollowers": {
"description": "Numeric follower count from hydration",
"type": "integer"
},
"organizerHostingYears": {
"description": "Organizer hosting tenure as displayed; organizerMode only",
"type": "string"
},
"organizerImageUrl": {
"description": "Organizer profile image URL",
"type": "string"
},
"organizerInstagram": {
"description": "Organizer Instagram profile or ID",
"type": "string"
},
"organizerName": {
"description": "Organizer name",
"type": "string"
},
"organizerSummary": {
"description": "Organizer summary or bio",
"type": "string"
},
"organizerTikTok": {
"description": "Organizer TikTok profile URL",
"type": "string"
},
"organizerTotalEvents": {
"description": "Organizer total events; organizerMode only",
"type": "integer"
},
"organizerTwitter": {
"description": "Organizer Twitter/X handle or URL from hydration",
"type": "string"
},
"organizerUpcomingTotal": {
"description": "Organizer upcoming-event count; organizerMode only",
"type": "integer"
},
"organizerUrl": {
"description": "Organizer profile URL",
"type": "string"
},
"organizerVerified": {
"description": "Organizer verified flag; organizerMode only",
"type": "boolean"
},
"organizerWebsite": {
"description": "Organizer website",
"type": "string"
},
"organizerX": {
"description": "Organizer X profile URL",
"type": "string"
},
"priceCurrency": {
"description": "ISO 4217 currency code",
"type": "string"
},
"priceDisplay": {
"description": "Eventbrite price display string",
"type": "string"
},
"priceMax": {
"description": "Maximum ticket price in major units",
"type": "number"
},
"priceMin": {
"description": "Minimum ticket price in major units; omitted when the source has no fixed price",
"type": "number"
},
"primaryOrganizerId": {
"description": "Organizer ID",
"type": "string"
},
"privacySetting": {
"description": "Eventbrite privacy setting",
"type": "string"
},
"publishedAt": {
"description": "Published timestamp (ISO 8601 UTC)",
"type": "string"
},
"recordType": {
"description": "Always event",
"type": "string"
},
"refundPolicy": {
"description": "Refund policy; requires includeDetails",
"properties": {
"isRefundAllowed": {
"type": "boolean"
},
"policyType": {
"type": "string"
},
"refundRequestOrganizer": {
"type": "boolean"
},
"validDays": {
"type": "integer"
}
},
"type": "object"
},
"salesEndUtc": {
"description": "Sales end timestamp (ISO 8601 UTC)",
"type": "string"
},
"salesMessage": {
"description": "Sales message when Eventbrite supplies one",
"type": "string"
},
"salesStartUtc": {
"description": "Sales start timestamp (ISO 8601 UTC)",
"type": "string"
},
"salesStatus": {
"description": "Sales status, e.g. on_sale, sales_ended, sold_out",
"type": "string"
},
"scrapedAt": {
"description": "ISO 8601 UTC timestamp of when the run started; the same on every record",
"type": "string"
},
"seriesId": {
"description": "Series ID for series children and parents",
"type": "string"
},
"sourceUrl": {
"description": "Canonical event page URL used as provenance",
"type": "string"
},
"startDate": {
"description": "Start date (YYYY-MM-DD, local to the event)",
"type": "string"
},
"startTime": {
"description": "Start time (HH:MM, local)",
"type": "string"
},
"startUtc": {
"description": "Start timestamp in ISO 8601 UTC with Z",
"type": "string"
},
"status": {
"description": "Eventbrite status, e.g. live or completed",
"type": "string"
},
"subcategory": {
"description": "Eventbrite subcategory display name",
"type": "string"
},
"subcategoryId": {
"description": "Eventbrite subcategory ID",
"type": "string"
},
"summary": {
"description": "Short summary, truncated to 1,000 characters",
"type": "string"
},
"tags": {
"description": "Organizer keyword tags",
"items": {
"type": "string"
},
"type": "array"
},
"ticketClasses": {
"description": "Ticket classes; requires includeDetails",
"items": {
"properties": {
"category": {
"type": "string"
},
"currency": {
"type": "string"
},
"deliveryMethods": {
"items": {
"type": "string"
},
"type": "array"
},
"description": {
"type": "string"
},
"fee": {
"type": "number"
},
"hasPdfTicket": {
"type": "boolean"
},
"id": {
"type": "string"
},
"includeFee": {
"type": "boolean"
},
"isFree": {
"type": "boolean"
},
"maxQuantity": {
"type": "integer"
},
"minQuantity": {
"type": "integer"
},
"name": {
"type": "string"
},
"onSaleStatus": {
"type": "string"
},
"price": {
"type": "number"
},
"salesChannels": {
"items": {
"type": "string"
},
"type": "array"
},
"tax": {
"type": "number"
}
},
"type": "object"
},
"type": "array"
},
"ticketsBy": {
"description": "Ticket provider name",
"type": "string"
},
"ticketsUrl": {
"description": "Eventbrite checkout URL; stored only and never fetched",
"type": "string"
},
"timezone": {
"description": "IANA timezone (e.g. America/New_York)",
"type": "string"
},
"urgencySignals": {
"description": "Eventbrite urgency messages from browse/search",
"items": {
"type": "string"
},
"type": "array"
},
"url": {
"description": "Canonical event page URL (regional TLD when Eventbrite redirects)",
"type": "string"
},
"venueAddress": {
"description": "Full display address",
"type": "string"
},
"venueAddressLine1": {
"description": "Venue street address line 1",
"type": "string"
},
"venueAddressLine2": {
"description": "Venue street address line 2",
"type": "string"
},
"venueCity": {
"description": "Venue city",
"type": "string"
},
"venueCountry": {
"description": "Venue country code",
"type": "string"
},
"venueName": {
"description": "Primary venue name",
"type": "string"
},
"venuePostalCode": {
"description": "Venue postal code",
"type": "string"
},
"venueRegion": {
"description": "Venue state/region",
"type": "string"
},
"waitlistAvailable": {
"description": "Whether a waitlist is available; requires includeDetails",
"type": "boolean"
}
},
"type": "object"
},
"title": "Eventbrite Events",
"views": {
"detailed": {
"display": {
"component": "table",
"properties": {
"category": {
"format": "text",
"label": "Category"
},
"endDate": {
"format": "text",
"label": "End Date"
},
"endTime": {
"format": "text",
"label": "End Time"
},
"endUtc": {
"format": "text",
"label": "End UTC"
},
"format": {
"format": "text",
"label": "Format"
},
"id": {
"format": "text",
"label": "ID"
},
"imageUrl": {
"format": "link",
"label": "Image"
},
"isCancelled": {
"format": "boolean",
"label": "Cancelled"
},
"isFree": {
"format": "boolean",
"label": "Free"
},
"isOnline": {
"format": "boolean",
"label": "Online"
},
"latitude": {
"format": "number",
"label": "Lat"
},
"longitude": {
"format": "number",
"label": "Lng"
},
"name": {
"format": "text",
"label": "Name"
},
"organizerName": {
"format": "text",
"label": "Organizer"
},
"priceCurrency": {
"format": "text",
"label": "Currency"
},
"priceMax": {
"format": "number",
"label": "Price Max"
},
"priceMin": {
"format": "number",
"label": "Price Min"
},
"primaryOrganizerId": {
"format": "text",
"label": "Organizer ID"
},
"salesStatus": {
"format": "text",
"label": "Sales"
},
"scrapedAt": {
"format": "text",
"label": "Scraped At"
},
"startDate": {
"format": "text",
"label": "Start Date"
},
"startTime": {
"format": "text",
"label": "Start Time"
},
"startUtc": {
"format": "text",
"label": "Start UTC"
},
"summary": {
"format": "text",
"label": "Summary"
},
"ticketsUrl": {
"format": "link",
"label": "Tickets"
},
"timezone": {
"format": "text",
"label": "TZ"
},
"url": {
"format": "link",
"label": "URL"
},
"venueAddress": {
"format": "text",
"label": "Address"
},
"venueCity": {
"format": "text",
"label": "City"
},
"venueCountry": {
"format": "text",
"label": "Country"
},
"venueName": {
"format": "text",
"label": "Venue"
},
"venuePostalCode": {
"format": "text",
"label": "Postal"
},
"venueRegion": {
"format": "text",
"label": "Region"
}
}
},
"title": "Detailed Results",
"transformation": {
"fields": [
"id",
"name",
"summary",
"startDate",
"startTime",
"endDate",
"endTime",
"timezone",
"startUtc",
"endUtc",
"isOnline",
"isCancelled",
"venueName",
"venueAddress",
"venueCity",
"venueRegion",
"venueCountry",
"venuePostalCode",
"latitude",
"longitude",
"category",
"format",
"primaryOrganizerId",
"organizerName",
"isFree",
"priceMin",
"priceMax",
"priceCurrency",
"salesStatus",
"imageUrl",
"url",
"ticketsUrl",
"scrapedAt"
]
}
},
"organizer": {
"display": {
"component": "table",
"properties": {
"name": {
"format": "text",
"label": "Event"
},
"organizerFollowers": {
"format": "number",
"label": "Followers"
},
"organizerInstagram": {
"format": "text",
"label": "Instagram"
},
"organizerName": {
"format": "text",
"label": "Organizer"
},
"organizerTotalEvents": {
"format": "number",
"label": "Total Events"
},
"organizerUpcomingTotal": {
"format": "number",
"label": "Upcoming"
},
"organizerUrl": {
"format": "link",
"label": "Organizer URL"
},
"organizerWebsite": {
"format": "link",
"label": "Website"
},
"startDate": {
"format": "text",
"label": "Date"
},
"url": {
"format": "link",
"label": "Event URL"
}
}
},
"title": "Organizer View",
"transformation": {
"fields": [
"name",
"startDate",
"organizerName",
"organizerFollowers",
"organizerUrl",
"organizerWebsite",
"organizerInstagram",
"organizerTotalEvents",
"organizerUpcomingTotal",
"url"
]
}
},
"overview": {
"display": {
"component": "table",
"properties": {
"category": {
"format": "text",
"label": "Category"
},
"isFree": {
"format": "boolean",
"label": "Free"
},
"name": {
"format": "text",
"label": "Name"
},
"startDate": {
"format": "text",
"label": "Date"
},
"startTime": {
"format": "text",
"label": "Time"
},
"url": {
"format": "link",
"label": "URL"
},
"venueCity": {
"format": "text",
"label": "City"
},
"venueName": {
"format": "text",
"label": "Venue"
},
"venueRegion": {
"format": "text",
"label": "Region"
}
}
},
"title": "Overview",
"transformation": {
"fields": [
"name",
"startDate",
"startTime",
"venueName",
"venueCity",
"venueRegion",
"category",
"isFree",
"url"
]
}
}
}
}
Key-value schema
Published key-value store definitions, when provided by this build.
This definition is not present in the default published build. See the published README for available documentation.
Published README
Read the full published documentation
Eventbrite Event Finder with Venue Geocoordinates
Find public Eventbrite events by browse URL, keyword, city, country, category, format, date window, price, or online/in-person status. Each event record includes local and UTC times, venue address and geocoordinates, images, taxonomy, organizer profile, ticket pricing and availability, and — with includeDetails — descriptions, ticket classes, refunds, age restrictions, and series data.
The actor is cookieless: no account, login, user cookie, or proxy setup is required. It reads only publicly accessible Eventbrite pages and never visits checkout.
What this actor does
- Flexible discovery: start from Eventbrite browse, event, or organizer URLs, or search by keyword, city, region, place ID, and country.
- Precise filters: exact Eventbrite categories and formats, date presets or a custom date range, free/paid, in-person/online, and relevance or date ordering.
- Venue detail: full street address, city, region, country, postal code, geocoordinates, and the Eventbrite place hierarchy.
- Optional enrichment: ticket prices, availability and sales status, organizer profile and social links, series counts, and full descriptions, refunds, FAQs, age limits, and door times.
- Empty fields are omitted: records never contain
null, blank strings, empty lists or objects,0,0coordinates, or NaN.
Output per event
Records are omit-empty. If Eventbrite does not supply a value, that field is absent. Real false and 0 values are kept, so isFree: false and a free priceMin: 0 are preserved.
id,eid,recordType,sourceUrl— event identity and provenance;recordTypeis alwaysevent.name,summary,url,ticketsUrl— event title, short summary (capped at 1,000 characters), canonical page URL, and stored checkout URL.startDate,startTime,endDate,endTime,timezone— local dates, localHH:MMtimes, and the IANA timezone.startUtc,endUtc,durationInMinutes— ISO 8601 UTC timestamps and duration; duration requiresincludeDetails.isOnline,isCancelled,isProtected,status,publishedAt,createdAt,changedAt,privacySetting,isListed,isShareable,locationType— status and visibility flags.venueName,venueAddress,venueAddressLine1,venueAddressLine2,venueCity,venueRegion,venueCountry,venuePostalCode,latitude,longitude— venue name and full postal address with geocoordinates.locationHierarchy[]— Eventbrite place hierarchy, withtypeandnamefor each level.imageUrl,gallery[],imageSizesLarge— primary image, image gallery in descending quality, and the large variant when it is not already in the gallery.category,categoryId,subcategory,subcategoryId,format,formatId,tags[]— taxonomy display names and IDs;tagsholds organizer keyword tags.primaryOrganizerId,organizerName,organizerUrl,organizerFollowers,organizerSummary,organizerWebsite,organizerTwitter,organizerFacebook,organizerInstagram,organizerX,organizerTikTok,organizerImageUrl— organizer profile and social links.organizerTotalEvents,organizerHostingYears,organizerAttendeesHosted,organizerVerified,organizerUpcomingTotal— organizer metrics;organizerModeonly.isFree,isSoldOut,hasAvailableTickets,hasBogoTickets,priceMin,priceMax,priceCurrency,priceDisplay,salesStatus,salesStartUtc,salesEndUtc,salesMessage,waitlistAvailable,ticketsBy— ticket pricing, availability, and sales windows.ticketClasses[]— ticket classes withid,name,description,price,fee,tax,currency,isFree,includeFee,deliveryMethods[],hasPdfTicket,minQuantity,maxQuantity,onSaleStatus,category, andsalesChannels[]; requiresincludeDetails.descriptionHtml,ageRestriction,doorTime,refundPolicy,faqs[],inventoryType,isReservedSeating,facebookEventId— detail-page enrichment; requiresincludeDetails.refundPolicyincludespolicyType,isRefundAllowed,validDays, andrefundRequestOrganizer; each FAQ hasquestionandanswer.seriesId,isSeries,numChildren— series membership and, when expanded from a parent event URL, the exact number of child events.urgencySignals[],language,scrapedAt— Eventbrite demand messages, listing language, and the UTC timestamp when the run started.
Dates are local to the event; UTC fields use ISO 8601 with Z. Prices are decimal major units with an ISO 4217 currency, including zero-decimal currencies such as JPY and three-decimal currencies such as KWD. Image URLs are signed Eventbrite CDN links and are left unchanged.
Input
No field is required. With an empty input, the actor browses all United States events and returns up to 50 records.
| Field | Type | Default | Description |
|---|---|---|---|
startUrls |
array of {url} |
[] (prefill: US all-events) |
Eventbrite browse (/d/...), event (/e/...), or organizer (/o/...) URLs. Plain URL strings and {"url": ...} objects are both accepted. When set, this wins over the filter fields. |
location |
string | – | Legacy city/region slug used when startUrls and locations are empty, e.g. ny--new-york or united-states. Blank means united-states. |
category |
string | – | Legacy category slug. Used alone, it runs as a keyword query for backward compatibility. Use categories for exact taxonomy filtering. |
maxItems |
integer | 50 (prefill 3) |
Maximum unique events across all queries, 1–10,000. |
keywords |
array of strings | [] |
Keyword queries. Each value runs as a separate slice and results are deduplicated by event ID. |
locations |
array of strings | [] |
City, region, or place IDs, e.g. ny--new-york, london, or 85977539. Multiple values run separately and are deduplicated. |
country |
select | any |
ISO country filter, combined with locations when possible. |
categories |
array of strings | [] |
Exact Eventbrite category names or IDs. Unknown values are skipped with a warning. |
format |
select | any |
Exact Eventbrite format. |
datePreset |
select | any |
any, today, tomorrow, this_week, this_weekend, next_week, this_month, next_month, or custom. |
dateFrom |
date | – | Start date in YYYY-MM-DD; used only with datePreset=custom. |
dateTo |
date | – | End date in YYYY-MM-DD; used only with datePreset=custom. |
priceFilter |
select | any |
any, free, or paid. |
eventType |
select | any |
any, in_person, or online. |
sort |
select | relevance |
relevance keeps Eventbrite's default order. date is experimental and ascending only. |
organizerMode |
boolean | false |
Adds organizer metrics and social links from the organizer page. Organizer URLs imply it. Records stay event records. |
includeDetails |
boolean | false |
Adds description, ticket classes, refunds, age, door time, duration, inventory flags, exact series counts, and the conditional Facebook event ID. Slower than the default run. |
useSitemap |
boolean | false |
For runs above 1,000 only. Reads Eventbrite's event sitemaps and matches events instead of splitting search queries. Filters are applied after collection. Ignored with startUrls or maxItems ≤ 1,000. |
proxyConfiguration |
object | – | Optional. The actor works without a proxy; an Apify AUTO proxy is supported. Never required. |
Example: browse all upcoming US events
{
"startUrls": [
{ "url": "https://www.eventbrite.com/d/united-states/all-events/" }
],
"maxItems": 50
}
Example: keyword search in a city
{
"keywords": ["jazz"],
"locations": ["ny--new-york"],
"maxItems": 100
}
Example: exact category, format, and custom date range
{
"locations": ["london"],
"country": "GB",
"categories": ["Music"],
"format": "Concert or Performance",
"datePreset": "custom",
"dateFrom": "2026-12-01",
"dateTo": "2026-12-31",
"maxItems": 200
}
Example: direct event URL with full details
{
"startUrls": [
{ "url": "https://www.eventbrite.com/e/example-event-tickets-127257012149" }
],
"includeDetails": true,
"maxItems": 1
}
Use cases
- Event discovery sites and local guides — build city, category, or date-focused event calendars.
- Venue and travel planning — map events by address and geocoordinates for visitors and transportation teams.
- Market and competitive research — compare event calendars, pricing, formats, and organizers across markets.
- Sponsorship and vendor prospecting — find events and organizers that match a target audience or industry.
- Newsletters and local media — pull upcoming events for weekly roundups and community listings.
- Civic and academic research — study public event activity by place, category, price, and date.
Limitations
- 1,000 events per query is a server-side cap. Any single search query stops at 1,000 unique events. Leaving
useSitemapoff splits large runs by date, category, price, and online coverage. SettinguseSitemap=truewithmaxItemsabove 1,000 scans the event sitemap (about 201,000 event IDs) for broader reach. - Some values are not public. Eventbrite does not expose attendee counts, public save counts, event capacity, ticket-class capacity, organizer email, or organizer phone. These fields are omitted rather than estimated.
facebookEventIdis conditional. It appears only when Eventbrite supplies a value, which is uncommon, and requiresincludeDetails=true.sort=dateis experimental and ascending only. Descending order is not available.- Some prices are unavailable. Pay-what-you-want and similar events may have no fixed price; those fields are omitted rather than set to
0. - Detail fields require opt-in. Full descriptions, refunds, age restrictions, door times, ticket classes, and the Facebook event ID require
includeDetails=true. - No login-only or cross-platform data. The actor does not collect private events, attendee lists, or events from other ticketing platforms.
- Regional domains may redirect. Non-US event URLs can resolve to a regional Eventbrite domain;
urlandsourceUrlreflect the final page. - Sitemap filtering is best-effort. The sitemap does not carry filter metadata, so keyword and location matching after sitemap discovery is approximate.
Robots and terms of use
This actor reads public event, venue, organizer, and sitemap pages and never accesses Eventbrite checkout. Eventbrite's robots.txt and Terms of Service, including their rules on automated access, may restrict some collection methods. Review those rules and any applicable law before running the actor, and use the data responsibly. You are responsible for confirming that your use complies with Eventbrite's terms.
FAQ
Do I need to log in or provide a proxy?
No. The actor needs no account, login, cookie, or proxy. A proxy is optional.
Why are some fields missing?
Records are omit-empty by design. A missing field means Eventbrite did not provide that value for that event. Unknown booleans and prices are never invented.
Why did I get fewer than maxItems results?
The source may have run out of matching events, a single query may have reached the 1,000-event cap, or Eventbrite may have temporarily limited the run. The run's status message reports the reason and the number of unique events found.
How do I get descriptions, ticket classes, refunds, and FAQs?
Set includeDetails=true. This adds the event detail data, including ticket classes, refund policy, age restriction, door time, duration, and FAQs. The Facebook event ID remains absent unless Eventbrite supplies it.
Does sort=date work everywhere?
It works when the actor uses Eventbrite's search results, which happens automatically when this option is set. Only ascending order is supported, and events on the same day may not be ordered by time.
How do I collect more than 1,000 events?
Leave useSitemap off to split the work by date, category, price, and online coverage, or set maxItems above 1,000 and enable useSitemap to scan Eventbrite's event sitemap.
What is the difference between a category and an organizer tag?
categories uses Eventbrite's official category taxonomy. tags in the output contains organizer-defined keyword tags, which are free-form and may vary between events.
Are venue coordinates always present?
No. Coordinates are included only when Eventbrite provides a valid latitude and longitude. Missing or invalid values, including 0,0, are omitted.
Is this actor affiliated with Eventbrite?
No. This is an independent third-party actor and is not endorsed by or affiliated with Eventbrite.
Python quickstart
Use a schema-derived input and the Python standard library to start a run. An Apify account and token are required for execution.
Source build cuKxsoljlR97VIqrd. Documentation is regenerated from the default published build; private drafts are not included.