Eventspan.com API Documentation

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

Method: /web_service/event/get

Given an event ID, returns the event data associated with that event. See http://www.eventspan.com/event/qnsvo01tzvs for an example interface.

Arguments

developer_key
This is the developer key attached to a user account, used to authenticate access to the database.
id
This is the event's id

Example Request

Here's an example request URL:

http://www.eventspan.com/web_service/event/get/(id)?developer_key=(developer_key)
http://www.eventspan.com/web_service/event/get/vp4numqzo3v?developer_key=mpo0stmuq0ro10ouv13v30uz4sm21u4p

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
webEvent string
An external identifier, often issued by the web event service provider
language string
Language for this web event, per W3C.org
source string
Media announcement source for this web event listing
title string
Title of the Event
url string
Link to the EventSpan listing for this evnet
subTitle string
Subtitle of the event
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
onDemandboolean
Returns true if this web event is available on-demand (in a recorded mode)
onDemandUntil datetime
If this web event is available on-demand, the date it is available on-demand until. (Use YYYY-MM-DD per W3C.org)
onDemandEventLink string
If this web event is available on-demand, the URL link to view this recorded web event (if different from 'eventLink' element)
eventType string
Type of web event.
categories string
Categories for this web event.
tags string
Tags related to the subject matter for this web event
summary string
Brief summary for this web event.
description string
Full description of this web event.
intendedAudience string
Description of the intended audience for this web event
whatYouWillLearn string
A description of what the intended audience will learn by attending this web event
disclaimer string
A disclaimer or legal notice for this web event
technicalRequirements string
A description of the technical requirements to attend this web event
dialInConferenceNumber string
The dial-in audio conference number for this web event, if applicable
dialInConferencePasscode string
The dial-in audio conference number pass or pin code for this web event, if applicable
presenters string
A list of presenters for this web event. Each presenter contains:
presenterRole string
The role played by the presenter (Speaker, Moderator, Panelist, Keynote Speaker)
firstName string
The presenter's first name
middleName string
The presenter's middle name
lastName string
The presenter's last name
title string
The presenter's title
organization string
The presenter's company
biography string
The presenter's biography
website string
The presenter's website
email string
The presenter's email address
url string
The URL for the presenter's company
headshotUrl string
The presenter's image
eventContacts
A list of people who can be contacted in reference to the event. Each contact role contains:
eventContactRole
The role played by that event contact (Event Producer, Event Publicist)
firstName string
The contact's first name
middleName string
The contact's middle name
lastName string
The contact's last name
organization string
The contact's company
website string
The contact's website
email string
The contact's email address
url string
The URL for the contact's page on Eventspan
eventHosts
A list of companies who host or sponsor an event. Each event host contains:
eventHostRole string
The role this company plays (Host, Sponsor, Partner)
organization string
The company name
background string
The company's background
website string
The company's website
logoUrl string
a link to the URL for the company logo
url string
a link to the company's page on Eventspan
whitePapers
White paper, or supplemental documentation associated with the event. Each white paper contains:
title
The title of the white paper
linkUrl
The URL of the white paper
description
A Short description of the white paper

Sample Codes 

<?xml version="1.0" encoding="UTF-8"?>
<response xsi:noNamespaceSchemaLocation="response.xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <status>Success</status>
  <message>XML Message delivered successfully</message>
  <webEvent>
    <language>Hindi</language>
    <source>WebEx</source>
    <title>Phasellus in massa aliquam et nisl vel ligula consectetuer suscipit</title>
	<url>http://www.eventspan.com/event/xmrv0pnoq3o</url>
    <subTitle>Nullam egestas feugiat felis morbi non erat non ipsum pharetra tempus</subTitle>
    <startTime>2007-07-20T01:41:57Z</startTime>
    <endTime>2007-07-20T03:41:57Z</endTime>
    <preferredTimeZone></preferredTimeZone>
    <eventLink>http://yahoo.com</eventLink>
    <onDemand>true</onDemand>

    <onDemandUntil>2008-07-19</onDemandUntil>
    <onDemandEventLink>http://cnn.com</onDemandEventLink>
    <eventType>Entertainment</eventType>
    <categories>Consulting Services</categories>
    <categories>Aerospace/Aviation/Defense</categories>
    <tags>cameltoes</tags>

    <tags>freepics</tags>
    <tags>kobebryant'saccuser</tags>
    <tags>wickedweasel</tags>
    <tags>paulhamm</tags>
    <summary>Cras dictum. Maecenas ut turpis. In vitae erat ac orci dignissim eleifend. Nunc quis justo. Sed vel ipsum in purus tincidunt pharetra. Sed pulvinar, fe</summary>
    <description>Morbi non erat non ipsum pharetra tempus. Donec orci. Proin in ante. Pellentesque sit amet purus. Cras egestas diam sed ante. Etiam imperdiet urna sit amet risus. Donec ornare arcu id erat. Aliquam u\
