Exporting PhilEvents data

In addition to viewing your events online on PhilEvents, it is possible to download/export some of the event listings in various formats. Alternatively, you might want to embed one of our calendar widgets on your site. This is a simpler way of using our data on an external site. Read on if you're interested in the more flexible way.

Exporting events based on topics

Every topic on PhilEvents has a unique identifier. View the list of topics and identifiers

You can view all upcoming events in a topic area by navigating to a URL of this form:

For example, if the topic identifier for Metaphysics is 577, navigating to

https://philevents.org/search/topic/577

Once you visit a URL of the above form, a few export links appear on the right-side of the page. They include:

• RSS feed for this search
• iCal for this search (Outlook, Google Calendar)
• Download as CSV

Clicking on any of these links allows you to get the results in the respective format.

For example, the RSS export URL will look something like this (notice the format parameter):

For iCal and CSV formats of the same listings, only the format parameter changes. The format parameter will be 'calendar' and 'csv' for iCal and CSV formats, respectively.

How you use the above URLs is up to you. You could use the RSS feeds to view the events in your favourite RSS reader (like Google Reader), or you could download the list of events in iCal format and add them to your Outlook or Apple calendar, or if you are a developer you could make REST-like API calls to fetch the results in CSV format and process the results as required.

List of topics with identifiers

Exporting advanced search results

Although the ability to export events based on a topic of interest is enough in most cases, PhilEvents also provides the ability to export events based on an advanced combination of criteria. This is provided by the Advanced Search on PhilEvents.

Every search on PhilEvents generates a unique identifier in the form of a number. This identifier can be used to export the results frequently, updated each time on request. To understand this better, go to our Advanced Search page where you can search for events based on a number of criteria and perform a search.

Once you get the results you are looking for, a few export links appear on the right-side of the page. They let you export these listings similarly to the exporting of events of a particular topic.

Let's take RSS for instance. If the unique identifier generated for your search was '12345', then the RSS export URL will look something like this (notice the identifier '12345' and the format parameter):

For iCal and CSV formats of the same search, the identifier remains the same, and only the format parameters change. The format parameter will be 'calendar' and 'csv' for iCal and CSV formats, respectively.