API Documentation

Developers

API Documentation

The PostRank APIs allow you to create applications that interact with the subscription management component of the PostRank website, as well as, create and retrieve story ratings and customized RSS feeds for your users.

Authentication

Authentication to PostRank is done using OAuth or HTTP basic authentication. If you're using OAuth authentication the user must authorize your application before the application can query subscription information. You should be able to utilize any OAuth library available for your given language to interact with the OAuth endpoints - PostRank standard request paths for all OAuth calls.

More information on OAuth can be found on the OAuth.net website.

Subscriptions API

This api is designed to allow you to retrieve all users subscriptions, or a subset, based on a feed identifier.

Authentication

All subscription APIs require you to be authenticated through OAuth to the PostRank website.

Subscription Information

Note: Before using the PostRank subscription API you must register your application to retrieve a token and secret key. Register application »

Note: Depending on the information you need there are currently three different ways to retrieve subscriptions.

All user subscriptions

http://www.postrank.com/myfeeds/subscriptions.{format}
Returns all of the subscriptions for the authenticated user.

Parameters (HTTP GET)

•	format = [js \| xml \| html]	(Optional) The format of the returned data. Default HTML.

Returns

Information for all of the users subscriptions. This information includes the feed hash, tags, keyword filters and postrank filters.

Example

http://www.postrank.com/myfeeds/subscriptions.xml

Results

<?xml version="1.0" encoding="UTF-8"?>
<subscriptions type="array">
  <subscription>
    <created-at type="datetime">2008-09-26T15:04:18Z</created-at>
    <feed-hash>12192ceb98044600ea2edc624d3c3930</feed-hash>
    <id type="integer">15</id>
    <keyword-filter nil="true"></keyword-filter>
    <postrank-filter type="float">2.7</postrank-filter>
    <updated-at type="datetime">2008-09-26T15:04:18Z</updated-at>
    <user-id type="integer">1</user-id>
    <tag_list></tag_list>
  </subscription>
  <subscription>
    <created-at type="datetime">2008-09-26T15:04:18Z</created-at>
    <feed-hash>139400fb2b8206267ae7d7db523d30aa</feed-hash>
    <id type="integer">13</id>
    <keyword-filter>iphone</keyword-filter>
    <postrank-filter type="float">7.6</postrank-filter>
    <updated-at type="datetime">2008-09-26T15:04:18Z</updated-at>
    <user-id type="integer">1</user-id>
    <tag_list></tag_list>
  </subscription>
</subscriptions>

All user subscriptions for a given feed

http://www.postrank.com/myfeeds/subscriptions/feed/{feed_hash}.{format}
Returns all user subscriptions for a given feed.

Parameters (HTTP GET)

•	feed_hash = [32 character feed identifier]	Feed identifier for the desired feed.
•	format = [js \| xml]	The format of the returned data.

Returns

Information for all of the subscriptions for a given feed identifier. This information includes the feed hash, tags, keyword filters and postrank filters.

Example

http://www.postrank.com/myfeeds/subscriptions/feed/12192ceb98044600ea2edc624d3c3930.xml

Results

<?xml version="1.0" encoding="UTF-8"?>
<subscription type="array">
  <subscription>
    <created-at type="datetime">2008-09-26T15:04:18Z</created-at>
    <feed-hash>12192ceb98044600ea2edc624d3c3930</feed-hash>
    <id type="integer">15</id>
    <keyword-filter nil="true"></keyword-filter>
    <postrank-filter type="float">2.7</postrank-filter>

    <updated-at type="datetime">2008-09-26T15:04:18Z</updated-at>
    <user-id type="integer">1</user-id>
    <tag_list></tag_list>
  </subscription>
</subscription>

Specific subscription

http://www.postrank.com/myfeeds/subscriptions/{subscription_id}.{format}
Retrieve the provided subscription information.

Parameters (HTTP GET)

•	subscription_id	Subscription identifier for the desired subscription.
•	format = [js \| xml]	The format of the returned data.

Returns

Information for the provided subscription identifier. This information includes the feed hash, tags, keyword filters and postrank filters.

Example

http://www.postrank.com/myfeeds/subscriptions/2.xml

Results

