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.
|keywords||The search keywords. To run an OR search, you need this format:
|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
<?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>
More information about error-handling and common error messages are available in our error docs.
|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.|