New York University Skip to Content Skip to Search Skip to Navigation Skip to Sub Navigation

Consuming Events Data into Your Own Website Using Feeds

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 Category, 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

CATEGORIES

Category inclusions behave identical to Tags.  For example:

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

RSS

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

iCal

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

Example:
To surface all events in the Ticket-Central Calendar Group with the Category '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 Categories:

RSS http://www.nyu.edu/feeds/events/rss/group/GROUP-NAME/categories/CATEGORY1/categories/CATEGORY2/categories/CATEGORY3
iCal http://www.nyu.edu/feeds/events/ical/group/GROUP-NAME/categories/CATEGORY1/categories/CATEGORY2/categories/CATEGORY3

Example:
To surface all events in the Ticket-Central Calendar Group within the Categories '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 Category and then, only those events in that Category that have a specific Tag.  The URLs would be created as:

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

Example:
To surface all events in the Ticket-Central Calendar Group within the Category '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 1, 2013:

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


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

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

Find Your Calendar Group Name:

When you log into the Events Calendar, you'll be placed into your default Calendar Group, and see a list of all its associated events. You can see your default Calendar Group referenced next to the Logged in as [your name] at the top of the screen.

Example of Calendar Group

 

Need Help?

There are many permutations that you can create using feed URLs. The NYU Events Team is happy to assist you with creating the URL that will best capture the information you wish to display. Contact the Digital Communications Events Team at events@nyu.edu with any questions.

NYU Footer