<?xml version="1.0" encoding="UTF-8"?>
<subscription>
  <created-at type="datetime">2008-09-26T15:04:18Z</created-at>
  <feed-hash>69e654f7dc09f8e0c09b2c0feb3348bb</feed-hash>
  <id type="integer">2</id>
  <keyword-filter nil="true"></keyword-filter>
  <postrank-filter type="float">5.4</postrank-filter>
  <updated-at type="datetime">2008-09-26T15:04:18Z</updated-at>

  <user-id type="integer">1</user-id>
  <tag_list></tag_list>
</subscription>

Create subscription

http://www.postrank.com/myfeeds/subscriptions.{format}
Create a new subscription with the provided values.

URL Parameters (HTTP PUT)

•	format = [js \| xml \| html]	(Optional) The format of the returned data. Default HTML.

POST Parameters (HTTP PUT)

•	feed_hash = [32 character feed identifier]	The feed to associate to the subscription
•	postrank_filter = [float: 1.0 - 10.0]	PostRank filter to be applied to the subscription
•	keyword_filter = [string]	Search filters to be applied to the subscription
•	tag_list = [string]	Space separated list of tags to attach to the subscription

The POST parameters are all provided under a top level identifier of subscription.

Returns

A 201 status code will be returned on success. A 422 otherwise.

Example JSON POST

{"subscription" : {
    "feed_hash":"cb3e81ac96fb0ada1212dfce4f329474",
    "postrank_filter":7.8,
    "keyword_filter":"cocoa",
    "tag_list":"programming cocoa" }
}

Update subscription

http://www.postrank.com/myfeeds/subscriptions/{subscription_id}.{format}
Update subscription to the provided values.

URL Parameters (HTTP PUT)

•	format = [js \| xml \| html]	(Optional) The format of the returned data. Default HTML.

POST Parameters (HTTP PUT)

•	feed_hash = [32 character feed identifier]	The feed to associate to the subscription
•	postrank_filter = [float: 1.0 - 10.0]	PostRank filter to be applied to the subscription
•	keyword_filter = [string]	Search filters to be applied to the subscription
•	tag_list = [string]	Space separated list of tags to attach to the subscription

The POST parameters are all provided under a top level identifier of subscription_id.

Returns

A 200 status code will be returned on success. A 422 otherwise.

Example JSON POST

{"2" : {
   "postrank_filter":1.0,
   "keyword_filter":"postrank OR monkey",
   "tag_list":"rss animal" }
}

Delete subscription

http://www.postrank.com/myfeeds/subscriptions/{subscription_id}.{format}
Delete the provided subscription.

Parameters (HTTP DELETE)

•	subscription_id	Subscription identifier for the desired subscription.

Returns

A 200 status code will be returned on success. A 422 otherwise.

User Information

The user information API allows you to query information for the user currently authenticated to PostRank.com. This information includes the user identifier and the users email address.

Authentication

The user information API requires you to be authenticated through OAuth to the PostRank website.

Get user information

http://www.postrank.com/user/info.{format}
Returns information for the current authenticated user.

Parameters (HTTP GET)

•	format = [js \| xml]	(Optional) The format of the returned data. Default JSON.

Returns

Information for the currently authenticated user including the user's identifier and email address.

Example

http://www.postrank.com/user/info.xml

Results

<?xml version="1.0" encoding="UTF-8"?>
<user>
  <email>quentin@example.com</email>
  <user-hash>b6589fc6ab0dc82cf12099d1c2d40ab9</user-hash>
</user>

Feed Information API

The feed information API is provided to allow you to retrieve the feed identifier for a given URL. The feed identifier is used to uniquely identify a given feed for different possible URLs.

Get feed information

http://api.postrank.com/v2/feed/{feed_hash}/info
http://api.postrank.com/v2/feed/info?id={feed URL}
Returns information for the requested feed.

Authentication

None

Parameters (HTTP GET)

•	appkey = [string]	An application key (typically your domain)
•	id = [string]	Either the URL of the site to be discovered (e.g. everburning.com) or a feed hash (e.g. cb3e81ac96fb0ada1212dfce4f329474).
•	format = [json \| xml \| rss]	(Optional) The format of the returned data. Default JSON.
•	noindex	(Optional) If the feed is not in the system and noindex is specified we will not discover the feed.
•	priority = [70 - 100]	(Optional) The priority to assign to the feed if it needs to be imported. 70 is most important, 100 is least important.
•	callback = [jsonp callback]	(Optional) Callback for JSONP data.

Returns

Returns information pertaining to the given feed including: title, feed hash, description, link, etc.

Example

