General usage

http://api.exslim.net/pagerank?url=<URL>&key=<API key>

• url — "quoted" URL. You are able to provide URL with http:// prefix.
• key — your personal API key

http://api.exslim.net/pagerank?url=www.python.org/peps%3Fpep%3D10000042175634

http://api.exslim.net/pagerank?url=www.python.org/peps?pep=10000042175634

import urllib
urllib.quote(url)

Additional params

http://api.exslim.net/pagerank?url=ya.ru&key=<API key>&return=raw

return — specifies response format

• raw(default) — return only pagerank(digit)
• xml — return xml document ↓

		<response code="200">
				<url>ya.ru</url>
				<result>6</result>
			</response>

Request limit, HTTP methods, Character Encoding

• Request limit — It depends on API key
• HTTP methods — Only GET method supported
• Character Encoding — UTF-8

How service controls resources

Service records how much requests you do in a calendar day and resets measurement at UTC. When a qouta is depleted, service returns HTTP 403 error. You can monitor resource usage at the following URL

http://api.exslim.net/status/pagerank?key=<API key>

HTTP Response Status Codes

• 200 — Everything fine
• 400 — Bad request, check request url
• 403 — Access denied due invalid api key, quota exeed etc.
• 404 — Possible, non existing URL
• 500 — Something wrong with server

Parsing response

As you can see, no need to parse raw response. But if you choose xml reponse — you have to parse it. The following example shows the simpliest way, how do it with Python and BeautifulSoup

 
from BeautifulSoup import BeautifulSoup
import urllib2
	 
response = urllib2.urlopen("http://full_api_url")
	 
soup = BeautifulSoup(response)
if soup.response['code'] == 200:
	#do something
	print 'URL:%s - PageRank:%s' % (soup.response.url, soup.response.result)