The fav.or.it API is designed to allow access to many of it’s core services. The first round of exposed requests allow comments to be distributed from external clients through fav.or.it back to the host of the specified blog. It is our desire that by opening up our core platform that we start a new flow of comments around the blogosphere and that by doing so everyone will benefit from a ‘better conversation’. The API will become available for testing sometime this week, we will make a further announcement when it is ready. We hope that this documentation will allow you to get started on developing exciting applications.
For full documentation on the API we have a Google Group which has detailed description of each request and more detailed information on all our services.
Suggested uses:
- Give commenting functionality to PC/Based RSS Readers
- Extending web based RSS Readers
- Send comments from embedded widgets
- Supply comments from external blogs (that fav.or.it cannot aggregate)
The API
fav.or.it exposes many of it’s data services via an application programming interface (API). Developers and power users may sign up for access the API by registering with fav.or.it and agree to our terms of service to use fav.or.it services and data in their applications.
RESTful Resources
The fav.or.it API tries to conform as much as possible to the design principles of Representational State Transfer (REST). You’ll find that you can simply change the file extension on almost any request to get results in the format of your choice. This document notes which formats are available for each method.
fav.or.it presently supports the following data formats: XML, JSON, and PHP (serialized)
Identity Management
fav.or.it has an internal identity system that allows the mapping of multiple identities from external providers onto a single fav.or.it user. Within fav.or.it a user may identify themselves across multiple services which then links any incoming comments/posts as being owned by that user.
The following services can be authenticated by fav.or.it – we will be announcing further services in the near future.
- openid
- blogger (blogspot)
- wordpress.com
- bloglines
Partner Services
A partner service is any external site that supplies fav.or.it with authenticated data. In most cases this means supplying authenticated comments from their own user base. fav.or.it has an internal identity management system that allows the mapping of multiple identities across comment systems. If you are interested in becoming a partner service please get in touch.
Parameters
Some API methods take optional or requisite parameters. Where applicable, we’ve documented those parameters. Remember to convert to UTF-8 and URL encode parameters that take complex strings.
HTTP Requests
Unless otherwise noted, methods exposed by the fav.or.it API require a GET request. Methods that post new comments require a POST. Where noted, some API methods will return different results based on HTTP headers sent by the client.
Rate Limiting
Public clients are allowed 500 requests in a 24 hour time period, starting from their first request. Notification that a client has exceeded the rate limit will be sent as JSON,XML or PHP when either is the requested format, and otherwise will be sent in plain text.
Example XML failure
failure
missing param 'comment_id'
Spam
fav.or.it takes spam very seriously and will not tolerate spam sent through it’s API. Our community + technologies identify spam before it is forwarded onto external blogs.
In the case of persistent spamming an API Key will be disabled along with the account that it is associated with.
[...] Nos lo anuncian en su blog con el título “The future of comment distribution“. [...]
Hello guys,
I would really try fav.or.it, because I believe that is the solution to my problem with google reader xD
Greetings xD
Hello,
Somewhere on the internet, one day I posted the absolute need for a personal comment tracker/aggregator….I guess you guys are on it and on an spectacular way!! I would be able to tell you where I posted that….but my memory can´t keep up with all read/write…I need fav.or.it now!
Congrats!
Great webservice.
Marcelo
Congratulations!
So she did retrace and kick, and Tom had to grope precariously her hailstones with his dumbfounded soldiers to jeapardize her to still.
[...] are also very pleased today to announce that the commenting company Disqus will be supporting the fav.or.it API to allow any Disqus enabled blog to interact directly with fav.or.it – This gives the blog owners [...]
Hello!
I think this try.
[...] recently announced an API that allowed access to a limited set of abilities that leveraged the fav.or.it core framework of [...]
[...] The fav.or.it Blog » fav.or.it API – Giving the conversation back to the blog! It allows comments to be distributed from external clients through fav.or.it back to the host of the specified blog. By opening up our core platform, we hope to start a new flow of comments around the blogosphere and anchored in individual blogs. (tags: api blog comments rss fav.or.it twitter friendfeed conversation identity news tech code) [...]