Faster, Asynchronously Loaded Share Buttons

2012-02-16

The awe.sm-powered Facebook and Twitter share buttons can now be loaded after the initial rendering of a page by the browser. Asynchronously loading the share buttons decreases the perceived load time of your pages and is now the recommended embedding method. Review the documentation for updated examples of how to take advantage of this feature.

HTTPS support for awe.sm APIs & tools

2012-01-23

The awe.sm-powered Facebook and Twitter sharing buttons, Administration API, Create API, Conversions API and JavaScript library, and Stats API are available now via HTTPS.

To use, simply replace http:// with https:// on these resources. Optionally, you can specify a scheme-relative request by replacing http:// with //.

awe.sm tracking links support HTTPS redirections on the awe.sm domain. SSL on custom domains is not yet supported. https://awe.sm/ should only be used when redirecting to an SSL-encrypted destination to avoid insecure content warnings in some browsers.

Conversions added to Administration API

2011-12-29

Conversion Tracking can now be managed via the Administration API using the projects/new and projects/{api_key}/update endpoints.

V3 APIs Released

2011-12-05

awe.sm now has more ways to share, track, retrieve stats, and manage your projects. They're easier and faster to use than ever before.

New Features

New Administration Endpoints

Ten new endpoints to manage domains, projects, and users.

New Create API Endpoint

api.awe.sm/url/update/{awesm_id}.{format}

Modify an awe.sm link's metadata after it's been created. Useful for adding a service's post id, time of sharing, and server user's friend count to an awe.sm link.

New Stats API Endpoint

api.awe.sm/stats/active.json

Retrieve all-time stats for all clicked (active) links in a project between a specified date and the present. Useful if your application needs to update stats totals periodically.

Redirection Patterns

Redirection Patterns can automatically and dynamically alter where an awe.sm link points. They allow for metadata stored with an awe.sm link to be passed to your application at the time it’s clicked.

Improved Features

Conversions metadata can now be specified in the awe.sm settings interface and be returned in stats requests.

awe.sm-powered Share Buttons now use the V3 APIs.

Pivots allow for secondary grouping within stats. For example, you could group stats by campaign and pivot by service to see how each service performed in several campaigns.

Sorting and pagination is now allowed on group and pivot results on any performance column, ascending or descending.

Expanded Metadata

Channels can now be collectively filtered and retrieved by their associated service.

Tools can now be collectively filtered and retrieved by their associated application.

Campaigns are now stubified, while preserving human-readable names in campaign_name. When a campaign is first used, campaign_description can be specify a human-readable description of a campaign.

Users of your application can be associated with awe.sm links by user_id. The user's username, profile URL, and icon URL can also be specified when a user_id is first used.

User identities on services can be associated with awe.sm links by service_userid. The user's username, profile URL, and icon URL on the service it is sharing on can also be specified when a service_userid is first used.

Service shares can be associated with awe.sm links by service_postid. On a per awe.sm link basis, the service user's fan/follower/friend count can be stored in service_postid_reach. The time an awe.sm link is shared on a service can be stored in service_postid_shared_at.

V2 to V3 Migration Notes

awe.sm's V3 APIs are JSON only, except where noted. XML is no longer supported.

Date time values now returned as ISO 8601 formatted.

V2 Parameter Name Changes

V2 Parameter	V3 Parameter	Notes
api_key	key
awesm_id	path
awesm_url	awesm_id
clicked_after	start_date
clicked_before	end_date
notes	tag	Existing `notes` were migrated to the `tag` field. The notes field is now an arbitrary, open-ended field retrievable only on individual awe.sm links.
parent_awesm	parent
user_id	service_userid	id of the user on the channel
version	v

Create API

api.awe.sm/url/share

The destination parameter value is no longer implied based on the channel and must be specified.

api.awe.sm/url/retweet

The make_parent parameter was added to disable automatic parent-child relationship creation when an awe.sm link is passed in the text parameter, if desired.

The destination parameter value is no longer implied based on the channel and must be specified.

The AWESM_TARGET placeholder in the destination parameter is now AWESM_TEXT.