Showing events near Saint Paul, MN (change?)

Eventification API Documentation

Event data on Eventification is free and open for anyone to consume -- currently without any restrictions or obligations. As a community resource, we hope others will utilize these capabilities and encourage others to promote their events using Eventification.

There will be changes to this API, so if you plan on developing around it, please get in touch with Brian (brianshaler at gmail dot com), to stay up to date with any changes that might affect your usage of the API.

Endpoints

  • /api/get/events: Returns a list of events
  • /api/get/users: Returns a list of users (Not available yet)
  • /api/get/tags: Returns a list of tags (Not available yet)

Events

Events > Parameters

Parameters can be passed as GET variables and can be used together in any combination or omitted. Currently, the API returns up to 100 matching events and there is not yet pagination support.

  • upcoming: Set upcoming=false to include past events. true will set starttime (if omitted) to the current time.
  • starttime/endtime: Minimum and maximum times in number of seconds since the Unix Epoch. Events will be included if: Event.endtime > starttime AND Event.starttime < endtime
  • tag: Matches Tag.tag_code, rather than Tag.tag_text. For example, use "social-media" rather than "Social Media"
  • query: Currently matches Event.name OR Event.description with a ghetto "LIKE '%query%'" but will eventually be based on a Full Text Search index.
  • group_name: Matches Event.group_name (events that are part of the group/organization named group_name. Must include the full name exactly as it exists in the system.
  • group_id: Matches Event.group_id, the (int) ID associated with group_name.
  • venue_name: Matches events being held at Event.venue_name.
  • venue_id: Matches Event.venue_id, the (int) ID associated with venue_name.
  • owner: Matches Event.owner, which is the User.user_id of the owner/creator of the event.
  • latitude/longitude/radius: If BOTH latitude and longitude are set (radius, in miles, is optional. Default=10), only events within the radius are selected, ordered by distance. We do our best to geocode all venues. If this functionality is activated, json and xml results will contain a new property: distance.
  • format: Can be set to json, xml, rss, or ical. Default is json.
  • callback: If set, json results will be wrapped in a function. e.g. callback=foobar -> foobar({json});

Examples:

JSON of all events mentioning "social media" including past events:
http://eventification.com/api/get/events?upcoming=false&query=social%20media

iCal feed of all upcoming "technology" (tag) events near a location:
http://eventification.com/api/get/events?latitude=33.42&longitude=-111.93&radius=20&format=ical&tag=technology



Events > Output

Depending on what format is requested, data will be returned in one of the following formats:

format Output
json
{"events":[
  {"event_id":"0",
    "group":"0",
    "owner":"0",
    "name":"Event Name",
    "description":"Event Description",
    "url":"http:\/\/eventurl.com\/",
    "venue_id":"0",
    "cost":"Free",
    "status":"1",
    "starttime":"1234567890",
    "endtime":"1234567890",
    "created_date":"1234567890",
    "last_modified":"1234567890",
    "venue_name":"Venue Name",
    "address":"123 Fake St",
    "city":"City",
    "state":"AZ",
    "latitude":"33.123",
    "longitude":"-111.123",
    "group_name":"Group Name",
    "event_url":"\/event\/view\/0",
    "event_short_url":"http:\/\/evnt.us\/e0",
    "formatted_starttime":"Friday January 1, 2000 6:00pm MST",
    "formatted_endtime":"Friday January 1, 2000 8:00pm MST",
    "formatted_time":"Friday January 1, 2000 6:00pm - 8:00pm MST",
    "map":"123+Fake+St+City%2C+AZ+%28Venue+Name%29",
    "venue_info":"<strong>Venue Name<\/strong> 
      <a href=\"http:\/\/maps.google.com\/
      ?q=123%20Fake%20St%20City,%20AZ%20(Venue%20Name)\" 
      style=\"color: #445599;\">(map)<\/a>
      <br \/>123 Fake St<br \/>City, AZ",
    "tags":[
      {"tag_id":"80",
        "tag_text":"Learning",
        "tag_code":"learning"},
      {"tag_id":"48",
        "tag_text":"Entrepreneurship",
        "tag_code":"entrepreneurship"},
      {...}
    ]
  },
  {...}
]}
xml
<?xml version="1.0" encoding="UTF-8"?>
<events>
  <event>
    <event_id>0</event_id>
    <group>0</group>
    <owner>0</owner>
    <name>Event Name</name>
    <description>Event description</description>
    <url>http://eventurl.com/</url>
    <venue_id>0</venue_id>
    <cost>Free</cost>
    <status>1</status>
    <starttime>1234567890</starttime>
    <endtime>1234567890</endtime>
    <created_date>1234567890</created_date>
    <last_modified>1234567890</last_modified>
    <venue_name>Venue Name</venue_name>
    <address>123 Fake St</address>
    <city>City</city>
    <state>AZ</state>
    <latitude>33.123</latitude>
    <longitude>-111.123</longitude>
    <group_name>Group Name</group_name>
    <event_url>/event/view/0</event_url>
    <event_short_url>http://evnt.us/e0</event_short_url>
    <formatted_starttime>Friday January 1, 2000 6:00pm MST</formatted_starttime>
    <formatted_endtime>Friday January 1, 2000 8:00pm MST</formatted_endtime>
    <formatted_time>Friday January 1, 2000 6:00pm - 8:00pm MST</formatted_time>
    <map>123+Fake+St+City%2C+AZ+%28Venue+Name%29</map>
    <venue_info><strong>Venue Name</strong> 
        <a href="http://maps.google.com/?q=123 Fake St (Venue Name)" 
        style="color: #445599;">(map)</a>
        <br />123 Fake St<br />City, AZ</venue_info>
    <tags>
      <tag>
        <tag_id>80</tag_id>
        <tag_text>Learning</tag_text>
        <tag_code>learning</tag_code>
      </tag>
      <tag>
        <tag_id>48</tag_id>
        <tag_text>Entrepreneurship</tag_text>
        <tag_code>entrepreneurship</tag_code>
      </tag>
      <...>
    </tags>
  </event>
  <...>
</events>
rss
<?xml version="1.0" encoding="utf-8"?>
<rss version="2.0"
    xmlns:content="http://purl.org/rss/1.0/modules/content/"
    xmlns:wfw="http://wellformedweb.org/CommentAPI/"
    >
<channel>
<title>Eventification Events</title>
<link>http:/eventification.com/api/get/events?format=rss</link>
<description><![CDATA[Eventification Events]]></description>
<image><title>Eventification Events</title>
<link>http:/eventification.com/api/get/events?format=rss</link>
<url>http://eventification.com/public/images/app/logo.png</url>
</image>
<language>en-us</language>
<pubDate>Fri, 01 Jan 2000 00:00:00 -0700</pubDate>
<item>
<title>Event Name - Friday January 1, 2000 6:00pm MST</title>
<link>http://eventification.com/event/view/0</link>
<pubDate>Fri, 01 Jan 2000 00:00:00 -0700</pubDate>
<description><![CDATA[    
    <div style="width: 650px; border: solid 2px #063868;">
    <table width="650px" cellpadding="0" cellspacing="0">
    <tr>
    <td colspan="3" style="font-size: 14px; line-height: 1.6em;" bgcolor="#A6CBEE">
    <div style="padding: 2px 8px;">
    <a href="http://eventification.com/event/view/0" 
    style="color: #063868;"><strong>Event Name</strong></a><br />
    </div>
    </td>
    </tr>
    <tr>
    <td width="370" valign="top" style="font-size: 12px; 
    line-height: 1.4em;" bgcolor="#F2F6F9">
    <div style="padding: 2px 8px;">
    <p>Event description</p>
    </td>
    <td width="30" bgcolor="#F2F6F9"> 
    </td>
    <td width="242" valign="top" bgcolor="#F2F6F9">
    <div style="padding: 2px 8px;">
    <p>Friday January 1, 2000 6:00pm MST<br />
    <strong>Venue Name</strong> 
    <a href="http://maps.google.com/?q=123+Fake+St+City%2C+AZ+%28Venue+Name%29" 
    style="color: #445599;">(map)</a><br />123 Fake St<br />City, AZ</p>
    </div>
    </td>
    </tr>
    </table>
    </div>
    ]]></description>
<author>brian@eventification.com</author>
<guid isPermaLink="true" >http://eventification.com/event/view/0</guid>
</item>
<...>
</channel>
</rss>
ical
BEGIN:VCALENDAR
PRODID:-//Brian Shaler//Eventification//EN
VERSION:2.0
CALSCALE:GREGORIAN
METHOD:PUBLISH
X-WR-CALNAME:Eventification Calendar
X-WR-TIMEZONE:America/Phoenix
X-WR-CALDESC:Customizable iCal event feed
BEGIN:VTIMEZONE
TZID:America/Phoenix
X-LIC-LOCATION:America/Phoenix
BEGIN:STANDARD
TZOFFSETFROM:-0700
TZOFFSETTO:-0700
TZNAME:MST
DTSTART:19700101T000000
END:STANDARD
END:VTIMEZONE
BEGIN:VEVENT
DTSTART:20000101T183000Z
DTEND:20000101T193000Z
DTSTAMP:20000101T111531Z
UID:8d3h897d38hd4b8c4b786cq4b8934qb8@eventification.com
CLASS:PUBLIC
CREATED:20000101T094028Z
DESCRIPTION:Event Description 
LAST-MODIFIED:20000101T021422Z
LOCATION:123 Fake St
SEQUENCE:0
STATUS:CONFIRMED
SUMMARY:Event Name
TRANSP:OPAQUE
END:VEVENT
...
END:VCALENDAR