Feed Types
- ICS & RSS — These feeds adhere to the iCalendar standard and hCalendar standard respectively and are available throughout the platform for automatic exporting via URLs. Localist provides specific Apple Cal, Google Cal and Outlook feeds to trigger each application when available.
- JSON — The Localist API provides all available event data in JSON.
- CSV — This can be generated through the Localist API and it will be a static file, not a feed.
ICS & RSS
Subscribed feeds cover 12 months
or
The first 1,000 events in that date range. For example, if there are 1,000 events in the first 6 months then the feed’s initial pull will only cover that date range.
- Title
- Date
- Start time
- End time (ICS only)
- Description (ICS descriptions are exported in plaintext only)
- Category (Event Types in Localist)
- Location (RSS appends this to the end of the title, such as Senior Concert at Arts Center)
- Room Number (ICS only)
Where to find these feeds:
- All Events or Filtered Results: On every filtered results page you’ll find the subscription options in the Filter dropdown. The export options are located in the Subscribe to Displayed Results section of the dropdown.
- My Calendar: To subscribe to the events you’ve marked yourself as I’m Interested in, navigate to your User Dashboard > My Calendar and the subscription options will be located in the Filter dropdown.
- Group or Place Landing Pages: When on the landing page, select View Full Calendar…then use the Filter dropdown.
Google Calendar Details
- Exporting Multiple Events: If exporting a filtered results page, Gmail will prompt you to add a new calendar.
- Exporting Individual Events: If exporting from an individual event landing page, Gmail will open a regular Create form pre-populated with the available data.
HEADS UP If the event is recurring and includes several instances, then Google will only add the first instance. |
Outlook Details
Outlook interprets data differently depending on where the iCal feed is exported:
- Outlook doesn’t allow subscribing to an ICS file with multiple events, such as a the “All Events” page or selecting a Filter Item. Events will be added, but they will not be connected so the events won’t update to reflect future changes. If you copy the link to the ICS file and manually subscribe to it in Outlook then the events will be added and updated accordingly.
- Windows Outlook handles importing an ICS file with one event in the ICS adds a single event to a calendar, but multiple events in the ICS as a new calendar. The ICS we generate for a single event always contains all instances of the event so it’s up to the calendar program how it’s imported.