bitly

node-bitly - Bitly API for nodejs

This module provides calls to the Bitly API for Nodejs. For more information on the API request and responses visit the Bitly API docs

node-bitly is programmed with ES7 async/await but uses the typescript compiler to ES5, so the library has been tested back to support node v4.8.4

Installation

To install via NPM type the following: npm install bitly

You can also install via git by cloning: git clone https://github.com/tanepiper/node-bitly.git /path/to/bitly

Usage

This library uses the API provided by bitly and requires an OAuth token to use. To get your access token, visit https://bitly.com/a/oauth_apps (under Generic Access Token)

See http://dev.bitly.com/ for format of returned objects from the API

Code

const BitlyClient = require('bitly');
const bitly = BitleyClient('<accessToken>');

const myFunc = async(uri = 'https://github.com/tanepiper/node-bitly') => {
  try {
    return await bitly.shorten(uri);
  } catch(e) {
    throw e;
  }
}

If you are not using node 8 then you can still use the library with Promise values:

const BitlyClient = require('bitly');
const bitly = BitleyClient('<accessToken>');

const uri = 'https://github.com/tanepiper/node-bitly';
bitly.shorten(uri).then(result => {
  console.log(result);
});

You can also do raw requests to any Bitly endpoint. With this you need to pass the access token to the method

const BitlyClient = require('bitly');
const MY_API_TOKEN = '<accessToken>';
const bitly = BitleyClient(MY_API_TOKEN);

const myFunc = async(method, data) => {
  try {
    return await bitly.doRequest({accessToken: MY_API_TOKEN, method, data});
  } catch(e) {
    throw e;
  }
}

Tests

To run tests type npm test.

Bit.ly Features

This module is limited to the following API methods:

• info
• shorten
• expand
• clicks / clicks_by_minute / clicks_by_day
• referrers
• countries
• lookup