Top Referrers

Display list of referrers through which visitors come to your website in order of popularity.

API Usage

This API produces a json array.

Parameters

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 in{ "resultsList": [ { "error":"javax.servlet.jsp.JspException: Problem accessing the absolute URL \\\"http:\/\/localhost\/api\/top_lists\/top_referrers.jsp?period=3d\\\". java.net.ConnectException: Connection refused\\n\\tat org.apache.taglibs.standard.tag.common.core.ImportSupport.acquireReader(ImportSupport.java:354)\\n\\tat org.apache.taglibs.standard.tag.common.core.ImportSupport.acquireString(ImportSupport.java:241)\\n\\tat org.apache.taglibs.standard.tag.common.core.ImportSupport.doEndTag(ImportSupport.java:161)\\n\\tat org.apache.jsp.api.top_005flists.top_005freferrers_jsp._jspx_meth_c_005fimport_005f0(top_005freferrers_jsp.java:1054)\\n\\tat org.apache.jsp.api.top_005flists.top_005freferrers_jsp._jspService(top_005freferrers_jsp.java:386)\\n\\tat org.apache.jasper.runtime.HttpJspBase.service(HttpJspBase.java:70)\\n\\tat javax.servlet.http.HttpServlet.service(HttpServlet.java:717)\\n\\tat org.apache.jasper.servlet.JspServletWrapper.service(JspServletWrapper.java:377)\\n\\tat org.apache.jasper.servlet.JspServlet.serviceJspFile(JspServlet.java:313)\\n\\tat org.apache.jasper.servlet.JspServlet.service(JspServlet.java:260)\\n\\tat javax.servlet.http.HttpServlet.service(HttpServlet.java:717)\\n\\tat org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:290)\\n\\tat org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:206)\\n\\tat org.tuckey.web.filters.urlrewrite.RuleChain.handleRewrite(RuleChain.java:176)\\n\\tat org.tuckey.web.filters.urlrewrite.RuleChain.doRules(RuleChain.java:145)\\n\\tat org.tuckey.web.filters.urlrewrite.UrlRewriter.processRequest(UrlRewriter.java:92)\\n\\tat org.tuckey.web.filters.urlrewrite.UrlRewriteFilter.doFilter(UrlRewriteFilter.java:394)\\n\\tat org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:235)\\n\\tat org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:206)\\n\\tat org.apache.catalina.core.StandardWrapperValve.invoke(StandardWrapperValve.java:233)\\n\\tat org.apache.catalina.core.StandardContextValve.invoke(StandardContextValve.java:191)\\n\\tat org.apache.catalina.core.StandardHostValve.invoke(StandardHostValve.java:127)\\n\\tat org.apache.catalina.valves.ErrorReportValve.invoke(ErrorReportValve.java:102)\\n\\tat org.apache.catalina.valves.AccessLogValve.invoke(AccessLogValve.java:555)\\n\\tat org.apache.catalina.core.StandardEngineValve.invoke(StandardEngineValve.java:109)\\n\\tat org.apache.catalina.connector.CoyoteAdapter.service(CoyoteAdapter.java:298)\\n\\tat org.apache.coyote.http11.Http11Processor.process(Http11Processor.java:857)\\n\\tat org.apache.coyote.http11.Http11Protocol$Http11ConnectionHandler.process(Http11Protocol.java:588)\\n\\tat org.apache.tomcat.util.net.JIoEndpoint$Worker.run(JIoEndpoint.java:489)\\n\\tat java.lang.Thread.run(Thread.java:745)\\nCaused by: java.net.ConnectException: Connection refused\\n\\tat java.net.PlainSocketImpl.socketConnect(Native Method)\\n\\tat java.net.AbstractPlainSocketImpl.doConnect(AbstractPlainSocketImpl.java:350)\\n\\tat java.net.AbstractPlainSocketImpl.connectToAddress(AbstractPlainSocketImpl.java:206)\\n\\tat java.net.AbstractPlainSocketImpl.connect(AbstractPlainSocketImpl.java:188)\\n\\tat java.net.SocksSocketImpl.connect(SocksSocketImpl.java:392)\\n\\tat java.net.Socket.connect(Socket.java:589)\\n\\tat java.net.Socket.connect(Socket.java:538)\\n\\tat sun.net.NetworkClient.doConnect(NetworkClient.java:180)\\n\\tat sun.net.www.http.HttpClient.openServer(HttpClient.java:432)\\n\\tat sun.net.www.http.HttpClient.openServer(HttpClient.java:527)\\n\\tat sun.net.www.http.HttpClient.(HttpClient.java:211)\\n\\tat sun.net.www.http.HttpClient.New(HttpClient.java:308)\\n\\tat sun.net.www.http.HttpClient.New(HttpClient.java:326)\\n\\tat sun.net.www.protocol.http.HttpURLConnection.getNewHttpClient(HttpURLConnection.java:1169)\\n\\tat sun.net.www.protocol.http.HttpURLConnection.plainConnect0(HttpURLConnection.java:1105)\\n\\tat sun.net.www.protocol.http.HttpURLConnection.plainConnect(HttpURLConnection.java:999)\\n\\tat sun.net.www.protocol.http.HttpURLConnection.connect(HttpURLConnection.java:933)\\n\\tat sun.net.www.protocol.http.HttpURLConnection.getInputStream0(HttpURLConnection.java:1513)\\n\\tat sun.net.www.protocol.http.HttpURLConnection.getInputStream(HttpURLConnection.java:1441)\\n\\tat org.apache.taglibs.standard.tag.common.core.ImportSupport.acquireReader(ImportSupport.java:330)\\n\\t... 29 more\\n"} ] }