Feed

From AideRSS API Documentation

Contents 1 feed 1.1 Parameters 1.2 Returns 1.3 Example Response 1.3.1 RSS 1.3.1.1 Result 1.3.2 Errors 1.3.3 JSON 1.3.3.1 Result 1.3.3.2 Errors

feed

http://api.aiderss.com/feed

Returns the entries for a feed, along with the stats.

Parameters

HTTP GET

• appkey=[string] : An Application Key (usually your domain name).
• format=[rss|json] : The format to return data in.
• feed_id=[feed_id] : Internal ID of the feed (see Feed ID).
• level=[all|good|great|best|a postrank number] : Level of entries to filter out.
• num=[1-30] : Number of entries to return.
• start=[integer] : (Optional) Entry to start returning from (for pagination).
• meta=[1] : (Optional) Returns just metadata (title, etc) for the feed.
• callback=[jsonp callback] : (Optional) Callback for JSONP data.

Returns

A list of entry stats.

Example Response

RSS

http://api.aiderss.com/feed?appkey=aiderss.com&format=rss&feed_id=1&level=all&num=1

Result

<?xml version="1.0" encoding="UTF-8" ?>
<rss version="2.0" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:wfw="http://wellformedweb.org/CommentAPI/" xmlns:aiderss="http://aiderss.com/xsd/2007-11-30/aiderss" xmlns:slash="http://purl.org/rss/1.0/modules/slash/">
	<channel>
		<pubDate>Wed, 20 Feb 2008 21:24:37 GMT</pubDate>
		<ttl>60</ttl>
		<title>igvita.com</title>
		<description>A goal is a dream with a deadline.</description>
		<link>http://igvita.com</link>
		<image>
			<title>AideRSS - Read what matters</title>
			<url>http://www.aiderss.com/images/aideRSS_logo.gif</url>
			<link>http://www.aiderss.com</link>
		</image>
		<lastBuildDate>Wed, 20 Feb 2008 21:24:37 GMT</lastBuildDate>
		<item>
			<title>Live Mongrel Debugging and Recovery</title>
			<link>http://api.aiderss.com/click?url=http://www.igvita.com/2008/02/19/live-mongrel-debugging-and-recovery/</link>
			<guid>http://www.igvita.com/2008/02/19/live-mongrel-debugging-and-recovery/</guid>
			<comments>http://www.igvita.com/2008/02/19/live-mongrel-debugging-and-recovery/#comments</comments>
			<wfw:commentRss>http://www.igvita.com/2008/02/19/live-mongrel-debugging-and-recovery/feed/</wfw:commentRss>
			<slash:comments>10</slash:comments>
			<pubDate>Tue, 19 Feb 2008 23:30:46 GMT</pubDate>
			<description>Unit::Test, RSpec, and good old manual testing ...snip...</description>
			<content:encoded>Unit::Test, RSpec, and good old manual testing ...snipsnip...</content:encoded>
			<aiderss:postrank>5.5</aiderss:postrank>
			<aiderss:original_link>5.5</aiderss:original_link>
		</item>
	</channel>
</rss>

Errors

<?xml version="1.0" encoding="UTF-8" ?>
<rss version="2.0" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:wfw="http://wellformedweb.org/CommentAPI/" xmlns:aiderss="http://aiderss.com/xsd/2007-11-30/aiderss" xmlns:slash="http://purl.org/rss/1.0/modules/slash/">
	<channel>
		<title>errorFeedID is missing or invalid</title>
		<item>
			<title>errorFeedID is missing or invalid</title>
			<description>{"error"=>"FeedID is missing or invalid"}</description>
		</item>
	</channel>
</rss>

JSON

http://api.aiderss.com/feed?appkey=aiderss.com&format=json&feed_id=1&level=all&num=1

Result

[{"pubdate":1203463846,"link":"http://api.aiderss.com/click?url=http://www.igvita.com/2008/02/19/live-mongrel-debugging-and-recovery/","comments":"http:\/\/www.igvita.com\/2008\/02\/19\/live-mongrel-debugging-and-recovery\/#comments","title":"Live Mongrel Debugging and Recovery","slash_comments:"10","postrank":"5.5","content":"Unit::Test, RSpec, and good old manual testing ...snipsnip...","comment_rss":"http:\/\/www.igvita.com\/2008\/02\/19\/live-mongrel-debugging-and-recovery\/feed\/"}, ...snip...]

Errors

{"error":"FeedID is missing or invalid"}