bitly Data APIs

Here at bitly, we see about 4 billion clicks a month, and millions of new links a day. We love looking through this enormous set of data to find interesting stuff -- and we're extremely excited to open up some of the system-wide data endpoints we use, for you to build cool things too!

/v3/highvalue

Returns a specified number of "high-value" bitly links that are popular across bitly at this particular moment.

Authentication: oauth2

Parameters

  • limit - the maximum number of high-value links to return.

Example Request

API Address: https://api-ssl.bitly.com
GET /v3/highvalue?access_token=ACCESS_TOKEN&limit=2

Example Response

{
  "data": {
    "params": {
      "lang": "en",
      "limit": 2
    },
    "values": [
      "http://bit.ly/Shd5nT",
      "http://bit.ly/VJqu9q"
    ]
  },
  "status_code": 200,
  "status_txt": "OK"
}

/v3/realtime/bursting_phrases

Returns phrases that are receiving an uncharacteristically high volume of click traffic, and the individual links (hashes) driving traffic to pages containing these phrases.

Authentication: oauth2

Example Request

API Address: https://api-ssl.bitly.com
GET /v3/realtime/bursting_phrases?access_token=ACCESS_TOKEN

Example Response

{
  "data": {
    "current_lag": 4,
    "phrases": [
      {
        "N": 644933,
        "ghashes": [
          {
            "ghash": "1534dqE",
            "visitors": 214
          },
          {
            "ghash": "123Tzxi",
            "visitors": 77
          },
          {
            "ghash": "YwtqHA",
            "visitors": 53
          },
          {
            "ghash": "171mi59",
            "visitors": 52
          },
          {
            "ghash": "10VIMDX",
            "visitors": 45
          }
        ],
        "mean": 0.17000000000000001,
        "phrase": "north korea",
        "rate": 0.29999999999999999,
        "std": 0.041785272667362532,
        "urls": [
          {
            "aggregate_url": "http://bit.ly/1534dqE",
            "visitors": 214
          },
          {
            "aggregate_url": "http://bit.ly/123Tzxi",
            "visitors": 77
          },
          {
            "aggregate_url": "http://bit.ly/YwtqHA",
            "visitors": 53
          },
          {
            "aggregate_url": "http://bit.ly/171mi59",
            "visitors": 52
          },
          {
            "aggregate_url": "http://bit.ly/10VIMDX",
            "visitors": 45
          }
        ]
      },
      {
        "N": 4026,
        "ghashes": [
          {
            "ghash": "123InRj",
            "visitors": 266
          },
          {
            "ghash": "12VnuGK",
            "visitors": 180
          },
          {
            "ghash": "10QUZsc",
            "visitors": 38
          },
          {
            "ghash": "171cUOS",
            "visitors": 10
          },
          {
            "ghash": "17vqEEC",
            "visitors": 8
          }
        ],
        "mean": 0.01,
        "phrase": "jackie robinson",
        "rate": 0.16,
        "std": 0.0042133518459201253,
        "urls": [
          {
            "aggregate_url": "http://bit.ly/123InRj",
            "visitors": 266
          },
          {
            "aggregate_url": "http://bit.ly/12VnuGK",
            "visitors": 180
          },
          {
            "aggregate_url": "http://bit.ly/10QUZsc",
            "visitors": 38
          },
          {
            "aggregate_url": "http://bit.ly/171cUOS",
            "visitors": 10
          }
        ]
      }
    ],
    "selectivity": 3,
    "time": 1365800585
  },
  "status_code": 200,
  "status_txt": "OK"
}

/v3/realtime/hot_phrases

Returns phrases that are receiving a consistently high volume of click traffic, and the individual links (hashes) driving traffic to pages containing these phrases.

Authentication: oauth2

Example Request

API Address: https://api-ssl.bitly.com
GET /v3/realtime/hot_phrases?access_token=ACCESS_TOKEN

Example Response

{
  "data": {
    "current_lag": 4,
    "phrases": [
      {
        "ghashes": [
          {
            "ghash": "QSQsPh",
            "visitors": 998
          },
          {
            "ghash": "ScRWYS",
            "visitors": 266
          },
          {
            "ghash": "ScHTDa",
            "visitors": 194
          },
          {
            "ghash": "QSxSab",
            "visitors": 131
          },
          {
            "ghash": "NW3HC7",
            "visitors": 101
          },
          {
            "ghash": "P9c0rD",
            "visitors": 47
          },
          {
            "ghash": "SbjnSG",
            "visitors": 26
          },
          {
            "ghash": "QghCiw",
            "visitors": 23
          },
          {
            "ghash": "Rvip6f",
            "visitors": 22
          },
          {
            "ghash": "Sb02kE",
            "visitors": 21
          },
          {
            "ghash": "NWxRS6",
            "visitors": 18
          },
          {
            "ghash": "NbDukJ",
            "visitors": 17
          },
          {
            "ghash": "OGqPAx",
            "visitors": 17
          }
        ],
        "phrase": "top gun",
        "rate": 1.0414969999999999
      },
      {
        "ghashes": [
          {
            "ghash": "PyyGlF",
            "visitors": 914
          },
          {
            "ghash": "SIDJ3h",
            "visitors": 209
          },
          {
            "ghash": "OQQbkR",
            "visitors": 35
          },
          {
            "ghash": "NBn40C",
            "visitors": 29
          },
          {
            "ghash": "SIv7K3",
            "visitors": 29
          },
          {
            "ghash": "QhQMGI",
            "visitors": 21
          }
        ],
        "phrase": "iphone 5",
        "rate": 0.76665669999999997
      }
    ],
    "time": 1345477932.46945
  },
  "status_code": 200,
  "status_txt": "OK"
}

/v3/realtime/clickrate

Returns the click rate for content containing a specified phrase.

Authentication: oauth2

Parameters

  • phrase - the phrase for which you'd like to get the click rate.

Example Request

API Address: https://api-ssl.bitly.com
GET /v3/realtime/clickrate?access_token=ACCESS_TOKEN&phrase=obama

Example Response

{
  "data": {
    "ghash": null,
    "lag": 4,
    "phrase": "obama",
    "rate": 1.123823,
    "time": 1342623038
  },
  "status_code": 200,
  "status_txt": "OK"
}