Added support to fetch referrers of a given short url or hash

bitly_api/bitly_api.py

@@ -103,6 +103,22 @@ def clicks(self, hash=None, shortUrl=None):
 
         data = self._call(self.host, 'v3/clicks', params, self.secret)
         return data['data']['clicks']
+
+    def referrers(self, hash=None, shortUrl=None):
+        """ given a bit.ly url or hash, get statistics about the referrers of that link """
+        if not hash and not shortUrl:
+            raise BitlyError(500, 'MISSING_ARG_SHORTURL')
+        params = {
+            'login' : self.login,
+            'apiKey' : self.api_key
+        }
+        if hash:
+            params['hash'] = hash
+        if shortUrl:
+            params['shortUrl'] = shortUrl
+
+        data = self._call(self.host, 'v3/referrers', params, self.secret)
+        return data['data']['referrers']
 
     def clicks_by_day(self, hash=None, shortUrl=None):
         """ given a bit.ly url or hash, get a time series of clicks

test/test_bitly_api.py

@@ -20,3 +20,8 @@ def testExpand():
     assert len(data) == 1
     assert data[0]['error'] == 'NOT_FOUND'
 
+def testReferrer():
+    bitly = bitly_api.Connection('bitlyapidemo','R_0da49e0a9118ff35f52f629d2d71bf07')
+    data = bitly.referrers(hash='a')
+    assert data != None
+    assert len(data) > 1