Search for events

This function looks for events fulfilling specified criteria.

Arguments:

  • auth or (user, password)

    This method requires authentication. See authentication

  • keywords (option)

    Keywords that the function will look for in event's title and description.

  • venue_name (option)

    Name of the venue where event takes place.

  • street (option)

    Name of the street where event takes place.

  • city (option)

    Name of the city where event takes place.

  • country (option)

    Name of the country where event takes place.

  • zip (option)

    Zip code of the area where event takes place.

  • date (option)

    Specifies timespan when the event took place. Default is is the current date, options:

    • past
    • all
    • today
    • this_month (this month)
    • this_year (this year)
    • name of the month or the equivalent number
      (e.g. August or 08)
    • exact range in form of two unix timestamps connected with "-"
      (e.g. 2009-01-26 20:00:00-2009-02-15 20:00:00)
    • only start date from an exact date in form of a unix timestamp with "-" character at the end
      (e.g. 2009-01-26 20:00:00-)
    • only end date to an exact date in form of a unix timestamp with "-" character at the beginning
      (e.g. -2009-01-26 20:00:00)

  • type (option)

    Type of the event, complete list of types can be found here.

  • sort_by (option)

    Sort results by (default is by date):

    • relevance (relev├óncia)
    • title
    • type
    • city
    • country

  • sort_direction (option)

    Sort results ascending or descending (ascending by default).

    • ascending
    • descending

Example Request URL:

http://www.findevent.com/api/request/"See authentication"
&function=search_event
&keywords=findevent+party
&date=this_year
&country=Canada
&sort_by=city

This is an example of an request that will look for events that contain the keywords in any given title or description and place this year in Canada, returning results sorted by city.

Response Parameters:

Response is a regular XML block.

  • num_events

    Total number of events found.

  • event

    All information about a found event is contained here.

  • id

    Unique id of the event.

  • url

    Url to this event on Findevent.

  • title

    Title of the event.

  • description

    Description of the event.

  • start_time

    Starting time of this event represented by a unix timestamp (ISO 8601).

  • end_time

    End time of the event, represented by a unix timestamp (ISO 8601).

  • place_name

    Name of the venue where the event takes place.

  • street_address

    The venue street address.

  • city

    The venue city.

  • state

    The venue state.

  • country

    The venue country.

  • zip

    The venue ZIP.

  • venue_id

    The venue ID.

  • type

    Event type. Complete list of types can be found. here.

  • event_url

    Url to the website of the company that is hosting this event.

  • phone

    Phone number.

  • images

    Contains information about images connected with this event.

  • image

    Information about a single image.

Example Response:

<?xml version="1.0" encoding="UTF-8"?>
<search_results>
   <num_events>3</num_events>
   <events>
      <event>
         <id>85510</id>
         <url> http://www.findevent.com/events/85510/Edmonton_Rush</url>
         <title>Edmonton Rush</title>
         <description>Boston Blazers at Edmonton Rush Tickets</description>
         <start_time>2009-04-18 19:30:00</start_time>
         <end_time>2009-04-18 22:30:00</end_time>
         <place_name>Rexall Place</place_name>
         <street_address>7424 118 Avenue North Wes</street_address>
         <city>Edmonton</city>
         <state>Alberta</state>
         <country>Canada</country>
         <zip>T5B4M</zip>
         <venue_id>1149</venue_id>
         <type>53</type>
         <event_url></event_url>
         <phone></phone>
         <images>
            <image>
               <small>
               <pic_url> http://www.findevent.com/small/zxc.jpg</pic_url>
               </small>
               <medium>
               <pic_url> http://www.findevent.com/medium/zxc.jpg</pic_url>
               </medium>
               <large>
               <pic_url> http://www.findevent.com/large/zxc.jpg</pic_url>
               </large>
            <image>
         </images>
      </event>
   </events>
</search_results>

Possible Errors:

  • Missing parameter either (keywords, venue_name, date, city, country, or type) must be nonempty.

Featured

Los Angeles Fashion Week

Los Angeles Fashion Week takes place each March (for fall collections) and October (for spring collections) in locations throughout the Los Angeles Area. It started in the middle of the 20th century w...

find out more!