ltrices scelerisque sem. In elit nulla, molestie vel, ornare sit amet, interdum vel, mauris. Etiam dignissim imperdiet metus. Nunc auctor bibendum eros. Maecenas porta accumsan mauris. Etiam enim enim, elementum sed, biben\
dum quis, rhoncus non, metus. Fusce neque dolor, adipiscing sed, consectetuer et, lacinia sit amet, quam. Suspendisse wisi quam, consectetuer in, blandit sed, suscipit eu, eros. Etiam ligula enim, tempor ut, blandit nec, m\
ollis eu, lectus. Nam cursus. Vivamus iaculis. Aenean risus purus, pharetra in, blandit quis, gravida a, turpis. Donec nisl. Aenean eget mi. Fusce mattis est id diam. Phasellus faucibus interdum sapien. Duis quis nunc. Sed\
 enim.</description>

    <dialInConferenceNumber>(218) 486-3898</dialInConferenceNumber>
    <dialInConferencePasscode>169456#</dialInConferencePasscode>
    <presenters>
      <presenter>
        <presenterRole>Panelist</presenterRole>
        <firstName>Suzy</firstName>
        <middleName>Burris</middleName>

        <lastName>Bidelia</lastName>
        <title>COO</title>
        <organization>Fryer, LLC</organization>
                <biography>Aliquam lectus orci, adipiscing et, sodales ac, feugiat non, lacus. Ut dictum velit nec est. Quisque posuere, purus sit amet malesuada blandit, sapien sapien auctor arcu, sed pulvinar felis mi soll\
icitudin tortor. Maecenas volutpat, nisl et dignissim pharetra, urna lectus ultrices est, vel pretium pede turpis id velit. Aliquam sagittis magna in felis egestas rutrum. Proin wisi libero, vestibulum eget, pulvinar nec, \
suscipit ut, mi. Integer in arcu ultricies leo dapibus ultricies. Sed rhoncus lobortis dolor. Suspendisse dolor. Mauris sapien velit, pulvinar non, rutrum non, consectetuer eget, metus. Morbi tincidunt lorem at urna. Etiam\
 porta. Ut mauris. Phasellus tristique rhoncus magna. Nam tincidunt consequat urna. Sed tempor.Morbi non erat non ipsum pharetra tempus. Donec orci. Proin in ante. Pellentesque sit amet purus. Cras egestas diam sed ante. E\
tiam imperdiet urna sit amet risus. Donec ornare arcu id erat. Aliquam ultrices scelerisque sem. In elit nulla, molestie vel, ornare sit amet, interdum vel, mauris. Etiam dignissim imperdiet metus.Lorem ipsum dolor sit ame\
t, consectetuer adipiscing elit. Morbi commodo, ipsum sed pharetra gravida, orci magna rhoncus neque, id pulvinar odio lorem non turpis. Nullam sit amet enim. Sus</biography>
        <website>http://fryer.com</website>
        <email>suzy.bidelia@fryer.com</email>

        <url>http://www.eventspan.com/events/speaker/speaker_profile/ttrv0pnoq3o</url>
        <headshotUrl>http://www.eventspan.com/speaker_profile/headshot/0000/0091/headshot_large/hs40.jpg</headshotUrl>
      </presenter>
    </presenters>
    <presenters>
      <presenter>
        <presenterRole>Moderator</presenterRole>

        <firstName>Willcox</firstName>
        <middleName>Strickland</middleName>
        <lastName>Lacon</lastName>
        <title>COO</title>
        <organization>Ashbaugh PLC</organization>
        <biography>Nunc auctor bibendum eros. Maecenas porta accumsan mauris. Etiam enim enim, elementum sed, bibendum quis, rhoncus non, metus. Fusce neque dolor, adipiscing sed, consectetuer et, lacinia sit amet, q\
