shorten url service for internet marketing with traffic statistics

API Documentation

kl.am's API uses a simple REST interface.

Endpoint: http://kl.am/api/

Methods

shorten

Parameters:

• url - URL-encoded string
• format - json or text (optional, defaults to json)
• api_key - API key can be found under your account settings (optional, allows you to create a link under your kl.am account)
• tags - URL-encoded list of tags separated by a space (optional, only applied when authenticating with your API key)
• utm_source - Campaign source for Google Analytics (optional)
• utm_medium - Campaign medium for Google Analytics (optional)
• utm_campaign - Campaign name for Google Analytics (optional)

stats

This method is in beta and may change without warning

Parameters:

• short - Full kl.am URL or key
• group - domain or url (optional, defaults to domain)

Returns:

• clicks - Number of total clicks
• referrers - Array of referrer click counts, sorted from highest to lowest with direct click count listed last

Example:

http://kl.am/api/stats/?short=2 or
http://kl.am/api/stats/?short=http%3A%2F%2Fkl.am%2F2

Returns JSON-encoded object:

• clicks => 342
• referrers =>
  • [0] =>
    • referrer => googleblog.blogspot.com
    • clicks => 202
  • [1] =>
    • referrer => www.mattcutts.com
    • clicks => 50
  • [2] =>
    • referrer => direct
    • clicks => 90