API Method 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.