http://api.postrank.com/v2/feed/info?format=xml&appkey=postrank.com/example&id=everburning.com
http://api.postrank.com/v2/feed/cb3e81ac96fb0ada1212dfce4f329474/info?format=xml&appkey=postrank.com/example

Result

<?xml version="1.0" encoding="UTF-8"?>
<results xmlns:opensearch='http://a9.com/-/spec/opensearch/1.1/'>
  <ttl>60</ttl>
  <xml>http://everburning.com/feed/</xml>
  <title>everburning</title>
  <id>cb3e81ac96fb0ada1212dfce4f329474</id>
  <feed_id>204053</feed_id>
  <link>http://everburning.com/</link>
  <description>the taste of nonsense and chaos</description>
  <image>
    <title>PostRank - Read what matters</title>
    <url>http://www.postrank.com/images/postrank_logo.gif</url>
    <link>http://www.postrank.com</link>
  </image>
</results>

Errors

<?xml version="1.0" encoding="UTF-8"?>
<results xmlns:opensearch='http://a9.com/-/spec/opensearch/1.1/'>
  <error>Collecting data</error>
</results>

Get feed information for multiple feeds

Note The request must be POST, but appkey and format are still specified in a GET-style query string.

Parameters (HTTP GET)

•	appkey = [ string ]	An Application Key (usually your domain name).
•	format = [json \| xml \| rss]	(Optional) The format of the returned data.
•	noindex	(Optional) If the feed is not in the system and noindex is specified we will not discover the feed.
•	priority = [70 - 100]	(Optional) The priority to assign to the feed if it needs to be imported. 70 is most important, 100 is least important.
•	callback = [ jsonp callback ]	(Optional) Callback for JSONP data.

Parameters (HTTP POST)

•	feed[] = [ feed url(s) or feed hashes ]

Returns

Returns information pertaining to the given feeds including: title, feed hash, description, link, etc.

Example

http://api.postrank.com/v2/recommend/feed/info?appkey=postrank.com/example&format=json
POST Data
feed[]=http://www.igvita.com/&
feed[]=f21649f0da15487a01597479afcc42c9

Results

{"items"=>[{"xml"=>"http://www.igvita.com/feed", "ttl"=>60, "title"=>"igvita.com RSS Feed", "id"=>"bac98d99a8120e79760cf38e41b21091", "feed_id"=>1, "description"=>"A dream is a goal with a deadline", "link"=>"http://www.igvita.com/"}, {"xml"=>"http://www.techcrunch.com/feed", "ttl"=>60, "title"=>"TechCrunch Feed", "id"=>"f21649f0da15487a01597479afcc42c9", "feed_id"=>2, "description"=>"TechCrunch News", "link"=>"http://www.techcrunch.com/"}], "meta"=>{"ttl"=>60, "image"=>{"title"=>"PostRank", "url"=>"http://www.postrank.com/graphics/header_logo.png", "link"=>"http://www.postrank.com"}}}

Feed API

The feed API is provided to allow you to retrieve filtered RSS feeds, along with additional PostRank data.

Get filtered feed

http://api.postrank.com/v2/feed/{feed hash}?appkey=postrank.com/example

Authentication

None

Required Parameters (HTTP GET)

•	appkey = [string]	An application key (typically your domain)
•	format = [json \| xml \| rss]	The format of returned data. Default JSON.

Optional Parameters (HTTP GET)

•	level	Level of entries to filter out (all, good, great, best, or a postrank number).
•	q	Encoded filter query string.
•	num	Number of entries to return (maximum of 30).
•	start	Entry to start returning from (for pagination).
•	callback	For JSONP, a callback function name.

Returns

Returns information pertaining to each feed post including: pubdate, title, content, postrank.

Example

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

Results

