Atom & RSS Feeds for Annotations

The Hypothesis stream is available in the Atom feed format. It can be used with RSS/feed readers such as NewsBlur or integrated with chat and notification systems such as Slack or used to trigger other events in other systems using services like Zapier or IFTTT.

The primary feeds are available at these URLs:

You can filter the stream using various query parameters:

by URL

All annotations on Ta-Nehisi Coates’ Letter to my Son:

  • Atom: https://hypothes.is/stream.atom?uri=http://www.theatlantic.com/politics/archive/2015/07/tanehisi-coates-between-the-world-and-me/397619/
  • RSS: https://hypothes.is/stream.rss?uri=http://www.theatlantic.com/politics/archive/2015/07/tanehisi-coates-between-the-world-and-me/397619/

by Tag

All annotations tagged “edu305”:

  • Atom: https://hypothes.is/stream.atom?tags=edu305
  • RSS: https://hypothes.is/stream.rss?tags=edu305

by User

Paul Allison’s annotations:

  • Atom: https://hypothes.is/stream.atom?user=paulallison
  • RSS: https://hypothes.is/stream.rss?user=paulallison

by Group

RSS feeds are inherently unauthenticated, and access to private group annotations requires authentication, so you can’t use https://hypothes.is/stream.rss or https://hypothes.is/stream.atom to receive feeds of private group annotation activity.

As an alternative, you can use this tool, created by our former Director of Integrations: https://github.com/judell/h_notify.

Was this article helpful?

Related Articles

Ask a Question

Send us a support ticket to get more help.
Create a Ticket