Eventspan.com API Documentation

Eventspan.com API -> /web_service/event/search

Method: /web_service/event/search

Given an event ID, returns the results of a search for an event. See http://www.eventspan.com/search?q=Nullam&substate=upcoming&state=events for an example interface.

Arguments

developer_key: This is the developer key attached to a user account, used to authenticate access to the database.
term: This is the search term for the events
state: This is the state for the events

Example Request

Here's an example request URL:

http://www.eventspan.com/web_service/event/search/(state)/(term)?developer_key=(developer_key)
http://www.eventspan.com/web_service/event/search/upcoming/Nullam?developer_key=v31nuqs024m3z22o0s0sov4mnpvntuu

Output Parameters

The output of this function is an XML block with the following parameters representing the event

response string

The Response to the method request

status string

The Response Status

message string

The Response Message

searchResults string

The results for the search. Each search result includes:

url string

Link to the EventSpan listing for this event

title string

Title of the Search Result

subTitle string

Subtitle of the Search Result

startTime datetime

The start date and time for this web event. (Use ISO 8601 per W3C.org)

endTime datetime

The end date and time for this web event. (Use ISO 8601 per W3C.org)

preferredTimeZone string

Preferred time zone for publishing this web event listing. (Use standard tz (Olsen) values - http://www.twinsun.com/tz/tz-link.htm)

eventLink string

URL link to the web event or registration area for the web event

featuredEventHost string

The featured event host for the site. The featured event host contains:

logoUrl string: a link to the URL for the company logo
url string: a link to the company's page on Eventspan

tags string

Tags related to the subject matter for this web event

featuredPresenter string

The featured presenter for the event. The featured presenter contains:

url string: The URL for the presenter's company
headshotUrl string: The presenter's image

Sample Codes

<response xsi:noNamespaceSchemaLocation="response.xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <status>Success</status>
  <message>Search Results Received</message>
  <searchResults>
    <resultContentType>WebEvents</resultContentType>
    <resultContentSubType>upcoming</resultContentSubType>
    <resultSize>21</resultSize>
    <searchResult>
      <title>Morbi non erat non ipsum pharetra tempus nullam vitae sem</title>
	  <url>http://www.eventspan.com/event/m3shg5snp</url>
      <subTitle>Nullam vitae sem at nunc pharetra ultricies phasellus i</subTitle>
      <startTime>2007-07-22T15:34:05Z</startTime>
      <endTime>2007-07-22T17:34:05Z</endTime>
      <preferredTimeZone>Eastern Time (US & Canada)</preferredTimeZone>
      <eventLink>http://ebay.com</eventLink>
      <featuredEventHost>
        <logoUrl>http://www.eventspan.com/event_accommodater/image/0000/0071/thumb7.gif</logoUrl>
        <url>http://www.eventspan.com/events/host/m31o1n2u1np</url>
      </featuredEventHost>
      <tags>nfl</tags>
      <tags>freeclipart</tags>
      <tags>mortgagecalculator</tags>
      <tags>fitness</tags>
      <tags>depression</tags>
      <featuredPresenter>
        <url>http://www.eventspan.com/events/speaker/event_person/zt1nttu1q12</url>
        <headshotUrl>http://www.eventspan.com/event_person/headshot/0000/0075/headshot_large/hs33.jpg</headshotUrl>
      </featuredPresenter>
    </searchResult>
    ...
  </searchResults>
</response>

Error Codes

This method may return these errors

authentication error: Your developer key did not authenticate correctly. Please try again.
missing parameter: A parameter is missing from the request.
no results: No results have been found for your request.