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.
Software API
To retrieve the software a user has used we offer a flexible api at:
http://api.wakoopa.com/<username>/software.<format>Allowed formats are xml, json or rss.
To get your desired results, try out these optional parameters:
- category only software
For example:http://api.wakoopa.com/<username>/software.xml?category=browsers
Filters the result by category. A list of categories can be found here - os only software
For example:http://api.wakoopa.com/<username>/software.xml?os=mac,web
Filters the result by operating system. This can be a single or comma-separated list of win, mac, web, iphone or linux. - key
For example:http://api.wakoopa.com/<username>/software.xml/<key>
orhttp://api.wakoopa.com/<username>/software.xml?key=<key>
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>/software.xml?limit=25
With this argument you can specify how much entries you want to retrieve. Should be an integer between 1 and 100. - offset
For example:http://api.wakoopa.com/<username>/software.xml?limit=25&offset=25
Offsets the result. Use when paginating. - order
For example:http://api.wakoopa.com/<username>/software.xml?order=asc
Order data descending or ascending. Allowed desc (default) or asc - sort
For example:http://api.wakoopa.com/<username>/software.xml?sort=active_seconds
Attribute to sort on. Allowed one of created_at (default), active_seconds or last_active_at (only software) - period only when sort is active_seconds
For example:http://api.wakoopa.com/<username>/software.xml?sort=active_seconds&period=week
Applies the sorting of active_seconds to the specified period. This can be one of day, week or month. - callback only json
For example:http://api.wakoopa.com/<username>/software.json?callback=myCustomCallback
Override the default callback function.
What else do we offer?
Besides the software API the following data is available: (click on the name to expand the entry)
- Comments on your profile
- Comments you've written
- Reviews you've written
- Your relations on Wakoopa
- Teams you are a member of
- Your contacts on Wakoopa Deprecated use relations-api
- Your most used software Deprecated, use software api
- Your most recently used software Deprecated, use software api
- Summary of your usage for the last day/week/month Deprecated, use software api
- Newly used software Deprecated, use software api
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(data) {
var html = ['<ul>'];
for (var i = 0; i < data.length; i++) {
var entry = data[i].software;
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>
