Skip to main content's shorten API

When the @ URL shortener originally debuted it was internal only. It initially had no web interace, no statistics, really not much of anything. While used mostly for @ and the Google Toolbar a few creative hackers where able to reverse engineer the shorten API.

Several months pass and Google has publicly launched the service with a fully working web interface. Also available are click through stats and and a history of links generated with your account. Google had this to say about the official API:

...we wanted to let you know we do plan to release an official API for in the future. You’ll be able to use the API to shorten URLs, expand URLs, and view analytics from directly within your own applications.

While poking around the web interface I discovered the shortening of URLs was happening with a simple AJAX request. No complicated algorithms needed. The exact request is a POST to with a paramater of url set to the URL you wish to shorten. You can see a snapshot of the request with @'s console.

Optionally you can pass a security_token paramater which will associate the shortened URL with your account. I do not however know how Google is generating the token. The format of security_token is hash:timestamp. Here is an example: j2Puli6c9i-lJjZse3WcJKzqC-No:1286694076556.

The security_token can also be used to get a users history. A POST request to will return a JSON payload with statistics for two hours, day, week, month and all time.

I checked a few combinations to get individual statistics for a shortened URL didn't have any luck. A few I tried were,,,, and a few others.

If you have any luck getting statistics for a single URL let me know in the comments.

Update: @ has created an unofficial API for getting click statistics.


  1. I'm also searching for API to work with my tweetmeme wordpress plugin.

  2. Hi, i have write an unofficial API for make that, it use the data visible on the "info" page.

    You can test it there :
    (the count value I returns is the "total clicks on all short URLs pointing to this long URL")

    Have fun
    ps: sorry for my bad english

  3. I tried doing this to get the statistics

    $page = file_get_contents('');

    preg_match('/urlshortener.initInfo\((.+)\);/', $page, $matches);
    $json_string = $matches[1];

    $data = json_decode($json_string, $array = true);


  4. I tried doing this to get the statistics

    $page = file_get_contents('');

    preg_match('/urlshortener.initInfo\((.+)\);/', $page, $matches);
    $json_string = $matches[1];

    $data = json_decode($json_string, $array = true);



Post a Comment

Popular posts from this blog

Sync is currently experiencing problems

Update: I now recommend you install Google Chrome and disable the built in Browser as it supports encrypting all synced data.

After picking up a gorgeous Galaxy Nexus yesterday I was running into an issue where my browser data wasn't syncing to the phone. After a little Googling I found this is commonly caused by having all of my synced Chrome data encrypted instead of the default of only encrypting the passwords. These are the steps I went through to get my dat syncing again without losing any of it. The exact error I was getting was "Sync is currently experiencing problems. It will be back shortly."

In Google Chrome open the personal stuff settings page by clicking this link or by opening the wrench menu, and click on "signed in with".  Hit "disconnect your Google Account" to temporarily disable syncing from your browser.

Visit the Google Dashboard and "Stop sync and delete data from Google". I waited until the stored dat…

Installing Storytlr the lifestreaming platform

"Storytlr is an open source lifestreaming and micro blogging platform. You can use it for a single user or it can act as a host for many people all from the same installation."

I've been looking for something like Storytlr for a few months now or at least trying to do it with Drupal. While I love Drupal and FeedAPI I did not want to spend all that time building a lifestream website. So I've been playing around with Storytlr instead and found it very easy. Here is how I got it up and running on a Ubuntu EC2 server. You can also check out the official Storytlr install instructions.

LAMP stack installed and running.Domain setup for a directory.MySQL database and user ready to go.Lets get started!
Get the code: wget tar -xvzf storytlr-0.9.2.tgzYou can find out the latest stable release on Storytlr's downloads page.

Import the database:
Within protected/install is database.sql. Import this into your empt…

Little known @Twitter and @TwitterAPI tips and tricks

Be sure to comeback as new tips and tricks get added. If you know of anything I missed be sure to let me know.

Static URL for profile images based on screen_name:

* This performs a http redirect to the actual profile image URL. Currently https redirects to http. You can also add "?size={mini | bigger | normal}" to get specific sizes.

Redirect to profile based on user_id:

In_reply_to_status_id mentions:

* In the web interface new mentions are only replies if they start with @screen_name. By pushing @screen_name further along in the string your followers who do not follow @screen_name will still see the status.

Profile image sizes:

* By default you get the original image size you can add _mini, _normal, and …