{ "items": [ 
    { "pubdate": 1223950080, "title": "A Peek at Ruby Internals", "feed_title": "everburning",
      "feed_url": "http:\/\/everburning.com\/feed\/", "postrank": 1.0, "id": "b0432f947bc0d44766d046bfc3c15043",
      "content": "<p>The MountainWest Ruby Conf 2008 had an interesting talk on <a href=\"http:\/\/mtnwestrubyconf2008.confreaks.com\/11farley.html\" onclick=\"javascript:pageTracker._trackPageview ('\/outbound\/mtnwestrubyconf2008.confreaks.com');\">Ruby Internals<\/a> by Patrick Farley . If you’ve worked with Ruby and are interested in learning more about classes, meta-classes and how all the method dispatch magic works give it a gander.<\/p>\n<p>Well worth the 50 minutes of time.<\/p>\n", "postrank_color": "#ffe08e", "description": "The MountainWest Ruby Conf 2008 had an interesting talk on Ruby Internals by Patrick Farley . If you' ve worked with Ruby and are interested in learning more about classes, meta-classes and how all the method dispatch magic works give it a gander. Well worth the 50 minutes of time.", "original_link": "http:\/\/everburning.com\/news\/a-peek-at-ruby-internals\/", "link": "http:\/\/api.postrank.com\/log?url=http%3A%2F%2Feverburning.com%2Fnews%2Fa-peek-at-ruby-internals%2F" },
    { "pubdate": 1223063820, "title": "Forked by rSpec", "feed_title": "everburning",
      "feed_url": "http:\/\/everburning.com\/feed\/", "postrank": 1.0, "id": "a020c1c3a5b2aef1ab4a7307cf3d2cb6",
      "content": "<p>So, I’ve been working at integrating some more of our test code into our automated build system at work and have spent a day trying to figure out why everything was failing with the tests. They ran fine in my lab, they’d run fine individually but when I used rake to run them everything would bomb.<\/p>\n<p>Eventually, I found out that all the rspec tests were being run twice. The first set of tests all passed the second set all failed. After a while I also realized the second set of tests were being run in the background. Odd, very odd.<\/p>\n<p>Fast forward another hour, a lot of digging in the rspec code and I realized it’s because we fork inside the spec files. We fork and execute the server we want to test. rSpec sets up an <em>at_exit<\/em> handler to run the specs at exit if they haven’t been run. That at_exit handler would run number of forks + 1 times for each spec file.<\/p>\n<p>I finally found <a href=\"http:\/\/blog.hiremaga.com\/2008\/01\/31\/dont-get-forked-by-rspec\/\" onclick=\"javascript:pageTracker._trackPageview ('\/outbound\/blog.hiremaga.com');\">Don\u2019t get forked by rSpec<\/a>, setup the <code>at_exit { exit! }<\/code> code in my spec files and everything is happy again.<\/p>\n<p>Wheeee…<\/p>\n", "postrank_color": "#ffe08e", "description": "So, I' ve been working at integrating some more of our test code into our automated build system at work and have spent a day trying to figure out why everything was failing with the tests. They ran fine in my lab, they' d run fine individually but when I used rake to run them everything would bomb. Eventually, I found out that all the rspec tests were being run twice. The first set of tests all passed the second ...", "original_link": "http:\/\/everburning.com\/news\/forked-by-rspec\/", "link": "http:\/\/api.postrank.com\/log?url=http%3A%2F%2Feverburning.com%2Fnews%2Fforked-by-rspec%2F" } ],
  "meta": { "opensearch:itemsPerPage": 10, "title": "everburning - PostRank (PostRank: All)",
            "opensearch:startIndex": 0, "opensearch:totalResults": 43, "postrank:searchPostrank": 1.0,
            "image": { "title": "PostRank", "url": "http:\/\/www.postrank.com\/graphics\/header_logo.png", "link": "http:\/\/postrank.com" } } }

Channel API

The channel API allows you to retrieve RSS feeds for the provided users subscriptions. Each feed is filtered and ranked according to the keyword and postrank filters specified in the subscription.

Get Channel

http://api.postrank.com/v2/channel/{user hash}/{tags}?appkey=postrank.com/example

Authentication

None

Required Parameters (HTTP GET)

•	appkey = [string]	An application key (typically your domain)
•	format = [json \| xml \| rss]	(Optional) The format of the returned data. Default JSON.
•	num	Number of entries to return (maximum of 30). Default 10.

Optional Parameters (HTTP GET)

•	tags	Get a channel for subscriptions with the provided tags.
•	callback	For JSONP, a callback function name.

Returns

Returns information pertaining to each feed post in the selected channels including: pubdate, title, content, postrank.

Example

http://api.postrank.com/v2/channel/aabe36179cd12314620eb78776e652bd475e1580/cloud?appkey=postrank.com/example&format=xml

Results

