Have a cool idea on how to use our ranks?

IZEARanks gives you the tools to do this with our developers API!

Set Up

To begin, all you need to do is create an account. Once you confirm and log in, you will find your API key on your account page. Make note of this key, you'll be using it in the API's url.

Using the API

The API can be accessed by a specially formatted url, as follows:

http://izearanks.com/api?url1=ESCAPED_URL&start_date=YYYY-MM-DD&d
ays=NUMBER_OF_DAYS&type=DATA_TYPE&key=YOUR_API_KEY

It's that simple... but let's look at it a little deeper.

• ESCAPED_URL
  The url you are looking up, escaped, so http://izearanks.com would be http%3A%2F%2Fizearanks.com. Honestly, you can just leave the http:// off, but the url still needs to be escaped for other special characters that may appear.
• YYYY-MM-DD
  The start date for the data you are requesting. If you want today's data using Ruby on Rails, you would use <%=Time.now.strftime("%Y-%m-%d")%>
• NUMBER_OF_DAYS
  The number of days previous to the start date. So if your start date was 2008-01-20 and your number of days is set to 20, you would get all data between December 31, 2007 and January 20, 2008. If you just want your start date, use 0 here.
• DATA_TYPE
  Which data you are selecting. The options are: realrank, pageviews or visitors. Please note, if you look up page view or visitor data for a site that has it's stats set to private, you will not get any values back. Also note that value returned for visitors is not the total visitors to the site, just the unique visitors for that day.
• YOUR_API_KEY
  The key we mentioned above, found on your account page.

What you get from us

We return to you an XML file with the requested data. Here's a quick example, considering the following API call:

http://izearanks.com/api?url1=ESCAPED_URL&start_date=YYYY-MM-DD&d
ays=NUMBER_OF_DAYS&type=DATA_TYPE&key=YOUR_API_KEY

Will return:

<stats type="realrank">
  <site url="http://simplekindoflife.com/">
    <stat date="2007-12-15" value="115"/>
    <stat date="2007-12-14" value="109"/>
    <stat date="2007-12-13" value="110"/>
    <stat date="2007-12-12" value="110"/>
    <stat date="2007-12-11" value="119"/>
    <stat date="2007-12-10" value="137"/>
  </site>
</stats>

It gets better

Did you notice that to specify the url in the API, you set the value of url1 and not just url? That's because you can query up to 10 urls at once. Just keep adding them to the API call. Here's an example:

http://izearanks.com/api?url1=ohgizmo.com&url2=simplekindoflife.c
om&url3=thedietdiary.com/blog&url4=site_that_doesnt_exist.com&sta
rt_date=2007-12-15&days=2&type=realrank&key=abc

Would return:

<stats type="realrank">
  <site url="ohgizmo.com">
    <stat date="2007-12-15" value="1"/>
    <stat date="2007-12-14" value="2"/>
    <stat date="2007-12-13" value="2"/>
  </site>
  <site url="simplekindoflife.com">
    <stat date="2007-12-15" value="115"/>
    <stat date="2007-12-14" value="109"/>
    <stat date="2007-12-13" value="110"/>
  </site>
  <site url="thedietdiary.com/blog">
    <stat date="2007-12-15" value="31"/>
    <stat date="2007-12-14" value="32"/>
    <stat date="2007-12-13" value="33"/>
  </site>
  <site url="site_that_doesnt_exist.com"></site>
</stats>

Limitations

Currently, we only offer 5000 calls to the API a day. A day starts new at midnight EST, where our servers are located.

Show us your apps!

Have you created something cool with IZEARank's API? We want to know! If it's really really cool, we might even up your API call limit!