rayyee / unshrtn

A LevelDB backed URL unshortening microservice written in JavaScript

unshrtn

unshrtn is a LevelDB backed URL unshortening microservice written in JavaScript and Node for quick, asynchronous processing of requests. unshrtn remembers what it has already looked up so it can save you the trouble of keeping track of URLs when you are looking up a lot of them at one time and they haven't necessarily been de-duplicated. It uses the metaweb library to do the lookups.

In addition to returning the unshortened URL unshrtn will also return metadata for the page including:

• final HTTP status code
• final HTTP content type
• a canonical link for HTML responses
• a title for HTML responses

% curl http://localhost:3000?url=https://bitly.com/4kb77v
{
  "short": "https://bitly.com/4kb77v",
  "long": "https://www.youtube.com/watch?v=oHg5SJYRHA0",
  "canonical": "https://www.youtube.com/watch?v=oHg5SJYRHA0",
  "status": 200,
  "content_type": "text/html; charset=utf-8",
  "title": "RickRoll'D - YouTube"
}

The easiest way to get unshrtn up and running is with Docker.

docker run -p 3000:3000 docnow/unshrtn

You can also install it with npm:

npm install -g unshrtn