Display a list of ISPs used by your website visitors.
This API produces a json array.
One or more of the following parameters are required:
date Calculate the top ISPs from the specified date entered as yyyy-MM-dd. Default is the current date.
unixTime Calculate the top ISPs from the specified unix timestamp. Default is the current unix timestamp.
period Specify the period:
timeZone Calculate the top ISPs for the specified timezone. The default is the site's defined timezone.
limit The maximum number of records to be displayed in the output. Default is [100].
Optional parameters:
login Your opentracker login email. Default is [demo@opentracker.net].
password Your password.
ticketId A ticketId can be used to provide credentials with an expiring token. A ticketId can be used instead of a login/ password combination. Further information can be found here.
segment This is the property field based on which you want to segment the data. By default there are no segments. You can find more information here.
filter You can choose to see no segments [none] (default), see all segments showAllSorts, or by specifying the name of the segment.
site The site to display data for. Default is [www.opentracker.net].
filterByText Only ISPs that contain this text will be shown.
locale The locale parameter is an identifier for a particular combination of language and region (e.g. en_US) and determines the format of the data returned. A list of locales can be found here.
ignoreLocale Display columns without language translation [false]|true.
dataType The dataType parameter determines the format of the data returned. Values can be [ json ] | html | jsondatatable | jsonjqgrid
Display a top ISPs list for the website www.opentracker.net for the user "demo@opentracker.net" with password "demo123":
HTTP GET/ POST:/api/location/top_isps.jsp?period=1d&login=demo@opentracker.net&password=demo123&site=www.opentracker.net
Display a top ISPs list for the website www.opentracker.net from 2023-12-05 and three days back display in html:
HTTP GET/ POST:/api/location/top_isps.jsp?date=2023-12-05&login=demo@opentracker.net&password=demo123&site=www.opentracker.net&period=3d&dataType=html
Display a top ISPs list for the website www.opentracker.net for 2023-12-05:
HTTP GET/ POST:/api/location/top_isps.jsp?date=2023-12-05
This last example returns a json array with 'n' entries starting from the specified period formatted as:
{ "resultsList": [
{
"No.":"1",
"isp":"China Unicom",
"users":"4",
"bar":"||||||||||||||||||||",
"percentage":"0.3%"}
,
{
"No.":"2",
"isp":"Andhra Pradesh State Fibernet Limited",
"users":"4",
"bar":"||||||||||||||||||||",
"percentage":"0.3%"}
,
{
"No.":"3",
"isp":"Bell Mobility",
"users":"4",
"bar":"||||||||||||||||||||",
"percentage":"0.3%"}
,
{
"No.":"4",
"isp":"Astound Broadband",
"users":"4",
"bar":"||||||||||||||||||||",
"percentage":"0.3%"}
,
{
"No.":"5",
"isp":"Bell Dsl Internet",
"users":"4",
"bar":"||||||||||||||||||||",
"percentage":"0.3%"}
,
{
"No.":"",
"isp":"",
"users":"20",
"bar":"",
"percentage":"100%"}
]
}
If errors are encountered, the first encountered error will be returned of form "Error: exception: message
Error: java.lang.RuntimeException: Login/ site combination is not valid