API

Base URL is http://api.azubu.tv

 

Timing

Broadcast data is updated every 30 seconds or so. There is therefore no benefit in querying the API server any faster than this. Querying too fast may result in your requests being rate limited or blocked entirely.

Key Data Structures

 

User Record

The user structure gives details of a channel owner.

Field Name
Type Description
id integer Unique key field for the Broadcaster/User
username string Unique string field for the Broadcaster/User
display_name string String to be displayed in user interfaces.
alt_name string Alternative display name.

Channel Record

The channel structure gives various URLs for a channel as well as extra details if the channel is currently streaming.

Field Name
Type Description
user User record The user record describing the owner of this channel record
url_thumbnail url Fully qualified URL of a thumbnail image.
url_channel url Fully qualified URL of the channel’s web site/page.
url_stream url Fully qualified URL for live stream of the channel. This URL can be used to show the stream in a pop up window. Opening this url only makes sense if is_live is true.
url_chat url Fully qualified URL for a chat window for the stream. Opening this url only makes sense if is_live is true.
is_live bool true if the channel is currently live.
followers_count int The number of followers for this channel
view_count int The view count for the current live stream
vods_view_count int The view count for VODs on this channel.

List of Live channels

{base-url}/public/channel/live/list

Live Example

Example Output:

{

   “data”:[

      {

         "user":{

            "id": 123,

            "username":"FnaticTV",

            "display_aame": "FnaticTV",

            "alt_name":"FnaticTV"

         },

         "url_thumbnail":"http:\/\/img.azubu.tv\/images\/channel\/1\/1\/119acf3fd9a245e30c7cd36df61f81996f00ffd1-1140x670.jpeg",

         "url_channel":"http:\/\/www.azubu.tv\/FnaticTV",

         "url_stream":"http:\/\/www.azubu.tv\/FnaticTV\/videopopup",

         "url_chat":"http:\/\/www.azubu.tv\/FnaticTV\/chatpopup"

         "is_live":true,

         "followers_count":17,

         "view_count":92,

         "vods_view_count":0

      },

      {

         "user":{

           "id": 1234,

            "username":"Riot_Games"

            "display_aame": "Riot Games",

            "alt_name":"Riot Games"

         },

         "url_thumbnail":"http:\/\/img.azubu.tv\/images\/channel\/9\/5\/95e0b6715d7fa6bb548f8860be35af4265001ae3-1140x670.jpeg",

         "url_channel":"http:\/\/www.azubu.tv\/Riot_Games",

         "url_stream":"http:\/\/www.azubu.tv\/Riot_Games\/videopopup",

         "url_chat":"http:\/\/www.azubu.tv\/Riot_Games\/chatpopup"

         "is_live":true,

         "followers_count":742,

         "view_count":9640,

         "vods_view_count":0

      }

   ],

   “total”:2,

   “limit”:100,

   “offset”:0

}

Live channels by game:

{base-url}//public/channel/live/list/game/{game-name}

Examples:

{base-url}/public/channel/live/list/game/league-of-legends

League of Legends Live Example

{base-url}/public/channel/live/list/game/hearthstone

Hearthstone Live Example

List of all Azubu Games

Example Output:

{

“data”:[

{    "user":{"username":"Cyanide"},

"url_thumbnail":"http:\/\/img.azubu.tv\/images\/channel\/0\/f\/0f3bb3c3110e1a9a4a07b9b32086947a79332a64-1140x670.jpeg",

"is_live":true,

"followers_count":1472,

"view_count":701,

"vods_view_count":22973},

{    "user":{"username":"Riot_Games_Oceania"},

"url_thumbnail":"http:\/\/img.azubu.tv\/images\/channel\/7\/b\/7bff5b8e0c588b790ffd4167b23295729b8a0aeb-1140x670.jpeg",

"is_live":true,

"followers_count":58,

"view_count":78,

"vods_view_count":6244},

{    "user":{"username":"BunnyFuFuu"},

"url_thumbnail":"http:\/\/img.azubu.tv\/images\/channel\/1\/4\/1422681a67740d47d0e203431c0cb32f31709954-1140x670.jpeg",

"is_live":true,

"followers_count":9,

"view_count":13,

"vods_view_count":74}

],

“total”:3,

“limit”:100,

“offset”:0

}

 

Channels By Game

A list of all channels for a particular game.

{base-url}/public/channel/list/game/{game-name}

Channel details

{base-url}/public/channel/{channel-name}

Example Output

{

   “data”:{

      “user”:{

         “username”:“Cyanide”

      },

      “url_thumbnail”:“http:\/\/img.azubu.tv\/images\/channel\/1\/8\/1899cfbf723fa632cdb96640b624f1d93ac2cfe2-700×394.jpeg”,

      “is_live”:true,

      “followers_count”:1125,

      “view_count”:265,

      “vods_view_count”:0

   }

}

Channel Statistics

 

{base-url}/public/channel/{channel-name}/info

Example Output

{

   “data”:{

      “is_live”:true,

      “followers_count”:742,

      “view_count”:9778,

      “vods_view_count”:0

   }

}