PHREADZ » API

(under development and invention)

Currently the Phreadz API offers the data required to build your own players and widgets based around the posts and conversations which Phreadz helps pull together.

Every 'channel', 'user' and 'post' on Phreadz currently outputs RSS and JSON data for applications to read and developers to build on.

You may access these data feeds thus (please do not overload these urls with too many requests. Eventually I will provide an API 'key', which will have limitations on the amount of requests which it can take):

'channel' feeds:

	http://[channelname.]phreadz.com/[format]/   - formats available are 'rss' and 'json'

	example: data feeds for the main Phreadz 'lobby'

	http://phreadz.com/rss/
	http://phreadz.com/json/

	example: data feeds for the Phreadz 'movies' channel:

	http://movies.phreadz.com/rss/
	http://movies.phreadz.com/json/

'user' feeds:

	http://phreadz.com/user/[username]/[format]/

	example: data feeds for the Phreadz user called 'guest':

	http://phreadz.com/user/guest/rss/
	http://phreadz.com/user/guest/json/

'phreadz' post reply feeds:

	http://phreadz.com/rss/[guid]/[format]/  - where 'guid' is the unique id of the phreadz post

	example: data feeds for the Phreadz post with guid '1P7IASJNNA48' :

	http://phreadz.com/rss/1P7IASJNNA48/
	http://phreadz.com/json/1P7IASJNNA48/
	http://phreadz.com/opml/1P7IASJNNA48/

[the structure of the JSON data will soon be explained below - the RSS feeds are in the RSS 2.0 format, utilising the Yahoo! media:rss namespace]

This API is a work in progress and will soon have various authenticated methods for listing posts by followers, and those members you are following and also, naturally posting to phreadz from outside the main interface (from your application, for example).

NB: Phreadz users will soon have the ability to flag their posts as 'shareable' or not, in order to decide if they want their posts to appear in the data feeds and widgets, which can be seen by non-members.

Kosso: 2008