<?xml version="1.0" encoding="UTF-8"?>
<results xmlns:opensearch='http://a9.com/-/spec/opensearch/1.1/' xmlns:postrank='http://www.postrank.com/xsd/2007-11-30/postrank'>
  <meta>
    <opensearch:itemsPerPage>10</opensearch:itemsPerPage>
    <ttl>60</ttl>
    <pubDate>Wed, 22 Oct 2008 17:59:03 GMT</pubDate>
    <title>Cloud Channel - (aabe36179cd12314620eb78776e652bd475e1580) PostRank</title>
    <opensearch:startIndex>0</opensearch:startIndex>
    <description>Merged and filtered feed.</description>
    <link>http://www.postrank.com</link>
    <image>
      <title>PostRank</title>
      <url>http://www.postrank.com/graphics/header_logo.png</url>
      <link>http://postrank.com</link>
    </image>
    <lastBuildDate>Wed, 22 Oct 2008 17:59:03 GMT</lastBuildDate>
  </meta>
  <items>
    <item>
      <pubdate>1213888800</pubdate>
      <title>Splunk Your Distributed Logs in EC2</title>
      <feed_title>igvita.com</feed_title>
      <feed_url>http://igvita.com/feed/</feed_url>
      <original_link>http://www.igvita.com/2008/06/19/splunk-your-distributed-logs-in-ec2/</original_link>
      <link>http://api.postrank.com/log?url=http%3A%2F%2Fwww.igvita.com%2F2008%2F06%2F19%2Fsplunk-your-distributed-logs-in-ec2%2F</link>
      <postrank>4.2</postrank>
      <postrank_color>#ffb86a</postrank_color>
      <id>e5c74faa6cc53084d4c22b1346bf59d8</id>
      <content><p><img align="left" src="/posts/06-08/splunk+aws+ruby.png"/> Managing log files is like herding cats, except its worse: a typical LAMP / Rails stack will easily generate a dozen logs in different locations. The fun part is, of course, the debugging and server administration tasks which involve the forensic task of tracking down each of these files and then cross-referencing timestamps to figure out what really happened. We've all dealt with this problem at one point or another.</p> NOTE: Full content trimmed for API Documentation purposes.</content>
      <description>Managing log files is like herding cats, except its worse: a typical LAMP / Rails stack will easily generate a dozen logs in different locations. The fun part is, of course, the debugging and server administration tasks which involve the forensic task of tracking down each of these files and then cross-referencing timestamps to [...]</description>
    </item>
  </items>
</results>

Recommendations API

The recommendations API allows you to retrieve a set of recommended feeds for a specific user, as determined by the users current subscriptions, or for any arbitrary set of developer provided feeds.

Get Recommendations for User

http://api.postrank.com/v2/recommend/{user hash}/?appkey=postrank.com/example

Authentication

None

Required Parameters (HTTP GET)

•	appkey = [string]	An Application Key (usually your domain name).
•	id = [user_hash]	Unique user identifier on PostRank.com (see feed/info)

Optional Parameters (HTTP GET)

•	num	Number of entries to return (default 5, maximum of 50).
•	format = [json \| xml]	The format of the returned data. Default JSON.
•	callback	For JSONP, a callback function name.

Returns

Returns an array of recommended feeds (in order) for a particular user, as determined by users current subscriptions.

Example

http://api.postrank.com/v2/recommend/839617f28ffc022b41c8699797801ca4617fbc27?appkey=postrank.com/example&format=xml&num=1

Results

<?xml version="1.0" encoding="UTF-8"?>
<results>
  <item>
    <xml>http://feeds.feedurner.com/37signals/beMH</xml>
    <xml_hash>b5012e4f57b58ca8ec618d10c3ecafaf</xml_hash>
    <title>Signal vs. Noise</title>
  </item>
</results>

Get Recommendations for set of feeds

Note The request must be POST, but appkey and format are still specified in a GET-style query string.

Parameters (HTTP GET)

•	appkey = [ string ]	An Application Key (usually your domain name).
•	format = [ json, xml ]	(Optional) The format of the returned data.
•	num	(Optional) Number of entries to return (maximum of 50).
•	callback = [ jsonp callback ]	(Optional) Callback for JSONP data.

Parameters (HTTP POST)

•	feed[] = [ feed hashes(s) ]

Note: You can pass an aribtrary set of feed_hashes (see Feed/Info API) and retrieve a list of recommendations just for that set.

Returns

Array of recommendations for the provided set of feed identifiers.

Example

http://api.postrank.com/v2/recommend?appkey=postrank.com/example&format=json&num=1
POST Data
feed[]=421df2d86ab95100de7dcc2e247a08ab&
feed[]=e3db78b1f54df0a7f4f50669bbb1fce6

Results

