awe.sm Stats API

These endpoints are used to retrieve data on how your awe.sm-powered tracking links have performed.

Please review the key concepts before continuing.

Retrieve stats

stats/range

This is the most powerful way to navigate project-wide data for a given time period. It allows you to filter, group, pivot, and sort on any of the attributes of the awe.sm links active in the specified time period.

Retrieve stats in intervals

stats/range/intervals

When your application needs to generate a graph, use this endpoint to retrieve the same project-wide data as the Range Endpoint in intervals of specified duration (i.e. hour, day, and week). It also allows you to filter, group, pivot, and sort on any of the attributes of the awe.sm links active in the specified time period.

Retrieve total stats on active links

stats/active

If your application needs to track all-time stats, periodically use this endpoint to retrieve updated totals values of active awe.sm links.

Retrieve an awe.sm link's stats

stats/{awesm_id}

When you want to retrieve information on a specific known awe.sm link on your project. Set with_metadata to TRUE to view all the context details associated with the creation of this awe.sm link.

Retrieve individual stats for multiple awe.sm links

stats/awesm_ids/batch

If your application needs to get the details on multiple known awe.sm links, use this endpoint to pass an array of links and get information on all of them with a single request.

Last updated 2011-11-30