Clicky API version 2 released

I am happy to announce the release of version 2 of the Clicky API. It has a unique URL from the old version to ensure that existing applications continue to function as expected. There are a few changes that are not backwards compatible, although these changes are very minor and should not take more than a few minutes to implement within existing applications. Juicy details are available in the API documentation, but here's a brief run down of what's new:

* new "actions-list" data type, includes ability to filter by session_id
* relative date formats ("5 days ago", "last 10 days", "last month", etc)
* a limit of "all" for every data type
* shorter cache times
* more consistent naming schemes for both data types and data values
* null values excluded by default (saves memory and bandwidth, can be disabled)
* new "total time" data type
* some new parameters: session_id, null_values, app
* CSV output (this was supported before, but undocumented)
* and more...


I know some people were hoping for more filters in the new version (such as filtering actions by title or url, or filtering visitors by referer domain or search query), but I just haven't been able to optimize them enough yet to allow this. But do note that we plan to have this functionality at some point in the future.

The API is now officially out of "beta" status. When it was first released many months ago, it was stated that there would be some restrictions for non-Pro users at a later date. (Pro is our upper tier premium package). These restrictions have changed to be much more relaxed, but please note that they are now in effect for all non-Pro users:

* Limited to 100 results per request
* Limited to "today" and "yesterday"
* 30 minute cache times

An important note to developers: The "Base API URL" is no longer provided or supported. This is to ensure that you are always in control of which version of the API is being used with your application. More information about this is in the docs.
1 comment |   Sep 09 2007 3:16pm





Copyright © 2017, Roxr Software Ltd     Blog home   |   Clicky home   |   RSS