Top Search Terms

Display a list of most popular keywords (search terms) visitors entered into a search engine to find your site.

API Usage

This API produces a json array.

Parameters

One or more of the following parameters are required:

date Calculate the top search terms from the specified date entered as yyyy-MM-dd. Default is the current date.
unixTime Calculate the top search terms from the specified unix timestamp. Default is the current unix timestamp.
period The time-range considered for calculating top search terms with respect to the date. Example: 3d for 3 days offset.
detailLevel The detail level; the search term including search engine, or only the searchterm. [search] | searchPlain.
filterBySearchTerm Filter by search term. If set then only show search terms containing the value set.
timezone Calculate the top search terms for the specified timezone. Default is the site's defined timezone.

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].
locale The locale parameter is an identifier for a particular combination of language and region (e.g. en_US) and determines the format of 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.

Examples

Display a top search terms for the website www.opentracker.net for the user "demo@opentracker.net" with password "demo123":
HTTP GET/ POST:/api/top_lists/top_search_terms.jsp?period=7d&login=demo@opentracker.net&password=demo123&site=www.opentracker.net
Display a top search terms list for the website www.opentracker.net from 2021-03-03 and three weeks back display in html:
HTTP GET/ POST:/api/top_lists/top_search_terms.jsp?date=2021-3-3&login=demo@opentracker.net&password=demo123&site=www.opentracker.net&period=3d&dataType=html

Response

This last example returns a json array with 'n' entries formatted as:

No. search term sessions graph events avg. pv/ v
1 ip tracker (google) 17 |||||||||||||||||||| 21 1.2
2 ip address tracker (google) 12 |||||||||||||| 15 1.2
3 iptracker (google) 6 ||||||| 6 1
4 ip tracker (bing) 5 |||||| 12 2.4
5 trace ip (google) 4 ||||| 5 1.2
6 ip trace (google) 4 ||||| 4 1
7 opentrackernet (bing) 3 |||| 5 1.7
8 best ip puller (bing) 3 |||| 3 1
9 open tracker ip (bing) 2 || 2 1
10 semalt.com (bing) 2 || 2 1
11 ip address location tracker (google) 2 || 3 1.5
12 track ip (google) 2 || 2 1
13 track ip address exact location (google) 2 || 4 2
14 tracker ip (google) 2 || 4 2
15 opentracker (bing) 2 || 4 2
16 trace ip address (google) 2 || 3 1.5
17 ip tracker location (google) 2 || 2 1
18 track ipp (bing) 1 | 1 1
19 real time ip address tracker (google) 1 | 4 4
20 track this ip (bing) 1 | 1 1
21 ip informatin puller (bing) 1 | 2 2
22 https://www.opentracker.net/products/web-analytics (google) 1 | 1 1
23 profiles marketing tampletes (bing) 1 | 2 2
24 get ip (google) 1 | 1 1
25 how to get someones ip by a username (bing) 1 | 1 1
26 free ip puller (bing) 1 | 1 1
27 track web addrrss details (google) 1 | 1 1
28 sites which give ips like trace my ip (google) 1 | 3 3
29 ip location tracker (google) 1 | 3 3
30 ip traker (google) 1 | 2 2
31 find ip phone number (google) 1 | 1 1
32 pull ip from phone number (bing) 1 | 2 2
33 real ip tracker (bing) 1 | 2 2
34 trace my ip (google) 1 | 1 1
35 trace ip address location (google) 1 | 1 1
36 ip trcker (bing) 1 | 1 1
37 track ip adress (google) 1 | 1 1
38 open tracker (bing) 1 | 2 2
39 how to identify an ip address (google) 1 | 2 2
40 how to pull ip address (google) 1 | 2 2
41 best ip finder (bing) 1 | 1 1
42 traceip (google) 1 | 1 1
43 ip tracker gamertag (bing) 1 | 5 5
44 the server ip for phone tracker location center (bing) 1 | 1 1
45 ip grabber online (google) 1 | 1 1
46 ip finder (google) 1 | 2 2
47 track ip location with gps (bing) 1 | 1 1
48 ip address tracker (bing) 1 | 2 2
49 ip puller (bing) 1 | 1 1
50 how to trace an ip address (google) 1 | 1 1
51 ip location finder map instagram (google) 1 | 2 2
52 best free ip (bing) 1 | 1 1
53 free ip address tracker (google) 1 | 1 1
54 ip puller (google) 1 | 1 1
55 define web metrics (bing) 1 | 1 1
56 free ip tracker online (bing) 1 | 1 1
57 ip puller for phone numbers (bing) 1 | 3 3
58 when they open the link i get their ip (bing) 1 | 1 1
59 keeping track of computer numbers and ip (bing) 1 | 1 1
60 vyhledávač ip (seznam) 1 | 1 1
61 phone number ip lo (google) 1 | 1 1
62 able to trace line id ip address (google) 1 | 1 1
63 ip tracking (google) 1 | 5 5
118 171

Errors

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

We would love to hear your feedback. Please use the facebook comment box below