EventUpon API Documentation

EventUpon aggregates events from thousands of organizations. It does the work and provides a custom feed for you.

EventUpon pulls from major event sources like Meetup, EventBrite, TicketLeap, RunSignUp, Picatic and others. We also pull events from event calendars on Facebook and thousands of other websites.

EventUpon provides a simple hosted API for organizations and businesses to easily pull event information from any organization. The API returns event information: date and time, location (including geocoding), address, description, organization, registration information, etc. The API can be called by anyone with a free or paid EventUpon account. The API uses a RESTful interface and responses are formatted in XML or JSON.

Table of Contents

Method: event_calendar.list

Parameters

Example Request

Example Response

Event Processing

Method: event_calendar.list

Parameters

Name Type Required? Description
token integer Yes Token is a unique identifier associated with an EventUpon account. The token is obtained in My Dashboard => Set up API Setting
after_date string No YYYY-MM-DD. Events returned that are equal or after the specified date.
before_date string No YYYY-MM-DD .Events returned that are equal or before the specified date, including past events.
host_id integer No Match events associated with this host ID.
host_name string No Match events associated with a host whose name

matches this.

proximity string No Match events within this many miles or these geographical coordinates (format: “latitude:longitude:radius”). Radius in miles.
zip string No Match events within this many miles of this US 5-digit ZIP Code (formats: “zip” or “zip:radius”). Radius in miles.
city string No A valid city, ex: Houston
state string No A valid 2 character state or province code, ex: NH
count integer No Number of events to be returned per page (default: 50, max: 100)
page integer No Page number from result set to return (default: 1)
online integer No Filter for online events (webinars)

0 – in person events

1 – online only

skip parameter to return both types

time_format24 integer No 1 – return time in format 24h, ex: 15:00:00

Default is 12 hour format, ex: 3:00 PM

event_source string No Search for events are pulled from specified event registration source:

for ex: EventBrite

Other choices: Meetup, TicketLeap, RunSignUp, Picatic

Example Request

For XML response: http://www.eventupon.com/services/rest?method=event_calendar.list&token=<your_token>

For JSON response: http://www.eventupon.com/services/rest.json?method=event_calendar.list&token=<your_token>

The parameter <your_token> is obtained in EventUpon. See FAQ for instructions.

Example Response

<rest generator=”xml_writer” version=”1.0″>

<status>success</status>

<response>

<count>50</count>

<page>1</page>

<total>225</total>

<page_count>5</page_count>

<item id=”5328471″>

<event_id>5328471</event_id>

<title>Starting Your Business 101 – June 21</title>

<body>

<P><SPAN STYLE=”font-size: 10.0pt; font-family: ‘Arial’,sans-serif;”>Owning a business is a dream for many people. Every new business starts with an idea. This interactive workshop will help you have a step-by-step overview of what you need to do to make it happen. It will also give you the opportunity to ask questions in your own words. </SPAN></P><P><SPAN STYLE=”font-size: 10.0pt; font-family: ‘Arial’,sans-serif;”>The session will cover at a high-level:<BR>- Market research<BR>- Registering your business and choosing a business name<BR>- Essential government regulations<BR>- Business planning<BR>- Financing for small business<BR></SPAN>- Marketing and sales<BR>- Insurance<BR><SPAN STYLE=”font-family: Arial, sans-serif; font-size: 10pt; line-height: 1.6em;”><BR>Audience:<BR></SPAN><SPAN STYLE=”font-size: 10.0pt; font-family: ‘Arial’,sans-serif;”>This session is designed for those looking to start their own business, but dont know where to start. The session will help get you started on pulling together the things youll need to get your business started.</SPAN></P><P><IMG STYLE=”display: block; margin-left: auto; margin-right: auto;” ALT=”” SRC=”https://cdn.evbuc.com/eventlogos/104828191/etsponsors28201429-1.jpg”></P>

</body>

<teaser>

Owning a business is a dream for many people. Every new business starts with an idea. This interactive workshop will help you have a step-by-step overview of what you need to do to make it happen. It…

</teaser>

<start>2016-06-21 9:00 AM</start>

<end>2016-06-21 12:00 PM</end>

<tbd>0</tbd>

<allday/>

<host_orgs>

<item id=”2317697″>Enterprise Toronto</item>

</host_orgs>

<contact_name/>

<contact_email/>

<contact_phone/>

<event_url>

http://www.eventupon.com/event/starting-your-business-101-june-21/5328471

</event_url>

<original_url>

http://www.eventbrite.com/e/starting-your-business-101-june-21-tickets-24778799055?aff=ebapi

</original_url>

<image_url>

https://img.evbuc.com/http%3A%2F%2Fcdn.evbuc.com%2Fimages%2F20433363%2F105561988337%2F1%2Foriginal.jpg?h=200&w=450&rect=0%2C45%2C180%2C90&s=3eb2473ed2b751b50b08521d133156de

</image_url>

<cost>0</cost>

<location_name>Toronto City Hall</location_name>

<location_street>100 Queen St W</location_street>

<location_additional>2nd Floor, Committee Room 4</location_additional>

<location_city>Toronto</location_city>

<location_province>ON<location_province/>

<location_postal_code>M5H 2N2</location_postal_code>

<location_country>us</location_country>

<location_lat>43.647605</location_lat>

<location_lon>-79.3814</location_lon>

<event_tags/>

<categories/>

<event_logo>

http://www.eventupon.com/media/cache/resolve/medium_event_thumb/images/event/5328471-57478a4ae4c5a.jpeg

</event_logo>

<registration_url/>

<online>0</online>

<ext_source>eventbrite</ext_source>

<ext_id>24778799055</ext_id>

<created>2016-04-20 03:24:48</created>

<modified>2016-05-27 10:21:24</modified>

</item>

<additional event items>

Event Processing

EventUpon does more than just pull events for you to use in your calendar.

# Task
1 Call Event Source API’s for all events in United States and Canada (contact EventUpon for other locations)
2 Pull events from other sources:

  • Web extraction sites
  • Google calendars
  • iCal
  • Facebook
  • Manual
3 Data Quality checks
4 Data Completeness (location, organization)
5 Deduplication
6 Event Updates
7 Event Deletions
8 Geo Coding (latitude and longitude)
9 Blacklist detection
10 Categorization (availability is TBD)