Display list of referrers through which visitors come to your website in order of popularity.
This API produces a json array.
One or more of the following parameters are required:
detailLevel
The detail level, either the entire url, or only the domain. [domain] | url.
filterBySearchEngines
Will search engines be displayed. [true] | false.
filterByUrl
Filter by url. If set then only show urls containing the value set. Wild cards can be used. Example: *google* searches for all urls containing the keyword 'google'.
date
Calculate the top referrers from the specified date entered as yyyy-MM-dd. Default is the current date.
unixTime
Calculate the top referrers from the specified unix timestamp. Default is the current unix timestamp.
period
The time-range considered for calculating the top referrers with respect to the date. For example: 3d for 3 days offset.
timezone
Calculate the top referrers for the specified timezone. Default is the site's defined timezone.
limit
The number of rows to show [100].
Optional parameters:
login
Your opentracker login email. The 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].
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
dateFormat
The dateFormat parameter determines the format of dates returned. An example is dateFormat=yyyy-dd-MM. The syntax can be found here.
Display a top referrers for the website www.opentracker.net for the user "demo@opentracker.net" with password "demo123":
HTTP GET/ POST:/api/top_lists/top_referrers.jsp?period=1d&login=demo@opentracker.net&password=demo123&site=www.opentracker.net
Display a top referrers list for the website www.opentracker.net from 2023-03-03 and three days back display in html:
HTTP GET/ POST:/api/top_lists/top_referrers.jsp?date=2023-3-3&login=demo@opentracker.net&password=demo123&site=www.opentracker.net&period=3d&dataType=html
Display a top referrers list for the website www.opentracker.net from now to three days back:
HTTP GET/ POST:/api/top_lists/top_referrers.jsp?period=3d
This last example returns a json array with 'n' entries starting from the specified period formatted as:
{ "resultsList": [ { "No.":"1", "referring domain or url":"www.google.com", "sessions":"5949", "graph":"||||||||||||||||||||", "events":"15655", "avg. pv/ v":"2.6", "events_bar":"||||||||||||||||||||"} , { "No.":"2", "referring domain or url":"www.bing.com", "sessions":"87", "graph":"|", "events":"195", "avg. pv/ v":"2.2", "events_bar":"|"} , { "No.":"3", "referring domain or url":"search.brave.com", "sessions":"77", "graph":"|", "events":"191", "avg. pv/ v":"2.5", "events_bar":"|"} , { "No.":"4", "referring domain or url":"duckduckgo.com", "sessions":"28", "graph":"|", "events":"60", "avg. pv/ v":"2.1", "events_bar":"|"} , { "No.":"5", "referring domain or url":"www.google.co.in", "sessions":"27", "graph":"|", "events":"78", "avg. pv/ v":"2.9", "events_bar":"|"} , { "No.":"6", "referring domain or url":"www.google.co.uk", "sessions":"23", "graph":"|", "events":"54", "avg. pv/ v":"2.3", "events_bar":"|"} , { "No.":"7", "referring domain or url":"www.bulutwebsite.com", "sessions":"20", "graph":"|", "events":"42", "avg. pv/ v":"2.1", "events_bar":"|"} , { "No.":"8", "referring domain or url":"www.google.de", "sessions":"20", "graph":"|", "events":"47", "avg. pv/ v":"2.4", "events_bar":"|"} , { "No.":"9", "referring domain or url":"www.google.nl", "sessions":"10", "graph":"|", "events":"23", "avg. pv/ v":"2.3", "events_bar":"|"} , { "No.":"10", "referring domain or url":"www.google.ca", "sessions":"10", "graph":"|", "events":"25", "avg. pv/ v":"2.5", "events_bar":"|"} , { "No.":"11", "referring domain or url":"www.google.co.id", "sessions":"10", "graph":"|", "events":"37", "avg. pv/ v":"3.7", "events_bar":"|"} , { "No.":"12", "referring domain or url":"www.google.fr", "sessions":"9", "graph":"|", "events":"14", "avg. pv/ v":"1.6", "events_bar":"|"} , { "No.":"13", "referring domain or url":"keyinsight.com", "sessions":"8", "graph":"|", "events":"28", "avg. pv/ v":"3.5", "events_bar":"|"} , { "No.":"14", "referring domain or url":"in.search.yahoo.com", "sessions":"8", "graph":"|", "events":"27", "avg. pv/ v":"3.4", "events_bar":"|"} , { "No.":"15", "referring domain or url":"www.google.it", "sessions":"8", "graph":"|", "events":"13", "avg. pv/ v":"1.6", "events_bar":"|"} , { "No.":"16", "referring domain or url":"x.com", "sessions":"8", "graph":"|", "events":"11", "avg. pv/ v":"1.4", "events_bar":"|"} , { "No.":"17", "referring domain or url":"www.google.com.au", "sessions":"7", "graph":"|", "events":"18", "avg. pv/ v":"2.6", "events_bar":"|"} , { "No.":"18", "referring domain or url":"www.youtube.com", "sessions":"6", "graph":"|", "events":"8", "avg. pv/ v":"1.3", "events_bar":"|"} , { "No.":"19", "referring domain or url":"www.google.com.hk", "sessions":"6", "graph":"|", "events":"8", "avg. pv/ v":"1.3", "events_bar":"|"} , { "No.":"20", "referring domain or url":"cloudzy.com", "sessions":"5", "graph":"|", "events":"8", "avg. pv/ v":"1.6", "events_bar":"|"} , { "No.":"21", "referring domain or url":"www.google.com.pk", "sessions":"5", "graph":"|", "events":"8", "avg. pv/ v":"1.6", "events_bar":"|"} , { "No.":"22", "referring domain or url":"www.opentracker.net", "sessions":"5", "graph":"|", "events":"7", "avg. pv/ v":"1.4", "events_bar":"|"} , { "No.":"23", "referring domain or url":"m.facebook.com", "sessions":"4", "graph":"|", "events":"21", "avg. pv/ v":"5.2", "events_bar":"|"} , { "No.":"24", "referring domain or url":"blog.opentracker.net", "sessions":"4", "graph":"|", "events":"4", "avg. pv/ v":"1", "events_bar":"|"} , { "No.":"25", "referring domain or url":"uk.search.yahoo.com", "sessions":"4", "graph":"|", "events":"8", "avg. pv/ v":"2", "events_bar":"|"} , { "No.":"26", "referring domain or url":"search.yahoo.com", "sessions":"4", "graph":"|", "events":"10", "avg. pv/ v":"2.5", "events_bar":"|"} , { "No.":"27", "referring domain or url":"com.google.android.googlequicksearchbox", "sessions":"4", "graph":"|", "events":"11", "avg. pv/ v":"2.8", "events_bar":"|"} , { "No.":"28", "referring domain or url":"www.google.ch", "sessions":"4", "graph":"|", "events":"12", "avg. pv/ v":"3", "events_bar":"|"} , { "No.":"29", "referring domain or url":"www.google.com.ph", "sessions":"4", "graph":"|", "events":"8", "avg. pv/ v":"2", "events_bar":"|"} , { "No.":"30", "referring domain or url":"www.google.ro", "sessions":"4", "graph":"|", "events":"14", "avg. pv/ v":"3.5", "events_bar":"|"} , { "No.":"31", "referring domain or url":"event.on24.com", "sessions":"4", "graph":"|", "events":"4", "avg. pv/ v":"1", "events_bar":"|"} , { "No.":"32", "referring domain or url":"www.google.se", "sessions":"3", "graph":"|", "events":"6", "avg. pv/ v":"2", "events_bar":"|"} , { "No.":"33", "referring domain or url":"www.ecosia.org", "sessions":"3", "graph":"|", "events":"14", "avg. pv/ v":"4.7", "events_bar":"|"} , { "No.":"34", "referring domain or url":"euc-powerpoint.officeapps.live.com", "sessions":"2", "graph":"|", "events":"2", "avg. pv/ v":"1", "events_bar":"|"} , { "No.":"35", "referring domain or url":"chatgpt.com", "sessions":"2", "graph":"|", "events":"2", "avg. pv/ v":"1", "events_bar":"|"} , { "No.":"36", "referring domain or url":"www.google.com.my", "sessions":"2", "graph":"|", "events":"3", "avg. pv/ v":"1.5", "events_bar":"|"} , { "No.":"37", "referring domain or url":"presearch.com", "sessions":"2", "graph":"|", "events":"5", "avg. pv/ v":"2.5", "events_bar":"|"} , { "No.":"38", "referring domain or url":"www.trackercellphone.com", "sessions":"2", "graph":"|", "events":"3", "avg. pv/ v":"1.5", "events_bar":"|"} , { "No.":"39", "referring domain or url":"www.google.com.tr", "sessions":"2", "graph":"|", "events":"4", "avg. pv/ v":"2", "events_bar":"|"} , { "No.":"40", "referring domain or url":"www.mariacardador.com", "sessions":"2", "graph":"|", "events":"3", "avg. pv/ v":"1.5", "events_bar":"|"} , { "No.":"41", "referring domain or url":"www.eknazar.com", "sessions":"2", "graph":"|", "events":"3", "avg. pv/ v":"1.5", "events_bar":"|"} , { "No.":"42", "referring domain or url":"ca.search.yahoo.com", "sessions":"2", "graph":"|", "events":"2", "avg. pv/ v":"1", "events_bar":"|"} , { "No.":"43", "referring domain or url":"yandex.ru", "sessions":"2", "graph":"|", "events":"6", "avg. pv/ v":"3", "events_bar":"|"} , { "No.":"44", "referring domain or url":"www.google.cl", "sessions":"2", "graph":"|", "events":"4", "avg. pv/ v":"2", "events_bar":"|"} , { "No.":"45", "referring domain or url":"zettels.info", "sessions":"2", "graph":"|", "events":"6", "avg. pv/ v":"3", "events_bar":"|"} , { "No.":"46", "referring domain or url":"www.weibingwangwe.com", "sessions":"2", "graph":"|", "events":"3", "avg. pv/ v":"1.5", "events_bar":"|"} , { "No.":"47", "referring domain or url":"cms.tripoculture.com", "sessions":"2", "graph":"|", "events":"2", "avg. pv/ v":"1", "events_bar":"|"} , { "No.":"48", "referring domain or url":"www-opentracker-net.translate.goog", "sessions":"2", "graph":"|", "events":"5", "avg. pv/ v":"2.5", "events_bar":"|"} , { "No.":"49", "referring domain or url":"www.google.co.za", "sessions":"2", "graph":"|", "events":"2", "avg. pv/ v":"1", "events_bar":"|"} , { "No.":"50", "referring domain or url":"www.google.pt", "sessions":"2", "graph":"|", "events":"5", "avg. pv/ v":"2.5", "events_bar":"|"} , { "No.":"51", "referring domain or url":"www.google.com.ar", "sessions":"2", "graph":"|", "events":"3", "avg. pv/ v":"1.5", "events_bar":"|"} , { "No.":"52", "referring domain or url":"learn.codeavengers.com", "sessions":"2", "graph":"|", "events":"4", "avg. pv/ v":"2", "events_bar":"|"} , { "No.":"53", "referring domain or url":"github.com", "sessions":"2", "graph":"|", "events":"2", "avg. pv/ v":"1", "events_bar":"|"} , { "No.":"54", "referring domain or url":"www.google.at", "sessions":"2", "graph":"|", "events":"3", "avg. pv/ v":"1.5", "events_bar":"|"} , { "No.":"55", "referring domain or url":"unrest.webnode.page", "sessions":"2", "graph":"|", "events":"2", "avg. pv/ v":"1", "events_bar":"|"} , { "No.":"56", "referring domain or url":"ot3.opentracker.net", "sessions":"2", "graph":"|", "events":"3", "avg. pv/ v":"1.5", "events_bar":"|"} , { "No.":"57", "referring domain or url":"joachimrichter.de", "sessions":"1", "graph":"|", "events":"11", "avg. pv/ v":"11", "events_bar":"|"} , { "No.":"58", "referring domain or url":"coccoc.com", "sessions":"1", "graph":"|", "events":"12", "avg. pv/ v":"12", "events_bar":"|"} , { "No.":"59", "referring domain or url":"www.google.com.mx", "sessions":"1", "graph":"|", "events":"3", "avg. pv/ v":"3", "events_bar":"|"} , { "No.":"60", "referring domain or url":"proxysp.com", "sessions":"1", "graph":"|", "events":"1", "avg. pv/ v":"1", "events_bar":"|"} , { "No.":"61", "referring domain or url":"www.google.lt", "sessions":"1", "graph":"|", "events":"3", "avg. pv/ v":"3", "events_bar":"|"} , { "No.":"62", "referring domain or url":"www.pesfolio.com", "sessions":"1", "graph":"|", "events":"1", "avg. pv/ v":"1", "events_bar":"|"} , { "No.":"63", "referring domain or url":"www.google.no", "sessions":"1", "graph":"|", "events":"3", "avg. pv/ v":"3", "events_bar":"|"} , { "No.":"64", "referring domain or url":"www.rickyspears.com", "sessions":"1", "graph":"|", "events":"5", "avg. pv/ v":"5", "events_bar":"|"} , { "No.":"65", "referring domain or url":"opentracker.net", "sessions":"1", "graph":"|", "events":"1", "avg. pv/ v":"1", "events_bar":"|"} , { "No.":"66", "referring domain or url":"br.search.yahoo.com", "sessions":"1", "graph":"|", "events":"8", "avg. pv/ v":"8", "events_bar":"|"} , { "No.":"67", "referring domain or url":"ph.search.yahoo.com", "sessions":"1", "graph":"|", "events":"3", "avg. pv/ v":"3", "events_bar":"|"} , { "No.":"68", "referring domain or url":"digitek.id", "sessions":"1", "graph":"|", "events":"1", "avg. pv/ v":"1", "events_bar":"|"} , { "No.":"69", "referring domain or url":"www.google.com.tw", "sessions":"1", "graph":"|", "events":"1", "avg. pv/ v":"1", "events_bar":"|"} , { "No.":"70", "referring domain or url":"ihm.egide.pin.prd.euw3r53.nbyt.fr", "sessions":"1", "graph":"|", "events":"1", "avg. pv/ v":"1", "events_bar":"|"} , { "No.":"71", "referring domain or url":"www.google.es", "sessions":"1", "graph":"|", "events":"3", "avg. pv/ v":"3", "events_bar":"|"} , { "No.":"72", "referring domain or url":"help.opentracker.net", "sessions":"1", "graph":"|", "events":"1", "avg. pv/ v":"1", "events_bar":"|"} , { "No.":"73", "referring domain or url":"tech.meteoweek.com", "sessions":"1", "graph":"|", "events":"1", "avg. pv/ v":"1", "events_bar":"|"} , { "No.":"74", "referring domain or url":"superquicksearch.com", "sessions":"1", "graph":"|", "events":"2", "avg. pv/ v":"2", "events_bar":"|"} , { "No.":"75", "referring domain or url":"www.google.co.kr", "sessions":"1", "graph":"|", "events":"1", "avg. pv/ v":"1", "events_bar":"|"} , { "No.":"76", "referring domain or url":"www.google.sk", "sessions":"1", "graph":"|", "events":"2", "avg. pv/ v":"2", "events_bar":"|"} , { "No.":"77", "referring domain or url":"my.siteground.com", "sessions":"1", "graph":"|", "events":"1", "avg. pv/ v":"1", "events_bar":"|"} , { "No.":"78", "referring domain or url":"yandex.com", "sessions":"1", "graph":"|", "events":"1", "avg. pv/ v":"1", "events_bar":"|"} , { "No.":"79", "referring domain or url":"www.google.jo", "sessions":"1", "graph":"|", "events":"4", "avg. pv/ v":"4", "events_bar":"|"} , { "No.":"80", "referring domain or url":"m.baidu.com", "sessions":"1", "graph":"|", "events":"1", "avg. pv/ v":"1", "events_bar":"|"} , { "No.":"81", "referring domain or url":"www.google.bg", "sessions":"1", "graph":"|", "events":"3", "avg. pv/ v":"3", "events_bar":"|"} , { "No.":"82", "referring domain or url":"www.google.ru", "sessions":"1", "graph":"|", "events":"1", "avg. pv/ v":"1", "events_bar":"|"} , { "No.":"83", "referring domain or url":"www.google.be", "sessions":"1", "graph":"|", "events":"2", "avg. pv/ v":"2", "events_bar":"|"} , { "No.":"84", "referring domain or url":"ru.pinterest.com", "sessions":"1", "graph":"|", "events":"1", "avg. pv/ v":"1", "events_bar":"|"} , { "No.":"85", "referring domain or url":"www.google.lk", "sessions":"1", "graph":"|", "events":"2", "avg. pv/ v":"2", "events_bar":"|"} , { "No.":"86", "referring domain or url":"www.google.com.jm", "sessions":"1", "graph":"|", "events":"3", "avg. pv/ v":"3", "events_bar":"|"} , { "No.":"87", "referring domain or url":"www.google.com.br", "sessions":"1", "graph":"|", "events":"2", "avg. pv/ v":"2", "events_bar":"|"} , { "No.":"88", "referring domain or url":"login.microsoftonline.com", "sessions":"1", "graph":"|", "events":"4", "avg. pv/ v":"4", "events_bar":"|"} , { "No.":"89", "referring domain or url":"www.google.com.sg", "sessions":"1", "graph":"|", "events":"1", "avg. pv/ v":"1", "events_bar":"|"} , { "No.":"90", "referring domain or url":"www.google.co.il", "sessions":"1", "graph":"|", "events":"1", "avg. pv/ v":"1", "events_bar":"|"} , { "No.":"91", "referring domain or url":"cn.bing.com", "sessions":"1", "graph":"|", "events":"4", "avg. pv/ v":"4", "events_bar":"|"} , { "No.":"92", "referring domain or url":"localhost", "sessions":"1", "graph":"|", "events":"1", "avg. pv/ v":"1", "events_bar":"|"} , { "No.":"93", "referring domain or url":"mirror.uncyc.org", "sessions":"1", "graph":"|", "events":"1", "avg. pv/ v":"1", "events_bar":"|"} , { "No.":"94", "referring domain or url":"www.google.az", "sessions":"1", "graph":"|", "events":"5", "avg. pv/ v":"5", "events_bar":"|"} , { "No.":"95", "referring domain or url":"oprend.hu", "sessions":"1", "graph":"|", "events":"1", "avg. pv/ v":"1", "events_bar":"|"} , { "No.":"96", "referring domain or url":"com.reddit.frontpage", "sessions":"1", "graph":"|", "events":"6", "avg. pv/ v":"6", "events_bar":"|"} , { "No.":"97", "referring domain or url":"search.seznam.cz", "sessions":"1", "graph":"|", "events":"4", "avg. pv/ v":"4", "events_bar":"|"} , { "No.":"98", "referring domain or url":"stackoverflow.com", "sessions":"1", "graph":"|", "events":"1", "avg. pv/ v":"1", "events_bar":"|"} , { "No.":"99", "referring domain or url":"wikikali.blogspot.com", "sessions":"1", "graph":"|", "events":"2", "avg. pv/ v":"2", "events_bar":"|"} , { "No.":"100", "referring domain or url":"ntp.msn.com", "sessions":"1", "graph":"|", "events":"5", "avg. pv/ v":"5", "events_bar":"|"} , { "No.":"", "referring domain or url":"", "sessions":"6,468", "graph":"", "events":"16,867", "avg. pv/ v":"", "events_bar":""} ] }
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