SalesViewer© API
Console
Endpoints
How-to
SVQL
Schema
Github
Schema file
grab your copy of the JSON Schema here
Schema viewer
{ }
object
array
string
integer
number
bool
null
"title":
SalesViewer
Definitions
object
array
string
integer
number
bool
null
PaginatedResult
object
array
string
integer
number
bool
null
description
respresents a generic but
paginated result
"title":
PaginatedResult
properties
object
array
string
integer
number
bool
null
pagination
object
array
string
integer
number
bool
null
$ref
#\/definitions\/ResultPag
ination
ErrorResponse
object
array
string
integer
number
bool
null
description
generic error response st
ructure
"title":
ErrorResponse
properties
object
array
string
integer
number
bool
null
error
object
array
string
integer
number
bool
null
description
Indicated that it' an err
or
errorDescription
object
array
string
integer
number
bool
null
description
Error description
errorType
object
array
string
integer
number
bool
null
description
Error type
ResultPagination
object
array
string
integer
number
bool
null
description
some metadata for inforam
tion about paginated resu
lt
"title":
ResultPagination
properties
object
array
string
integer
number
bool
null
total
object
array
string
integer
number
bool
null
description
Number of total entries
format
int64
isFirst
object
array
string
integer
number
bool
null
description
Current page is first pag
e
current
object
array
string
integer
number
bool
null
description
Current page number (1-ba
sed)
format
int64
isLast
object
array
string
integer
number
bool
null
description
Current page is last page
pageSize
object
array
string
integer
number
bool
null
description
Size (=number of entries)
of each page
format
int64
GetSessionsResponse
object
array
string
integer
number
bool
null
description
response structure of any
`\/session.json` query
"title":
GetSessionsResponse
properties
object
array
string
integer
number
bool
null
totals
object
array
string
integer
number
bool
null
$ref
#\/definitions\/GetSessio
nsResultTotals
result
object
array
string
integer
number
bool
null
description
Array of `SessionPublic`
(query results)
items
object
array
string
integer
number
bool
null
$ref
#\/definitions\/SessionPu
blic
AllOf
{ }
object
array
string
integer
number
bool
null
$ref
#\/definitions\/Paginated
Result
GetSessionsResultTotals
object
array
string
integer
number
bool
null
description
some metadata information
of object counts
"title":
GetSessionsResultTotals
properties
object
array
string
integer
number
bool
null
sessions
object
array
string
integer
number
bool
null
description
Total number of unique se
ssions
format
int64
companies
object
array
string
integer
number
bool
null
description
Total number of unique co
mpanies
format
int64
visits
object
array
string
integer
number
bool
null
description
Total number of page visi
ts
format
int64
interest_visits
object
array
string
integer
number
bool
null
description
Total number of page visi
ts which triggered intere
st
format
int64
interests
object
array
string
integer
number
bool
null
description
Total number of interests
triggered
format
int64
Url
object
array
string
integer
number
bool
null
description
URL object (can be implic
itly casted to string)
"title":
Url
properties
object
array
string
integer
number
bool
null
scheme
object
array
string
integer
number
bool
null
description
protocol scheme (e.g. `ht
tp` or `https`)
host
object
array
string
integer
number
bool
null
description
hostname (e.g. `salesview
er.com`) _Note: `www.sale
sviwer.com` is an other h
ost than `salesviewer.com
`, maybe use `like(host,
'%salesviwer.com')`_\n
format
hostname
pathQueryFragment
object
array
string
integer
number
bool
null
description
path, query and fragment
of URL, e.g. `\/api\/?que
ry=test#result`\n
pathQuery
object
array
string
integer
number
bool
null
description
path and query of URL, e.
g. `\/api\/?query=test`\n
path
object
array
string
integer
number
bool
null
description
path of URL, e.g. `\/api\
/`\n
queryFragment
object
array
string
integer
number
bool
null
description
query and fragment of URL
, e.g. `query=test#result
`\n
query
object
array
string
integer
number
bool
null
description
query of URL, e.g. `query
=test&foo=baz&utm_source=
test&utm_media=online`\n
fragment
object
array
string
integer
number
bool
null
description
query and fragment of URL
, e.g. `result`\n
Session
object
array
string
integer
number
bool
null
description
common session object
"title":
Session
properties
object
array
string
integer
number
bool
null
guid
object
array
string
integer
number
bool
null
description
UUID of Session
startedAt
object
array
string
integer
number
bool
null
description
Session started at (in gi
ven timezone)
format
date-time
lastActivityAt
object
array
string
integer
number
bool
null
description
Session last activity at
(in given timezone)
format
date-time
duration
object
array
string
integer
number
bool
null
description
Duration of session in TI
ME format (Rfc3339 time c
omponents)
format
date-time
language
object
array
string
integer
number
bool
null
description
Session language\/locale
company
object
array
string
integer
number
bool
null
$ref
#\/definitions\/CompanyPu
blic
visits
object
array
string
integer
number
bool
null
description
Session visits of this se
ssion. \nNOTE: if `includ
eVisits`-parameter set to
`false`, result won't co
ntain visits field.\n
items
object
array
string
integer
number
bool
null
$ref
#\/definitions\/SessionVi
sit
interests
object
array
string
integer
number
bool
null
description
interests triggered by on
e or more visits in this
session\n
items
object
array
string
integer
number
bool
null
$ref
#\/definitions\/SessionIn
terest
SessionQuery
object
array
string
integer
number
bool
null
description
queryable session object
"title":
Session
properties
object
array
string
integer
number
bool
null
date
object
array
string
integer
number
bool
null
description
alias of `started_at`
format
date-time
locale
object
array
string
integer
number
bool
null
description
alias of `language`
userAgent
object
array
string
integer
number
bool
null
description
clients user agent string
company
object
array
string
integer
number
bool
null
$ref
#\/definitions\/CompanyQu
ery
visits
object
array
string
integer
number
bool
null
description
Session visits of this se
ssion. \nNOTE: if `includ
eVisits`-parameter set to
`false`, result won't co
ntain visits field.\n
items
object
array
string
integer
number
bool
null
$ref
#\/definitions\/SessionVi
sitQuery
interests
object
array
string
integer
number
bool
null
description
interests triggered by on
e or more visits in this
session\n
items
object
array
string
integer
number
bool
null
$ref
#\/definitions\/SessionIn
terestQuery
AllOf
{ }
object
array
string
integer
number
bool
null
$ref
#\/definitions\/Session
SessionPublic
object
array
string
integer
number
bool
null
description
public session object
"title":
Session
properties
object
array
string
integer
number
bool
null
startedAt_ts_server
object
array
string
integer
number
bool
null
description
Session started at UNIX-T
ime
format
date-time
lastActivityAt_ts_server
object
array
string
integer
number
bool
null
description
Session last activity at
UNIX-Time
format
date-time
duration_secs
object
array
string
integer
number
bool
null
description
Duration of session in se
conds
format
int64
company
object
array
string
integer
number
bool
null
$ref
#\/definitions\/CompanyPu
blic
visits
object
array
string
integer
number
bool
null
description
Session visits of this se
ssion. \nNOTE: if `includ
eVisits`-parameter set to
`false`, result won't co
ntain visits field.\n
items
object
array
string
integer
number
bool
null
$ref
#\/definitions\/SessionVi
sitPublic
interests
object
array
string
integer
number
bool
null
description
interests triggered by on
e or more visits in this
session\n
items
object
array
string
integer
number
bool
null
$ref
#\/definitions\/SessionIn
terestPublic
Company
object
array
string
integer
number
bool
null
description
common company object
"title":
Company
properties
object
array
string
integer
number
bool
null
id
object
array
string
integer
number
bool
null
description
ID of company
street
object
array
string
integer
number
bool
null
description
Street of company
zip
object
array
string
integer
number
bool
null
description
Zip of company
name
object
array
string
integer
number
bool
null
description
Name of company
phone
object
array
string
integer
number
bool
null
description
Phone of company
email
object
array
string
integer
number
bool
null
description
E-Mail address of company
city
object
array
string
integer
number
bool
null
description
City of company
latitude
object
array
string
integer
number
bool
null
description
Geographical latitude of
company's address
format
double
longitude
object
array
string
integer
number
bool
null
description
Geographical longitude of
company's address
format
double
url
object
array
string
integer
number
bool
null
description
URL of company's website
countyCode
object
array
string
integer
number
bool
null
description
Country code in (ISO 3166
Alpha 2) format (e.g. `D
E`)
countyCode3
object
array
string
integer
number
bool
null
description
Country code in (ISO 3166
Alpha 3) format (e.g. `D
EU`)
isCustomer
object
array
string
integer
number
bool
null
description
Indicates if company is m
arked as customer
isFavorite
object
array
string
integer
number
bool
null
description
Indicates if company is m
arked as favorite
isCompetitor
object
array
string
integer
number
bool
null
description
Indicates if company is m
arked as competitor
sector
object
array
string
integer
number
bool
null
$ref
#\/definitions\/CompanySe
ctor
CompanyQuery
object
array
string
integer
number
bool
null
description
queryable company object
"title":
CompanyQuery
properties
object
array
string
integer
number
bool
null
website
object
array
string
integer
number
bool
null
$ref
#\/definitions\/Url
url
object
array
string
integer
number
bool
null
$ref
#\/definitions\/Url
sector
object
array
string
integer
number
bool
null
$ref
#\/definitions\/CompanySe
ctorQuery
AllOf
{ }
object
array
string
integer
number
bool
null
$ref
#\/definitions\/Company
CompanyPublic
object
array
string
integer
number
bool
null
description
public company object
"title":
CompanyPublic
properties
object
array
string
integer
number
bool
null
sector
object
array
string
integer
number
bool
null
$ref
#\/definitions\/CompanySe
ctorPublic
AllOf
{ }
object
array
string
integer
number
bool
null
$ref
#\/definitions\/Company
CompanySector
object
array
string
integer
number
bool
null
description
common company sector obj
ect
"title":
CompanySector
properties
object
array
string
integer
number
bool
null
id
object
array
string
integer
number
bool
null
description
ID of sector
format
int64
name
object
array
string
integer
number
bool
null
description
Name of sector
CompanySectorQuery
object
array
string
integer
number
bool
null
description
queryable company sector
object
"title":
CompanySectorQuery
AllOf
{ }
object
array
string
integer
number
bool
null
$ref
#\/definitions\/CompanySe
ctor
CompanySectorPublic
object
array
string
integer
number
bool
null
description
public company sector obj
ect
"title":
CompanySectorPublic
AllOf
{ }
object
array
string
integer
number
bool
null
$ref
#\/definitions\/CompanySe
ctor
SessionVisit
object
array
string
integer
number
bool
null
description
common session visit obje
ct
"title":
SessionVisit
properties
object
array
string
integer
number
bool
null
id
object
array
string
integer
number
bool
null
description
ID of Session visit
format
int64
startedAt
object
array
string
integer
number
bool
null
description
Session visit started at
(in given timezone)
format
date-time
lastActivityAt
object
array
string
integer
number
bool
null
description
Session visit last activi
ty at (in given timezone)
format
date-time
duration
object
array
string
integer
number
bool
null
description
Duration of session visit
in TIME format (Rfc3339
time components)
format
date-time
duration_secs
object
array
string
integer
number
bool
null
description
Duration of session visit
in seconds
format
precision
url
object
array
string
integer
number
bool
null
description
URL of the session visit
numEvents
object
array
string
integer
number
bool
null
description
Number of events collecte
d during website session
format
int64
referer
object
array
string
integer
number
bool
null
description
Referer URL of the sessio
n visit
refererSource
object
array
string
integer
number
bool
null
description
Referer parsed `source`-c
omponent
refererTerm
object
array
string
integer
number
bool
null
description
Referer parsed `term`-com
ponent
refererMedium
object
array
string
integer
number
bool
null
description
Referer parsed `medium`-c
omponent
SessionVisitQuery
object
array
string
integer
number
bool
null
description
queryable session visit o
bject
"title":
SessionVisitQuery
properties
object
array
string
integer
number
bool
null
url
object
array
string
integer
number
bool
null
$ref
#\/definitions\/Url
referer
object
array
string
integer
number
bool
null
$ref
#\/definitions\/Url
AllOf
{ }
object
array
string
integer
number
bool
null
$ref
#\/definitions\/SessionVi
sit
SessionVisitPublic
object
array
string
integer
number
bool
null
description
public session visit obje
ct
"title":
SessionVisitPublic
properties
object
array
string
integer
number
bool
null
startedAt_ts_server
object
array
string
integer
number
bool
null
description
Session visit started at
UNIX-Time
format
date-time
lastActivityAt_ts_server
object
array
string
integer
number
bool
null
description
Session visit last activi
ty at UNIX-Time
format
date-time
AllOf
{ }
object
array
string
integer
number
bool
null
$ref
#\/definitions\/SessionVi
sit
SessionInterest
object
array
string
integer
number
bool
null
description
common session interest o
bject
"title":
SessionInterest
properties
object
array
string
integer
number
bool
null
id
object
array
string
integer
number
bool
null
description
ID of interest
format
int64
name
object
array
string
integer
number
bool
null
description
name of interest
SessionInterestQuery
object
array
string
integer
number
bool
null
description
querably session interest
object
"title":
SessionInterestQuery
AllOf
{ }
object
array
string
integer
number
bool
null
$ref
#\/definitions\/SessionIn
terest
SessionInterestPublic
object
array
string
integer
number
bool
null
description
querably session interest
object
"title":
SessionInterestPublic
AllOf
{ }
object
array
string
integer
number
bool
null
$ref
#\/definitions\/SessionIn
terest