[ { "xml": "http:\/\/feeds.feedburner.com\/RidingRails", "xml_hash": "38b4a2ab965a4319799db96b0fb86a57", "title": "Riding Rails - home" } ]

Postrank

PostRank scores can be either computed with respect to a specific feed (Feed-based PostRank), or, with respect to provided URLs (Thematic PostRank). Feed-based PostRank is a specialized variant of Thematic PostRank. By allowing you to define your own context and themes, we enable you to increase the relevancy of the content and enable you help your users find and read what matters.

Get postrank

http://api.postrank.com/v1/postrank
Returns PostRank scores for the URLs specified by the user.

Authentication

None

Note The request must be POST, but appkey and format are still specified in a GET-style query string.

Parameters (HTTP GET)

•	appkey = [ string ]	An Application Key (usually your domain name).
•	format = [ json ]	The format of the returned data.
•	callback = [ jsonp callback ]	(Optional) Callback for JSONP data.

Parameters (HTTP POST)

•	url[] = [ entry url(s) ]
•	feed_id[] = [ feed id(s) ]

Note: To retrieve feed-based PostRank each url requires a corresponding feed_id to identify the context of the post. This is necessary because the same post may appear in multiple feeds. If there are fewer feed_id[] arguments than url[] arguments, then the last feed_id[] value is used for every subsequent url[] argument. Thus if only one feed_id[] argument is specified, it will be used as the context for all the provided url[] arguments. If no feed_id[] arguments are supplied, then the resultant PostRank scores are thematic and relative only to each other.

Returns

PostRank data for each specified URL.

Example - Thematic PostRank

http://api.postrank.com/v1/postrank?appkey=aiderss.com&format=json
POST Data
url[]=http://www.igvita.com/2008/06/19/splunk-your-distributed-logs-in-ec2/&
url[]=http://www.igvita.com/2008/02/11/nginx-and-memcached-a-400-boost/

Results

{ "http:\/\/www.igvita.com\/2008\/02\/11\/nginx-and-memcached-a-400-boost\/": { "postrank": 5.7, "postrank_color": "#ffa659" },
  "http:\/\/www.igvita.com\/2008\/06\/19\/splunk-your-distributed-logs-in-ec2\/": { "postrank": 2.4, "postrank_color": "#ffcf7e" } }

Example - Feed-based PostRank

http://api.postrank.com/v1/postrank?appkey=aiderss.com&format=json
POST Data
url[]=http://www.igvita.com/2008/06/19/splunk-your-distributed-logs-in-ec2/&
url[]=http://www.igvita.com/2008/02/11/nginx-and-memcached-a-400-boost/&
feed_id[]=1&
feed_id[]=1;

Results

{ "http:\/\/www.igvita.com\/2008\/02\/11\/nginx-and-memcached-a-400-boost\/": { "postrank": 7.7, "postrank_color": "#ff8d42" },
  "http:\/\/www.igvita.com\/2008\/06\/19\/splunk-your-distributed-logs-in-ec2\/": { "postrank": 5.5, "postrank_color": "#ffa85b" } }

Errors

{"error" => "URL(s) missing"}

Ping

Tells PostRank that a feed has been updated and queues that feed for immediate fetching.

Send Ping

http://api.postrank.com/v2/ping

Authentication

None

Note you can access the Ping API using either an HTTP GET or HTTP POST request.

Parameters (HTTP GET)

•	url = [ url ]	The feed or blog URL.

Parameters (HTTP POST)

<?xml version="1.0"?>
<methodCall>
 <methodName>weblogUpdates.ping</methodName>
 <params>
  <param>
   <value>Singpolyma</value>
  </param>
  <param>
   <value>http://singpolyma.net/blog</value>
  </param>
 </params>
</methodCall>

Returns

An XML-RPC response.

Example

http://api.postrank.com/v2/ping?url=everburning.com

Results

<?xml version="1.0" encoding="UTF-8"?>
<results xmlns:opensearch='http://a9.com/-/spec/opensearch/1.1/' xmlns:aiderss='http://aiderss.com/xsd/2007-11-30/aiderss'>
 <methodResponse>
  <params>
   <param>
    <value>
     <struct>
      <member>
       <name>flerror</name>
       <value>
        <boolean>0</boolean>
       </value>
      </member>
     </struct>
    </value>
   </param>
  </params>
 </methodResponse>
</results>

Feedback and Questions

If you have any questions, ideas, or suggestions, feel free to contact us at Get Satisfaction.