AideRSSmantra

Top Posts

From AideRSS API Documentation

Contents

top_posts

http://api.aiderss.com/top_posts

Returns the top posts (by PostRank™) for the specified time period and feed.

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] : The internal ID of the feed (see Feed ID).
  • period=[day|week|month|year|auto|length in seconds] : The period to return posts from.
  • num=[1-30] : The number of posts to return.
  • callback=[jsonp callback] : (Optional) Callback for JSONP data.

Returns

A list of posts.

Example Response

JSON

http://api.aiderss.com/top_posts?appkey=aiderss.com&format=json&feed_id=2&period=month&num=1

Result
[{"pubdate":1201011823,"link":"http:\/\/www.gapingvoid.com\/Moveable_Type\/archives\/004426.html","title":"meatball sundae [part two]","postrank":10.0,"postrank_color":"#ff7128"}, ...snip... ]
Errors
{"error":"Num is missing or invalid"}

RSS

http://api.aiderss.com/top_posts?appkey=aiderss.com&format=rss&feed_id=2&period=month&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>Mon, 24 Mar 2008 02:02:28 GMT</pubDate>
		<ttl>60</ttl>
		<title>gapingvoid: "cartoons drawn on the back of business cards" - AideRSS Top Posts Since 2008-03-01</title>
		<description></description>
		<link>http://gapingvoid.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>Mon, 24 Mar 2008 02:02:28 GMT</lastBuildDate>
		<item>
			<title>the quiet life of a writer yak yak yak</title>
			<link>http://api.aiderss.com/click?url=http%3A%2F%2Fwww.gapingvoid.com%2FMoveable_Type%2Farchives%2F004455.html</link>
			<guid>http://www.gapingvoid.com/Moveable_Type/archives/004455.html</guid>
			<pubDate>Thu, 13 Mar 2008 21:33:11 GMT</pubDate>
			<aiderss:postrank>8.7</aiderss:postrank>
			<aiderss:original_link>http://www.gapingvoid.com/Moveable_Type/archives/004455.html</aiderss:original_link>
			<aiderss:postrank_color>#ff8136</aiderss:postrank_color>
		</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>
		<pubDate>Mon, 24 Mar 2008 02:02:28 GMT</pubDate>
		<ttl>60</ttl>
		<title>gapingvoid: "cartoons drawn on the back of business cards" - AideRSS Top Posts Since 2008-03-01</title>
		<description></description>
		<link>http://gapingvoid.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>Mon, 24 Mar 2008 02:02:28 GMT</lastBuildDate>

		<item>
			<title>errorNum is missing or invalid</title>
 			<description>{"error"=>"Num is missing or invalid"}</description>
		</item>
	</channel>
</rss>
Retrieved from "http://apidoc.aiderss.com/Top_Posts"