API (Application Programming Interface)

It is our intention to add an API to the Timeline which will allow users to write programs that pull information from, or inject information into, the Timeline. We will announce the availability of this API via the Timeline (and on this page). In the meantime, you can access the tagged posts in Timeline using the following URL:

https://timeline-qa.princeton.edu/public/postsByTag

To get only items that contain one or more particular tags, append "/Tag1,Tag2", e.g. "/public/postsByTag/Arts", or “/public/postByTag/Arts,Music,Athletics”.

To get JSON format, either set the "Accept: application/json" header field (preferred) or add the URL parameter "?accept=json" to the end of your URL.  You can also specify “accept=xml” or “accept=ical” to get an xml or ical version of the feed.