Twitter Inc HQ

Image via Wikipedia

Lately I’ve been spending my evenings and nights working on a super secret and above awesome project that I will talk about … soon, when it’s a bit more ready.

tl; dr -> github link to source

That project deals mostly with Twitter and harnessing url’s from the stream. As anyone who’s sniffed at Twitter lately can atest, therea re many, many many strange urls floating around, using any number of url shortening schemes or what seems to have become quite fashionable, a custom domains that are shortenered via services nobody could guess at.

But when you’re trying to do something useful with these it’s usually much easier when you have the original url to work with. Especially when it comes to doing things for specific domains.

What’s needed is some sort of library that can unshort pretty much any url you throw at it. Surely someone has already made one right?

Turns out, outside of a few services, no such thing existed … and I didn’t want to use a third party service. Naturally I set out to make my own library for unshortening short links.

You can check out the source on github.


It’s pretty simple to use, only has one function you should care about 🙂

var unshortener = require('unshortener');
// you can pass in a url object or string
                   function (url) {
		       // prints:

Simple logic

The approach is pretty simple:

  • take a url
  • check if known service
  • know it –> use an API
  • wtf –> pretend to be a browser

As you can see, the library is pretty simple, just 68 sloc of JavaScript code. But simple solutions are good solutions I’m told and this little thing does everything I need it to do.

Right now it directly supports only and, so if you know of any more shorteners with an expand API please tell me so I can add them. Following redirects is a bit messy and I’d prefer to do as much as possible through official API’s.

Enhanced by Zemanta

Learned something new? Want to improve your skills?

Join over 10,000 engineers just like you already improving their skills!

Here's how it works 👇

Leave your email and I'll send you an Interactive Modern JavaScript Cheatsheet 📖right away. After that you'll get thoughtfully written emails every week about React, JavaScript, and your career. Lessons learned over my 20 years in the industry working with companies ranging from tiny startups to Fortune5 behemoths.

PS: You should also follow me on twitter 👉 here.
It's where I go to shoot the shit about programming.