Data API

Listings

The Streamroot Data API gives access to streams, platforms, ISPs and countries in a list format. This article explains how to obtain this data.

 

Query parameters

Parameter Type Description
since string

Since given elapsed time - (s=seconds, d=days, h=hours, w=weeks).
from string YYYY-MM-DD or Unix timestamp. Required if param 'to' present.
to string

YYYY-MM-DD or Unix timestamp. Required if param 'from' present.
sortBy string

Sort the data by one of its fields (ascending order). Add the Desc keyword to sort the data by descending order (eg: sortBy=maxViewersDesc).
live* boolean  Filter to get only live or only VoD.

 *: only available for streams and platforms

 

Streams

Endpoint

GET https://apiv2.streamroot.io/data/streams

Response

[
   {
     "cdn": 4.70158912e+08,
     "p2p": 7.2717632e+07,
     "total": 4.7743067e+13,
     "percentage": 14,
     "manifest": "http://edge.com/8g7h6j5k/playlist.m3u8",
     "trafficPercentage": 3.138709845613234,
     "viewers": 0,
     "maxViewers": 153,
     "averageViewers": 142.92592592592592,
     "live": "false"
   },
   {
     "cdn": 1.591616e+06,
     "p2p": 1.983232e+06,
     "total": 3.5747383e+12,
     "percentage": 56,
     "manifest": "http://edge.com/5cfgv4b3hj/playlist.m3u8",
     "trafficPercentage": 0.020668438778910992,
     "viewers": 0,
     "maxViewers": 85,
     "averageViewers": 63.629629629629626,
     "live": "true"
   }
 ]

 

Platforms

Endpoint

GET https://apiv2.streamroot.io/data/platform

Response 

[
   {
     "platform": "web-desktop",
     "cdn": 2.34137348941e+11,
     "p2p": 4.433132624e+10,
     "total": 2.78468675181e+11,
     "upload": 4.9993121501e+10,
     "percentage": 16,
     "viewers": 5,
     "maxViewers": 12,
     "averageViewers": 2.31522025850699,
     "trafficPercentage": 56.86791477886231,
     "live": "unknown"
   },
   {
     "platform": "android",
     "cdn": 3.2359940628e+10,
     "p2p": 5.249050392e+09,
     "total": 3.760899102e+10,
     "upload": 3.485214072e+09,
     "percentage": 14,
     "viewers": 1,
     "maxViewers": 7,
     "averageViewers": 1.5443592552026286,
     "trafficPercentage": 7.680378753029257,
     "live": "unknown"
   }
 ]

 

ISPs

Endpoint

GET https://apiv2.streamroot.io/data/isp

Response 

[
   {
    "cdn": 2588337692,
    "p2p": 1703553164,
    "total": 4291890856,
    "percentage": 40,
    "isp": "1&1 Internet AG"
  },
  {
    "cdn": 854836,
    "p2p": 0,
    "total": 854836,
    "percentage": 0,
    "isp": "123 Internetworks Pty. Ltd."
  }
 ]

 

Countries

Endpoint

GET https://apiv2.streamroot.io/data/country

Response 

[
   {
    "cdn": 100604828987,
    "p2p": 24480744300,
    "total": 125085573287,
    "percentage": 20,
    "country": "BO"
  },
  {
    "cdn": 10937445200,
    "p2p": 3654261844,
    "total": 14591707044,
    "percentage": 26,
    "country": "SR"
  }
 ]

Related articles

In this article