Consuming Events Data into Your Own Website Using Feeds

Note:
If you are creating a feed for a CMS Calendar Component, the instructions below do not apply. Please see our CMS Tutorial Section for more information.


If you wish to ingest feeds from data you've entered into the LiveWhale system, you may do so by referencing a URL coded to display all events entered by your Calendar Groups, or a specific Calendar Group's events.

You may also add more granularity to your feeds, for example, displaying events that have a specific Event Type, or are categorized with a specific Tag.

Feeds are available in 3 formats:

  1. RSS
  2. iCal
  3. JSON

RSS and iCal

The RSS and iCal formats assume various characteristics from their formats. For example, RSS is automatically limited to 15 items and listed in reverse-chronological order.

You can use any of the following parameters in a RSS or iCal request:

GROUPS

You may include Calendar Groups to construct the desired output. For example:

1. To feature all events in your 1 Calendar Group, use the URLs:

RSS

http://www.nyu.edu/feeds/events/rss/group/GROUP-NAME
[where GROUP-NAME is your Calendar Group's name]

iCal

http://www.nyu.edu/feeds/events/ical/group/GROUP-NAME
[where GROUP-NAME is your Calendar Group's name ]

Example:
If your Calendar Group name is "Ticket-Central", your feed URL would be constructed as:

RSS
http://www.nyu.edu/feeds/events/rss/group/Ticket-Central

iCal
http://www.nyu.edu/feeds/events/ical/group/Ticket-Central

 

2. Or, if you have 3 Calendar Groups, you could include the events for all 3 Groups with the URLs:

RSS http://www.nyu.edu/feeds/events/rss/group/GROUP-NAME1 /group/GROUP-NAME2 /group/GROUP-NAME3
iCal http://www.nyu.edu/feeds/events/ical/group/GROUP-NAME1 /group/GROUP-NAME2 /group/GROUP-NAME3

Example:
Using the 3 Calendar Groups Ticket-Central, Health-Center, and CMEP, you would construct our feed as:

RSS
http://www.nyu.edu/feeds/events/rss/group/Ticket-Central/group/Health-Center/group/CMEP

iCal
http://www.nyu.edu/feeds/events/ical/group/Ticket-Central/group/Health-Center/group/CMEP

 

TAGS

Like group parameters, tags inclusions may be repeated as often as desired. For example:

1. To feature all events in your Calendar Group with 1 specific Tag:

RSS

http://www.nyu.edu/feeds/events/rss/group/GROUP-NAME/tag/TAG-NAME
[where TAG-NAME is the Tag you wish to surface]

iCal

http://www.nyu.edu/feeds/events/ical/group/GROUP-NAME/tag/TAG-NAME
[where TAG-NAME is the Tag you wish to surface ]

Example:
To surface all events in the Ticket-Central Calendar Group with the Tag 'music':

RSS
http://www.nyu.edu/feeds/events/rss/group/Ticket-Central/tag/music

iCal
http://www.nyu.edu/feeds/events/rss/group/Ticket-Central/tag/music

2. To feature all events in your Calendar Group with 2 or more specific Tags:

RSS http://www.nyu.edu/feeds/events/rss/group/GROUP-NAME /tag/TAG-NAME1 /tag/TAG-NAME2 /tag/TAG-NAME3
iCal http://www.nyu.edu/feeds/events/ical/group/GROUP-NAME /tag/TAG-NAME1 /tag/TAG-NAME2 /tag/ TAG-NAME3

Example:
To surface all events in the Ticket-Central Calendar Group with the Tags 'music', 'arts', and 'workshop':

RSS
http://www.nyu.edu/feeds/events/rss/group/Ticket-Central/tag/music/tag/arts/tag/workshop

iCal
http://www.nyu.edu/feeds/events/rss/group/Ticket-Central/tag/music/tag/arts/tag/workshop

EVENT TYPES

Event Type inclusions behave identical to Tags.  For example:

1. To feature all events in your Calendar Group within 1 Event Type:

RSS

http://www.nyu.edu/feeds/events/rss/group/GROUP-NAME/categories/EVENT-TYPE
[where EVENT-TYPE is the event type you wish to surface]

iCal

http://www.nyu.edu/feeds/events/ical/group/GROUP-NAME/categories/EVENT-TYPE [where EVENT-TYPE is the event type you wish to surface ]

Example:
To surface all events in the Ticket-Central Calendar Group with the Event Type 'Arts':

RSS
http://www.nyu.edu/feeds/events/rss/group/Ticket-Central/categories/arts

iCal
http://www.nyu.edu/feeds/events/rss/group/Ticket-Central/categories/arts

2. To feature all events in your Calendar Group within 1 or more Event Types:

RSS http://www.nyu.edu/feeds/events/rss/group/GROUP-NAME /categories/EVENT-TYPE1 /categories/EVENT-TYPE2 /categories/EVENT-TYPE3
iCal http://www.nyu.edu/feeds/events/ical/group/GROUP-NAME /categories/EVENT-TYPE1 /categories/EVENT-TYPE2 /categories/EVENT-TYPE3

Example:
To surface all events in the Ticket-Central Calendar Group within the Event Types 'Arts', 'Programs', and 'Speakers':

RSS
http://www.nyu.edu/feeds/events/rss/group/Ticket-Central/categories/Arts/categories/Programs/categories/Speakers

iCal
http://www.nyu.edu/feeds/events/rss/group/Ticket-Central/categories/Arts/categories/Programs/categories/Speakers

MIXED QUERIES

You can create various combinations and surface events from your Calendar Group to only show a specific Event Type and then, only those events in that Event Type that have a specific Tag.  The URLs would be created as:

RSS http://www.nyu.edu/feeds/events/rss/group/GROUP-NAME /categories/EVENT-TYPE /tag/TAG-NAME
iCal http://www.nyu.edu/feeds/events/ical/group/GROUP-NAME /categories/EVENT-TYPE /tag/TAG-NAME

Example:
To surface all events in the Ticket-Central Calendar Group within the Event Type 'Programs' and the Tag 'music':

RSS
http://www.nyu.edu/feeds/events/rss/group/Ticket-Central/categories/Programs/tag/music

iCal
http://www.nyu.edu/feeds/events/rss/group/Ticket-Central/categories/Programs/tag/music

JSON

JSON has the most robust response within the LiveWhale API. All of the above RSS and iCal parameters work with JSON and in addition, you may also utilize the following parameters:

/start_date/[mmddyyyy]/
This will show all events starting on the specified date onwards, or pull 90 days of events that begin close to the specified start date.

/end_date/[mmddyyyy]/
This will show 90 days worth of events from today's date until the specified end date.

Show 90 days of events from this start date
http://www.nyu.edu/feeds/events/json/start_date/[mmddyyyy]/group/GROUP-NAME /
Show 90 days of events from today until this end date
http://www.nyu.edu/feeds/events/json/end_date/[mmddyyyy]/group/GROUP-NAME /

Example:

To surface 90 days of events in the Ticket-Central Calendar Group that start on or around August 21, 2016:

http://www.nyu.edu/feeds/events/json/start_date/08212016/group/Ticket-Central


To surface 90 days of events in the Ticket-Central Calendar Group up until an end date of August 21, 2016:

http://www.nyu.edu/feeds/events/json/end_date/08212016/group/Ticket-Central