paRSS
Feews! for the rest of us.
About Parss
Parss retrieves RSS feeds from the World Wide Web and provides them in a unified format via a simple XML-RPC interface.
How to join
To use Parss in your own software simply apply for a user key by entering a valid e-mail address in the topmost box on the right. Then follow the steps described in the mail that will be sent to you.
Latest news
Read more about this open-source software at the Parss project weblog.
XML-RPC Interface
The XML-RPC server address of this Parss installation is http://xmlrpc.winter.cd/. You can use any of the following methods:
addFeed
parss.addFeed(key, URL)

Registers the RSS data at the given URL in Parss' database and starts to retrieve and update it regularly. Returns the resulting ID (ie. a number) of the feed as stored the database.
getFeedId
parss.getFeedId(key, URL)

Returns the ID (ie. a number) of the feed with the given URL (ie. a string).
getFeed
parss.getFeed(key, ID)

Returns the feed with the given ID (ie. a number) as hierarchical structure.
rateFeed
parss.rateFeed(key, ID, vote)

Adds the value of vote to the current overall rating of the feed with the given ID. vote can only be either +1 or -1. Returns the feed's new overall rating value.
getUpdateList
parss.getUpdateList(key, date)

Returns a list of feed IDs which have been updated in Parss' database since the given date.
XML-RPC Examples
Request for getFeed method:
POST / HTTP/1.0 User-Agent: Helma HTTP Library Host: parss.info Content-Type: text/xml Content-Length: 294 <?xml version="1.0"?> <methodCall> <methodName>parss.getFeed</methodName> <params> <param> <value><string>a8d39b6c7d4f81e9f203c7485f9e3c92</string></value> </param> <param> <value><i4>41</i4></value> </param> </params> </methodCall>

Response of getFeed method:
HTTP/1.0 200 OK Server: Apache XML-RPC 1.0 Connection: close Content-Type: text/xml Content-Length: 3586 <?xml version="1.0" encoding="ISO-8859-1"?> <methodResponse> <params> <param> <value> <struct> <member> <name>id</name> <value>12</value> </member> <member> <name>link</name> <value>http://host.server.dom</value> </member> <member> <name>url</name> <value>http://host.server.dom/rss.xml</value> </member> <member> <name>title</name> <value>The feed's title.</value> </member> <member> <name>description</name> <value>Text describing the feed.</value> </member> <member> <name>author</name> <value>The feed's authorship information.</value> </member> <member> <name>copyright</name> <value>Copyright 2005 by the author</value> </member> <member> <name>language</name> <value>de</value> </member> <member> <name>type</name> <value>rss_1.0</value> </member> <member> <name>rating</name> <value><double>2.0</double></value> </member> <member> <name>errors</name> <value><double>0.0</double></value> </member> <member> <name>image</name> <value>HTML code for (linked) image element.</value> </member> <member> <name>textInput</name> <value>HTML code for text input form.</value> </member> <member> <name>lastUpdate</name> <value><dateTime.iso8601> 20050404T21:41:18 </dateTime.iso8601></value> </member> <member> <name>pubdate</name> <value><dateTime.iso8601> 20050404T21:41:01 </dateTime.iso8601></value> </member> <member> <name>items</name> <value> <array> <data> <value> [n items, see below] </value> </data> </array> </value> </member> </struct> </value> </param> </params> </methodResponse>

Item inside getFeed response:
<struct> <member> <name>title</name> <value>The item's title.</value> </member> <member> <name>description</name> <value>The item's content.</value> </member> <member> <name>link</name> <value>http://host.server.dom/item</value> </member> <member> <name>type</name> <value>text/plain</value> </member> <member> <name>position</name> <value><double>0.0</double></value> </member> <member> <name>pubdate</name> <value><dateTime.iso8601> 20050404T20:11:00 </dateTime.iso8601></value> </member> <member> <name>feed</name> <value>12</value> </member> <member> <name>feedtitle</name> <value>The title of the feed the item belongs to.</value> </member> <member> <name>feedlink</name> <value>The URL of the feed the item belongs to.</value> </member> </struct>