Back to Events

event_search

This method uses our search index to find publicly listed events.

For your events to be included in our search results, they must include an organizer profile, a valid venue address, and must have available ticket types. The event must also be marked as both ‘public’ and ‘live’.

No additional user access tokens are required for this method, but you must supply your application key.

RSS feeds of public event data are also available from any of our directory search result pages.

Request Parameters

Name description
keywords The search keywords. To run an OR search, you need this format:
“keywords=google%20OR%20multimedia”
category Event categories (comma seperated): conferences, conventions, entertainment, fundraisers, meetings, other, performances, reunions, sales, seminars, social, sports, tradeshows, travel, religion, fairs, food, music, recreation.
address The venue address.
city The venue city.
region The venue state/province/county/territory depending on the country. 2-letter state code is required for US addresses.
postal_code The postal/zip code of the venue.
country 2-letter country code, according to the ISO 3166 format.
within If “within” is set and the “city” or “zipcode” resolve to a specific geolocation, the search will be restricted to the specified within radius. The sorting default will be set to “distance”.
within_unit If within is set, you can specify the unit to use: “M” for miles, or “K” for kilometers. By default, the API will use miles.
latitude If “within” is set you can limit your search to wgs84 coordinates (latitude, Longitude).
longitude If “within” is set you can limit your search to wgs84 coordinates (latitude, Longitude).
date The event start date. Limit the list of results to a date range, specified by a label or by exact dates. Currently supported labels include: “All”, “Future”, “Past”, “Today”, “Yesterday”, “Last Week”, “This Week”, “Next week”, “This Month”, “Next Month” and months by name, e.g. “October”. Exact date ranges take the form “YYYY-MM-DD YYYY-MM-DD”, e.g. “2008-04-25 2008-04-27″.
date_created The date range the event was created, specified by a label or by exact dates. Currently supported labels include: “Today”, “Yesterday”, “Last Week”, “This Week”, “This Month”. Exact date ranges take the form “YYYY-MM-DD YYYY-MM-DD”, e.g. “2008-04-25 2008-04-27″.
date_modified The date the event was last modified, specified by a label or by exact dates. Currently supported labels include: “Today”, “Yesterday”, “Last Week”, “This Week”, “This Month”. Exact date ranges take the form “YYYY-MM-DD YYYY-MM-DD”, e.g. “2008-04-25 2008-04-27″.
organizer The organizer name.
max Limit the number of events returned. Maximum limit is 100 events per page. Default is 10.
count_only Only return the total number of events (“true” or “false”). Default is “false”.
sort_by Sort the list of events by “id”, “date”, “name”, “city”. The default is “date”.
page Allows for paging through the results of a query. Default is 1.
since_id Returns events with id greater than “since_id” value. Default is 1.
tracking_link The tracking link code to add to the event URLs.

Example Request URL

https://www.eventbrite.com/xml/event_search?...&keywords=computer&city=San+Francisco&date=This+month

Example Response

<?xml version="1.0" encoding="utf-8" ?>
<events>
	<summary>
		<filters>
			<city>New York</city>
			<country>US</country>
		</filters>
		<first_event>908163459</first_event>
		<last_event>702165483</last_event>
		<total_items>10</total_items>
	</summary>
	<event>
		<id>908163459</id>
		<title>Best NYC New Year's Party</title>
		<description>Come spend New Year's Eve with us!</description>
		<category>conferences</category>
		<tags>new year, party</tags>
		<start_date>2008-12-31 20:00:00</start_date>
		<end_date>2009-01-01 06:00:00</end_date>
		<timezone>US/Eastern</timezone>
		<created>2007-11-03 12:47:06</created>
		<modified>2008-01-09 10:12:15</modified>
		<privacy>1</privacy>
		<url>http://nycparty.eventbrite.com</url>
		<logo>http://images.eventbrite.com/logos/908163459.jpg</logo>
		<logo_ssl>https://www.eventbrite.com/php/logo.php?id=908163459.jpg</logo_ssl>
		<venue>
			<id>1</id>
			<name>Madison Square Garden</name>
			<address>4 Penn Plaza</address>
			<address_2></address_2>
			<city>New York</city>
			<region>NY</region>
			<postal_code>10001</postal_code>
			<country>United States</country>
			<country_code>US</country_code>
			<Lat-Long>47.123 / 3.34</Lat-Long>
		</venue>
		<organizer>
			<id>65739440</id>
			<name>New Year's NYC Team</name>
			<description>We organizer the best parties in town!</description>
			<url>http://www.eventbrite.com/org/65739440</url>
		</organizer>
		<tickets>
			<ticket>
				<id>45264859</id>
				<name>VIP Registration</name>
				<description>Access to VIP Rooms</description>
				<type>0</type>
				<currency>USD</currency>
				<price>199.99</price>
				<start_date>2008-10-24 00:00:00</start_date>
				<end_date>2008-12-30 23:00:00</end_date>
				<quantity_available>100</quantity_available>
				<quantity_sold>0</quantity_sold>
			</ticket>
		</tickets>
	</event>
</events>

Method-Specific Errors

More information about error-handling and common error messages are available in our error docs.

error_type error_message
Authentication Error The specified user was not found or the login credentials didn’t match.
Not Found The keyword(s) provided return no event.
Country error The 2-letter country code provided is invalid.
Region error The 2-letter state code provided is invalid (US only).
DateRange error The date range provided is invalid (check document for valid values).
Date error The date provided is invalid.
Distance error Distance must be a number.
Distance error No events found within the specified distance.
Distance error Invalid unit. “M” or “K” are accepted values.
Distance error Missing city or zip code for location.