What is this?
The RSSmeme API enables you pull information out of RSSmeme. All you have to do is tack on some parameters to a URL and RSSmeme will filter the correct data.
This example: http://www.rssmeme.com/api/?order_by=-pub_date&tag=google&source=11&feeds_gte=10&output=atom shows a feed for stories that were published on TechCrunch, tagged 'google', with at least 10 shares, sorted by the date published.
Follow these instructions to create a "most shared stories" widget for your blog's sidebar.
Parameters
- output - the output format. Choices are 'html', 'json', 'xml', or 'atom'. If you want a feed to put in Google Reader choose 'atom'. If you are looking to build something out of the API then choose 'json' because it serves the most data (including notes).
- author - the id of an author.
- hours - the number of hours since a story was published.
- entry - the id of an entry.
- feed - the id of a feed. I know this is confusing but a feed is a user. It is named feed because a user is simply a Google Reader shared RSS feed. The easiest way to find your feed id is to put your Google Reader shared RSS feed link into the Register form which will redirect you to your feed.
- feeds_gte - the minimum number of times an entry must be shared.
- feeds_lte - the maximum number of times an entry must be shared.
- friendfeed - the nickname of a user on Friendfeed. This will limit the entries to only those that were shared by friends of this user.
- language - the language code ('en') of an entry.
- order_by - how the data should be ordered. Acceptable values are 'pub_date', '-pub_date', 'feed_count', or '-feed_count'.
- page - the page of data you are requesting. Every page is a maximum of 20 entries long.
- search - a search term on an entry's title.
- source - the id or URL of a source. For instance TechCrunch has an id of 11 and their URL is http://www.techcrunch.com. Passing either value in will work.
- tag - the slug of a tag ('google' for instance).
- url - a specific URL you are looking for. This is very useful if you want to pull information out of RSSmeme for based on a URL. This could be used to create a Wordpress plugin that pulls notes out of RSSmeme and into the blog for instance.
JSON Callbacks
The JSON output format also lets your add an additional parameter 'callback' that will wrap the JSON in a function call to the function of your choice. This will let you use the API with JavaScript.
