Consuming with Atom and RSS

Atom is a protocol created for distributing blog posts and other syndicated web content. While not a perfect match for SHARE Notify, it does provide a simple way to explore the notifications flowing from the service.

Using the SHARE Atom feed

The SHARE Atom feed can be found at:

https://osf.io/share/atom

The feed is a layer on top of the existing scrAPI search API developed for SHARE. It takes a query URL parameter, and returns an Atom feed with the results of that query. The query syntax is as follows:

/atom/?q=query_term

You can also specify the field you would like to search, by adding the prefix of field: to the query, like so:

/atom/?q=source:plos

The fields themselves are documented on our metadata schema page

To query the Atom feed, you can use any valid Lucene query syntax. You can query by any field in the metadata schema, by date ranges (using solr date formats), by keywords, or any combination of the above.

Here are some examples of valid queries:

• [/atom/?q=open AND science AND source:scitech](https://share-dev.osf.io/api/v1/app/6qajn/rss/?q=open AND science AND source:scitech)

• /atom/?q=tags:frogs

• [/atom/?q=dateUpdated:[2014-10-01 TO 2014-10-10]](https://osf.io/share/atom/?q=dateUpdated:[2014-10-01T00:00:00Z TO 2014-10-10T00:00:59Z])

Note: Atom allows for some greater flexibility in the way the metadata payload is structured. It also allows for some flexibility is specifying the date range of items to be returned. While this flexibility has not yet been leveraged in this Atom feed, we expect to improve it in time. For now, you can treat it much as you would the RSS feed.