Foller.me API Documentation

Welcome to the Foller.me Public API. We're really looking forward to all the plugins and widgets you create using our API and hopefully (with your help & support) improve it over the next few months. The fist version of the API is up and running and it's pretty basic. We work with the REST protocol and the calls are unsigned, no auth, no API key (not just yet, until we get too much spam).

Response formats

• JSON
• XHTML

Requests

• Recent topics
• Recent #hashtags
• Recent @mentions

Here's the general request format: http://api.foller.me/{who}/{what}.{format} where {who} is the screen name of the person you're querying, {what} is either topics, hashtags or mentions and {format } is the response format - either json or xhtml. Pretty straightforward ;) Go ahead and try browsing to: http://api.foller.me/kovshenin/topics.xhtml or perhaps http://api.foller.me/kovshenin/hashtags.json

There's also an option to exclude some entries from the cloud: http://api.foller.me/kovshenin/topics.xhtml?exclude=wordpress,kovshenin,foller like that.

There's an issue when trying to exclude hashtags from the cloud. You probaboy know that the hash symbol (#) is used for bookmarking in the hypertext markup language, so example.org/topics/#follerme will direct you to example.org/topics/ and then search for a bookmark called "follerme" on the page (an anchor). Thus, all you have to do is omit the hash symbol when excluding hashtags, so "#follerme" becomes "follerme" and "#wordpress" becomes "wordpress". Like this: http://api.foller.me/kovshenin/hashtags.xhtml?exclude=wordpress will exclude the #wordpress hashtag from the list.

It's not too complicated yet and we hope to keep it this way. After all, the Twitter API is pretty simple too! Anyways, if you're a developer and have used the Foller.me API in any of your apps, make sure you contact us. We'll be building up a list of apps that use the Foller.me API right here and we'll make sure you, as a developer, get featured on our blog.

Good luck and happy coding!

~ @kovshenin