Top Posts API

 

Part of the Data Mining APIs

 

The top posts API allows you to retrieve top recent stories for any RSS feed. Posts are ranked by their PostRank score and returned in descending order.

 

Url

http://api.postrank.com/v2/feed/{feed_hash}/topposts

 

 

Parameters

 

appkey	Your API Key
q	(Optional) Encoded filter query string.
format = [json | xml | rss]	(Optional) The format of the returned data. Default JSON.
num	(Optional) Number of entries to return (maximum of 30). Default 10.
callback	(Optional) For JSONP, a callback function name.

 

Returns

Returns a list of top posts for the specified feed with meta data about the feed.

 

 

Example

 

http://api.postrank.com/v2/feed/cb3e81ac96fb0ada1212dfce4f329474/topposts?appkey=example.com&num=3&format=json

 

Response

{
	"items": [
	       {
	               "pubdate": 1247705520,
	               "feed_title": "everburning - PostRank",
	               "title": "EventMachine Screencast \u2014 EM-HTTP-Request",
	               "feed_url": "http:\/\/everburning.com\/feed\/",
	               "postrank": 10.0,
	               "id": "c9f47a87261be35896f764b6f849c33e",
	               "link": "http:\/\/api.postrank.com\/log?url=http%3A%2F%2Feverburning.com%2Fnews%2Feventmachine-screencast-em-http-request%2F",
	               "original_link": "http:\/\/everburning.com\/news\/eventmachine-screencast-em-http-request\/",
	               "postrank_color": "#ff7128"
	       },
	       {
	               "pubdate": 1243042860,
	               "feed_title": "everburning - PostRank",
	               "title": "Heating up with HotCocoa Part I",
	               "feed_url": "http:\/\/everburning.com\/feed\/",
	               "postrank": 10.0,
	               "id": "665437a07f2f1c2b1bf127b15b11c3e0",
	               "link": "http:\/\/api.postrank.com\/log?url=http%3A%2F%2Feverburning.com%2Fnews%2Fheating-up-with-hotcocoa-part-i%2F",
	               "original_link": "http:\/\/everburning.com\/news\/heating-up-with-hotcocoa-part-i\/",
	               "postrank_color": "#ff7128"
	       },
	       {
	               "pubdate": 1232075460,
	               "feed_title": "everburning - PostRank",
	               "title": "Playing with EventMachine",
	               "feed_url": "http:\/\/everburning.com\/feed\/",
	               "postrank": 10.0,
	               "id": "4085aca8ee55d5280a7f9004f11422a5",
	               "link": "http:\/\/api.postrank.com\/log?url=http%3A%2F%2Feverburning.com%2Fnews%2Fplaying-with-eventmachine%2F",
	               "original_link": "http:\/\/everburning.com\/news\/playing-with-eventmachine\/",
	               "postrank_color": "#ff7128"
	       }
	],
	"meta": {
	       "ttl": 60,
	       "xml": "http:\/\/everburning.com\/feed\/",
	       "title": "everburning - PostRank",
	       "tags": [
	               {
	                       "name": "familiars",
	                       "count": 3
	               }
	       ],
	       "topics": [
	               {
	                       "name": "Ruby",
	                       "count": 131
	               },
	               {
	                       "name": "Ruby on Rails",
	                       "count": 108
	               },
	               {
	                       "name": "Waterloo",
	                       "count": 51
	               },
	               {
	                       "name": "Red Canary Influencers",
	                       "count": 36
	               },
	               {
	                       "name": "Dans Topic",
	                       "count": 1
	               }
	       ],
	       "id": "cb3e81ac96fb0ada1212dfce4f329474",
	       "description": "the taste of nonsense and chaos",
	       "feed_id": 204053,
	       "link": "http:\/\/everburning.com\/",
	       "opensearch:itemsPerPage": 3,
	       "image": {
	               "title": "PostRank",
	               "url": "http:\/\/www.postrank.com\/graphics\/header_logo.png",
	               "link": "http:\/\/www.postrank.com"
	       }
	}
}