About the api

How does it work?

Wakoopa provides a simple interface to access some of your data via XML and JSON. You can use this data to make your own widgets or integrate our service with other services.

If you have any questions or suggestions about our API don't hesitate to contact us.

What do we offer?

The following data is available: (click on the name to expand the entry)

  • Your most used software
  • Your most recently used software
  • Summary of your usage for the last day/week/month
  • Newly used software
  • Latest versions of your software
  • Comments on your profile
  • Reviews you've written
  • Your contacts on Wakoopa
  • Teams you are a member of

Security and privacy

Access to your data through the API is restricted by your privacy settings. Providing a feedkey as an argument to your request will override these settings. An exception to this are applications you've chosen to show to nobody; they will never appear in any response.

Keeping your feedkey private is important to your own privacy. Have you accidently shared your feedkey with anyone, you can reset your key with the button below. Make you sure you are logged in to do this.

More on JSON

By default JSON-responses are wrapped in a callback function named wakoopaApi. This is the safest and easiest way to render your data as a nifty custom widget.

Example: print a simple list of your usage 

<div id="widget"></div>
<script type="text/javascript">
	function wakoopaApi(software) {
		var html = ['<ul>'];
		for (var i = 0; i < software.length; i++) {
			var entry = software[i];
			var img = '<img src="' + entry.complete_thumb_url + '" />';
			html.push("<li>", img, entry.name, "</li>");
		}
		html.push("</ul>");
		document.getElementById("widget").innerHTML = html.join("");
	}
</script>
<script src="http://api.wakoopa.com/<username>/most_used.json"></script>

Optional arguments

At the moment there are two optional arguments you can add to the url:

  • feedkey
    For example: 
    http://api.wakoopa.com/<username>/most_used.xml/<feedkey>
    Your feedkey provides access to data you've chosen to be private. Read more about your feedkey in the privacy section.
  • limit
    For example: 
    http://api.wakoopa.com/<username>/most_used.xml?limit=25
    With this argument you can specify how much entries you want to retrieve. Should be an integer between 1 and 30.
  • callback only json
    For example: 
    http://api.wakoopa.com/<username>/most_used.json?callback=myCustomCallback
    Override the default callback function.