uam. Suspendisse wisi quam, consectetuer in, blandit sed, suscipit eu, eros. Etiam ligula enim, tempor ut, blandit nec, mollis eu, lectus. Nam cursus. Vivamus iaculis. Aenean risus purus, pharetra in, blandit quis, gravida\
 a, turpis. Donec nisl. Aenean eget mi. Fusce mattis est id diam. Phasellus faucibus interdum sapien. Duis quis nunc. Sed enim.Cras dictum. Maecenas ut turpis. In vitae erat ac orci dignissim eleifend. Nunc quis justo. Sed\
 vel ipsum in purus tincidunt pharetra. Sed pulvinar, felis id consectetuer malesuada, enim nisl mattis elit, a facilisis tortor nibh quis leo. Sed augue lacus, pretium vitae, molestie eget, rhoncus quis, elit. Donec in au\
gue. Fusce orci wisi, ornare id, mollis vel, lacinia vel, massa. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas.Morbi non erat non ipsum pharetra tempus. Donec orci. Proin in a\
nte. Pellentesque sit amet purus. Cras egestas diam sed ante. Etiam imperdiet urna sit amet risus. Donec ornare arcu id erat. Aliquam ultrices scelerisque sem. In elit nulla, molestie vel, ornare sit amet, interdum vel, ma\
uris. Etiam dignissim imperdiet metus.Aliquam lectus orci, adipiscing et, sodales ac, feugiat non, lacus. Ut dictum velit nec est. Quisque posuere, purus sit amet malesuada blandit, sapien sapien auctor arcu, sed pulvinar \
felis mi sollicitudin tortor. Maecenas volutpat, nisl et dignissim pharetra, urna lectus ultrices est, vel pretium pede turpis id velit. Aliquam sagittis magna in felis egestas rutrum. Proin wisi libero, vestibulum eget, p\
ulvinar nec, suscipit ut, mi. Integer in arcu ultricies leo dapibus ultricies. Sed rhoncus lobortis dolor. Suspendisse dolor. Mauris sap</biography>

        <website>http://ashbaugh.com</website>
        <email>willcox.lacon@ashbaugh.com</email>
        <url>http://www.eventspan.com/events/speaker/speaker_profile/rmnvvtzmo0z</url>
        <headshotUrl>http://www.eventspan.com/speaker_profile/headshot/0000/0092/headshot_large/hs35.jpg</headshotUrl>
      </presenter>
    </presenters>
    <eventContacts>

      <eventContact>
        <eventContactRole>Event Publicist</eventContactRole>
        <organization>Collyn, LLC</organization>
        <website>http://collyn.com</website>
        <email>kristia.armitage@collyn.com</email>
        <url>http://www.eventspan.com/events/contact/ttrrqtzmz21</url>
              </eventContact>
    </eventContacts>
    <eventHosts>
      <eventHost>
        <eventHostRole>Partner</eventHostRole>
        <organization>Cicely, Inc.</organization>
        <background>Cras dictum. Maecenas ut turpis. In vitae erat ac orci dignissim eleifend. Nunc quis justo. Sed vel ipsum in purus tincidunt pharetra. Sed pulvinar, felis id consectetuer malesuada, enim nisl matt\
is elit, a facilisis tortor nibh quis leo. Sed augue lacus, pretium vitae, molestie eget, rhoncus quis, elit. Donec in augue. Fusce orci wisi, ornare id, mollis vel, lacinia vel, massa. Pellentesque habitant morbi tristiqu\
e senectus et netus et malesuada fames ac turpis egestas.</background>

        <website>http://amazon.com</website>
        <logoUrl>http://www.eventspan.com/event_accommodater/image/0000/0091/medium/13.gif</logoUrl>
        <url>http://www.eventspan.com/events/host/q2t3s21nzoq</url>
      </eventHost>
    </eventHosts>
    <whitePapers>
      <whitePaper>

        <title>Morbi non erat non ipsum pharetra tempus</title>
        <linkUrl>http://www.eventspan.com/download/white_paper/vq2vzs4s0n4</linkUrl>
        <description>Nullam vitae sem at nunc pharetra ultricies</description>
      </whitePaper>
    </whitePapers>
  </webEvent>
</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.
not found
The requested event is not available.