TWIPLA API (Alpha Version - Work in Progress) (V2)

Download OpenAPI specification:

TWIPLA Support: api@twipla.com License: Apache 2.0 Terms of Service

Overview

Introduction

This is the official documentation for the TWIPLA API. New endpoints will be added constantly.

Example query: /v2/visits?from=2021-09-27T00:00:00.000Z&until=2021-09-20T11:00:31.212Z&page=1&pageSize=15&order=page.asc

Pagination

Raw data is always paginated and uses the following 2 parameters: page and pageSize.

Time Filtering

Coming soon

Field Filtering

Coming soon

Grouping

Coming soon

Ordering

Coming soon

Time series

Time series data is useful for displaying in graphs.

Parameters

Name	Type	Default	Description
`from`	string	Today - 7 days	ISO8601 date format or `YYYY-MM-DD`
`until`	string	Today	ISO8601 date format or `YYYY-MM-DD`
`unit`	string	Based on the time interval	One of `day`, `week`, `month` or `year`

Authentication

Authentication operations

Create Standard Token

A token can be created using a user's email and password

Request Body schema: application/json
required

email	string
password	string

Responses

Request samples

Payload

Content type

application/json

{"email": "test@test.com",
"password": "test"
}

Response samples

200
401

Content type

application/json

{"token": "token-string-value",
"refreshToken": "token-refresh-string-value",
"userId": "user-id"
}

Refresh Standard Token

A token can be refreshed based on the refreshToken from the create endpoint

Request Body schema: application/json
required

refreshToken

string

Responses

Request samples

Payload

Content type

application/json

{"refreshToken": "token-refresh-string-value"
}

Response samples

200
401

Content type

application/json

{"token": "token-string-value",
"refreshToken": "token-refresh-string-value",
"userId": "user-id"
}

Create 3AS Token

A token can be created by using a 3AS INTPC Token that was generated using the 3AS SDK

Request Body schema: application/json
required

token

string

If token is sent email and password are ignored

Responses

Request samples

Payload

Content type

application/json

{"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c"
}

Response samples

200
401

Content type

application/json

{"token": "token-string-value",
"refreshToken": "token-refresh-string-value",
"clientId": "client-id",
"companyId": "company-id"
}

Visits

Operations about website visits

Visits graph data V2

Get visits information as graph data

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
type required	string Value: "time-series" Example: type=time-series
unit required	string Enum: "day" "week" "month" "year" Example: unit=day

Responses

Response samples

200
401

Content type

application/json

{"payload": {"datasets": [{"label": "Overall Page Visits",
"data": [32,
50,
80
]
}
],
"labels": ["2022-06-22T15:46:47Z"
]
}
}

Visits graph filtered data V2

Get filtered visits information as graph data

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
type required	string Value: "time-series" Example: type=time-series
unit required	string Enum: "day" "week" "month" "year" Example: unit=day

Request Body schema: application/json
required

	object
	Array of objects
	object
	object
	Array of objects
primaryDimension	string optional

Responses

Request samples

Payload

Content type

application/json

{"where": {"and": [{"member": "string",
"operator": "string",
"values": [{"type": "string",
"category": ["string"
]
}
]
}
]
},
"order": [{"member": "string",
"direction": "string",
"priority": 0
}
],
"timeframe": {"from": "2019-08-24T14:15:22Z",
"until": "2019-08-24T14:15:22Z"
},
"pagination": {"page": 0,
"pageSize": 0
},
"segments": [{"id": "string",
"conditions": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
}
}
],
"primaryDimension": "string"
}

Response samples

200
401

Content type

application/json

{"payload": {"datasets": [{"label": "Overall Page Visits",
"data": [32,
50,
80
]
}
],
"labels": ["2022-06-22T15:46:47Z"
]
}
}

Visits V2

Get all website visits with filters

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
previousFrom required	string <date-time> (urlEncodedISO8601) Example: previousFrom=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
previousUntil required	string <date-time> (urlEncodedISO8601) Example: previousUntil=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
group required	string Example: group=page (only group by page option available) Property by which to group the response
order required	string Enum: "desc" "asc" Example: order=count.asc\|desc (only count ordering option) Orders the results from query ascending or descending.
page required	integer Example: page=1 Page to be requested
pageSize required	integer Example: pageSize=20 Number of items per page to be requested; maximum number of elements per page is 500 if group=null

Request Body schema: application/json
optional

object

Responses

Request samples

Payload

Content type

application/json

{"where": {"and": [{"member": "string",
"operator": "string",
"values": [{"type": "string",
"category": ["string"
]
}
]
}
]
}
}

Response samples

200
4XX
5xx

Content type

application/json

Example

No group

{"payload": [{"unixTs": 1529230033,
"websiteKey": "2dc02576-f22f-11ec-b772-0242ac120004",
"sessionKey": "5b2632d211d969.77370315",
"pageKey": "08d024a29cfae918ee1245e3c9df86c6",
"url": "https://www.test-site.com"
},
{"unixTs": 1529230077,
"websiteKey": "2dc02576-f22f-11ec-b772-0242ac120004",
"sessionKey": "5b2632d211d969.77370915",
"pageKey": "08d024a29cfae918ee1245e3c9df86c6",
"url": "https://www.test-site.com"
}
]
}

Visits count

Get all website visits from the current month considering timezone

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

timezone

string

Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"payload": {"count": 1
}
}

Visit charts by period

Get all website visits given a period considering timezone

Authorizations:

bearerAuth

path Parameters

websiteId required	string <uuid> (uuid) Example: 06d99a32-ee11-11eb-830a-0146de130018 ID of a website
period required	string Enum: "daily" "monthly" "hourly" Period of the results from query.

query Parameters

specificYear	string Specific year of the results from query.
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Responses

Response samples

200
4XX
5xx

Content type

application/json

Example

Hourly

{"payload": [{"title": "12",
"count": 1
},
{"title": "13",
"count": 2
}
]
}

Page Visits Stats

Get all website visits within a specified time range and organizes them by day. Also calculates the count of visits for a previous period with the same duration. The results are sorted by day and consider the specified timezone for the data

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12.1,
13.2
]
]
}
]
}

Visits by company name

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 from date, default is 7 days ago
until	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 until date, default is today
page	integer Example: page=1 page number, default is 1
pageSize	integer Example: pageSize=20 page size, default is 10
unit	string Enum: "day" "week" "month" "year" Example: unit=day
	Array of objects Example: order=visits.desc,companyOrgName.asc order by, default is `visits.desc`
companyOrgName	string Example: companyOrgName=Orange Company name, default returns all companies. Partial values accepted
companyCategory	string Enum: "from" "via" Example: companyCategory=from Company category, default returns all companies. `"via"` returns companies with `companyOrgType = isp`, `"from"` returns companies with `companyOrgType != isp`

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"payload": [{"companyOrgName": "Orange",
"companyOrgType": "Telecom",
"visits": 12,
"visitsPercentage": 0.23
}
],
"meta": {"page": 1,
"pageSize": 10,
"total": 30,
"pageTotal": 9
}
}

Overview page visits

Count and organize visit data by timestamp, grouping it into time period defined by unit. It fills in missing data points with 0.

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"total": 4
}

Competition Page Visits

Get count for competition website visits within a specified time range for a given country code and business sector.

Authorizations:

bearerAuth

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
businessSector required	integer Business sector of the results from query.
countryCode required	string Example: countryCode=US \| BR \| DE \| GB \| RO Country code of the results from query. Length must be 2.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"total": 4
}

Competition Page Visits V2

Get count for competition website visits within a specified time range for a given country code and business sector.

Authorizations:

bearerAuth

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
businessSector required	integer Business sector of the results from query.
countryCode required	string Example: countryCode=US \| BR \| DE \| GB \| RO Country code of the results from query. Length must be 2.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"payload": {"total": 4
}
}

Visitors

Operations about website visitors

Visitors

Get all website visitors with filters

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
previousFrom required	string <date-time> (urlEncodedISO8601) Example: previousFrom=2024-06-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter; optional
previousUntil required	string <date-time> (urlEncodedISO8601) Example: previousUntil=2024-07-10T23%3A59%3A59.000%2B02%3A00 Upper bound date filter; optional
group	string Enum: "device" "display" "browser" "operatingSystem" Groups the results by filter. If other string or none is sent, by default the result is grouped by `device`
order required	string Enum: "desc" "asc" Example: order=count.asc\|desc or by group name: device.desc\|asc, browser.desc\|asc, display.desc\|asc, operatingSystem.desc\|asc Orders the results from query ascending or descending.
page	integer Example: page=1 Page to be requested
pageSize	integer Example: pageSize=20 Number of items per page to be requested

Responses

Response samples

200
4xx
5xx

Content type

application/json

{"payload": [{"device|display|browser|operatingSystem": "string",
"count": 7,
"previousCount": 7
}
],
"meta": {"page": 1,
"pageSize": 20,
"total": 3,
"visitorsTotal": 9,
"previousvisitorsTotal": 9
}
}

Converting visitors graph

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
type required	string Enum: "time-series" "pie" "bar" Example: type=time-series
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Request Body schema: application/json
required

	object
	Array of objects
	object
	object
	Array of objects
primaryDimension	string optional

Responses

Request samples

Payload

Content type

application/json

{"where": {"and": [{"member": "string",
"operator": "string",
"values": [{"type": "string",
"category": ["string"
]
}
]
}
]
},
"order": [{"member": "string",
"direction": "string",
"priority": 0
}
],
"timeframe": {"from": "2019-08-24T14:15:22Z",
"until": "2019-08-24T14:15:22Z"
},
"pagination": {"page": 0,
"pageSize": 0
},
"segments": [{"id": "string",
"conditions": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
}
}
],
"primaryDimension": "string"
}

Response samples

200
4XX
5xx

Content type

application/json

{"payload": {"labels": ["string"
],
"datasets": [{"label": "string",
"data": [0
]
}
]
}
}

Converting visitors graph

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
type required	string Enum: "time-series" "pie" "bar" Example: type=time-series
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"payload": {"labels": ["string"
],
"datasets": [{"label": "string",
"data": [0
]
}
]
}
}

Get Visitors Graph Data

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day

Request Body schema: application/json
required

	object
	Array of objects
	object
	object
	Array of objects
primaryDimension	string optional

Responses

Request samples

Payload

Content type

application/json

{"where": {"and": [{"member": "string",
"operator": "string",
"values": [{"type": "string",
"category": ["string"
]
}
]
}
]
},
"order": [{"member": "string",
"direction": "string",
"priority": 0
}
],
"timeframe": {"from": "2019-08-24T14:15:22Z",
"until": "2019-08-24T14:15:22Z"
},
"pagination": {"page": 0,
"pageSize": 0
},
"segments": [{"id": "string",
"conditions": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
}
}
],
"primaryDimension": "string"
}

Response samples

200
4XX
5xx

Content type

application/json

{"payload": {"labels": ["2023-09-16T00:00:00+02:00"
],
"datasets": [{"label": "string",
"data": [0
]
}
]
}
}

Count Visitors By Device

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter

Responses

Response samples

200
4XX
5xx

Content type

application/json

[{"visitorsCount": 134,
"deviceType": "desktop"
}
]

Count Visitors By Device With Filter

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter

Request Body schema: application/json
required

	object
	Array of objects
	object
	object
	Array of objects
primaryDimension	string optional

Responses

Request samples

Payload

Content type

application/json

{"where": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
},
"order": [{"member": "string",
"direction": "string",
"priority": 0
}
],
"timeframe": {"from": "2019-08-24T14:15:22Z",
"until": "2019-08-24T14:15:22Z"
},
"pagination": {"page": 0,
"pageSize": 0
},
"segments": [{"id": "string",
"conditions": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
}
}
],
"primaryDimension": "string"
}

Response samples

200
4XX
5xx

Content type

application/json

[{"visitorsCount": 134,
"deviceType": "desktop"
}
]

Get All Visitors Graph Data

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day

Request Body schema: application/json
required

	object
	Array of objects
	object
	object
	Array of objects
primaryDimension	string optional

Responses

Request samples

Payload

Content type

application/json

{"where": {"and": [{"member": "string",
"operator": "string",
"values": [{"type": "string",
"category": ["string"
]
}
]
}
]
},
"order": [{"member": "string",
"direction": "string",
"priority": 0
}
],
"timeframe": {"from": "2019-08-24T14:15:22Z",
"until": "2019-08-24T14:15:22Z"
},
"pagination": {"page": 0,
"pageSize": 0
},
"segments": [{"id": "string",
"conditions": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
}
}
],
"primaryDimension": "string"
}

Response samples

200
4XX
5xx

Content type

application/json

{"payload": {"labels": ["2023-09-16T00:00:00+02:00"
],
"datasets": [{"label": "string",
"data": [0
]
}
]
}
}

Visitors map

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
limit	integer Example: limit=10 limit
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Responses

Response samples

200
4XX
5xx

Content type

application/json

[{"sessionKey": "string",
"position": [0
],
"isPrivate": true
}
]

Visitors by Geo

Authorizations:

bearerAuth

path Parameters

websiteId required	string <uuid> (uuid) Example: 06d99a32-ee11-11eb-830a-0146de130018 ID of a website
aggr required	string Example: by-country \| by-city aggregate by country or city, default is by country

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
start required	integer Example: start=6 Start of the results from query.
length required	integer Length of the results from query.
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Responses

Response samples

200
4XX
5xx

Content type

application/json

[{"name": "New York",
"countryCode": "US",
"count": 123
},
{"name": "London",
"countryCode": "GB",
"count": 456
}
]

Live visitors

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

timezone

string

Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"count": 0,
"visitors": [{"visitorKey": "string",
"sessionKey": "string",
"lastVisitTs": 0,
"latitude": 0,
"longitude": 0,
"ip": "string",
"countryCode": "string",
"deviceType": "string",
"browserName": "string",
"platform": "string",
"visitorType": 0,
"visitDetails": "string"
}
]
}

Competition Page Visitors

Get count for competition website visitors within a specified time range for a given country code and business sector.

Authorizations:

bearerAuth

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
businessSector required	integer Business sector of the results from query.
countryCode required	string Example: countryCode=US \| BR \| DE \| GB \| RO Country code of the results from query. Length must be 2.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"total": 4
}

Competition Page Visitors V2

Get count for competition website visitors within a specified time range for a given country code and business sector.

Authorizations:

bearerAuth

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
businessSector required	integer Business sector of the results from query.
countryCode required	string Example: countryCode=US \| BR \| DE \| GB \| RO Country code of the results from query. Length must be 2.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"payload": {"total": 4
}
}

Competition Unique Visitors

Get count for unique competition website visitors within a specified time range for a given country code and business sector.

Authorizations:

bearerAuth

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
businessSector required	integer Business sector of the results from query.
countryCode required	string Example: countryCode=US \| BR \| DE \| GB \| RO Country code of the results from query. Length must be 2.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"total": 4
}

Competition Unique Visitors V2

Get count for unique competition website visitors within a specified time range for a given country code and business sector.

Authorizations:

bearerAuth

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
businessSector required	integer Business sector of the results from query.
countryCode required	string Example: countryCode=US \| BR \| DE \| GB \| RO Country code of the results from query. Length must be 2.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"payload": {"total": 4
}
}

Competition

Operations about competition websites

Competition Page Visits

Get count for competition website visits within a specified time range for a given country code and business sector.

Authorizations:

bearerAuth

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
businessSector required	integer Business sector of the results from query.
countryCode required	string Example: countryCode=US \| BR \| DE \| GB \| RO Country code of the results from query. Length must be 2.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"total": 4
}

Competition Page Visits V2

Get count for competition website visits within a specified time range for a given country code and business sector.

Authorizations:

bearerAuth

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
businessSector required	integer Business sector of the results from query.
countryCode required	string Example: countryCode=US \| BR \| DE \| GB \| RO Country code of the results from query. Length must be 2.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"payload": {"total": 4
}
}

Competition Page Visitors

Get count for competition website visitors within a specified time range for a given country code and business sector.

Authorizations:

bearerAuth

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
businessSector required	integer Business sector of the results from query.
countryCode required	string Example: countryCode=US \| BR \| DE \| GB \| RO Country code of the results from query. Length must be 2.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"total": 4
}

Competition Page Visitors V2

Get count for competition website visitors within a specified time range for a given country code and business sector.

Authorizations:

bearerAuth

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
businessSector required	integer Business sector of the results from query.
countryCode required	string Example: countryCode=US \| BR \| DE \| GB \| RO Country code of the results from query. Length must be 2.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"payload": {"total": 4
}
}

Competition Unique Visitors

Get count for unique competition website visitors within a specified time range for a given country code and business sector.

Authorizations:

bearerAuth

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
businessSector required	integer Business sector of the results from query.
countryCode required	string Example: countryCode=US \| BR \| DE \| GB \| RO Country code of the results from query. Length must be 2.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"total": 4
}

Competition Unique Visitors V2

Get count for unique competition website visitors within a specified time range for a given country code and business sector.

Authorizations:

bearerAuth

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
businessSector required	integer Business sector of the results from query.
countryCode required	string Example: countryCode=US \| BR \| DE \| GB \| RO Country code of the results from query. Length must be 2.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"payload": {"total": 4
}
}

Competition Browsers

Get count for unique competition website visitors within a specified time range for a given country code and business sector.

Authorizations:

bearerAuth

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
businessSector required	integer Business sector of the results from query.
countryCode required	string Example: countryCode=US \| BR \| DE \| GB \| RO Country code of the results from query. Length must be 2.

Request Body schema: application/json
required

browsers

Array of strings

Responses

Request samples

Payload

Content type

application/json

{"browsers": ["Chrome",
"Firefox",
"Safari",
"Opera"
]
}

Response samples

200
4XX
5xx

Content type

application/json

[["Chrome",
45.12
],
["Firefox",
32.56
],
["Safari",
52.77
]
]

Competition Browsers V2

Get count for unique competition website visitors within a specified time range for a given country code and business sector.

Authorizations:

bearerAuth

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
businessSector required	integer Business sector of the results from query.
countryCode required	string Example: countryCode=US \| BR \| DE \| GB \| RO Country code of the results from query. Length must be 2.

Request Body schema: application/json
required

browsers

Array of strings

Responses

Request samples

Payload

Content type

application/json

{"browsers": ["Chrome",
"Firefox",
"Safari",
"Opera"
]
}

Response samples

200
4XX
5xx

Content type

application/json

{"payload": {"result": [["chrome",
45
],
["firefox",
32
],
["safari",
52
]
]
}
}

Competition Operating Systems

Get count for unique competition visits by OS within a specified time range for a given country code and business sector.

Authorizations:

bearerAuth

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
businessSector required	integer Business sector of the results from query.
countryCode required	string Example: countryCode=US \| BR \| DE \| GB \| RO Country code of the results from query. Length must be 2.

Request Body schema: application/json
required

operatingSystems

Array of strings

Responses

Request samples

Payload

Content type

application/json

{"operatingSystems": ["Windows",
"Mac OS",
"Linux",
"Android",
"iOS"
]
}

Response samples

200
4XX
5xx

Content type

application/json

[["Linux",
45.12
],
["Windows",
32.56
],
["iOS",
52.77
]
]

Competition Operating Systems V2

Get count for unique competition visits by OS within a specified time range for a given country code and business sector.

Authorizations:

bearerAuth

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
businessSector required	integer Business sector of the results from query.
countryCode required	string Example: countryCode=US \| BR \| DE \| GB \| RO Country code of the results from query. Length must be 2.

Request Body schema: application/json
required

operatingSystems

Array of strings

Responses

Request samples

Payload

Content type

application/json

{"operatingSystems": ["Windows",
"Mac OS",
"Linux",
"Android",
"iOS"
]
}

Response samples

200
4XX
5xx

Content type

application/json

{"payload": {"result": [["linux",
32
],
["macos",
0
],
["windows",
130
]
]
}
}

Competition Devices

Get count for unique competition visits by device within a specified time range for a given country code and business sector.

Authorizations:

bearerAuth

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
businessSector required	integer Business sector of the results from query.
countryCode required	string Example: countryCode=US \| BR \| DE \| GB \| RO Country code of the results from query. Length must be 2.

Request Body schema: application/json
required

devices

Array of strings

Responses

Request samples

Payload

Content type

application/json

{"devices": ["Desktop",
"Mobile",
"Tablet"
]
}

Response samples

200
4XX
5xx

Content type

application/json

[["Desktop",
45.12
],
["Mobile",
32.56
],
["Tablet",
52.77
]
]

Competition Devices V2

Get count for unique competition visits by device within a specified time range for a given country code and business sector.

Authorizations:

bearerAuth

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
businessSector required	integer Business sector of the results from query.
countryCode required	string Example: countryCode=US \| BR \| DE \| GB \| RO Country code of the results from query. Length must be 2.

Request Body schema: application/json
required

devices

Array of strings

Responses

Request samples

Payload

Content type

application/json

{"devices": ["Desktop",
"Mobile",
"Tablet"
]
}

Response samples

200
4XX
5xx

Content type

application/json

{"payload": {"result": [["desktop",
166
],
["phone",
0
]
]
}
}

Competition Screen Sizes

Get count for unique competition visits by screen size within a specified time range for a given country code and business sector.

Authorizations:

bearerAuth

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
businessSector required	integer Business sector of the results from query.
countryCode required	string Example: countryCode=US \| BR \| DE \| GB \| RO Country code of the results from query. Length must be 2.

Request Body schema: application/json
required

screenSizes

Array of strings

Responses

Request samples

Payload

Content type

application/json

{"screenSizes": ["0-320",
"321-480",
"481-768",
"769-1024"
]
}

Response samples

200
4XX
5xx

Content type

application/json

[["0-320",
45.12
],
["321-480",
32.56
],
["769-1024",
52.77
]
]

Competition Screen Sizes V2

Get count for unique competition visits by screen size within a specified time range for a given country code and business sector.

Authorizations:

bearerAuth

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
businessSector required	integer Business sector of the results from query.
countryCode required	string Example: countryCode=US \| BR \| DE \| GB \| RO Country code of the results from query. Length must be 2.

Request Body schema: application/json
required

screenSizes

Array of strings

Responses

Request samples

Payload

Content type

application/json

{"screenSizes": ["1280x1024",
"1920x1200",
"2560x1440"
]
}

Response samples

200
4XX
5xx

Content type

application/json

{"payload": {"result": [["1280x1024",
166
],
["1920x1200",
20
],
["2560x1440",
5
]
]
}
}

Sessions

Operations about website sessions

Raw Sessions

Retrieve a comprehensive list of visitor sessions with advanced filtering, sorting, and dimension selection capabilities.

The endpoint supports:

Filtering by date range and specific session attributes.
Selecting dimensions to include in the response, allowing tailored data output.
Sorting results by any supported field in ascending or descending order.

This allows clients to query exactly the session data they need, with flexible control over both the dataset and its presentation.

Authorizations:

Api Key AuthbearerAuth

Request Body schema: application/json
required

dimensions	Array of strings Items Enum: "sessionKey" "channel" "category" "adCampaignLabel" "adCampaignSource" "adCampaignMedium" "adCampaignContent" "adCampaignSourcePlatform" "adCampaignCreativeFormat" "adCampaignMarketingTactic" "adCampaignKey" "adCampaignTerm" "referrerUrl" "browserName" "browserVersion" "countryName" "countryCode" "cityName" "cityCode" "deviceType" "display" "platform" "ip" "privacyLevel" "companyOrgName" "companyOrgType" "sessionStartUnix" "landingPageUrl" "landingPageTitle" "latitude" "longitude" "visitorType" "visitorKey" "durationSeconds" "userAgent" "hasRecording" "isRecordingSeen" "isRecordingStarred" "hasUTMCampaign" "hasThirdPartyReferrer" "conversionEventCount" "isConvertingSession" "pages" "unfilteredPages" "visitCount" "unfilteredVisitCount" List of dimensions to include in the response
required	object Start and end of the date range (ISO 8601)
	Array of objects Array of objects specifying ordering of results
required	object
	object Filter conditions for the query

Responses

Request samples

Payload

Content type

application/json

{"dimensions": [ ],
"dateRange": {"start": "2026-01-01",
"end": "2026-01-07"
},
"order": [{"member": "createdAt",
"direction": "asc"
}
],
"pagination": {"page": 1,
"pageSize": 10
},
"where": {"and": [{"member": "hasRecording",
"operator": "eq",
"values": [false
]
}
]
}
}

Response samples

200
400

Content type

application/json

{"payload": [{"sessionKey": "fa107264-6daa-40f8-b410-64610e9c41eb",
"channel": "direct",
"category": "direct",
"adCampaignLabel": "",
"adCampaignSource": "",
"adCampaignMedium": "",
"adCampaignContent": "",
"adCampaignSourcePlatform": "",
"adCampaignCreativeFormat": "",
"adCampaignMarketingTactic": "",
"adCampaignKey": "",
"adCampaignTerm": "",
"referrerUrl": "",
"browserName": "Safari",
"browserVersion": "17.2",
"countryName": "Norway",
"countryCode": "NO",
"cityName": "Lillestrøm",
"cityCode": "LILLESTRM",
"deviceType": "phone",
"display": "600x720",
"platform": "iOS",
"ip": "-",
"privacyLevel": 2,
"companyOrgName": "Telia Norge AS",
"companyOrgType": "isp",
"sessionStartUnix": 1706741964,
"landingPageUrl": "https://www.twipla.com/en",
"landingPageTitle": "The Website Intelligence Platform | Advanced Web Statistics, Visitor Behavior Analytics & Communication",
"latitude": 59.9536,
"longitude": 11.062,
"visitorType": "returning",
"visitorKey": "yOnPxi4KGKiI7B9D3d+yXgdUFUHK3cRAEIUCDquB7cM=",
"durationSeconds": 0,
"hasRecording": false,
"isRecordingSeen": false,
"isRecordingStarred": false,
"hasUTMCampaign": false,
"hasThirdPartyReferrer": false,
"conversionEventCount": 1,
"isConvertingSession": true,
"pages": [{"title": "The Website Intelligence Platform | Advanced Web Statistics, Visitor Behavior Analytics & Communication",
"url": "https://www.twipla.com/en"
}
],
"unfilteredPages": [{"title": "The Website Intelligence Platform | Advanced Web Statistics, Visitor Behavior Analytics & Communication",
"url": "https://www.twipla.com/en"
}
],
"visitCount": 1,
"unfilteredVisitCount": 1,
"userAgent": ""
}
],
"meta": {"page": 1,
"pageSize": 1,
"pageTotal": 10464,
"total": 10464
}
}

Session analytics

Advanced metrics endpoint for session data aggregation.

This endpoint allows you to retrieve detailed metrics based on user sessions with flexible grouping, filtering, and sorting capabilities.

This endpoint is ideal for advanced analytics and reporting dashboards, allowing full control over which dimensions and metrics are returned, and how the data is aggregated and compared over time.

Authorizations:

Api Key AuthbearerAuth

Request Body schema: application/json
required

dimensions required	Array of strings Items Enum: "date" "pageUrl" "pageTitle" "channel" "category" "adCampaignLabel" "adCampaignSource" "adCampaignMedium" "adCampaignContent" "adCampaignSourcePlatform" "adCampaignCreativeFormat" "adCampaignMarketingTactic" "adCampaignKey" "adCampaignTerm" "referrerUrl" "browserName" "browserVersion" "countryName" "countryCode" "cityName" "cityCode" "deviceType" "display" "platform" "ip" "companyOrgName" "companyOrgType" "sessionStartUnix" "landingPageUrl" "landingPageTitle" "latitude" "longitude" "visitorType" "visitorKey" "userAgent" "hasRecording" "isRecordingSeen" "isRecordingStarred" "hasUTMCampaign" "hasThirdPartyReferrer" "isConvertingSession" List of dimensions to group metrics by. Maximum 2 can be used at once Special dimension `date` : when included, metrics are aggregated over time. Use the `granularity` field to specify the aggregation level (`year`, `month`, `week`, or `day`). all other dimensions correspond to session attributes (e.g., `countryName`, `deviceType`, `channel`) and can be used to segment metrics. some functionality may be limited when using `date`, such as sorting or metrics based on the previous period. the endpoint will automatically populate all time intervals within the specified date range, ensuring consistent time-series results.
metrics required	Array of strings Items Enum: "sessionCount" "previousSessionCount" "sessionCountPercentageChange" "sessionPercentOfTotal" "visitCount" "previousVisitCount" "visitCountPercentageChange" "visitorCount" "newVisitorCount" "returningVisitorCount" "previousVisitorCount" "visitorCountPercentageChange" "bounceRate" List of metrics to include in the response
required	object Start and end of the date range (ISO 8601)
	object Optional previous period for comparative metrics.
	Array of objects
	object Pagination is optional. If not specified, all results will be returned. This is particularly useful for time series data, such as when building graphs or visualizations.
granularity	string Enum: "year" "month" "week" "day" Controls the aggregation level for date-based dimensions. Must be used when the `date` dimension is included.

Responses

Request samples

Payload

Content type

application/json

{"dimensions": ["date"
],
"metrics": ["sessionCount"
],
"dateRange": {"start": "2019-08-24T14:15:22Z",
"end": "2019-08-24T14:15:22Z"
},
"previousDateRange": {"start": "2019-08-24T14:15:22Z",
"end": "2019-08-24T14:15:22Z"
},
"order": [{"member": "sessionCount",
"direction": "desc"
}
],
"pagination": {"page": 1,
"pageSize": 1
},
"granularity": "year"
}

Response samples

200
400

Content type

application/json

Example

(1) Analytics Sessions 200 Response - Overall Metrics

{"payload": [{"visitCount": 28622,
"sessionCount": 10464,
"previousSessionCount": 9464,
"sessionCountPercentageChange": 10.57,
"sessionPercentOfTotal": 100,
"previousVisitCount": 34117,
"visitCountPercentageChange": -16.11,
"visitorCount": 8109,
"newVisitorCount": 7565,
"returningVisitorCount": 544,
"previousVisitorCount": 7488,
"visitorCountPercentageChange": 8.29,
"bounceRate": 71.77
}
],
"meta": {"page": 1,
"pageSize": 2,
"pageTotal": 1,
"total": 1
},
"type": "(1) Analytics Sessions 200 Response - Overall Metrics"
}

Sessions Deprecated

Deprecated: Use /v2/websites/{websiteId}/raw/sessions instead.

Authentication is needed. For that, the request should have authorization header Authorization:Bearer token-string-value. Also logged in user can see only his own website data (otherwise 403 status code will be received).

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter (default = until - 7 days)
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter (default = today's date)
previousFrom	string <date-time> (urlEncodedISO8601) Example: previousFrom=2024-06-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter; optional
previousUntil	string <date-time> (urlEncodedISO8601) Example: previousUntil=2024-07-10T23%3A59%3A59.000%2B02%3A00 Upper bound date filter; optional
group	string Enum: "country" "landing-page" "page" "referrer" Example: group=country Groups the results by filter. No default option is available.
order required	string Enum: "desc" "asc" Example: order=count.asc,referrer.desc (only for group by referrer) Orders the results from query ascending or descending.
pageSize	integer Example: pageSize=20 Number of items per page to be requested; maximum number of elements per page is 500 if group=null
page	integer Example: page=1 Page to be requested

Responses

Response samples

200
4xx
5xx

Content type

application/json

Example

No group

{"payload": [{"sessionKey": "session-key-string",
"websiteKey": "website-key-string",
"visitorKey": "visitor-key-string",
"lastVisitTs": 1656927734,
"createdAt": 1651927731,
"totalVisits": null,
"location": {"latitude": null,
"longitude": null
},
"referrerUrl": null,
"ip": "ip-string",
"countryCode": "RO",
"display": null,
"platform": "linux",
"browserName": "Firefox",
"browserVersion": "101.0",
"deviceType": "desktop"
}
],
"meta": {"page": 1,
"pageSize": 20,
"sessionsTotal": 1
}
}

Sessions graph data V2 Deprecated

Deprecated: Use /v2/websites/{websiteId}/analytics/sessions instead.

Get sessions information as graph data

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
type required	string Enum: "time-series" "pie" "bar" Example: type=time-series
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Request Body schema: application/json
required

	object
	Array of objects
	object
	object
	Array of objects
primaryDimension	string optional

Responses

Request samples

Payload

Content type

application/json

{"where": {"and": [{"member": "string",
"operator": "string",
"values": [{"type": "string",
"category": ["string"
]
}
]
}
]
},
"order": [{"member": "string",
"direction": "string",
"priority": 0
}
],
"timeframe": {"from": "2019-08-24T14:15:22Z",
"until": "2019-08-24T14:15:22Z"
},
"pagination": {"page": 0,
"pageSize": 0
},
"segments": [{"id": "string",
"conditions": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
}
}
],
"primaryDimension": "string"
}

Response samples

200
4XX
5xx

Content type

application/json

{"payload": {"labels": ["string"
],
"datasets": [{"label": "string",
"data": [0
]
}
]
}
}

Average Session Duration Stats Deprecated

Deprecated: Use /v2/websites/{websiteId}/analytics/sessions instead.

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Request Body schema: application/json
optional

object

Responses

Request samples

Payload

Content type

application/json

{"where": {"and": [{"member": "string",
"operator": "string",
"values": [{"type": "string",
"category": ["string"
]
}
]
}
]
}
}

Response samples

200
4xx
5xx

Content type

application/json

{"payload": {"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12.1,
13.2
]
]
}
]
}
}

User Sessions Stats Deprecated

Deprecated: Use /v2/websites/{websiteId}/analytics/sessions instead.

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12.1,
13.2
]
]
}
]
}

Average Session Pages Stats

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12.1,
13.2
]
]
}
]
}

Sessions table Deprecated

Deprecated: Use /v2/websites/{websiteId}/raw/sessions instead.

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Request Body schema: application/json
required

containsPage	string
notContainsPage	string
	object
devices	Array of strings
	object
	object
status	Array of integers

Responses

Request samples

Payload

Content type

application/json

{"containsPage": "string",
"notContainsPage": "string",
"country": {"is": "string",
"isNot": "string"
},
"devices": ["string"
],
"os": {"is": "string",
"isNot": "string"
},
"browser": {"is": "string",
"isNot": "string"
},
"status": [0
]
}

Response samples

200
4XX
5xx

Content type

application/json

{"sessionsTotal": 0,
"data": [{"id": "string",
"visitorKey": "string",
"pageVisitsInSession": 0,
"device": "string",
"platform": "string",
"browser": "string",
"countryCode": "string",
"location": {"lat": 0,
"lng": 0
},
"status": 0,
"ip": "string",
"companyOrgName": "string",
"companyOrgType": "string",
"hasRecording": true,
"duration": 0,
"sessionExtras": {"id": "string",
"seen": true,
"star": true,
"tags": ["string"
]
},
"visitorStatus": 0,
"adCampaignSource": "string",
"adCampaignMedium": "string",
"adCampaignTerm": "string",
"adCampaignKey": "string",
"adCampaignLabel": "string",
"pageVisit": {"key": "string",
"url": "string",
"title": "string",
"unixTs": 0
},
"lastVisitTs": 0
}
]
}

Session log

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

sessionId required	string Example: sessionId=5f7b1b2b-5b0b-4b0b-8b0b-5b0b1b2b5b0b or 5f7b1b2b-5b0b-4b0b-8b0b-5b0b1b2b5b0b,130bf20c-6693-42f6-b03c-7c3d38117f46 One or more session IDs separated by a comma
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"data": {"ip": "string",
"device": "string",
"platform": "string",
"browser": "string",
"display": "string",
"countryCode": "string",
"location": {"lat": 0,
"lng": 0
},
"sessions": [{"id": "string",
"status": 0,
"sessionsStart": 0,
"ip": "string",
"countryCode": "string",
"location": {"lat": 0,
"lng": 0
},
"adCampaignSource": "string",
"adCampaignMedium": "string",
"adCampaignTerm": "string",
"adCampaignKey": "string",
"adCampaignLabel": "string",
"adCampaignContent": "string",
"referrer": "string",
"hasRecording": true,
"duration": 0,
"pageVisits": [{"key": "string",
"url": "string",
"title": "string",
"unixTs": 0
}
],
"sessionExtras": {"id": "string",
"seen": true,
"star": true,
"tags": ["string"
]
}
}
]
}
}

Sessions table V2 Deprecated

Deprecated: Use /v2/websites/{websiteId}/raw/sessions instead.

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-08-09T23%3A59%3A59.999%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter.
page	integer Example: page=1 Page to be requested
pageSize	integer Example: pageSize=20 Number of items per page to be requested
	Array of objects Example: order=visitorStatus.asc,unixTs.desc,countryCode.asc,ip.desc,companyOrgName.asc,device.desc,platform.asc,browser.desc,pageVisitsInSession.asc,hasRecording.desc Orders the results from query by name in ascending or descending order.
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Request Body schema: application/json
optional

containsPage	string
notContainsPage	string
	object
devices	Array of strings
	object
	object
status	Array of integers
onlySsrSessions	string
	object
	object
alarmingEvents	Array of strings (Alarming Events) Items Enum: "deadClicks" "rageClicks" "mouseMoves" "scrolls" "uTurns" "reloads"

Responses

Request samples

Payload

Content type

application/json

{"containsPage": "string",
"notContainsPage": "string",
"country": {"is": "string",
"isNot": "string"
},
"devices": ["string"
],
"os": {"is": "string",
"isNot": "string"
},
"browser": {"is": "string",
"isNot": "string"
},
"status": [0
],
"onlySsrSessions": "true",
"ip": {"contains": "string",
"notContains": "string"
},
"companyName": {"contains": "string",
"notContains": "string"
},
"alarmingEvents": ["deadClicks"
]
}

Response samples

200
4XX
5xx

Content type

application/json

{"meta": {"page": 1,
"pageSize": 10,
"total": 30,
"pageTotal": 9
},
"payload": {"data": [{"id": "string",
"visitorKey": "string",
"pageVisitsInSession": 0,
"device": "string",
"platform": "string",
"browser": "string",
"countryCode": "string",
"location": {"lat": 0,
"lng": 0
},
"status": 0,
"ip": "string",
"companyOrgName": "string",
"companyOrgType": "string",
"hasRecording": true,
"duration": 0,
"sessionExtras": {"id": "string",
"seen": true,
"star": true,
"tags": ["string"
]
},
"visitorStatus": 0,
"adCampaignSource": "string",
"adCampaignMedium": "string",
"adCampaignTerm": "string",
"adCampaignKey": "string",
"adCampaignLabel": "string",
"pageVisit": {"key": "string",
"url": "string",
"title": "string",
"unixTs": 0
},
"lastVisitTs": 0,
"alarmingEvents": ["deadClicks"
]
}
]
}
}

Sessions Geo Location Deprecated

Deprecated: Use /v2/websites/{websiteId}/raw/sessions instead.

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
limit required	integer Example: limit=10 limit

Request Body schema: application/json
required

	object
	Array of objects
	object
	object
	Array of objects
primaryDimension	string optional

Responses

Request samples

Payload

Content type

application/json

{"where": {"and": [{"member": "string",
"operator": "string",
"values": ["string"
]
}
]
},
"order": [{"member": "string",
"direction": "string",
"priority": 0
}
],
"timeframe": {"from": "2019-08-24T14:15:22Z",
"until": "2019-08-24T14:15:22Z"
},
"pagination": {"page": 0,
"pageSize": 0
},
"segments": [{"id": "string",
"conditions": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
}
}
],
"primaryDimension": "string"
}

Response samples

200
4XX
5xx

Content type

application/json

{"payload": [{"sessionKey": "valid-uuid",
"lat": 51.0328,
"long": 7.0524,
"ip": "78.47.153.144",
"visitorKey": "fp_955b8d6c494da9d80099da003a24f1ce",
"privacyLevel": "0"
}
]
}

Session Extras All

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

Request Body schema: application/json
optional

	object
	object

Responses

Request samples

Payload

Content type

application/json

{"filter": {"from": "2024-01-01T00:00:00.000+07:00",
"until": "2024-01-01T00:00:00.000+07:00"
},
"update": {"seen": true,
"star": true
}
}

Response samples

200
4XX
5xx

Content type

application/json

[{"key": "string",
"websiteKey": "string",
"sessionKey": "string",
"seen": true,
"star": true,
"comment": "string"
}
]

Get session recordings data V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-08-09T23%3A59%3A59.999%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter.
start	integer Example: start=6 Start of the results from query.
length	integer Length of the results from query.
order	string Enum: "desc" "asc" Orders the results from query ascending or descending.
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Request Body schema: application/json
required

starred	string
watched	string
note	string
from	number <int64>
until	number <int64>
	object
	object
	object
	object
status	Array of integers
containsPage	string
notContainsPage	string
	object
	object
entryPage	string
exitPage	string
	object
referrerURLs	Array of strings
trafficChannels	Array of strings
adCampaignLabels	Array of strings
	object
recordingId	string
alarmingEvents	Array of strings (Alarming Events) Items Enum: "deadClicks" "rageClicks" "mouseMoves" "scrolls" "uTurns" "reloads"

Responses

Request samples

Payload

Content type

application/json

{"starred": "string",
"watched": "string",
"note": "string",
"from": 0,
"until": 0,
"country": {"is": ["string"
],
"isNot": ["string"
]
},
"os": {"is": ["string"
],
"isNot": ["string"
]
},
"browser": {"is": ["string"
],
"isNot": ["string"
]
},
"devices": {"is": ["string"
],
"isNot": ["string"
]
},
"status": [0
],
"containsPage": "string",
"notContainsPage": "string",
"durations": {"min": 0,
"max": 0
},
"pageCount": {"min": 0,
"max": 0
},
"entryPage": "string",
"exitPage": "string",
"funnelDropouts": {"id": "string",
"level": 0
},
"referrerURLs": ["string"
],
"trafficChannels": ["string"
],
"adCampaignLabels": ["string"
],
"tags": {"property1": "string",
"property2": "string"
},
"recordingId": "string",
"alarmingEvents": ["deadClicks"
]
}

Response samples

200
4XX
5xx

Content type

application/json

{"sessionsTotal": 0,
"data": [{"id": "string",
"status": 0,
"countryCode": "string",
"sessionStart": 0,
"referrer": "string",
"platform": "string",
"device": "string",
"browser": "string",
"screenSize": "string",
"location": {"lat": 0,
"lng": 0
},
"visitorId": "string",
"entryPage": "https://twipla.com/home",
"exitPage": "https://twipla.com/register",
"ssrStatus": 0,
"ssrInfo": {"pagesCount": 0,
"duration": 0,
"pages": [{"url": "string",
"duration": 0,
"timestamp": 0,
"type": 0
}
]
},
"sessionExtras": {"id": "string",
"seen": true,
"star": true,
"tags": ["string"
]
},
"comment": "string",
"tags": {"property1": "string",
"property2": "string"
},
"events": {"events": 0,
"moveInteractions": 0,
"scrollInteractions": 0,
"clickInteractions": 0,
"incSnapshots": 0
},
"alarmingEvents": {"deadClicks": 0,
"rageClicks": 0,
"mouseMoves": 0,
"scrolls": 0,
"uTurns": 0,
"reloads": 0
}
}
]
}

Get average duration

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

timezone

string

Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"payload": {"average-duration": 0
}
}

Get recordings

Get the recordings of a session

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

Responses

Response samples

200
4xx
5xx

Content type

application/json

[{"id": "507f1f77bcf86cd799439011",
"sessionId": "507f1f77bcf86cd799439011",
"page": "https://example.com",
"duration": 616188,
"wsSessionId": null,
"status": "NONE",
"createdAt": "2025-06-04T09:53:18.993Z",
"scopes": ["R",
"H"
],
"compression": "COMPRESSED",
"metadata": {"events": 421,
"clickInteractions": 3,
"moveInteractions": 2,
"scrollInteractions": 0,
"incSnapshots": 419
}
}
]

Get recordings events

Get the events of a recording

Authorizations:

bearerAuth

path Parameters

websiteId required	string <uuid> (uuid) Example: 06d99a32-ee11-11eb-830a-0146de130018 ID of a website
recordingId required	string (objectId) ^[a-f\d]{24}$ Example: 507f1f77bcf86cd799439011 ObjectId of a recording

Responses

Response samples

200
4xx
5xx

Content type

application/json

[{"id": null,
"recordingId": null,
"data": "{\"positions\":[{\"ex\":82.0,\"ey\":3.0,\"id\":48.0,\"timeOffset\":0.0,\"x\":1762.0,\"y\":11.0}],\"source\":1.0}",
"timestamp": 1749029783479,
"type": 3
}
]

Traffic Structure

Operations about website traffic structure

Traffic share classification overview

Retrieve and analyze data to understand how people visit a website. They count and categorize the traffic sources, helping website owners to see where their visitors are coming from and how they interact with the site.

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Request Body schema: application/json
required

	object
	Array of objects
	object
	object
	Array of objects
primaryDimension	string optional

Responses

Request samples

Payload

Content type

application/json

{"where": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
},
"order": [{"member": "string",
"direction": "string",
"priority": 0
}
],
"timeframe": {"from": "2019-08-24T14:15:22Z",
"until": "2019-08-24T14:15:22Z"
},
"pagination": {"page": 0,
"pageSize": 0
},
"segments": [{"id": "string",
"conditions": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
}
}
],
"primaryDimension": "string"
}

Response samples

200
4XX
5xx

Content type

application/json

{"from": "2019-08-24T14:15:22Z",
"until": "2019-08-24T14:15:22Z",
"points": [{"channelType": 0,
"values": [{"company": "string",
"value": 0
}
]
}
]
}

Traffic share classification overview

The SQL queries in the code retrieve and analyze data from a database to understand how people visit a website. They count and categorize the traffic sources, helping website owners to see where their visitors are coming from and how they interact with the site.

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"from": "2019-08-24T14:15:22Z",
"until": "2019-08-24T14:15:22Z",
"points": [{"channelType": 0,
"values": [{"company": "string",
"value": 0
}
]
}
]
}

Traffic share in depth

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Request Body schema: application/json
required

	object
	Array of objects
	object
	object
	Array of objects
primaryDimension	string optional

Responses

Request samples

Payload

Content type

application/json

{"where": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
},
"order": [{"member": "string",
"direction": "string",
"priority": 0
}
],
"timeframe": {"from": "2019-08-24T14:15:22Z",
"until": "2019-08-24T14:15:22Z"
},
"pagination": {"page": 0,
"pageSize": 0
},
"segments": [{"id": "string",
"conditions": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
}
}
],
"primaryDimension": "string"
}

Response samples

200
4XX
5xx

Content type

application/json

{"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12,
13
]
]
}
]
}

Traffic share in depth

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12,
13
]
]
}
]
}

Traffic share internal visits

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Request Body schema: application/json
required

	object
	Array of objects

Responses

Request samples

Payload

Content type

application/json

{"where": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
},
"segments": [{"id": "string",
"conditions": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
}
}
]
}

Response samples

200
4XX
5xx

Content type

application/json

{"payload": {"datasets": [{"label": "Internal Traffic Visits",
"data": [32,
50,
80
]
}
],
"labels": ["2022-06-22T15:46:47Z"
]
}
}

Traffic share internal visits

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"payload": {"datasets": [{"label": "Internal Traffic Visits",
"data": [32,
50,
80
]
}
],
"labels": ["2022-06-22T15:46:47Z"
]
}
}

Pages per visits overview

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Request Body schema: application/json
required

	object
	Array of objects
	object
	object
	Array of objects
primaryDimension	string optional

Responses

Request samples

Payload

Content type

application/json

{"where": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
},
"order": [{"member": "string",
"direction": "string",
"priority": 0
}
],
"timeframe": {"from": "2019-08-24T14:15:22Z",
"until": "2019-08-24T14:15:22Z"
},
"pagination": {"page": 0,
"pageSize": 0
},
"segments": [{"id": "string",
"conditions": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
}
}
],
"primaryDimension": "string"
}

Response samples

200
4XX
5xx

Content type

application/json

{"overall": 0,
"points": [{"channelType": 0,
"value": 0
}
],
"from": "2019-08-24T14:15:22Z",
"until": "2019-08-24T14:15:22Z"
}

Pages per visits overview

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"overall": 0,
"points": [{"channelType": 0,
"value": 0
}
],
"from": "2019-08-24T14:15:22Z",
"until": "2019-08-24T14:15:22Z"
}

Pages per visits in depth

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Request Body schema: application/json
required

	object
	Array of objects
	object
	object
	Array of objects
primaryDimension	string optional

Responses

Request samples

Payload

Content type

application/json

{"where": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
},
"order": [{"member": "string",
"direction": "string",
"priority": 0
}
],
"timeframe": {"from": "2019-08-24T14:15:22Z",
"until": "2019-08-24T14:15:22Z"
},
"pagination": {"page": 0,
"pageSize": 0
},
"segments": [{"id": "string",
"conditions": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
}
}
],
"primaryDimension": "string"
}

Response samples

200
4XX
5xx

Content type

application/json

{"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12.1,
13.2
]
]
}
]
}

Pages per visit in depth

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12.1,
13.2
]
]
}
]
}

Bounce rate overview

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Request Body schema: application/json
required

	object
	Array of objects
	object
	object
	Array of objects
primaryDimension	string optional

Responses

Request samples

Payload

Content type

application/json

{"where": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
},
"order": [{"member": "string",
"direction": "string",
"priority": 0
}
],
"timeframe": {"from": "2019-08-24T14:15:22Z",
"until": "2019-08-24T14:15:22Z"
},
"pagination": {"page": 0,
"pageSize": 0
},
"segments": [{"id": "string",
"conditions": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
}
}
],
"primaryDimension": "string"
}

Response samples

200
4XX
5xx

Content type

application/json

{"overall": 0,
"points": [{"channelType": 0,
"value": 0
}
],
"from": "2019-08-24T14:15:22Z",
"until": "2019-08-24T14:15:22Z"
}

Bounce rate overview

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"overall": 0,
"points": [{"channelType": 0,
"value": 0
}
],
"from": "2019-08-24T14:15:22Z",
"until": "2019-08-24T14:15:22Z"
}

Bounce rate in depth

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Request Body schema: application/json
required

	object
	Array of objects
	object
	object
	Array of objects
primaryDimension	string optional

Responses

Request samples

Payload

Content type

application/json

null

Response samples

200
4XX
5xx

Content type

application/json

{"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12.1,
13.2
]
]
}
]
}

Bounce rate in depth

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12.1,
13.2
]
]
}
]
}

Session duration overview

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Request Body schema: application/json
required

	object
	Array of objects
	object
	object
	Array of objects
primaryDimension	string optional

Responses

Request samples

Payload

Content type

application/json

{"where": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
},
"order": [{"member": "string",
"direction": "string",
"priority": 0
}
],
"timeframe": {"from": "2019-08-24T14:15:22Z",
"until": "2019-08-24T14:15:22Z"
},
"pagination": {"page": 0,
"pageSize": 0
},
"segments": [{"id": "string",
"conditions": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
}
}
],
"primaryDimension": "string"
}

Response samples

200
4XX
5xx

Content type

application/json

{"overall": 0,
"points": [{"channelType": 0,
"value": 0
}
],
"from": "2019-08-24T14:15:22Z",
"until": "2019-08-24T14:15:22Z"
}

Session duration overview

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"overall": 0,
"points": [{"channelType": 0,
"value": 0
}
],
"from": "2019-08-24T14:15:22Z",
"until": "2019-08-24T14:15:22Z"
}

Session duration in depth

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Request Body schema: application/json
required

	object
	Array of objects
	object
	object
	Array of objects
primaryDimension	string optional

Responses

Request samples

Payload

Content type

application/json

{"where": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
},
"order": [{"member": "string",
"direction": "string",
"priority": 0
}
],
"timeframe": {"from": "2019-08-24T14:15:22Z",
"until": "2019-08-24T14:15:22Z"
},
"pagination": {"page": 0,
"pageSize": 0
},
"segments": [{"id": "string",
"conditions": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
}
}
],
"primaryDimension": "string"
}

Response samples

200
4XX
5xx

Content type

application/json

{"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12.1,
13.2
]
]
}
]
}

Session duration in depth

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12.1,
13.2
]
]
}
]
}

Field Values

Get Traffic Structure Field Values

Authorizations:

bearerAuth

path Parameters

websiteId required	string <uuid> (uuid) Example: 06d99a32-ee11-11eb-830a-0146de130018 ID of a website
trafficType required	string Type of traffic

Responses

Response samples

200
4XX
5xx

Content type

application/json

["string"
]

Field Values V2

Get Traffic Structure Field Values V2

Authorizations:

bearerAuth

path Parameters

websiteId required	string <uuid> (uuid) Example: 06d99a32-ee11-11eb-830a-0146de130018 ID of a website
trafficType required	string Type of traffic

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"payload": ["string"
]
}

Get Website Traffic Graph Overall

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Responses

Response samples

200
4xx
5xx

Content type

application/json

{"payload": {"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12.1,
13.2
]
]
}
]
},
"meta": {"page": 1,
"pageSize": 10,
"total": 30,
"pageTotal": 9
}
}

Post Website Traffic Graph Overall

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Request Body schema: application/json

object

Responses

Request samples

Payload

Content type

application/json

{"where": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
}
}

Response samples

200
4xx
5xx

Content type

application/json

{"payload": {"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12.1,
13.2
]
]
}
]
},
"meta": {"page": 1,
"pageSize": 10,
"total": 30,
"pageTotal": 9
}
}

Get Referrer Traffic Graph Overall

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Responses

Response samples

200
4xx
5xx

Content type

application/json

{"payload": {"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12.1,
13.2
]
]
}
]
},
"meta": {"page": 1,
"pageSize": 10,
"total": 30,
"pageTotal": 9
}
}

Post Referrer Traffic Graph Overall

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Request Body schema: application/json

object

Responses

Request samples

Payload

Content type

application/json

{"where": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
}
}

Response samples

200
4xx
5xx

Content type

application/json

{"payload": {"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12.1,
13.2
]
]
}
]
},
"meta": {"page": 1,
"pageSize": 10,
"total": 30,
"pageTotal": 9
}
}

Get Ecom Traffic Structure Overview V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Request Body schema: application/json
required

	object
	Array of objects
	object
	object
	Array of objects
primaryDimension	string optional

Responses

Request samples

Payload

Content type

application/json

{"where": {"and": [{"member": "string",
"operator": "string",
"values": [{"type": "string",
"category": ["string"
]
}
]
}
]
},
"order": [{"member": "string",
"direction": "string",
"priority": 0
}
],
"timeframe": {"from": "2019-08-24T14:15:22Z",
"until": "2019-08-24T14:15:22Z"
},
"pagination": {"page": 0,
"pageSize": 0
},
"segments": [{"id": "string",
"conditions": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
}
}
],
"primaryDimension": "string"
}

Response samples

200
4XX
5xx

Content type

application/json

{"payload": {"from": "2019-08-24T14:15:22Z",
"until": "2019-08-24T14:15:22Z",
"points": [{"channelType": 0,
"values": [{"company": "string",
"value": 0
}
]
}
]
}
}

Get Ecom Traffic Structure Overview V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"payload": {"from": "2019-08-24T14:15:22Z",
"until": "2019-08-24T14:15:22Z",
"points": [{"channelType": 0,
"values": [{"company": "string",
"value": 0
}
]
}
]
}
}

Get Ecom Traffic Structure In Depth V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Request Body schema: application/json
required

	object
	Array of objects
	object
	object
	Array of objects
primaryDimension	string optional

Responses

Request samples

Payload

Content type

application/json

{"where": {"and": [{"member": "string",
"operator": "string",
"values": [{"type": "string",
"category": ["string"
]
}
]
}
]
},
"order": [{"member": "string",
"direction": "string",
"priority": 0
}
],
"timeframe": {"from": "2019-08-24T14:15:22Z",
"until": "2019-08-24T14:15:22Z"
},
"pagination": {"page": 0,
"pageSize": 0
},
"segments": [{"id": "string",
"conditions": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
}
}
],
"primaryDimension": "string"
}

Response samples

200
4XX
5xx

Content type

application/json

{"meta": {"page": 1,
"pageSize": 10,
"total": 30,
"pageTotal": 9
},
"payload": {"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12,
13
]
]
}
]
}
}

Get Ecom Traffic Structure In Depth V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"meta": {"page": 1,
"pageSize": 10,
"total": 30,
"pageTotal": 9
},
"payload": {"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12,
13
]
]
}
]
}
}

Analytics

Operations about website analytics

Page Analytics

In regards to the visitor data, the endpoint returns the number of unique overall visitors, new visitors, and returning visitors in a given period of time.

This endpoint calculates unique visitors based on the previous visits made by a visitor before the specified period.

Unique overall visitors: Total number of unique visitors within the specified period. Each visitor is counted only once, even if they visited multiple times within the period.
Unique new visitors: Visitors who visited for the first time within the specified period. Each visitor is counted only once, even if they made multiple visits within the period.
Unique returning visitors: Visitors who have made at least one visit before the specified period and visited again within the specified period. Each visitor is counted only once, even if they made multiple visits within the period.

The period is determined by the start and end timestamps provided in the request query parameters.

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

timezone

string

Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Request Body schema: application/json
required

	object
	Array of objects
	object
	object
	Array of objects
primaryDimension	string optional

Responses

Request samples

Payload

Content type

application/json

{"where": {"and": [{"member": "string",
"operator": "string",
"values": [{"type": "string",
"category": ["string"
]
}
]
}
]
},
"order": [{"member": "string",
"direction": "string",
"priority": 0
}
],
"timeframe": {"from": "2019-08-24T14:15:22Z",
"until": "2019-08-24T14:15:22Z"
},
"pagination": {"page": 0,
"pageSize": 0
},
"segments": [{"id": "string",
"conditions": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
}
}
],
"primaryDimension": "string"
}

Response samples

200
4XX
5xx

Content type

application/json

{"page": 0,
"pageSize": 0,
"totalPages": 0,
"totalItems": 0,
"items": [{"pageUrl": "string",
"visitors": 0,
"newVisitors": 0,
"returningVisitors": 0,
"topReferer": "string",
"topRefererVisits": 0,
"topRefererAverageDuration": 0,
"visits": 0,
"averageVisitDuration": 0,
"segments": [{"id": "string",
"data": {"pageUrl": "string",
"visitors": 0,
"newVisitors": 0,
"returningVisitors": 0,
"topReferer": "string",
"topRefererVisits": 0,
"topRefererAverageDuration": 0,
"visits": 0,
"averageDuration": 0
}
}
]
}
]
}

Ecom

Operations about website e-commerce

Has ecom events

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

Responses

Response samples

200
4XX
5xx

Content type

application/json

true

Get Ecom Sessions Graph V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Request Body schema: application/json
required

	object
	Array of objects
	object
	object
	Array of objects
primaryDimension	string optional

Responses

Request samples

Payload

Content type

application/json

{"where": {"and": [{"member": "string",
"operator": "string",
"values": [{"type": "string",
"category": ["string"
]
}
]
}
]
},
"order": [{"member": "string",
"direction": "string",
"priority": 0
}
],
"timeframe": {"from": "2019-08-24T14:15:22Z",
"until": "2019-08-24T14:15:22Z"
},
"pagination": {"page": 0,
"pageSize": 0
},
"segments": [{"id": "string",
"conditions": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
}
}
],
"primaryDimension": "string"
}

Response samples

200
4XX
5xx

Content type

application/json

{"meta": {"page": 1,
"pageSize": 10,
"total": 30,
"pageTotal": 9
},
"payload": {"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12,
13
]
],
"total": 25.3,
"totalAverage": 12.6
}
]
}
}

Get Ecom Sessions Graph V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"meta": {"page": 1,
"pageSize": 10,
"total": 30,
"pageTotal": 9
},
"payload": {"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12,
13
]
],
"total": 25.3,
"totalAverage": 12.6
}
]
}
}

Get Ecom Customers Graph V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Request Body schema: application/json
required

	object
	Array of objects
	object
	object
	Array of objects
primaryDimension	string optional

Responses

Request samples

Payload

Content type

application/json

{"where": {"and": [{"member": "string",
"operator": "string",
"values": [{"type": "string",
"category": ["string"
]
}
]
}
]
},
"order": [{"member": "string",
"direction": "string",
"priority": 0
}
],
"timeframe": {"from": "2019-08-24T14:15:22Z",
"until": "2019-08-24T14:15:22Z"
},
"pagination": {"page": 0,
"pageSize": 0
},
"segments": [{"id": "string",
"conditions": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
}
}
],
"primaryDimension": "string"
}

Response samples

200
4XX
5xx

Content type

application/json

{"meta": {"page": 1,
"pageSize": 10,
"total": 30,
"pageTotal": 9
},
"payload": {"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12,
13
]
],
"total": 25.3,
"totalAverage": 12.6
}
]
}
}

Get Ecom Customers Graph V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"meta": {"page": 1,
"pageSize": 10,
"total": 30,
"pageTotal": 9
},
"payload": {"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12,
13
]
],
"total": 25.3,
"totalAverage": 12.6
}
]
}
}

Get Ecom Orders Graph V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Request Body schema: application/json
required

	object
	Array of objects
	object
	object
	Array of objects
primaryDimension	string optional

Responses

Request samples

Payload

Content type

application/json

{"where": {"and": [{"member": "string",
"operator": "string",
"values": [{"type": "string",
"category": ["string"
]
}
]
}
]
},
"order": [{"member": "string",
"direction": "string",
"priority": 0
}
],
"timeframe": {"from": "2019-08-24T14:15:22Z",
"until": "2019-08-24T14:15:22Z"
},
"pagination": {"page": 0,
"pageSize": 0
},
"segments": [{"id": "string",
"conditions": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
}
}
],
"primaryDimension": "string"
}

Response samples

200
4XX
5xx

Content type

application/json

{"meta": {"page": 1,
"pageSize": 10,
"total": 30,
"pageTotal": 9
},
"payload": {"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12,
13
]
],
"total": 25.3,
"totalAverage": 12.6
}
]
}
}

Get Ecom Orders Graph V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"meta": {"page": 1,
"pageSize": 10,
"total": 30,
"pageTotal": 9
},
"payload": {"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12,
13
]
],
"total": 25.3,
"totalAverage": 12.6
}
]
}
}

Get Ecom Sold Products Graph V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Request Body schema: application/json
required

	object
	Array of objects
	object
	object
	Array of objects
primaryDimension	string optional

Responses

Request samples

Payload

Content type

application/json

{"where": {"and": [{"member": "string",
"operator": "string",
"values": [{"type": "string",
"category": ["string"
]
}
]
}
]
},
"order": [{"member": "string",
"direction": "string",
"priority": 0
}
],
"timeframe": {"from": "2019-08-24T14:15:22Z",
"until": "2019-08-24T14:15:22Z"
},
"pagination": {"page": 0,
"pageSize": 0
},
"segments": [{"id": "string",
"conditions": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
}
}
],
"primaryDimension": "string"
}

Response samples

200
4XX
5xx

Content type

application/json

{"meta": {"page": 1,
"pageSize": 10,
"total": 30,
"pageTotal": 9
},
"payload": {"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12,
13
]
],
"total": 25.3,
"totalAverage": 12.6
}
]
}
}

Get Ecom Sold Products Graph V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"meta": {"page": 1,
"pageSize": 10,
"total": 30,
"pageTotal": 9
},
"payload": {"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12,
13
]
],
"total": 25.3,
"totalAverage": 12.6
}
]
}
}

Get Ecom Gross Revenue Graph V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Request Body schema: application/json
required

	object
	Array of objects
	object
	object
	Array of objects
primaryDimension	string optional

Responses

Request samples

Payload

Content type

application/json

{"where": {"and": [{"member": "string",
"operator": "string",
"values": [{"type": "string",
"category": ["string"
]
}
]
}
]
},
"order": [{"member": "string",
"direction": "string",
"priority": 0
}
],
"timeframe": {"from": "2019-08-24T14:15:22Z",
"until": "2019-08-24T14:15:22Z"
},
"pagination": {"page": 0,
"pageSize": 0
},
"segments": [{"id": "string",
"conditions": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
}
}
],
"primaryDimension": "string"
}

Response samples

200
4XX
5xx

Content type

application/json

{"meta": {"page": 1,
"pageSize": 10,
"total": 30,
"pageTotal": 9
},
"payload": {"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12.1,
13.2
]
],
"total": 25.3,
"totalAverage": 12.6
}
]
}
}

Get Ecom Gross Revenue Graph V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"meta": {"page": 1,
"pageSize": 10,
"total": 30,
"pageTotal": 9
},
"payload": {"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12.1,
13.2
]
],
"total": 25.3,
"totalAverage": 12.6
}
]
}
}

Get Ecom Net Revenue Graph V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Request Body schema: application/json
required

	object
	Array of objects
	object
	object
	Array of objects
primaryDimension	string optional

Responses

Request samples

Payload

Content type

application/json

{"where": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
},
"order": [{"member": "string",
"direction": "string",
"priority": 0
}
],
"timeframe": {"from": "2019-08-24T14:15:22Z",
"until": "2019-08-24T14:15:22Z"
},
"pagination": {"page": 0,
"pageSize": 0
},
"segments": [{"id": "string",
"conditions": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
}
}
],
"primaryDimension": "string"
}

Response samples

200
4XX
5xx

Content type

application/json

{"payload": {"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12.1,
13.2
]
]
}
]
}
}

Get Ecom Net Revenue Graph V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"payload": {"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12.1,
13.2
]
]
}
]
}
}

Get Ecom Session Purchase Ratio Graph V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Request Body schema: application/json
required

	object
	Array of objects
	object
	object
	Array of objects
primaryDimension	string optional

Responses

Request samples

Payload

Content type

application/json

{"where": {"and": [{"member": "string",
"operator": "string",
"values": [{"type": "string",
"category": ["string"
]
}
]
}
]
},
"order": [{"member": "string",
"direction": "string",
"priority": 0
}
],
"timeframe": {"from": "2019-08-24T14:15:22Z",
"until": "2019-08-24T14:15:22Z"
},
"pagination": {"page": 0,
"pageSize": 0
},
"segments": [{"id": "string",
"conditions": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
}
}
],
"primaryDimension": "string"
}

Response samples

200
4XX
5xx

Content type

application/json

{"meta": {"page": 1,
"pageSize": 10,
"total": 30,
"pageTotal": 9
},
"payload": {"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12.1,
13.2
]
],
"total": 25.3,
"totalAverage": 12.6
}
]
}
}

Get Ecom Session Purchase Ratio Graph V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"meta": {"page": 1,
"pageSize": 10,
"total": 30,
"pageTotal": 9
},
"payload": {"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12.1,
13.2
]
],
"total": 25.3,
"totalAverage": 12.6
}
]
}
}

Get Ecom Checkout Purchase Ratio Graph V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Request Body schema: application/json
required

	object
	Array of objects
	object
	object
	Array of objects
primaryDimension	string optional

Responses

Request samples

Payload

Content type

application/json

{"where": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
},
"order": [{"member": "string",
"direction": "string",
"priority": 0
}
],
"timeframe": {"from": "2019-08-24T14:15:22Z",
"until": "2019-08-24T14:15:22Z"
},
"pagination": {"page": 0,
"pageSize": 0
},
"segments": [{"id": "string",
"conditions": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
}
}
],
"primaryDimension": "string"
}

Response samples

200
4XX
5xx

Content type

application/json

{"payload": {"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12.1,
13.2
]
]
}
]
}
}

Get Ecom Checkout Purchase Ratio Graph V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"payload": {"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12.1,
13.2
]
]
}
]
}
}

Get Ecom Average Items Order V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Request Body schema: application/json
required

object

Responses

Request samples

Payload

Content type

application/json

{"payload": {"data": 79.12
}
}

Response samples

200
4XX
5xx

Content type

application/json

{"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12.1,
13.2
]
]
}
]
}

Get Ecom Average Items Order V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"payload": {"data": 79.12
}
}

Get Ecom Average Value Order V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Request Body schema: application/json
required

	object
	Array of objects
	object
	object
	Array of objects
primaryDimension	string optional

Responses

Request samples

Payload

Content type

application/json

{"where": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
},
"order": [{"member": "string",
"direction": "string",
"priority": 0
}
],
"timeframe": {"from": "2019-08-24T14:15:22Z",
"until": "2019-08-24T14:15:22Z"
},
"pagination": {"page": 0,
"pageSize": 0
},
"segments": [{"id": "string",
"conditions": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
}
}
],
"primaryDimension": "string"
}

Response samples

200
4XX
5xx

Content type

application/json

{"payload": {"data": 79.12
}
}

Get Ecom Average Value Order V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"payload": {"data": 79.12
}
}

Get Ecom Highest Revenue Day V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Request Body schema: application/json
required

	object
	Array of objects
	object
	object
	Array of objects
primaryDimension	string optional

Responses

Request samples

Payload

Content type

application/json

{"where": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
},
"order": [{"member": "string",
"direction": "string",
"priority": 0
}
],
"timeframe": {"from": "2019-08-24T14:15:22Z",
"until": "2019-08-24T14:15:22Z"
},
"pagination": {"page": 0,
"pageSize": 0
},
"segments": [{"id": "string",
"conditions": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
}
}
],
"primaryDimension": "string"
}

Response samples

200
4XX
5xx

Content type

application/json

{"payload": {"data": 79.12,
"info": "string"
}
}

Get Ecom Highest Revenue Day V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"payload": {"data": 79.12,
"info": "string"
}
}

Get Ecom Highest Order Day V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Request Body schema: application/json
required

	object
	Array of objects
	object
	object
	Array of objects
primaryDimension	string optional

Responses

Request samples

Payload

Content type

application/json

{"where": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
},
"order": [{"member": "string",
"direction": "string",
"priority": 0
}
],
"timeframe": {"from": "2019-08-24T14:15:22Z",
"until": "2019-08-24T14:15:22Z"
},
"pagination": {"page": 0,
"pageSize": 0
},
"segments": [{"id": "string",
"conditions": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
}
}
],
"primaryDimension": "string"
}

Response samples

200
4XX
5xx

Content type

application/json

{"payload": {"data": 79.12,
"info": "string"
}
}

Get Ecom Highest Order Day V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"payload": {"data": 79.12,
"info": "string"
}
}

Get Ecom Top Sold Products V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
limit required	integer Example: limit=10 limit
start required	integer Example: start=6 Start of the results from query.
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Request Body schema: application/json
required

	object
	Array of objects
	object
	object
	Array of objects
primaryDimension	string optional

Responses

Request samples

Payload

Content type

application/json

{"where": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
},
"order": [{"member": "string",
"direction": "string",
"priority": 0
}
],
"timeframe": {"from": "2019-08-24T14:15:22Z",
"until": "2019-08-24T14:15:22Z"
},
"pagination": {"page": 0,
"pageSize": 0
},
"segments": [{"id": "string",
"conditions": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
}
}
],
"primaryDimension": "string"
}

Response samples

200
4XX
5xx

Content type

application/json

{"payload": {"countItems": 2,
"total": 2,
"items": [{"id": "00000000-0000-0000-0000-000000000000",
"name": "Product 1",
"variant": "Variant 1",
"imageUrl": "https://www.twipla.com/image",
"data": 2
}
]
}
}

Get Ecom Top Sold Products V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
limit required	integer Example: limit=10 limit
start required	integer Example: start=6 Start of the results from query.
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"payload": {"countItems": 2,
"total": 2,
"items": [{"id": "00000000-0000-0000-0000-000000000000",
"name": "Product 1",
"variant": "Variant 1",
"imageUrl": "https://www.twipla.com/image",
"data": 2
}
]
}
}

Get Ecom Most Viewed Products V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
limit required	integer Example: limit=10 limit
start required	integer Example: start=6 Start of the results from query.
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Request Body schema: application/json
required

	object
	Array of objects
	object
	object
	Array of objects
primaryDimension	string optional

Responses

Request samples

Payload

Content type

application/json

{"where": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
},
"order": [{"member": "string",
"direction": "string",
"priority": 0
}
],
"timeframe": {"from": "2019-08-24T14:15:22Z",
"until": "2019-08-24T14:15:22Z"
},
"pagination": {"page": 0,
"pageSize": 0
},
"segments": [{"id": "string",
"conditions": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
}
}
],
"primaryDimension": "string"
}

Response samples

200
4XX
5xx

Content type

application/json

{"payload": {"countItems": 2,
"total": 2,
"items": [{"id": "00000000-0000-0000-0000-000000000000",
"name": "Product 1",
"variant": "Variant 1",
"imageUrl": "https://www.twipla.com/image",
"data": 2
}
]
}
}

Get Ecom Most Viewed Products V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
limit required	integer Example: limit=10 limit
start required	integer Example: start=6 Start of the results from query.
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"payload": {"countItems": 2,
"total": 2,
"items": [{"id": "00000000-0000-0000-0000-000000000000",
"name": "Product 1",
"variant": "Variant 1",
"imageUrl": "https://www.twipla.com/image",
"data": 2
}
]
}
}

Get Ecom Most Removed From Cart V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
limit required	integer Example: limit=10 limit
start required	integer Example: start=6 Start of the results from query.
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Request Body schema: application/json
required

	object
	Array of objects
	object
	object
	Array of objects
primaryDimension	string optional

Responses

Request samples

Payload

Content type

application/json

{"where": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
},
"order": [{"member": "string",
"direction": "string",
"priority": 0
}
],
"timeframe": {"from": "2019-08-24T14:15:22Z",
"until": "2019-08-24T14:15:22Z"
},
"pagination": {"page": 0,
"pageSize": 0
},
"segments": [{"id": "string",
"conditions": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
}
}
],
"primaryDimension": "string"
}

Response samples

200
4XX
5xx

Content type

application/json

{"payload": {"countItems": 2,
"total": 2,
"items": [{"id": "00000000-0000-0000-0000-000000000000",
"name": "Product 1",
"variant": "Variant 1",
"imageUrl": "https://www.twipla.com/image",
"data": 2
}
]
}
}

Get Ecom Most Removed From Cart V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
limit required	integer Example: limit=10 limit
start required	integer Example: start=6 Start of the results from query.
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"payload": {"countItems": 2,
"total": 2,
"items": [{"id": "00000000-0000-0000-0000-000000000000",
"name": "Product 1",
"variant": "Variant 1",
"imageUrl": "https://www.twipla.com/image",
"data": 2
}
]
}
}

Get Ecom Most Added To Cart V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
limit required	integer Example: limit=10 limit
start required	integer Example: start=6 Start of the results from query.
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Request Body schema: application/json
required

	object
	Array of objects
	object
	object
	Array of objects
primaryDimension	string optional

Responses

Request samples

Payload

Content type

application/json

{"where": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
},
"order": [{"member": "string",
"direction": "string",
"priority": 0
}
],
"timeframe": {"from": "2019-08-24T14:15:22Z",
"until": "2019-08-24T14:15:22Z"
},
"pagination": {"page": 0,
"pageSize": 0
},
"segments": [{"id": "string",
"conditions": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
}
}
],
"primaryDimension": "string"
}

Response samples

200
4XX
5xx

Content type

application/json

{"payload": {"countItems": 2,
"total": 2,
"items": [{"id": "00000000-0000-0000-0000-000000000000",
"name": "Product 1",
"variant": "Variant 1",
"imageUrl": "https://www.twipla.com/image",
"data": 2
}
]
}
}

Get Ecom Most Added To Cart V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
limit required	integer Example: limit=10 limit
start required	integer Example: start=6 Start of the results from query.
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"payload": {"countItems": 2,
"total": 2,
"items": [{"id": "00000000-0000-0000-0000-000000000000",
"name": "Product 1",
"variant": "Variant 1",
"imageUrl": "https://www.twipla.com/image",
"data": 2
}
]
}
}

Get Ecom Top Customers V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
limit required	integer Example: limit=10 limit
start required	integer Example: start=6 Start of the results from query.
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"payload": [{"name": "John Doe",
"email": "john.doe@gmail.com",
"phoneNumber": "+1 123 456 7890",
"revenue": 198.12,
"products": 2,
"orders": 2,
"latestOrder": "2020-01-01T00:00:00Z"
}
]
}

Get Ecom Latest Orders V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

limit required	integer Example: limit=10 limit
start required	integer Example: start=6 Start of the results from query.
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"meta": {"page": 1,
"pageSize": 10,
"total": 30,
"pageTotal": 9
},
"payload": [{"id": "uuid",
"customerName": "John Doe",
"type": 1,
"trafficChannel": "Organic",
"trafficChannelSpecific": "Go",
"UTMCampaignKey": "utm_campaign",
"UTMSource": "utm_source",
"UTMMedium": "utm_medium",
"UTMTerm": "utm_term",
"UTMContent": "utm_content",
"UTMLabel": "utm_label",
"UTMSourcePlatform": "utm_source_platform",
"UTMCreativeFormat": "utm_creative_format",
"UTMMarketingTactic": "utm_marketing_tactic",
"orderDate": "2020-01-01T00:00:00Z",
"value": 198.12,
"productCount": 2
}
]
}

Get Ecom Customers V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

limit required	integer Example: limit=10 limit
start required	integer Example: start=6 Start of the results from query.
order required	string Permited values: name, grossRevenue, orderCount Example: name.asc, grossRevenue.desc Default is name.asc
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"payload": {"count": 1,
"countOrders": 1,
"grossRevenue": 100.12,
"payload": [{"id": "uuid",
"originalID": "uuid",
"name": "John Doe",
"email": "jd@gmail.com",
"phoneNumber": "123456789",
"grossRevenue": 100.12,
"orderCount": 1
}
]
}
}

Get Ecom Highest Revenue Products V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
limit required	integer Example: limit=10 limit
start required	integer Example: start=6 Start of the results from query.
itemName	string Example: "Product 1" Default is "Product 1"
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"payload": [{"id": "uuid",
"name": "Product 1"
}
],
"meta": {"page": 1,
"pageSize": 10,
"total": 30,
"pageTotal": 9
}
}

Get Ecom Revenue By Product V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
items	integer Example: items=10 items
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Request Body schema: application/json
required

	object
	Array of objects
	object
	object
	Array of objects
primaryDimension	string optional

Responses

Request samples

Payload

Content type

application/json

{"where": {"and": [{"member": "string",
"operator": "string",
"values": [{"type": "string",
"category": ["string"
]
}
]
}
]
},
"order": [{"member": "string",
"direction": "string",
"priority": 0
}
],
"timeframe": {"from": "2019-08-24T14:15:22Z",
"until": "2019-08-24T14:15:22Z"
},
"pagination": {"page": 0,
"pageSize": 0
},
"segments": [{"id": "string",
"conditions": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
}
}
],
"primaryDimension": "string"
}

Response samples

200
4XX
5xx

Content type

application/json

{"meta": {"page": 1,
"pageSize": 10,
"total": 30,
"pageTotal": 9
},
"payload": {"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12.1,
13.2
]
],
"total": 25.3,
"totalAverage": 12.6,
"itemId": "uuid-uuid-uuid-uuid"
}
]
}
}

Get Ecom Revenue By Product V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
items	integer Example: items=10 items
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"meta": {"page": 1,
"pageSize": 10,
"total": 30,
"pageTotal": 9
},
"payload": {"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12.1,
13.2
]
],
"total": 25.3,
"totalAverage": 12.6,
"itemId": "uuid-uuid-uuid-uuid"
}
]
}
}

Get Ecom Units Sold By Product V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
items	integer Example: items=10 items
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Request Body schema: application/json
required

	object
	Array of objects
	object
	object
	Array of objects
primaryDimension	string optional

Responses

Request samples

Payload

Content type

application/json

{"where": {"and": [{"member": "string",
"operator": "string",
"values": [{"type": "string",
"category": ["string"
]
}
]
}
]
},
"order": [{"member": "string",
"direction": "string",
"priority": 0
}
],
"timeframe": {"from": "2019-08-24T14:15:22Z",
"until": "2019-08-24T14:15:22Z"
},
"pagination": {"page": 0,
"pageSize": 0
},
"segments": [{"id": "string",
"conditions": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
}
}
],
"primaryDimension": "string"
}

Response samples

200
4XX
5xx

Content type

application/json

{"meta": {"page": 1,
"pageSize": 10,
"total": 30,
"pageTotal": 9
},
"payload": {"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12.1,
13.2
]
],
"total": 25.3,
"totalAverage": 12.6,
"itemId": "uuid-uuid-uuid-uuid"
}
]
}
}

Get Ecom Units Sold By Product V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
items	integer Example: items=10 items
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"meta": {"page": 1,
"pageSize": 10,
"total": 30,
"pageTotal": 9
},
"payload": {"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12.1,
13.2
]
],
"total": 25.3,
"totalAverage": 12.6,
"itemId": "uuid-uuid-uuid-uuid"
}
]
}
}

Get Ecom Viewed Products V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
limit required	integer Example: limit=10 limit
start required	integer Example: start=6 Start of the results from query.
order required	string Permited values: itemName, cntSold, sku, cateogry, price, numViews, addToWishlist, addToCart, removeFromCart Example: itemName.asc Default is cntSold.desc
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"payload": {"count": 2,
"items": [{"id": "uuid",
"name": "John Doe",
"imageURL": "https://example.com/image.jpg",
"category": "Category",
"soldItems": 2,
"countViews": 2,
"countAddToWishlist": 2,
"countAddToCart": 2,
"countRemoveFromCart": 2,
"price": 198.12
}
]
}
}

Get Ecom Viewed Products V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
limit required	integer Example: limit=10 limit
start required	integer Example: start=6 Start of the results from query.
order required	string Permited values: itemName, cntSold, sku, cateogry, price, numViews, addToWishlist, addToCart, removeFromCart Example: itemName.asc Default is cntSold.desc
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Request Body schema: application/json

	object
	Array of objects
	object
	object
	Array of objects
primaryDimension	string optional

Responses

Request samples

Payload

Content type

application/json

{"where": {"and": [{"member": "string",
"operator": "string",
"values": [{"type": "string",
"category": ["string"
]
}
]
}
]
},
"order": [{"member": "string",
"direction": "string",
"priority": 0
}
],
"timeframe": {"from": "2019-08-24T14:15:22Z",
"until": "2019-08-24T14:15:22Z"
},
"pagination": {"page": 0,
"pageSize": 0
},
"segments": [{"id": "string",
"conditions": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
}
}
],
"primaryDimension": "string"
}

Response samples

200
4XX
5xx

Content type

application/json

{"payload": {"count": 2,
"items": [{"id": "uuid",
"name": "John Doe",
"imageURL": "https://example.com/image.jpg",
"category": "Category",
"soldItems": 2,
"countViews": 2,
"countAddToWishlist": 2,
"countAddToCart": 2,
"countRemoveFromCart": 2,
"price": 198.12
}
]
}
}

Get Ecom Product List V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
limit	integer Example: limit=10 limit
start	integer Example: start=6 Start of the results from query.
order	string Permited values: itemName, numViews Example: itemName.asc Default is numViews.desc
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"payload": {"count": 1,
"payload": [{"viewCount": 2,
"name": "Product 1"
}
]
}
}

Get Ecom Product List V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
limit	integer Example: limit=10 limit
start	integer Example: start=6 Start of the results from query.
order	string Permited values: itemName, numViews Example: itemName.asc Default is numViews.desc
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Request Body schema: application/json

	object
	Array of objects
	object
	object
	Array of objects
primaryDimension	string optional

Responses

Request samples

Payload

Content type

application/json

{"where": {"and": [{"member": "string",
"operator": "string",
"values": [{"type": "string",
"category": ["string"
]
}
]
}
]
},
"order": [{"member": "string",
"direction": "string",
"priority": 0
}
],
"timeframe": {"from": "2019-08-24T14:15:22Z",
"until": "2019-08-24T14:15:22Z"
},
"pagination": {"page": 0,
"pageSize": 0
},
"segments": [{"id": "string",
"conditions": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
}
}
],
"primaryDimension": "string"
}

Response samples

200
4XX
5xx

Content type

application/json

{"payload": {"count": 1,
"payload": [{"viewCount": 2,
"name": "Product 1"
}
]
}
}

Get Ecom Checkout Initiated Graph V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Request Body schema: application/json
required

	object
	Array of objects
	object
	object
	Array of objects
primaryDimension	string optional

Responses

Request samples

Payload

Content type

application/json

{"where": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
},
"order": [{"member": "string",
"direction": "string",
"priority": 0
}
],
"timeframe": {"from": "2019-08-24T14:15:22Z",
"until": "2019-08-24T14:15:22Z"
},
"pagination": {"page": 0,
"pageSize": 0
},
"segments": [{"id": "string",
"conditions": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
}
}
],
"primaryDimension": "string"
}

Response samples

200
4XX
5xx

Content type

application/json

{"payload": {"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12,
13
]
]
}
]
}
}

Get Ecom Checkout Initiated Graph V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"payload": {"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12,
13
]
]
}
]
}
}

Get Ecom Cart Viewed Graph V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Request Body schema: application/json
required

	object
	Array of objects
	object
	object
	Array of objects
primaryDimension	string optional

Responses

Request samples

Payload

Content type

application/json

{"where": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
},
"order": [{"member": "string",
"direction": "string",
"priority": 0
}
],
"timeframe": {"from": "2019-08-24T14:15:22Z",
"until": "2019-08-24T14:15:22Z"
},
"pagination": {"page": 0,
"pageSize": 0
},
"segments": [{"id": "string",
"conditions": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
}
}
],
"primaryDimension": "string"
}

Response samples

200
4XX
5xx

Content type

application/json

{"payload": {"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12,
13
]
]
}
]
}
}

Get Ecom Cart Viewed Graph V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"payload": {"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12,
13
]
]
}
]
}
}

Get Ecom Traffic Structure Overview V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Request Body schema: application/json
required

	object
	Array of objects
	object
	object
	Array of objects
primaryDimension	string optional

Responses

Request samples

Payload

Content type

application/json

{"where": {"and": [{"member": "string",
"operator": "string",
"values": [{"type": "string",
"category": ["string"
]
}
]
}
]
},
"order": [{"member": "string",
"direction": "string",
"priority": 0
}
],
"timeframe": {"from": "2019-08-24T14:15:22Z",
"until": "2019-08-24T14:15:22Z"
},
"pagination": {"page": 0,
"pageSize": 0
},
"segments": [{"id": "string",
"conditions": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
}
}
],
"primaryDimension": "string"
}

Response samples

200
4XX
5xx

Content type

application/json

{"payload": {"from": "2019-08-24T14:15:22Z",
"until": "2019-08-24T14:15:22Z",
"points": [{"channelType": 0,
"values": [{"company": "string",
"value": 0
}
]
}
]
}
}

Get Ecom Traffic Structure Overview V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"payload": {"from": "2019-08-24T14:15:22Z",
"until": "2019-08-24T14:15:22Z",
"points": [{"channelType": 0,
"values": [{"company": "string",
"value": 0
}
]
}
]
}
}

Get Ecom Traffic Structure In Depth V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Request Body schema: application/json
required

	object
	Array of objects
	object
	object
	Array of objects
primaryDimension	string optional

Responses

Request samples

Payload

Content type

application/json

{"where": {"and": [{"member": "string",
"operator": "string",
"values": [{"type": "string",
"category": ["string"
]
}
]
}
]
},
"order": [{"member": "string",
"direction": "string",
"priority": 0
}
],
"timeframe": {"from": "2019-08-24T14:15:22Z",
"until": "2019-08-24T14:15:22Z"
},
"pagination": {"page": 0,
"pageSize": 0
},
"segments": [{"id": "string",
"conditions": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
}
}
],
"primaryDimension": "string"
}

Response samples

200
4XX
5xx

Content type

application/json

{"meta": {"page": 1,
"pageSize": 10,
"total": 30,
"pageTotal": 9
},
"payload": {"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12,
13
]
]
}
]
}
}

Get Ecom Traffic Structure In Depth V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"meta": {"page": 1,
"pageSize": 10,
"total": 30,
"pageTotal": 9
},
"payload": {"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12,
13
]
]
}
]
}
}

Get Ecom Abandoned Cart V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
limit required	integer Example: limit=10 limit
start required	integer Example: start=6 Start of the results from query.
order	string Permited values: name, customerId, phoneNumber, cartValue, abandonment, numProducts Example: name.desc Default is abandonment.desc
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"count": 1,
"payload": [{"customerName": "John Doe",
"customerEmail": "johndoe@mail.com",
"customerPhoneNumber": "+1 123 456 7890",
"customerId": "1234567890",
"cartValue": 123.45,
"abandonment": 0,
"dateTimeAbandonment": "2020-01-01T00:00:00Z",
"products": [{"name": "Product name",
"imageUrl": "https://example.com/image.jpg",
"quantity": 12.11
}
]
}
]
}

Get Ecom Abandoned Cart V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
limit required	integer Example: limit=10 limit
start required	integer Example: start=6 Start of the results from query.
order	string Permited values: name, customerId, phoneNumber, cartValue, abandonment, numProducts Example: name.desc Default is abandonment.desc
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Request Body schema: application/json
required

	object
	Array of objects
	object
	object
	Array of objects
primaryDimension	string optional

Responses

Request samples

Payload

Content type

application/json

{"where": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
},
"order": [{"member": "string",
"direction": "string",
"priority": 0
}
],
"timeframe": {"from": "2019-08-24T14:15:22Z",
"until": "2019-08-24T14:15:22Z"
},
"pagination": {"page": 0,
"pageSize": 0
},
"segments": [{"id": "string",
"conditions": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
}
}
],
"primaryDimension": "string"
}

Response samples

200
4XX
5xx

Content type

application/json

{"count": 1,
"payload": [{"customerName": "John Doe",
"customerEmail": "johndoe@mail.com",
"customerPhoneNumber": "+1 123 456 7890",
"customerId": "1234567890",
"cartValue": 123.45,
"abandonment": 0,
"dateTimeAbandonment": "2020-01-01T00:00:00Z",
"products": [{"name": "Product name",
"imageUrl": "https://example.com/image.jpg",
"quantity": 12.11
}
]
}
]
}

Ecom events funnel params

Authentication is needed. For that, the request should have authorization header Authorization:Bearer token-string-value. Also logged in user can see only his own website data (otherwise 403 status code will be received).

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

view required	string Enum: "item" "type" Example: view=item Must be either "item" or "type".
page	integer Example: page=1 Page to be requested
pageSize	integer Example: pageSize=20 Number of items per page to be requested
search	string Example: search=button Text to search for. Returns most similar results based on ngram score.

Responses

Response samples

200
4xx
5xx

Content type

application/json

{"data": [{"itemId": "prod_01HJ121FHEVZD39MNasdasd2adasJ8VSN",
"itemName": "Camera lens"
},
{"itemId": "prod_01HNJH8JMGH6WX7950VRGR7WSJ",
"itemName": "Medusa Shorts 234234234"
},
{"itemId": "prod_01HNJHBS14PQAVTTQF8NTSFAX3",
"itemName": "dualshock4"
}
],
"page": 1,
"pageSize": 10
}

Graphs

Some resources support retrieving data in graph form. There are several types of graphs available: time-series, pie or bar. They all have the same response body:

{
  "payload": {
    "labels": ["2021-09-27T00:00:00.000Z", "2021-09-28T00:00:00.000Z"],
    "datasets": [
      {
        "label": "Dataset 1",
        "data": [20, 30]
      }
    ]
  }
}

Examples

/v2/traffic-structure/graph?type=time-series&unit=week

/v2/traffic-structure/graph?type=pie

/v2/traffic-structure/graph?type=bar

Most graph endpoints support Time-Filtering. Most time series endpoints also support Time Units for time bucketing.

Time Units

Time series graph data is aggregated into time buckets using time units. These can be: day, week, month and year. The response contains a list of points each representing the given time unit.

unit string

Possible values: day, week, month, year

Default: Based on the given time period (Ex: for a year default will be month).

Visits graph data V2

Get visits information as graph data

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
type required	string Value: "time-series" Example: type=time-series
unit required	string Enum: "day" "week" "month" "year" Example: unit=day

Responses

Response samples

200
401

Content type

application/json

{"payload": {"datasets": [{"label": "Overall Page Visits",
"data": [32,
50,
80
]
}
],
"labels": ["2022-06-22T15:46:47Z"
]
}
}

Visits graph filtered data V2

Get filtered visits information as graph data

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
type required	string Value: "time-series" Example: type=time-series
unit required	string Enum: "day" "week" "month" "year" Example: unit=day

Request Body schema: application/json
required

	object
	Array of objects
	object
	object
	Array of objects
primaryDimension	string optional

Responses

Request samples

Payload

Content type

application/json

{"where": {"and": [{"member": "string",
"operator": "string",
"values": [{"type": "string",
"category": ["string"
]
}
]
}
]
},
"order": [{"member": "string",
"direction": "string",
"priority": 0
}
],
"timeframe": {"from": "2019-08-24T14:15:22Z",
"until": "2019-08-24T14:15:22Z"
},
"pagination": {"page": 0,
"pageSize": 0
},
"segments": [{"id": "string",
"conditions": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
}
}
],
"primaryDimension": "string"
}

Response samples

200
401

Content type

application/json

{"payload": {"datasets": [{"label": "Overall Page Visits",
"data": [32,
50,
80
]
}
],
"labels": ["2022-06-22T15:46:47Z"
]
}
}

Converting visitors graph

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
type required	string Enum: "time-series" "pie" "bar" Example: type=time-series
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Request Body schema: application/json
required

	object
	Array of objects
	object
	object
	Array of objects
primaryDimension	string optional

Responses

Request samples

Payload

Content type

application/json

{"where": {"and": [{"member": "string",
"operator": "string",
"values": [{"type": "string",
"category": ["string"
]
}
]
}
]
},
"order": [{"member": "string",
"direction": "string",
"priority": 0
}
],
"timeframe": {"from": "2019-08-24T14:15:22Z",
"until": "2019-08-24T14:15:22Z"
},
"pagination": {"page": 0,
"pageSize": 0
},
"segments": [{"id": "string",
"conditions": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
}
}
],
"primaryDimension": "string"
}

Response samples

200
4XX
5xx

Content type

application/json

{"payload": {"labels": ["string"
],
"datasets": [{"label": "string",
"data": [0
]
}
]
}
}

Sessions graph data V2 Deprecated

Deprecated: Use /v2/websites/{websiteId}/analytics/sessions instead.

Get sessions information as graph data

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
type required	string Enum: "time-series" "pie" "bar" Example: type=time-series
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Request Body schema: application/json
required

	object
	Array of objects
	object
	object
	Array of objects
primaryDimension	string optional

Responses

Request samples

Payload

Content type

application/json

{"where": {"and": [{"member": "string",
"operator": "string",
"values": [{"type": "string",
"category": ["string"
]
}
]
}
]
},
"order": [{"member": "string",
"direction": "string",
"priority": 0
}
],
"timeframe": {"from": "2019-08-24T14:15:22Z",
"until": "2019-08-24T14:15:22Z"
},
"pagination": {"page": 0,
"pageSize": 0
},
"segments": [{"id": "string",
"conditions": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
}
}
],
"primaryDimension": "string"
}

Response samples

200
4XX
5xx

Content type

application/json

{"payload": {"labels": ["string"
],
"datasets": [{"label": "string",
"data": [0
]
}
]
}
}

Recordings

Recordings operations

Get session recordings data V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-08-09T23%3A59%3A59.999%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter.
start	integer Example: start=6 Start of the results from query.
length	integer Length of the results from query.
order	string Enum: "desc" "asc" Orders the results from query ascending or descending.
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Request Body schema: application/json
required

starred	string
watched	string
note	string
from	number <int64>
until	number <int64>
	object
	object
	object
	object
status	Array of integers
containsPage	string
notContainsPage	string
	object
	object
entryPage	string
exitPage	string
	object
referrerURLs	Array of strings
trafficChannels	Array of strings
adCampaignLabels	Array of strings
	object
recordingId	string
alarmingEvents	Array of strings (Alarming Events) Items Enum: "deadClicks" "rageClicks" "mouseMoves" "scrolls" "uTurns" "reloads"

Responses

Request samples

Payload

Content type

application/json

{"starred": "string",
"watched": "string",
"note": "string",
"from": 0,
"until": 0,
"country": {"is": ["string"
],
"isNot": ["string"
]
},
"os": {"is": ["string"
],
"isNot": ["string"
]
},
"browser": {"is": ["string"
],
"isNot": ["string"
]
},
"devices": {"is": ["string"
],
"isNot": ["string"
]
},
"status": [0
],
"containsPage": "string",
"notContainsPage": "string",
"durations": {"min": 0,
"max": 0
},
"pageCount": {"min": 0,
"max": 0
},
"entryPage": "string",
"exitPage": "string",
"funnelDropouts": {"id": "string",
"level": 0
},
"referrerURLs": ["string"
],
"trafficChannels": ["string"
],
"adCampaignLabels": ["string"
],
"tags": {"property1": "string",
"property2": "string"
},
"recordingId": "string",
"alarmingEvents": ["deadClicks"
]
}

Response samples

200
4XX
5xx

Content type

application/json

{"sessionsTotal": 0,
"data": [{"id": "string",
"status": 0,
"countryCode": "string",
"sessionStart": 0,
"referrer": "string",
"platform": "string",
"device": "string",
"browser": "string",
"screenSize": "string",
"location": {"lat": 0,
"lng": 0
},
"visitorId": "string",
"entryPage": "https://twipla.com/home",
"exitPage": "https://twipla.com/register",
"ssrStatus": 0,
"ssrInfo": {"pagesCount": 0,
"duration": 0,
"pages": [{"url": "string",
"duration": 0,
"timestamp": 0,
"type": 0
}
]
},
"sessionExtras": {"id": "string",
"seen": true,
"star": true,
"tags": ["string"
]
},
"comment": "string",
"tags": {"property1": "string",
"property2": "string"
},
"events": {"events": 0,
"moveInteractions": 0,
"scrollInteractions": 0,
"clickInteractions": 0,
"incSnapshots": 0
},
"alarmingEvents": {"deadClicks": 0,
"rageClicks": 0,
"mouseMoves": 0,
"scrolls": 0,
"uTurns": 0,
"reloads": 0
}
}
]
}

Delete recordings by sessionIds

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

timezone

string

Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Request Body schema: application/json
required

sessionIds

Array of strings

Responses

Request samples

Payload

Content type

application/json

{"sessionIds": ["string"
]
}

Response samples

4XX
5xx

Content type

application/json

{"error": {"code": "server_error",
"message": "this is error response",
"details": { }
}
}

Delete recordings

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

timezone

string

Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Request Body schema: application/json
required

starred	string
watched	string
from	number <int64>
until	number <int64>
	object
	object
	object
devices	Array of strings
status	Array of integers
containsPage	string
notContainsPage	string
	object
	object
entryPage	string
exitPage	string
	object
referrerURLs	Array of strings
trafficChannels	Array of strings
adCampaignLabels	Array of strings

Responses

Request samples

Payload

Content type

application/json

{"starred": "string",
"watched": "string",
"from": 0,
"until": 0,
"country": {"is": "string",
"isNot": "string"
},
"os": {"is": "string",
"isNot": "string"
},
"browser": {"is": "string",
"isNot": "string"
},
"devices": ["string"
],
"status": [0
],
"containsPage": "string",
"notContainsPage": "string",
"durations": {"min": 0,
"max": 0
},
"pageCount": {"min": 0,
"max": 0
},
"entryPage": "string",
"exitPage": "string",
"funnelDropouts": {"id": "string",
"level": 0
},
"referrerURLs": ["string"
],
"trafficChannels": ["string"
],
"adCampaignLabels": ["string"
]
}

Response samples

200
4XX
5xx

Content type

application/json

{"sessionsTotal": 0,
"data": [{"id": "string",
"status": 0,
"countryCode": "string",
"sessionStart": 0,
"referrer": "string",
"platform": "string",
"device": "string",
"browser": "string",
"screenSize": "string",
"location": {"lat": 0,
"lng": 0
},
"visitorId": "string",
"entryPage": "string",
"exitPage": "string",
"ssrStatus": 0,
"ssrInfo": {"pagesCount": 0,
"duration": 0,
"pages": [{"url": "string",
"duration": 0,
"timestamp": 0,
"type": 0
}
]
},
"sessionExtras": {"id": "string",
"seen": true,
"star": true,
"tags": ["string"
]
},
"comment": "string"
}
]
}

Get average duration

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

timezone

string

Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"payload": {"average-duration": 0
}
}

Get alarming events for recording

Authorizations:

bearerAuth

path Parameters

websiteId required	string <uuid> (uuid) Example: 06d99a32-ee11-11eb-830a-0146de130018 ID of a website
sessionId required	string <uuid> (uuid) Example: 06d99a32-ee11-11eb-830a-0146de130018 ID of a session

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"payload": [{"page": "https://twipla.com",
"trigger": "deadClicks",
"triggerValue": 10,
"start": 1664345317,
"end": 1664345317
}
],
"meta": {"total": 30
}
}

Get recordings

Get the recordings of a session

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

Responses

Response samples

200
4xx
5xx

Content type

application/json

[{"id": "507f1f77bcf86cd799439011",
"sessionId": "507f1f77bcf86cd799439011",
"page": "https://example.com",
"duration": 616188,
"wsSessionId": null,
"status": "NONE",
"createdAt": "2025-06-04T09:53:18.993Z",
"scopes": ["R",
"H"
],
"compression": "COMPRESSED",
"metadata": {"events": 421,
"clickInteractions": 3,
"moveInteractions": 2,
"scrollInteractions": 0,
"incSnapshots": 419
}
}
]

Get recordings events

Get the events of a recording

Authorizations:

bearerAuth

path Parameters

websiteId required	string <uuid> (uuid) Example: 06d99a32-ee11-11eb-830a-0146de130018 ID of a website
recordingId required	string (objectId) ^[a-f\d]{24}$ Example: 507f1f77bcf86cd799439011 ObjectId of a recording

Responses

Response samples

200
4xx
5xx

Content type

application/json

[{"id": null,
"recordingId": null,
"data": "{\"positions\":[{\"ex\":82.0,\"ey\":3.0,\"id\":48.0,\"timeOffset\":0.0,\"x\":1762.0,\"y\":11.0}],\"source\":1.0}",
"timestamp": 1749029783479,
"type": 3
}
]

Devices

Operations about website devices

Device Types

Authentication is needed. For that, the request should have authorization header Authorization:Bearer token-string-value. Also logged in user can see only his own website data (otherwise 403 status code will be received).

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter (default = until - 7 days)
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter (default = today's date)
page	integer Example: page=1 Page to be requested
pageSize	integer Example: pageSize=20 Number of items per page to be requested

Responses

Response samples

200
4xx
5xx

Content type

application/json

{"payload": [["desktop",
27244,
0.16617520909285868
]
],
"meta": {"page": 1,
"pageSize": 10,
"total": 30,
"pageTotal": 9
}
}

Browsers

Authentication is needed. For that, the request should have authorization header Authorization:Bearer token-string-value. Also logged in user can see only his own website data (otherwise 403 status code will be received).

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter (default = until - 7 days)
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter (default = today's date)
page	integer Example: page=1 Page to be requested
pageSize	integer Example: pageSize=20 Number of items per page to be requested

Responses

Response samples

200
4xx
5xx

Content type

application/json

{"payload": [["chrome",
7244,
0.16617520909285868
]
],
"meta": {"page": 1,
"pageSize": 10,
"total": 30,
"pageTotal": 9
}
}

Operating Systems

Authentication is needed. For that, the request should have authorization header Authorization:Bearer token-string-value. Also logged in user can see only his own website data (otherwise 403 status code will be received).

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter (default = until - 7 days)
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter (default = today's date)
page	integer Example: page=1 Page to be requested
pageSize	integer Example: pageSize=20 Number of items per page to be requested

Responses

Response samples

200
4xx
5xx

Content type

application/json

{"payload": [["iOS",
21969,
0.16617520909285868
]
],
"meta": {"page": 1,
"pageSize": 10,
"total": 30,
"pageTotal": 9
}
}

Screen Sizes

Authentication is needed. For that, the request should have authorization header Authorization:Bearer token-string-value. Also logged in user can see only his own website data (otherwise 403 status code will be received).

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter (default = until - 7 days)
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter (default = today's date)
page	integer Example: page=1 Page to be requested
pageSize	integer Example: pageSize=20 Number of items per page to be requested

Responses

Response samples

200
4xx
5xx

Content type

application/json

{"payload": [["864x640",
19431,
0.16617520909285868
]
],
"meta": {"page": 1,
"pageSize": 10,
"total": 30,
"pageTotal": 9
}
}

Funnels

Funnels operations

(DEPRECATED) Get Funnel list by Website Key

(DEPRECATED) Authentication is needed. For that, the request should have authorization header Authorization:Bearer token-string-value. Also logged in user can see only his own website data (otherwise 403 status code will be received).

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter (default = until - 7 days)
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter (default = today's date)
previousFrom required	string <date-time> (urlEncodedISO8601) Example: previousFrom=2024-06-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter; optional
previousUntil required	string <date-time> (urlEncodedISO8601) Example: previousUntil=2024-07-10T23%3A59%3A59.000%2B02%3A00 Upper bound date filter; optional
status	number Enum: 0 1 2 0 = pending or draft status, 1 = active status, 2 = limit reached status
search	string Example: search=string Regex for funnel name
order required	string Enum: "desc" "asc" Example: order=count.asc\|desc (only count ordering option) TO BE IMPLEMENTED

Responses

Response samples

200
4xx
5xx

Content type

application/json

{"payload": [{"key": "id-string",
"name": "Test funnel",
"visitorLimit": 10000,
"visitorCount": 0,
"visitorCountInTimeRange": 2700,
"visitorCountInPreviousTimeRange": 0,
"createdAt": 1584451370,
"createdBy": "id-string",
"levels": [{"url": "www.test1.com",
"name": "step 1",
"type": 0,
"match": 1
},
{"url": "www.test2.com",
"name": "step 2",
"type": 0,
"match": 1
},
{"url": "www.test3.com",
"name": "step 3",
"type": 0,
"match": 1
}
],
"status": 0,
"expectedConversionRate": 50,
"conversionRate": 37.04,
"previousConversionRate": 0,
"currentConversion": 1000,
"previousConversion": 0
}
]
}

Funnels average conversion rate

Authentication is needed. For that, the request should have authorization header Authorization:Bearer token-string-value. Also logged in user can see only his own website data (otherwise 403 status code will be received).

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

Responses

Response samples

200
4xx
5xx

Content type

application/json

{"payload": [{"average-conversion-rate": "int"
}
]
}

Funnels highest conversion rate

Authentication is needed. For that, the request should have authorization header Authorization:Bearer token-string-value. Also logged in user can see only his own website data (otherwise 403 status code will be received).

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

Responses

Response samples

200
4xx
5xx

Content type

application/json

{"payload": [{"highest-conversion-rate": "int"
}
]
}

Get Funnel list by Website Key

Authentication is needed. For that, the request should have authorization header Authorization:Bearer token-string-value. Also logged in user can see only his own website data (otherwise 403 status code will be received).

Authorizations:

bearerAuth

path Parameters

websiteId required	string <uuid> (uuid) Example: 06d99a32-ee11-11eb-830a-0146de130018 ID of a website
funnelId required	string Funnel ID

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter (default = until - 7 days)
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter (default = today's date)
previousFrom required	string <date-time> (urlEncodedISO8601) Example: previousFrom=2024-06-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter; optional
previousUntil required	string <date-time> (urlEncodedISO8601) Example: previousUntil=2024-07-10T23%3A59%3A59.000%2B02%3A00 Upper bound date filter; optional
status	string Enum: "draft" "published" 0 = pending or draft status, 1 = active status, 2 = limit reached status

Request Body schema: application/json
optional

object

Responses

Request samples

Payload

Content type

application/json

{"where": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
}
}

Response samples

200
4xx
5xx

Content type

application/json

{"payload": [{"id": "funnel-123456",
"name": "Homepage to External Link Funnel",
"createdAt": 1628097600000,
"updatedAt": 1694822400000,
"createdBy": "user-abc123",
"levels": [{"kind": "page",
"name": "Homepage",
"data": {"websitePage": {"type": "static",
"url": "https://example.com/"
},
"urlPattern": null,
"customEvent": null,
"autoEvent": null,
"outgoingTraffic": null,
"ecomEvent": null,
"alarmingEvent": null
}
},
{"kind": "outgoing_traffic",
"name": "Click to Partner Site",
"data": {"websitePage": null,
"urlPattern": null,
"customEvent": null,
"autoEvent": null,
"outgoingTraffic": {"url": "https://partner-site.com"
},
"ecomEvent": null,
"alarmingEvent": null
}
}
],
"status": "published",
"expectedConversionRate": 25,
"visitorCountInTimeRange": 5000,
"visitorCountInPreviousTimeRange": 4500,
"conversionRate": 18.6,
"previousConversionRate": 16.2,
"currentConversion": 930,
"previousConversion": 729,
"levelsConversionData": [{"totalVisitors": 5000,
"dropoutsVisitors": 1200,
"conversionRate": 76,
"dropoutsRate": 24
},
{"totalVisitors": 3800,
"dropoutsVisitors": 2870,
"conversionRate": 24.5,
"dropoutsRate": 75.5
}
]
},
{"id": "funnel-789012",
"name": "Signup Funnel",
"createdAt": 1628184000000,
"updatedAt": 1694908800000,
"createdBy": "user-abc123",
"levels": [{"kind": "website_page",
"name": "Landing Page",
"data": {"websitePage": {"type": "equals",
"url": "https://example.com/landing"
},
"urlPattern": null,
"customEvent": null,
"autoEvent": null,
"outgoingTraffic": null,
"ecomEvent": null,
"alarmingEvent": null
}
},
{"kind": "website_page",
"name": "Signup Page",
"data": {"websitePage": {"type": "static",
"url": "https://example.com/signup"
},
"urlPattern": null,
"customEvent": null,
"autoEvent": null,
"outgoingTraffic": null,
"ecomEvent": null,
"alarmingEvent": null
}
}
],
"status": "published",
"expectedConversionRate": 30,
"visitorCountInTimeRange": 3500,
"visitorCountInPreviousTimeRange": 3200,
"conversionRate": 22.8,
"previousConversionRate": 20.1,
"currentConversion": 798,
"previousConversion": 643,
"levelsConversionData": [{"totalVisitors": 3500,
"dropoutsVisitors": 700,
"conversionRate": 80,
"dropoutsRate": 20
},
{"totalVisitors": 2800,
"dropoutsVisitors": 2002,
"conversionRate": 28.5,
"dropoutsRate": 71.5
}
]
}
]
}

Get Funnel by ID

Authentication is needed. For that, the request should have authorization header Authorization:Bearer token-string-value. Also logged in user can see only his own website data (otherwise 403 status code will be received).

Authorizations:

bearerAuth

path Parameters

websiteId required	string <uuid> (uuid) Example: 06d99a32-ee11-11eb-830a-0146de130018 ID of a website
funnelId required	string Funnel ID

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter (default = until - 7 days)
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter (default = today's date)
previousFrom required	string <date-time> (urlEncodedISO8601) Example: previousFrom=2024-06-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter; optional
previousUntil required	string <date-time> (urlEncodedISO8601) Example: previousUntil=2024-07-10T23%3A59%3A59.000%2B02%3A00 Upper bound date filter; optional

Request Body schema: application/json
optional

object

Responses

Request samples

Payload

Content type

application/json

{"where": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
}
}

Response samples

200
4xx
5xx

Content type

application/json

{"payload": {"FunnelWithOutgoingTrafficAndPageURL": {"value": {"payload": {"id": "funnel-123456",
"name": "Homepage to External Link Funnel",
"createdAt": 1628097600000,
"updatedAt": 1694822400000,
"createdBy": "user-abc123",
"levels": [{"kind": "website_page",
"name": "Homepage",
"data": {"websitePage": {"type": "static",
"url": "https://example.com/"
},
"urlPattern": null,
"customEvent": null,
"autoEvent": null,
"outgoingTraffic": null,
"ecomEvent": null,
"alarmingEvent": null
}
},
{"kind": "outgoing_traffic",
"name": "Click to Partner Site",
"data": {"websitePage": null,
"urlPattern": null,
"customEvent": null,
"autoEvent": null,
"outgoingTraffic": {"url": "https://partner-site.com"
},
"ecomEvent": null,
"alarmingEvent": null
}
}
],
"status": "published",
"expectedConversionRate": 25,
"visitorCountInTimeRange": 5000,
"visitorCountInPreviousTimeRange": 4500,
"conversionRate": 18.6,
"previousConversionRate": 16.2,
"currentConversion": 930,
"previousConversion": 729,
"levelsConversionData": [{"totalVisitors": 5000,
"dropoutsVisitors": 1200,
"conversionRate": 76,
"dropoutsRate": 24
},
{"totalVisitors": 3800,
"dropoutsVisitors": 2870,
"conversionRate": 24.5,
"dropoutsRate": 75.5
}
]
}
}
}
}
}

Custom events funnel params

Authentication is needed. For that, the request should have authorization header Authorization:Bearer token-string-value. Also logged in user can see only his own website data (otherwise 403 status code will be received).

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

view required	string Enum: "label" "category" "action" "value" Example: view=label Must be either "label" or "category" or "action" or "value".
page	integer Example: page=1 Page to be requested
pageSize	integer Example: pageSize=20 Number of items per page to be requested
search	string Example: search=button Text to search for. Returns most similar results based on ngram score.
type	string Enum: "custom" "auto" Example: type=auto Type of custom event, can be custom or auto.

Responses

Response samples

200
4xx
5xx

Content type

application/json

{"data": ["button",
"Test which listeners are are active on the button",
"Create new button ",
"Dead Click Button",
"radiobutton",
"new button"
],
"page": 1,
"pageSize": 10
}

Ecom events funnel params

Authentication is needed. For that, the request should have authorization header Authorization:Bearer token-string-value. Also logged in user can see only his own website data (otherwise 403 status code will be received).

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

view required	string Enum: "item" "type" Example: view=item Must be either "item" or "type".
page	integer Example: page=1 Page to be requested
pageSize	integer Example: pageSize=20 Number of items per page to be requested
search	string Example: search=button Text to search for. Returns most similar results based on ngram score.

Responses

Response samples

200
4xx
5xx

Content type

application/json

{"data": [{"itemId": "prod_01HJ121FHEVZD39MNasdasd2adasJ8VSN",
"itemName": "Camera lens"
},
{"itemId": "prod_01HNJH8JMGH6WX7950VRGR7WSJ",
"itemName": "Medusa Shorts 234234234"
},
{"itemId": "prod_01HNJHBS14PQAVTTQF8NTSFAX3",
"itemName": "dualshock4"
}
],
"page": 1,
"pageSize": 10
}

Create funnel V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

Request Body schema: application/json
required

createdBy	string or null
expectedConversionRate	integer or null <int32> [ 0 .. 100 ]
required	Array of objects or null (FunnelLevelItem)
name required	string
status required	string Enum: "published" "draft"

Responses

Request samples

Payload

Content type

application/json

{"createdBy": "string",
"expectedConversionRate": 100,
"levels": [{"data": {"alarmingEvent": {"type": ["string"
]
},
"autoEvent": {"action": "string",
"category": "string",
"label": "string",
"triggerURLs": ["string"
],
"value": "string"
},
"customEvent": {"action": "string",
"bindingBrowserAction": "string",
"category": "string",
"fieldsObject": "string",
"label": "string",
"triggerURLs": ["string"
],
"value": "string"
},
"ecomEvent": {"itemIDs": ["string"
],
"triggerURLs": ["string"
],
"type": ["string"
]
},
"outgoingTraffic": {"url": "string"
},
"urlPattern": {"match": "simple",
"url": "string"
},
"websitePage": {"type": "static",
"url": "string"
}
},
"kind": "website_page",
"name": "string"
}
],
"name": "string",
"status": "published"
}

Response samples

200
400
409
422
500

Content type

application/json

{"meta": {"page": 0,
"pageSize": 0,
"pageTotal": 0,
"total": 0
},
"payload": {"createdAt": "2019-08-24T14:15:22Z",
"createdBy": "string",
"expectedConversionRate": 0,
"id": "string",
"levels": [{"data": {"alarmingEvent": {"type": ["string"
]
},
"autoEvent": {"action": "string",
"category": "string",
"label": "string",
"triggerURLs": ["string"
],
"value": "string"
},
"customEvent": {"action": "string",
"bindingBrowserAction": "string",
"category": "string",
"fieldsObject": "string",
"label": "string",
"triggerURLs": ["string"
],
"value": "string"
},
"ecomEvent": {"itemIDs": ["string"
],
"triggerURLs": ["string"
],
"type": ["string"
]
},
"outgoingTraffic": {"url": "string"
},
"urlPattern": {"match": "simple",
"url": "string"
},
"websitePage": {"type": "static",
"url": "string"
}
},
"kind": "string",
"name": "string"
}
],
"name": "string",
"status": "string",
"updatedAt": "2019-08-24T14:15:22Z",
"websiteKey": "string"
}
}

Update funnel V2

Authorizations:

bearerAuth

path Parameters

websiteId required	string <uuid> (uuid) Example: 06d99a32-ee11-11eb-830a-0146de130018 ID of a website
funnelId required	string

Request Body schema: application/json
required

expectedConversionRate	integer or null <int32> [ 0 .. 100 ]
name	string or null
status	string or null Enum: "published" "draft"

Responses

Request samples

Payload

Content type

application/json

{"expectedConversionRate": 100,
"name": "string",
"status": "published"
}

Response samples

200
404
422
500

Content type

application/json

{"meta": {"page": 0,
"pageSize": 0,
"pageTotal": 0,
"total": 0
},
"payload": {"createdAt": "2019-08-24T14:15:22Z",
"createdBy": "string",
"expectedConversionRate": 0,
"id": "string",
"levels": [{"data": {"alarmingEvent": {"type": ["string"
]
},
"autoEvent": {"action": "string",
"category": "string",
"label": "string",
"triggerURLs": ["string"
],
"value": "string"
},
"customEvent": {"action": "string",
"bindingBrowserAction": "string",
"category": "string",
"fieldsObject": "string",
"label": "string",
"triggerURLs": ["string"
],
"value": "string"
},
"ecomEvent": {"itemIDs": ["string"
],
"triggerURLs": ["string"
],
"type": ["string"
]
},
"outgoingTraffic": {"url": "string"
},
"urlPattern": {"match": "simple",
"url": "string"
},
"websitePage": {"type": "static",
"url": "string"
}
},
"kind": "string",
"name": "string"
}
],
"name": "string",
"status": "string",
"updatedAt": "2019-08-24T14:15:22Z",
"websiteKey": "string"
}
}

Delete funnel V2

Authorizations:

bearerAuth

path Parameters

websiteKey required	string
funnelId required	string

Responses

Response samples

404
422
500

Content type

application/problem+json

{"$schema": "https://example.com/schemas/ErrorModel.json",
"detail": "Property foo is required but is missing.",
"errors": [{"location": "string",
"message": "string",
"value": null
}
],
"instance": "https://example.com/error-log/abc123",
"status": 400,
"title": "Bad Request",
"type": "https://example.com/errors/example"
}

Conversion Events

Conversion Events operations

Get the breakdown overview by conversion event

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
previousFrom required	string <date-time> (urlEncodedISO8601) Example: previousFrom=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
previousUntil required	string <date-time> (urlEncodedISO8601) Example: previousUntil=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter

Request Body schema: application/json

object

Responses

Request samples

Payload

Content type

application/json

{"where": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
}
}

Response samples

200
4xx
5xx

Content type

application/json

{"data": [{"websiteKey": "string",
"value": {"conversionEventId": "146222fb-0c3a-416e-a3c5-8724e3e4514a",
"name": "string",
"kind": "string",
"createdAt": 0,
"note": "string"
},
"current": {"convertedSessions": 0,
"conversions": 0,
"conversionValue": 0,
"conversionRate": 0
},
"previous": {"convertedSessions": 0,
"conversions": 0,
"conversionValue": 0,
"conversionRate": 0
}
}
],
"metadata": {"type": null,
"property1": "string",
"property2": "string"
}
}

Get the conversion event breakdown by property

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
previousFrom required	string <date-time> (urlEncodedISO8601) Example: previousFrom=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
previousUntil required	string <date-time> (urlEncodedISO8601) Example: previousUntil=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter

Request Body schema: application/json

object

Responses

Request samples

Payload

Content type

application/json

{"where": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
}
}

Response samples

200
4xx
5xx

Content type

application/json

{"data": [{"websiteKey": "string",
"value": "string",
"current": {"convertedSessions": 0,
"conversions": 0,
"conversionValue": 0,
"conversionRate": 0
},
"previous": {"convertedSessions": 0,
"conversions": 0,
"conversionValue": 0,
"conversionRate": 0
}
}
],
"metadata": {"type": null,
"property1": "string",
"property2": "string"
}
}

Get graph of statistics referring to conversion events

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
type required	string Enum: "time-series" "pie" "bar" Example: type=time-series

Request Body schema: application/json

object

Responses

Request samples

Payload

Content type

application/json

{"where": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
}
}

Response samples

200
4XX
5xx

Content type

application/json

{"payload": {"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12.1,
13.2
]
]
}
]
},
"meta": {"page": 1,
"pageSize": 10,
"total": 30,
"pageTotal": 9
}
}

Get the valid authors of conversion events

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

Responses

Response samples

200
4xx
5xx

Content type

application/json

[{"payload": ["string"
]
}
]

Create conversion event

Authorizations:

bearerAuth

path Parameters

websiteKey

required

string

Request Body schema: application/json
required

conversionValue	number or null <float>
dailyConversionGoal	integer or null <int32>
required	object (ConversionData)
kind required	string Enum: "alarming_event" "website_page" "url_pattern" "ecom_event" "auto_event" "custom_event" "outgoing_traffic" "funnel"
name required	string
note	string or null

Responses

Request samples

Payload

Content type

application/json

{"conversionValue": 0,
"dailyConversionGoal": 0,
"data": {"alarmingEvent": {"type": ["string"
]
},
"autoEvent": {"action": "string",
"category": "string",
"label": "string",
"triggerURLs": ["string"
],
"value": "string"
},
"customEvent": {"action": "string",
"bindingBrowserAction": "string",
"category": "string",
"fieldsObject": "string",
"label": "string",
"triggerURLs": ["string"
],
"value": "string"
},
"ecomEvent": {"ecom_item_filter": {"and": [{"member": "string",
"operator": "string",
"values": [null
]
}
]
},
"itemIDs": ["string"
],
"triggerURLs": ["string"
],
"type": ["string"
]
},
"funnel": {"funnelId": "string"
},
"outgoingTraffic": {"url": "string"
},
"urlPattern": {"match": "simple",
"url": "string"
},
"websitePage": {"type": "static",
"url": "string"
}
},
"kind": "alarming_event",
"name": "string",
"note": "string"
}

Response samples

200
400
409
422
500

Content type

application/json

{"$schema": "https://example.com/schemas/ResponseConversionEvent.json",
"meta": {"page": 0,
"pageSize": 0,
"pageTotal": 0,
"total": 0
},
"payload": {"conversionValue": 0,
"createdAt": "2019-08-24T14:15:22Z",
"createdBy": "string",
"dailyConversionGoal": 0,
"data": {"alarmingEvent": {"type": ["string"
]
},
"autoEvent": {"action": "string",
"category": "string",
"label": "string",
"triggerURLs": ["string"
],
"value": "string"
},
"customEvent": {"action": "string",
"bindingBrowserAction": "string",
"category": "string",
"fieldsObject": "string",
"label": "string",
"triggerURLs": ["string"
],
"value": "string"
},
"ecomEvent": {"ecom_item_filter": {"and": [{"member": "string",
"operator": "string",
"values": [null
]
}
]
},
"itemIDs": ["string"
],
"triggerURLs": ["string"
],
"type": ["string"
]
},
"funnel": {"funnelId": "string"
},
"outgoingTraffic": {"url": "string"
},
"urlPattern": {"match": "simple",
"url": "string"
},
"websitePage": {"type": "static",
"url": "string"
}
},
"id": "string",
"kind": "string",
"name": "string",
"note": "string",
"updatedAt": "2019-08-24T14:15:22Z",
"websiteKey": "string"
}
}

Delete conversion events by list of ids

Authorizations:

bearerAuth

path Parameters

websiteKey

required

string

Request Body schema: application/json
required

conversionEventIds

required

Array of strings or null

Responses

Request samples

Payload

Content type

application/json

{"conversionEventIds": ["string"
]
}

Response samples

404
422
500

Content type

application/problem+json

{"$schema": "https://example.com/schemas/ErrorModel.json",
"detail": "Property foo is required but is missing.",
"errors": [{"location": "string",
"message": "string",
"value": null
}
],
"instance": "https://example.com/error-log/abc123",
"status": 400,
"title": "Bad Request",
"type": "https://example.com/errors/example"
}

List conversion events

Authorizations:

bearerAuth

path Parameters

websiteKey

required

string

query Parameters

nameContains	string
page	integer <int64> >= 0
pageSize	integer <int64> >= 0
orderBy	string
orderDir	string Enum: "asc" "ASC" "desc" "DESC"

Request Body schema: application/json

required

object (ListWhere)

Responses

Request samples

Payload

Content type

application/json

{"where": {"and": [{"member": "string",
"operator": "string",
"values": [null
]
}
]
}
}

Response samples

200
default

Content type

application/json

{"$schema": "https://example.com/schemas/ResponseListConversionEvent.json",
"meta": {"page": 0,
"pageSize": 0,
"pageTotal": 0,
"total": 0
},
"payload": [{"conversionValue": 0,
"createdAt": "2019-08-24T14:15:22Z",
"createdBy": "string",
"dailyConversionGoal": 0,
"data": {"alarmingEvent": {"type": ["string"
]
},
"autoEvent": {"action": "string",
"category": "string",
"label": "string",
"triggerURLs": ["string"
],
"value": "string"
},
"customEvent": {"action": "string",
"bindingBrowserAction": "string",
"category": "string",
"fieldsObject": "string",
"label": "string",
"triggerURLs": ["string"
],
"value": "string"
},
"ecomEvent": {"ecom_item_filter": {"and": [{"member": "string",
"operator": "string",
"values": [null
]
}
]
},
"itemIDs": ["string"
],
"triggerURLs": ["string"
],
"type": ["string"
]
},
"funnel": {"funnelId": "string"
},
"outgoingTraffic": {"url": "string"
},
"urlPattern": {"match": "simple",
"url": "string"
},
"websitePage": {"type": "static",
"url": "string"
}
},
"id": "string",
"kind": "string",
"name": "string",
"note": "string",
"updatedAt": "2019-08-24T14:15:22Z",
"websiteKey": "string"
}
]
}

Get one conversion event

Authorizations:

bearerAuth

path Parameters

websiteKey required	string
conversionEventId required	string

Responses

Response samples

200
default

Content type

application/json

{"$schema": "https://example.com/schemas/ResponseConversionEvent.json",
"meta": {"page": 0,
"pageSize": 0,
"pageTotal": 0,
"total": 0
},
"payload": {"conversionValue": 0,
"createdAt": "2019-08-24T14:15:22Z",
"createdBy": "string",
"dailyConversionGoal": 0,
"data": {"alarmingEvent": {"type": ["string"
]
},
"autoEvent": {"action": "string",
"category": "string",
"label": "string",
"triggerURLs": ["string"
],
"value": "string"
},
"customEvent": {"action": "string",
"bindingBrowserAction": "string",
"category": "string",
"fieldsObject": "string",
"label": "string",
"triggerURLs": ["string"
],
"value": "string"
},
"ecomEvent": {"ecom_item_filter": {"and": [{"member": "string",
"operator": "string",
"values": [null
]
}
]
},
"itemIDs": ["string"
],
"triggerURLs": ["string"
],
"type": ["string"
]
},
"funnel": {"funnelId": "string"
},
"outgoingTraffic": {"url": "string"
},
"urlPattern": {"match": "simple",
"url": "string"
},
"websitePage": {"type": "static",
"url": "string"
}
},
"id": "string",
"kind": "string",
"name": "string",
"note": "string",
"updatedAt": "2019-08-24T14:15:22Z",
"websiteKey": "string"
}
}

Update conversion event

Authorizations:

bearerAuth

path Parameters

websiteKey required	string
conversionEventId required	string

header Parameters

X-User-Id

string

Request Body schema: application/json
required

conversionValue	number or null <float>
dailyConversionGoal	integer or null <int32>
name	string or null
note	string or null

Responses

Request samples

Payload

Content type

application/json

{"conversionValue": 0,
"dailyConversionGoal": 0,
"name": "string",
"note": "string"
}

Response samples

200
404
422
500

Content type

application/json

{"$schema": "https://example.com/schemas/ResponseConversionEvent.json",
"meta": {"page": 0,
"pageSize": 0,
"pageTotal": 0,
"total": 0
},
"payload": {"conversionValue": 0,
"createdAt": "2019-08-24T14:15:22Z",
"createdBy": "string",
"dailyConversionGoal": 0,
"data": {"alarmingEvent": {"type": ["string"
]
},
"autoEvent": {"action": "string",
"category": "string",
"label": "string",
"triggerURLs": ["string"
],
"value": "string"
},
"customEvent": {"action": "string",
"bindingBrowserAction": "string",
"category": "string",
"fieldsObject": "string",
"label": "string",
"triggerURLs": ["string"
],
"value": "string"
},
"ecomEvent": {"ecom_item_filter": {"and": [{"member": "string",
"operator": "string",
"values": [null
]
}
]
},
"itemIDs": ["string"
],
"triggerURLs": ["string"
],
"type": ["string"
]
},
"funnel": {"funnelId": "string"
},
"outgoingTraffic": {"url": "string"
},
"urlPattern": {"match": "simple",
"url": "string"
},
"websitePage": {"type": "static",
"url": "string"
}
},
"id": "string",
"kind": "string",
"name": "string",
"note": "string",
"updatedAt": "2019-08-24T14:15:22Z",
"websiteKey": "string"
}
}

Get conversion value history for a conversion event

Authorizations:

bearerAuth

path Parameters

websiteKey required	string
conversionEventId required	string

query Parameters

page	integer <int64>
pageSize	integer <int64>

Responses

Response samples

200
400
404
422
500

Content type

application/json

{"$schema": "https://example.com/schemas/ResponseListConversionValue.json",
"meta": {"page": 0,
"pageSize": 0,
"pageTotal": 0,
"total": 0
},
"payload": [{"conversionEventId": "string",
"createdAt": "2019-08-24T14:15:22Z",
"createdBy": "string",
"id": "string",
"value": 0.1,
"websiteKey": "string"
}
]
}

Custom Events

Operations about website custom events

Get Custom Events Overview V2

Authentication is needed. For that, the request should have authorization header Authorization:Bearer token-string-value. Also logged in user can see only his own website data (otherwise 403 status code will be received).

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
page	integer Example: page=1 Page to be requested
pageSize	integer Example: pageSize=20 Number of items per page to be requested
action, category, label, pageTitle, element	string action, category, label, pageTitle, element are allowed in text filtering results by one or more terms
group	string one or more columns to group by ( format is option1,option2). Allowed options are 'action', 'category', 'value', 'label', 'pageTitle', 'element', 'type'
order	string one ore more columns to order by 'asc' or 'desc' (format is option1.asc,option2.desc). If no direction is provided for a column 'desc' is assumed. Allowed options are 'action', 'category', 'value', 'label', 'pageTitle', 'element', 'type', 'createdAt'

Responses

Response samples

200
4xx
5xx

Content type

application/json

{"items": [{"key": "string",
"createdAt": "2022-09-27T13:32:01.085Z",
"websiteKey": "string",
"sessionKey": "string",
"visitKey": "string",
"pageKey": "string",
"pageTitle": "Support",
"pageUrl": "https://www.example.com/support",
"domPathKey": "string",
"deviceType": "desktop",
"action": "onmouseover",
"category": "textarea",
"label": "textarea",
"type": 2,
"element": "string",
"fieldsObject": "string",
"value": "string"
}
],
"meta": {"total": 10,
"page": 10,
"pageSize": 10
}
}

Get Custom Events In Depth V2

Authentication is needed. For that, the request should have authorization header Authorization:Bearer token-string-value. Also logged in user can see only his own website data (otherwise 403 status code will be received).

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
action, category, label, pageTitle, element	string action, category, label, pageTitle, element are allowed in text filtering results by one or more terms
group	string one or more columns to group by ( format is option1,option2). Allowed options are 'action', 'category', 'value', 'label', 'pageTitle', 'element', 'type'

Responses

Response samples

200
4xx
5xx

Content type

application/json

[{"timeInterval": {"from": "2022-07-29T22:00:00.001Z",
"until": "2022-07-29T23:59:59.999Z"
},
"groupBy": "websiteKey",
"itemGroups": [{"groupValue": "string",
"itemsInGroup": 35
}
]
}
]

Get Custom Events Filters

Authentication is needed. For that, the request should have authorization header Authorization:Bearer token-string-value. Also logged in user can see only his own website data (otherwise 403 status code will be received).

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

page	integer Example: page=1 Page to be requested
pageSize	integer Example: pageSize=20 Number of items per page to be requested

Responses

Response samples

200
4xx
5xx

Content type

application/json

{"payload": [{"key": "id-string",
"name": "name-string",
"createdAt": 1584451370,
"websiteKey": "id-string",
"value": {"group": ["action"
],
"order": {"name": "category",
"value": "desc"
}
}
}
],
"meta": {"total": 10,
"page": 10,
"pageSize": 10
}
}

Create Custom Event Filter

Authentication is needed. For that, the request should have authorization header Authorization:Bearer token-string-value. Also logged in user can see only his own website data (otherwise 403 status code will be received).

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

Request Body schema: application/json

name	string Represents the filter name
	object

Responses

Request samples

Payload

Content type

application/json

{"name": "Order by action",
"value": {"page": 2,
"pageSize": 25,
"action": "Click",
"category": "Video",
"group": ["action"
],
"order": [{"name": "category",
"value": "desc"
}
]
}
}

Response samples

200
4xx
5xx

Content type

application/json

{"payload": {"key": "id-string",
"name": "Order by action",
"createdAt": 1584451370,
"websiteKey": "id-string",
"value": {"group": ["action"
],
"order": {"name": "category",
"value": "desc"
}
},
"filterKey": "id-string"
}
}

Edit Custom Event Filter's Name

Authentication is needed. For that, the request should have authorization header Authorization:Bearer token-string-value. Also logged in user can see only his own website data (otherwise 403 status code will be received).

Authorizations:

bearerAuth

path Parameters

websiteId required	string <uuid> (uuid) Example: 06d99a32-ee11-11eb-830a-0146de130018 ID of a website
filterId required	string <uuid> (uuid) Example: 06d99a32-ee11-11eb-830a-0146de130018 ID of a custom events filter

Request Body schema: application/json

name	string Represents the filter name

Responses

Request samples

Payload

Content type

application/json

{"name": "Order by action edit"
}

Response samples

200
4xx
5xx

Content type

application/json

"OK"

Delete Custom Event Filter

Authentication is needed. For that, the request should have authorization header Authorization:Bearer token-string-value. Also logged in user can see only his own website data (otherwise 403 status code will be received).

Authorizations:

bearerAuth

path Parameters

websiteId required	string <uuid> (uuid) Example: 06d99a32-ee11-11eb-830a-0146de130018 ID of a website
filterId required	string <uuid> (uuid) Example: 06d99a32-ee11-11eb-830a-0146de130018 ID of a custom events filter

Responses

Response samples

200
4xx
5xx

Content type

application/json

"OK"

Get element interactions V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
pageUrl required	string Page URL of the results from query.
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Responses

Response samples

200
4XX
5xx

Content type

application/json

[{"domPath": "string",
"domPathKey": "string",
"actions": [{"name": "string",
"devices": {"desktop": 0,
"mobile": 0,
"phone": 0
}
}
]
}
]

Surveys

Operations about website surveys

Create Survey

Authentication is needed. For that, the request should have authorization header Authorization:Bearer token-string-value. Also logged in user can see only his own website data (otherwise 403 status code will be received).

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

Request Body schema: application/json

title	string Represents the survey title
language	string
status	integer Available options are 1 (Inactive), 2 (Draft), 3 (Active)
logoId	string Logo id uuid. It is obtained after a file upload
advertising	boolean
	Array of objects
	object
	object

Responses

Request samples

Payload

Content type

application/json

{"title": "My first survey",
"language": "en",
"status": 2,
"logoId": "string",
"advertising": true,
"questions": [{"body": "What city do you like the most?",
"type": 1,
"required": false,
"hasDescription": false
},
{"body": "What city do you like the most and why?",
"type": 2,
"required": false,
"hasDescription": false
},
{"body": "What city do you like the most?",
"type": 3,
"required": false,
"hasDescription": false,
"multipleChoice": true,
"choices": ["London",
"Paris",
"Barcelona",
"Berlin",
"Budapest"
]
},
{"body": "How much do you like Paris?",
"type": 4,
"required": false,
"labels": true,
"choices": ["low",
"medium",
"high"
],
"hasDescription": false
},
{"body": "On a scale from 1 to 5 how much do you like Barcelona?",
"type": 5,
"required": false,
"labels": true,
"steps": 5,
"choices": ["low",
"medium",
"high"
],
"hasDescription": true,
"shape": 2,
"description": "This is some extra description."
},
{"body": "On a scale from 1 to 5 how much do you like London?",
"type": 6,
"labels": true,
"steps": 5,
"choices": ["low",
"medium",
"high"
],
"hasDescription": false
},
{"body": "What is your email address?",
"type": 7,
"required": false,
"hasDescription": false
},
{"body": "What is your phone number?",
"type": 8,
"required": false,
"hasDescription": false
},
{"body": "What is your website address?",
"type": 9,
"required": false,
"hasDescription": false
},
{"body": "What is your birth date?",
"type": 10,
"required": false,
"hasDescription": false
}
],
"appearance": {"mainColor": "#0C635A",
"backgroundColor": "#FFFFFF",
"estimatedTimeToComplete": 5
},
"settings": {"visualization": 1,
"progressBar": true,
"redirectOnCompletion": "https://www.example.com"
}
}

Response samples

200
4xx
5xx

Content type

application/json

{"payload": {"id": "string-id",
"createdAt": 1664345317,
"title": "My first survey",
"language": "en",
"status": 2,
"advertising": true,
"questions": [{"id": "id-string",
"body": "What city do you like the most?",
"type": 1,
"required": false,
"choices": null,
"createdAt": 1664345317,
"description": null,
"inBank": false,
"labels": null,
"multipleChoice": null,
"shape": null,
"steps": null
},
{"id": "id-string",
"body": "What city do you like the most and why?",
"type": 2,
"required": false,
"choices": null,
"createdAt": 1664345317,
"description": null,
"inBank": false,
"labels": null,
"multipleChoice": null,
"shape": null,
"steps": null
},
{"id": "id-string",
"body": "What city do you like the most?",
"type": 3,
"required": false,
"choices": ["London",
"Paris",
"Barcelona",
"Berlin",
"Budapest"
],
"createdAt": 1664345317,
"description": null,
"inBank": false,
"labels": null,
"multipleChoice": true,
"shape": null,
"steps": null
},
{"id": "id-string",
"body": "How much do you like Paris?",
"type": 4,
"required": false,
"choices": ["low",
"medium",
"high"
],
"createdAt": 1664345317,
"description": null,
"inBank": false,
"labels": true,
"multipleChoice": null,
"shape": null,
"steps": null
},
{"id": "id-string",
"body": "On a scale from 1 to 5 how much do you like Barcelona?",
"type": 5,
"required": false,
"choices": ["low",
"medium",
"high"
],
"createdAt": 1664345317,
"description": "This is some extra description.",
"inBank": false,
"labels": true,
"multipleChoice": null,
"shape": 2,
"steps": 5
},
{"id": "id-string",
"body": "On a scale from 1 to 5 how much do you like London?",
"type": 6,
"required": false,
"choices": ["low",
"medium",
"high"
],
"createdAt": 1664345317,
"description": null,
"inBank": false,
"labels": true,
"multipleChoice": null,
"shape": null,
"steps": 5
},
{"id": "id-string",
"body": "What is your email address?",
"type": 7,
"required": false,
"choices": null,
"createdAt": 1664345317,
"description": null,
"inBank": false,
"labels": null,
"multipleChoice": null,
"shape": null,
"steps": null
},
{"id": "id-string",
"body": "What is your phone number?",
"type": 8,
"required": false,
"choices": null,
"createdAt": 1664345317,
"description": null,
"inBank": false,
"labels": null,
"multipleChoice": null,
"shape": null,
"steps": null
},
{"id": "id-string",
"body": "What is your website address?",
"type": 9,
"required": false,
"choices": null,
"createdAt": 1664345317,
"description": null,
"inBank": false,
"labels": null,
"multipleChoice": null,
"shape": null,
"steps": null
},
{"id": "id-string",
"body": "What is your birth date?",
"type": 10,
"required": false,
"choices": null,
"createdAt": 1664345317,
"description": null,
"inBank": false,
"labels": null,
"multipleChoice": null,
"shape": null,
"steps": null
}
],
"appearance": {"mainColor": "#0C635A",
"backgroundColor": "#FFFFFF",
"estimatedTimeToComplete": 5
},
"settings": {"visualization": 1,
"progressBar": true,
"redirectOnCompletion": "https://www.example.com"
}
}
}

Get all Surveys with general stats

Authentication is needed. For that, the request should have authorization header Authorization:Bearer token-string-value. Also logged in user can see only his own website data (otherwise 403 status code will be received).

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

Responses

Response samples

200
4xx
5xx

Content type

application/json

{"payload": [{"id": "string-id",
"createdAt": 1664345317,
"title": "My first survey",
"language": "en",
"status": 2,
"advertising": true,
"websiteId": "string-id",
"generalStats": {"initiates": 59,
"responses": 412,
"completionRate": 98.31,
"averageCompletionTime": 153,
"answersPerQuestion": [59,
59,
59,
59,
59,
59,
59,
59,
59,
58
]
}
}
]
}

Get Survey

Authentication is needed. For that, the request should have authorization header Authorization:Bearer token-string-value. Also logged in user can see only his own website data (otherwise 403 status code will be received). Survey questions will always be included in the response. Appearance & Settings can be added to the response by using: appearance=true AND/OR settings=true

Authorizations:

bearerAuth

path Parameters

websiteId required	string <uuid> (uuid) Example: 06d99a32-ee11-11eb-830a-0146de130018 ID of a website
surveyId required	string ID of a survey. Pattern is [a-f\d]{24}

Responses

Response samples

200
4xx
5xx

Content type

application/json

{"payload": {"id": "string-id",
"createdAt": 1664345317,
"title": "My first survey",
"language": "en",
"status": 2,
"advertising": true,
"questions": [{"id": "id-string",
"body": "What city do you like the most?",
"type": 1,
"required": false,
"choices": null,
"createdAt": 1664345317,
"description": null,
"inBank": false,
"labels": null,
"multipleChoice": null,
"shape": null,
"steps": null
},
{"id": "id-string",
"body": "What city do you like the most and why?",
"type": 2,
"required": false,
"choices": null,
"createdAt": 1664345317,
"description": null,
"inBank": false,
"labels": null,
"multipleChoice": null,
"shape": null,
"steps": null
},
{"id": "id-string",
"body": "What city do you like the most?",
"type": 3,
"required": false,
"choices": ["London",
"Paris",
"Barcelona",
"Berlin",
"Budapest"
],
"createdAt": 1664345317,
"description": null,
"inBank": false,
"labels": null,
"multipleChoice": true,
"shape": null,
"steps": null
},
{"id": "id-string",
"body": "How much do you like Paris?",
"type": 4,
"required": false,
"choices": ["low",
"medium",
"high"
],
"createdAt": 1664345317,
"description": null,
"inBank": false,
"labels": true,
"multipleChoice": null,
"shape": null,
"steps": null
},
{"id": "id-string",
"body": "On a scale from 1 to 5 how much do you like Barcelona?",
"type": 5,
"required": false,
"choices": ["low",
"medium",
"high"
],
"createdAt": 1664345317,
"description": "This is some extra description.",
"inBank": false,
"labels": true,
"multipleChoice": null,
"shape": 2,
"steps": 5
},
{"id": "id-string",
"body": "On a scale from 1 to 5 how much do you like London?",
"type": 6,
"required": false,
"choices": ["low",
"medium",
"high"
],
"createdAt": 1664345317,
"description": null,
"inBank": false,
"labels": true,
"multipleChoice": null,
"shape": null,
"steps": 5
},
{"id": "id-string",
"body": "What is your email address?",
"type": 7,
"required": false,
"choices": null,
"createdAt": 1664345317,
"description": null,
"inBank": false,
"labels": null,
"multipleChoice": null,
"shape": null,
"steps": null
},
{"id": "id-string",
"body": "What is your phone number?",
"type": 8,
"required": false,
"choices": null,
"createdAt": 1664345317,
"description": null,
"inBank": false,
"labels": null,
"multipleChoice": null,
"shape": null,
"steps": null
},
{"id": "id-string",
"body": "What is your website address?",
"type": 9,
"required": false,
"choices": null,
"createdAt": 1664345317,
"description": null,
"inBank": false,
"labels": null,
"multipleChoice": null,
"shape": null,
"steps": null
},
{"id": "id-string",
"body": "What is your birth date?",
"type": 10,
"required": false,
"choices": null,
"createdAt": 1664345317,
"description": null,
"inBank": false,
"labels": null,
"multipleChoice": null,
"shape": null,
"steps": null
}
],
"appearance": {"mainColor": "#0C635A",
"backgroundColor": "#FFFFFF",
"estimatedTimeToComplete": 5
},
"settings": {"visualization": 1,
"progressBar": true,
"redirectOnCompletion": "https://www.example.com"
}
}
}

Edit Survey

Authentication is needed. For that, the request should have authorization header Authorization:Bearer token-string-value. Also logged in user can see only his own website data (otherwise 403 status code will be received). Once the survey has status 1 (Inactive) or 3 (Active) you can not edit the survey anymore.

Authorizations:

bearerAuth

path Parameters

websiteId required	string <uuid> (uuid) Example: 06d99a32-ee11-11eb-830a-0146de130018 ID of a website
surveyId required	string ID of a survey. Pattern is [a-f\d]{24}

Request Body schema: application/json

title	string Represents the survey title
language	string
status	integer Available options are 1 (Inactive), 2 (Draft), 3 (Active)
logoId	string Logo id uuid. It is obtained after a file upload
advertising	boolean
	Array of objects
	object
	object

Responses

Request samples

Payload

Content type

application/json

{"title": "My first survey",
"language": "en",
"status": 2,
"logoId": "string",
"advertising": true,
"questions": [{"id": "id-string",
"body": "What city do you like the most?",
"type": 1,
"required": false,
"hasDescription": false
},
{"id": "id-string",
"body": "What city do you like the most and why?",
"type": 2,
"required": false,
"hasDescription": false
},
{"id": "id-string",
"body": "What city do you like the most?",
"type": 3,
"required": false,
"hasDescription": false,
"multipleChoice": true,
"choices": ["London",
"Paris",
"Barcelona",
"Berlin",
"Budapest"
]
},
{"id": "id-string",
"body": "How much do you like Paris?",
"type": 4,
"required": false,
"labels": true,
"choices": ["low",
"medium",
"high"
],
"hasDescription": false
},
{"id": "id-string",
"body": "On a scale from 1 to 5 how much do you like Barcelona?",
"type": 5,
"required": false,
"labels": true,
"steps": 5,
"choices": ["low",
"medium",
"high"
],
"hasDescription": true,
"shape": 2,
"description": "This is some extra description."
},
{"id": "id-string",
"body": "On a scale from 1 to 5 how much do you like London?",
"type": 6,
"labels": true,
"steps": 5,
"choices": ["low",
"medium",
"high"
],
"hasDescription": false
},
{"id": "id-string",
"body": "What is your email address?",
"type": 7,
"required": false,
"hasDescription": false
},
{"id": "id-string",
"body": "What is your phone number?",
"type": 8,
"required": false,
"hasDescription": false
},
{"id": "id-string",
"body": "What is your website address?",
"type": 9,
"required": false,
"hasDescription": false
},
{"id": "id-string",
"body": "What is your birth date?",
"type": 10,
"required": false,
"hasDescription": false
}
],
"appearance": {"mainColor": "#0C635A",
"backgroundColor": "#FFFFFF",
"estimatedTimeToComplete": 5
},
"settings": {"visualization": 1,
"progressBar": true,
"redirectOnCompletion": "https://www.example.com"
}
}

Response samples

200
4xx
5xx

Content type

application/json

{"payload": {"id": "string-id",
"createdAt": 1664345317,
"title": "My first survey",
"language": "en",
"status": 2,
"advertising": true,
"questions": [{"id": "id-string",
"body": "What city do you like the most?",
"type": 1,
"required": false,
"choices": null,
"createdAt": 1664345317,
"description": null,
"inBank": false,
"labels": null,
"multipleChoice": null,
"shape": null,
"steps": null
},
{"id": "id-string",
"body": "What city do you like the most and why?",
"type": 2,
"required": false,
"choices": null,
"createdAt": 1664345317,
"description": null,
"inBank": false,
"labels": null,
"multipleChoice": null,
"shape": null,
"steps": null
},
{"id": "id-string",
"body": "What city do you like the most?",
"type": 3,
"required": false,
"choices": ["London",
"Paris",
"Barcelona",
"Berlin",
"Budapest"
],
"createdAt": 1664345317,
"description": null,
"inBank": false,
"labels": null,
"multipleChoice": true,
"shape": null,
"steps": null
},
{"id": "id-string",
"body": "How much do you like Paris?",
"type": 4,
"required": false,
"choices": ["low",
"medium",
"high"
],
"createdAt": 1664345317,
"description": null,
"inBank": false,
"labels": true,
"multipleChoice": null,
"shape": null,
"steps": null
},
{"id": "id-string",
"body": "On a scale from 1 to 5 how much do you like Barcelona?",
"type": 5,
"required": false,
"choices": ["low",
"medium",
"high"
],
"createdAt": 1664345317,
"description": "This is some extra description.",
"inBank": false,
"labels": true,
"multipleChoice": null,
"shape": 2,
"steps": 5
},
{"id": "id-string",
"body": "On a scale from 1 to 5 how much do you like London?",
"type": 6,
"required": false,
"choices": ["low",
"medium",
"high"
],
"createdAt": 1664345317,
"description": null,
"inBank": false,
"labels": true,
"multipleChoice": null,
"shape": null,
"steps": 5
},
{"id": "id-string",
"body": "What is your email address?",
"type": 7,
"required": false,
"choices": null,
"createdAt": 1664345317,
"description": null,
"inBank": false,
"labels": null,
"multipleChoice": null,
"shape": null,
"steps": null
},
{"id": "id-string",
"body": "What is your phone number?",
"type": 8,
"required": false,
"choices": null,
"createdAt": 1664345317,
"description": null,
"inBank": false,
"labels": null,
"multipleChoice": null,
"shape": null,
"steps": null
},
{"id": "id-string",
"body": "What is your website address?",
"type": 9,
"required": false,
"choices": null,
"createdAt": 1664345317,
"description": null,
"inBank": false,
"labels": null,
"multipleChoice": null,
"shape": null,
"steps": null
},
{"id": "id-string",
"body": "What is your birth date?",
"type": 10,
"required": false,
"choices": null,
"createdAt": 1664345317,
"description": null,
"inBank": false,
"labels": null,
"multipleChoice": null,
"shape": null,
"steps": null
}
],
"appearance": {"mainColor": "#0C635A",
"backgroundColor": "#FFFFFF",
"estimatedTimeToComplete": 5
},
"settings": {"visualization": 1,
"progressBar": true,
"redirectOnCompletion": "https://www.example.com"
}
}
}

Delete Survey

Authentication is needed. For that, the request should have authorization header Authorization:Bearer token-string-value. Also logged in user can see only his own website data (otherwise 403 status code will be received).

Authorizations:

bearerAuth

path Parameters

websiteId required	string <uuid> (uuid) Example: 06d99a32-ee11-11eb-830a-0146de130018 ID of a website
surveyId required	string ID of a survey. Pattern is [a-f\d]{24}

Responses

Response samples

4xx
5xx

Content type

application/json

{"error": {"code": "server_error",
"message": "this is error response",
"details": { }
}
}

Activate/Deactivate Survey

Authentication is needed. For that, the request should have authorization header Authorization:Bearer token-string-value. Also logged in user can see only his own website data (otherwise 403 status code will be received).

Authorizations:

bearerAuth

path Parameters

websiteId required	string <uuid> (uuid) Example: 06d99a32-ee11-11eb-830a-0146de130018 ID of a website
surveyId required	string ID of a survey. Pattern is [a-f\d]{24}

Request Body schema: application/json

status

integer

Available options are 1 (Inactive), 3 (Active)

Responses

Request samples

Payload

Content type

application/json

{"status": 3
}

Response samples

4xx
5xx

Content type

application/json

{"error": {"code": "server_error",
"message": "this is error response",
"details": { }
}
}

Get Surveys count for website

Authentication is needed. For that, the request should have authorization header Authorization:Bearer token-string-value. Also logged in user can see only his own website data (otherwise 403 status code will be received).

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

Responses

Response samples

200
4xx
5xx

Content type

application/json

{"payload": {"count": 3
}
}

Get Survey Text Question Answers

Authentication is needed. For that, the request should have authorization header Authorization:Bearer token-string-value. Also logged in user can see only his own website data (otherwise 403 status code will be received). This endpoint will return avalid response only for question having type 1 (Short Answer). For any other question types will return nulls in response

Authorizations:

bearerAuth

path Parameters

websiteId required	string <uuid> (uuid) Example: 06d99a32-ee11-11eb-830a-0146de130018 ID of a website
surveyId required	string ID of a survey. Pattern is [a-f\d]{24}
questionId required	string ID of a survey question. Pattern is [a-f\d]{24}

Responses

Response samples

200
4xx
5xx

Content type

application/json

{"payload": {"id": "string-id",
"type": 1,
"body": "What city do you like the most?",
"description": "This is some extra description.",
"answerCount": 6,
"answers": [{"body": "I like Paris",
"visitor": null,
"createdAt": 1664345317
},
{"body": "Barcelona",
"visitor": null,
"createdAt": 1664345417
},
{"body": "None",
"visitor": null,
"createdAt": 1664345427
},
{"body": "What question is this?",
"visitor": null,
"createdAt": 1664346317
},
{"body": "this is a test response",
"visitor": null,
"createdAt": 1664346417
},
{"body": "NewYork",
"visitor": null,
"createdAt": 1664346617
}
]
}
}

Create Survey Question Answer For Public

Authentication is not needed.

path Parameters

websiteId required	string <uuid> (uuid) Example: 06d99a32-ee11-11eb-830a-0146de130018 ID of a website
surveyId required	string ID of a survey. Pattern is [a-f\d]{24}
questionId required	string ID of a survey question. Pattern is [a-f\d]{24}

Request Body schema: application/json

body	string Represents the answer for Short Answer, Long Answer, Email, Website, Phone, Date
value	integer Represents the answer for Slider, Rating, Rating Scale
choices	Array of arrays
visitorKey	string
shownAt	integer <timestamp>

Responses

Request samples

Payload

Content type

application/json

{"body": "My first answer",
"value": 2,
"choices": ["choice1",
"choice3"
],
"visitorKey": "string",
"shownAt": 1608209339
}

Response samples

4xx
5xx

Content type

application/json

{"error": {"code": "server_error",
"message": "this is error response",
"details": { }
}
}

Get Survey for Public

Authentication not needed. Survey questions will always be included in the response. Appearance & Settings can be added to the response by using: appearance=true AND/OR settings=true

Authorizations:

bearerAuth

path Parameters

websiteId required	string <uuid> (uuid) Example: 06d99a32-ee11-11eb-830a-0146de130018 ID of a website
surveyId required	string ID of a survey. Pattern is [a-f\d]{24}

Responses

Response samples

200
4xx
5xx

Content type

application/json

{"payload": {"id": "string-id",
"createdAt": 1664345317,
"title": "My first survey",
"language": "en",
"status": 3,
"advertising": true,
"questions": [{"id": "id-string",
"body": "What city do you like the most?",
"type": 1,
"required": false,
"choices": null,
"createdAt": 1664345317,
"description": null,
"inBank": false,
"labels": null,
"multipleChoice": null,
"shape": null,
"steps": null
},
{"id": "id-string",
"body": "What city do you like the most and why?",
"type": 2,
"required": false,
"choices": null,
"createdAt": 1664345317,
"description": null,
"inBank": false,
"labels": null,
"multipleChoice": null,
"shape": null,
"steps": null
},
{"id": "id-string",
"body": "What city do you like the most?",
"type": 3,
"required": false,
"choices": ["London",
"Paris",
"Barcelona",
"Berlin",
"Budapest"
],
"createdAt": 1664345317,
"description": null,
"inBank": false,
"labels": null,
"multipleChoice": true,
"shape": null,
"steps": null
},
{"id": "id-string",
"body": "How much do you like Paris?",
"type": 4,
"required": false,
"choices": ["low",
"medium",
"high"
],
"createdAt": 1664345317,
"description": null,
"inBank": false,
"labels": true,
"multipleChoice": null,
"shape": null,
"steps": null
},
{"id": "id-string",
"body": "On a scale from 1 to 5 how much do you like Barcelona?",
"type": 5,
"required": false,
"choices": ["low",
"medium",
"high"
],
"createdAt": 1664345317,
"description": "This is some extra description.",
"inBank": false,
"labels": true,
"multipleChoice": null,
"shape": 2,
"steps": 5
},
{"id": "id-string",
"body": "On a scale from 1 to 5 how much do you like London?",
"type": 6,
"required": false,
"choices": ["low",
"medium",
"high"
],
"createdAt": 1664345317,
"description": null,
"inBank": false,
"labels": true,
"multipleChoice": null,
"shape": null,
"steps": 5
},
{"id": "id-string",
"body": "What is your email address?",
"type": 7,
"required": false,
"choices": null,
"createdAt": 1664345317,
"description": null,
"inBank": false,
"labels": null,
"multipleChoice": null,
"shape": null,
"steps": null
},
{"id": "id-string",
"body": "What is your phone number?",
"type": 8,
"required": false,
"choices": null,
"createdAt": 1664345317,
"description": null,
"inBank": false,
"labels": null,
"multipleChoice": null,
"shape": null,
"steps": null
},
{"id": "id-string",
"body": "What is your website address?",
"type": 9,
"required": false,
"choices": null,
"createdAt": 1664345317,
"description": null,
"inBank": false,
"labels": null,
"multipleChoice": null,
"shape": null,
"steps": null
},
{"id": "id-string",
"body": "What is your birth date?",
"type": 10,
"required": false,
"choices": null,
"createdAt": 1664345317,
"description": null,
"inBank": false,
"labels": null,
"multipleChoice": null,
"shape": null,
"steps": null
}
],
"appearance": {"mainColor": "#0C635A",
"backgroundColor": "#FFFFFF",
"estimatedTimeToComplete": 5
},
"settings": {"visualization": 1,
"progressBar": true,
"redirectOnCompletion": "https://www.example.com"
}
}
}

Get Survey Logo for Public

Authentication is not needed

path Parameters

websiteId required	string <uuid> (uuid) Example: 06d99a32-ee11-11eb-830a-0146de130018 ID of a website
surveyId required	string ID of a survey. Pattern is [a-f\d]{24}

Responses

Response samples

4xx
5xx

Content type

application/json

{"error": {"code": "server_error",
"message": "this is error response",
"details": { }
}
}

Create Survey Answer For Public

Authentication is not needed.

path Parameters

websiteId required	string <uuid> (uuid) Example: 06d99a32-ee11-11eb-830a-0146de130018 ID of a website
surveyId required	string ID of a survey. Pattern is [a-f\d]{24}

Request Body schema: application/json

body	string Represents the answer for Short Answer, Long Answer, Email, Website, Phone, Date
value	integer Represents the answer for Slider, Rating, Rating Scale
choices	Array of arrays
visitorKey	string
questionId	string
shownAt	integer <timestamp>

Responses

Request samples

Payload

Content type

application/json

{"body": "My first answer",
"value": 2,
"choices": ["choice1",
"choice3"
],
"visitorKey": "string",
"questionId": "question-id",
"shownAt": 1608209339
}

Response samples

4xx
5xx

Content type

application/json

{"error": {"code": "server_error",
"message": "this is error response",
"details": { }
}
}

Get All Surveys Average Completion Rate

Authentication is needed. For that, the request should have authorization header Authorization:Bearer token-string-value. Also logged in user can see only his own website data (otherwise 403 status code will be received).

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

Responses

Response samples

200
4xx
5xx

Content type

application/json

{"payload": {"average-completion-rate": 25.5
}
}

Get All Surveys Responses Count

Authentication is needed. For that, the request should have authorization header Authorization:Bearer token-string-value. Also logged in user can see only his own website data (otherwise 403 status code will be received).

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

Responses

Response samples

200
4xx
5xx

Content type

application/json

{"payload": {"count": 400
}
}

Get All Surveys Initiates

Authentication is needed. For that, the request should have authorization header Authorization:Bearer token-string-value. Also logged in user can see only his own website data (otherwise 403 status code will be received).

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

Responses

Response samples

200
4xx
5xx

Content type

application/json

{"payload": {"count": 10
}
}

Get Survey Results

Authentication is needed. For that, the request should have authorization header Authorization:Bearer token-string-value. Also logged in user can see only his own website data (otherwise 403 status code will be received).

Authorizations:

bearerAuth

path Parameters

websiteId required	string <uuid> (uuid) Example: 06d99a32-ee11-11eb-830a-0146de130018 ID of a website
surveyId required	string ID of a survey. Pattern is [a-f\d]{24}

Responses

Response samples

200
4xx
5xx

Content type

application/json

{"payload": {"totalAnswersCount": 131,
"questions": [{"id": "id-string",
"type": 1,
"body": "What city do you like the most?",
"description": "Question Short Answer Description",
"answerCount": 20,
"answer": [{"body": "answer short 1",
"visitor": null,
"createdAt": 1597939200
}
]
},
{"id": "id-string",
"body": "What city do you like the most and why?",
"type": 2,
"description": "Question Long Answer Description",
"answerCount": 20,
"answer": [{"body": "answer long 1",
"visitor": null,
"createdAt": 1597939200
}
]
},
{"id": "id-string",
"body": "What city do you like the most?",
"description": "Question Multiple Choice Description",
"type": 3,
"required": false,
"answerCount": 17,
"answers": [{"London": 1
},
{"Paris": 0
},
{"Barcelona": 10
},
{"Berlin": 4
},
{"Budapest": 2
}
]
},
{"id": "id-string",
"body": "How much do you like Paris?",
"description": "Question Slider Description",
"type": 4,
"labels": ["low",
"medium",
"high"
],
"answerCount": 16,
"average": 10
},
{"id": "id-string",
"body": "On a scale from 1 to 5 how much do you like Barcelona?",
"description": "Question Rating Description",
"type": 5,
"labels": ["low",
"medium",
"high"
],
"answerCount": 15,
"answers": [1,
7,
7
]
},
{"id": "id-string",
"body": "On a scale from 1 to 5 how much do you like London?",
"type": 6,
"description": "Question Scale Description",
"labels": ["low",
"medium",
"high"
],
"answerCount": 15,
"answers": [1,
6,
8
]
},
{"id": "id-string",
"body": "What is your email address?",
"description": "Question Email Description",
"type": 7,
"answerCount": 10,
"answers": [{"body": "my-email",
"visitor": null,
"createdAt": 1597939200
}
]
},
{"id": "id-string",
"body": "What is your phone number?",
"description": "Question Phone Description",
"type": 8,
"answerCount": 10,
"answers": [{"body": "my-phone",
"visitor": null,
"createdAt": 1597939200
}
]
},
{"id": "id-string",
"body": "What is your website address?",
"description": "Question Website Description",
"type": 9,
"answerCount": 5,
"answers": [{"body": "my-website",
"visitor": null,
"createdAt": 1597939200
}
]
},
{"id": "id-string",
"body": "What is your birth date?",
"description": "Question Date Description",
"type": 10,
"answerCount": 3,
"answers": [{"body": "my-birthday",
"visitor": null,
"createdAt": 1597939200
}
]
}
]
}
}

Get Survey General Stats

Authentication is needed. For that, the request should have authorization header Authorization:Bearer token-string-value. Also logged in user can see only his own website data (otherwise 403 status code will be received).

Authorizations:

bearerAuth

path Parameters

websiteId required	string <uuid> (uuid) Example: 06d99a32-ee11-11eb-830a-0146de130018 ID of a website
surveyId required	string ID of a survey. Pattern is [a-f\d]{24}

Responses

Response samples

200
4xx
5xx

Content type

application/json

{"payload": {"surveyId": "survey-id",
"initiates": 6,
"responses": 6,
"averageCompletionTime": 50,
"completionRate": 25.5,
"answersPerQuestion": [20,
20,
17,
16,
15,
15,
10,
10,
5,
3
]
}
}

Polls

Operations about website polls

Create Poll

Authentication is needed. For that, the request should have authorization header Authorization:Bearer token-string-value. Also logged in user can see only his own website data (otherwise 403 status code will be received).

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

Request Body schema: application/json

title	string Represents the poll title
language	string
status	integer Available options are 1 (Inactive), 2 (Draft), 3 (Active)
logoId	string Logo id uuid. It is obtained after a file upload
advertising	boolean
dismissible	boolean
	Array of objects
	object
	object

Responses

Request samples

Payload

Content type

application/json

{"title": "My first poll",
"language": "en",
"status": 2,
"logoId": "string",
"advertising": true,
"dismissible": true,
"questions": [{"body": "What city do you like the most?",
"type": 1,
"required": false,
"hasDescription": false
},
{"body": "What city do you like the most and why?",
"type": 2,
"required": false,
"hasDescription": false
},
{"body": "What city do you like the most?",
"type": 3,
"required": false,
"hasDescription": false,
"multipleChoice": true,
"choices": ["London",
"Paris",
"Barcelona",
"Berlin",
"Budapest"
]
},
{"body": "How much do you like Paris?",
"type": 4,
"required": false,
"labels": true,
"choices": ["low",
"medium",
"high"
],
"hasDescription": false
},
{"body": "On a scale from 1 to 5 how much do you like Barcelona?",
"type": 5,
"required": false,
"labels": true,
"steps": 5,
"choices": ["low",
"medium",
"high"
],
"hasDescription": true,
"shape": 2,
"description": "This is some extra description."
},
{"body": "On a scale from 1 to 5 how much do you like London?",
"type": 6,
"labels": true,
"steps": 5,
"choices": ["low",
"medium",
"high"
],
"hasDescription": false
},
{"body": "What is your email address?",
"type": 7,
"required": false,
"hasDescription": false
},
{"body": "What is your phone number?",
"type": 8,
"required": false,
"hasDescription": false
},
{"body": "What is your website address?",
"type": 9,
"required": false,
"hasDescription": false
},
{"body": "What is your birth date?",
"type": 10,
"required": false,
"hasDescription": false
}
],
"appearance": {"mainColor": "#0C635A",
"backgroundColor": "#FFFFFF",
"bubblePosition": 1,
"hPadding": 10,
"vPadding": 10
},
"targeting": {"showOn": [[{"type": 1,
"value": "example.com"
},
{"type": 2,
"value": "http://www.example.com?example=example"
},
{"type": 3,
"value": "example.com"
},
{"type": 4,
"value": "example"
},
{"type": 5,
"value": "example=example"
}
]
],
"hideOn": [[{"type": 1,
"value": "example.com"
},
{"type": 2,
"value": "http://www.example.com?example=example"
},
{"type": 3,
"value": "example.com"
},
{"type": 4,
"value": "example"
}
]
]
}
}

Response samples

200
4xx
5xx

Content type

application/json

{"payload": {"id": "string-id",
"createdAt": 1664345317,
"title": "My first poll",
"language": "en",
"status": 2,
"advertising": true,
"dismissible": true,
"questions": [{"id": "id-string",
"body": "What city do you like the most?",
"type": 1,
"required": false,
"choices": null,
"createdAt": 1664345317,
"description": null,
"inBank": false,
"labels": null,
"multipleChoice": null,
"shape": null,
"steps": null
},
{"id": "id-string",
"body": "What city do you like the most and why?",
"type": 2,
"required": false,
"choices": null,
"createdAt": 1664345317,
"description": null,
"inBank": false,
"labels": null,
"multipleChoice": null,
"shape": null,
"steps": null
},
{"id": "id-string",
"body": "What city do you like the most?",
"type": 3,
"required": false,
"choices": ["London",
"Paris",
"Barcelona",
"Berlin",
"Budapest"
],
"createdAt": 1664345317,
"description": null,
"inBank": false,
"labels": null,
"multipleChoice": true,
"shape": null,
"steps": null
},
{"id": "id-string",
"body": "How much do you like Paris?",
"type": 4,
"required": false,
"choices": ["low",
"medium",
"high"
],
"createdAt": 1664345317,
"description": null,
"inBank": false,
"labels": true,
"multipleChoice": null,
"shape": null,
"steps": null
},
{"id": "id-string",
"body": "On a scale from 1 to 5 how much do you like Barcelona?",
"type": 5,
"required": false,
"choices": ["low",
"medium",
"high"
],
"createdAt": 1664345317,
"description": "This is some extra description.",
"inBank": false,
"labels": true,
"multipleChoice": null,
"shape": 2,
"steps": 5
},
{"id": "id-string",
"body": "On a scale from 1 to 5 how much do you like London?",
"type": 6,
"required": false,
"choices": ["low",
"medium",
"high"
],
"createdAt": 1664345317,
"description": null,
"inBank": false,
"labels": true,
"multipleChoice": null,
"shape": null,
"steps": 5
},
{"id": "id-string",
"body": "What is your email address?",
"type": 7,
"required": false,
"choices": null,
"createdAt": 1664345317,
"description": null,
"inBank": false,
"labels": null,
"multipleChoice": null,
"shape": null,
"steps": null
},
{"id": "id-string",
"body": "What is your phone number?",
"type": 8,
"required": false,
"choices": null,
"createdAt": 1664345317,
"description": null,
"inBank": false,
"labels": null,
"multipleChoice": null,
"shape": null,
"steps": null
},
{"id": "id-string",
"body": "What is your website address?",
"type": 9,
"required": false,
"choices": null,
"createdAt": 1664345317,
"description": null,
"inBank": false,
"labels": null,
"multipleChoice": null,
"shape": null,
"steps": null
},
{"id": "id-string",
"body": "What is your birth date?",
"type": 10,
"required": false,
"choices": null,
"createdAt": 1664345317,
"description": null,
"inBank": false,
"labels": null,
"multipleChoice": null,
"shape": null,
"steps": null
}
],
"appearance": {"mainColor": "#0C635A",
"backgroundColor": "#FFFFFF",
"bubblePosition": 1,
"hPadding": 10,
"vPadding": 10
},
"targeting": {"showOn": [[{"type": 1,
"value": "example.com"
},
{"type": 2,
"value": "http://www.example.com?example=example"
},
{"type": 3,
"value": "example.com"
},
{"type": 4,
"value": "example"
},
{"type": 5,
"value": "example=example"
}
]
],
"hideOn": [[{"type": 1,
"value": "example.com"
},
{"type": 2,
"value": "http://www.example.com?example=example"
},
{"type": 3,
"value": "example.com"
},
{"type": 4,
"value": "example"
}
]
]
}
}
}

Get all Polls with general stats

Authentication is needed. For that, the request should have authorization header Authorization:Bearer token-string-value. Also logged in user can see only his own website data (otherwise 403 status code will be received).

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

Responses

Response samples

200
4xx
5xx

Content type

application/json

{"payload": [{"id": "string-id",
"createdAt": 1664345317,
"title": "My first poll",
"language": "en",
"status": 2,
"advertising": true,
"dismissible": true,
"websiteId": "string-id",
"generalStats": {"initiates": 59,
"responses": 412,
"completionRate": 98.31,
"averageCompletionTime": 153,
"answersPerQuestion": [59,
59,
59,
59,
59,
59,
59,
59,
59,
58
],
"dismissals": 1
}
}
]
}

Get Poll

Authentication is needed. For that, the request should have authorization header Authorization:Bearer token-string-value. Also logged in user can see only his own website data (otherwise 403 status code will be received). Poll questions will always be included in the response. Appearance & Targeting can be added to the response by using: appearance=true AND/OR targeting=true

Authorizations:

bearerAuth

path Parameters

websiteId required	string <uuid> (uuid) Example: 06d99a32-ee11-11eb-830a-0146de130018 ID of a website
pollId required	string ID of a poll. Pattern is [a-f\d]{24}

Responses

Response samples

200
4xx
5xx

Content type

application/json

{"payload": {"id": "string-id",
"createdAt": 1664345317,
"title": "My first Poll",
"language": "en",
"status": 2,
"advertising": true,
"dismissible": true,
"questions": [{"id": "id-string",
"body": "What city do you like the most?",
"type": 1,
"required": false,
"choices": null,
"createdAt": 1664345317,
"description": null,
"inBank": false,
"labels": null,
"multipleChoice": null,
"shape": null,
"steps": null
},
{"id": "id-string",
"body": "What city do you like the most and why?",
"type": 2,
"required": false,
"choices": null,
"createdAt": 1664345317,
"description": null,
"inBank": false,
"labels": null,
"multipleChoice": null,
"shape": null,
"steps": null
},
{"id": "id-string",
"body": "What city do you like the most?",
"type": 3,
"required": false,
"choices": ["London",
"Paris",
"Barcelona",
"Berlin",
"Budapest"
],
"createdAt": 1664345317,
"description": null,
"inBank": false,
"labels": null,
"multipleChoice": true,
"shape": null,
"steps": null
},
{"id": "id-string",
"body": "How much do you like Paris?",
"type": 4,
"required": false,
"choices": ["low",
"medium",
"high"
],
"createdAt": 1664345317,
"description": null,
"inBank": false,
"labels": true,
"multipleChoice": null,
"shape": null,
"steps": null
},
{"id": "id-string",
"body": "On a scale from 1 to 5 how much do you like Barcelona?",
"type": 5,
"required": false,
"choices": ["low",
"medium",
"high"
],
"createdAt": 1664345317,
"description": "This is some extra description.",
"inBank": false,
"labels": true,
"multipleChoice": null,
"shape": 2,
"steps": 5
},
{"id": "id-string",
"body": "On a scale from 1 to 5 how much do you like London?",
"type": 6,
"required": false,
"choices": ["low",
"medium",
"high"
],
"createdAt": 1664345317,
"description": null,
"inBank": false,
"labels": true,
"multipleChoice": null,
"shape": null,
"steps": 5
},
{"id": "id-string",
"body": "What is your email address?",
"type": 7,
"required": false,
"choices": null,
"createdAt": 1664345317,
"description": null,
"inBank": false,
"labels": null,
"multipleChoice": null,
"shape": null,
"steps": null
},
{"id": "id-string",
"body": "What is your phone number?",
"type": 8,
"required": false,
"choices": null,
"createdAt": 1664345317,
"description": null,
"inBank": false,
"labels": null,
"multipleChoice": null,
"shape": null,
"steps": null
},
{"id": "id-string",
"body": "What is your website address?",
"type": 9,
"required": false,
"choices": null,
"createdAt": 1664345317,
"description": null,
"inBank": false,
"labels": null,
"multipleChoice": null,
"shape": null,
"steps": null
},
{"id": "id-string",
"body": "What is your birth date?",
"type": 10,
"required": false,
"choices": null,
"createdAt": 1664345317,
"description": null,
"inBank": false,
"labels": null,
"multipleChoice": null,
"shape": null,
"steps": null
}
],
"appearance": {"mainColor": "#0C635A",
"backgroundColor": "#FFFFFF",
"bubblePosition": 1,
"hPadding": 10,
"vPadding": 10
},
"targeting": {"showOn": [[{"type": 1,
"value": "example.com"
},
{"type": 2,
"value": "http://www.example.com?example=example"
},
{"type": 3,
"value": "example.com"
},
{"type": 4,
"value": "example"
},
{"type": 5,
"value": "example=example"
}
]
],
"hideOn": [[{"type": 1,
"value": "example.com"
},
{"type": 2,
"value": "http://www.example.com?example=example"
},
{"type": 3,
"value": "example.com"
},
{"type": 4,
"value": "example"
}
]
]
}
}
}

Edit Poll

Authentication is needed. For that, the request should have authorization header Authorization:Bearer token-string-value. Also logged in user can see only his own website data (otherwise 403 status code will be received). Once the poll has status 1 (Inactive) or 3 (Active) you can not edit the poll anymore.

Authorizations:

bearerAuth

path Parameters

websiteId required	string <uuid> (uuid) Example: 06d99a32-ee11-11eb-830a-0146de130018 ID of a website
pollId required	string ID of a poll. Pattern is [a-f\d]{24}

Request Body schema: application/json

title	string Represents the poll title
language	string
status	integer Available options are 1 (Inactive), 2 (Draft), 3 (Active)
logoId	string Logo id uuid. It is obtained after a file upload
advertising	boolean
dismissible	boolean
	Array of objects
	object
	object

Responses

Request samples

Payload

Content type

application/json

{"title": "My first poll",
"language": "en",
"status": 2,
"logoId": "string",
"advertising": true,
"dismissible": true,
"questions": [{"id": "id-string",
"body": "What city do you like the most?",
"type": 1,
"required": false,
"hasDescription": false
},
{"id": "id-string",
"body": "What city do you like the most and why?",
"type": 2,
"required": false,
"hasDescription": false
},
{"id": "id-string",
"body": "What city do you like the most?",
"type": 3,
"required": false,
"hasDescription": false,
"multipleChoice": true,
"choices": ["London",
"Paris",
"Barcelona",
"Berlin",
"Budapest"
]
},
{"id": "id-string",
"body": "How much do you like Paris?",
"type": 4,
"required": false,
"labels": true,
"choices": ["low",
"medium",
"high"
],
"hasDescription": false
},
{"id": "id-string",
"body": "On a scale from 1 to 5 how much do you like Barcelona?",
"type": 5,
"required": false,
"labels": true,
"steps": 5,
"choices": ["low",
"medium",
"high"
],
"hasDescription": true,
"shape": 2,
"description": "This is some extra description."
},
{"id": "id-string",
"body": "On a scale from 1 to 5 how much do you like London?",
"type": 6,
"labels": true,
"steps": 5,
"choices": ["low",
"medium",
"high"
],
"hasDescription": false
},
{"id": "id-string",
"body": "What is your email address?",
"type": 7,
"required": false,
"hasDescription": false
},
{"id": "id-string",
"body": "What is your phone number?",
"type": 8,
"required": false,
"hasDescription": false
},
{"id": "id-string",
"body": "What is your website address?",
"type": 9,
"required": false,
"hasDescription": false
},
{"id": "id-string",
"body": "What is your birth date?",
"type": 10,
"required": false,
"hasDescription": false
}
],
"appearance": {"mainColor": "#0C635A",
"backgroundColor": "#FFFFFF",
"bubblePosition": 1,
"hPadding": 10,
"vPadding": 10
},
"targeting": {"showOn": [[{"type": 1,
"value": "example.com"
},
{"type": 2,
"value": "http://www.example.com?example=example"
},
{"type": 3,
"value": "example.com"
},
{"type": 4,
"value": "example"
},
{"type": 5,
"value": "example=example"
}
]
],
"hideOn": [[{"type": 1,
"value": "example.com"
},
{"type": 2,
"value": "http://www.example.com?example=example"
},
{"type": 3,
"value": "example.com"
},
{"type": 4,
"value": "example"
}
]
]
}
}

Response samples

200
4xx
5xx

Content type

application/json

{"payload": {"id": "string-id",
"createdAt": 1664345317,
"title": "My first poll",
"language": "en",
"status": 2,
"advertising": true,
"questions": [{"id": "id-string",
"body": "What city do you like the most?",
"type": 1,
"required": false,
"choices": null,
"createdAt": 1664345317,
"description": null,
"inBank": false,
"labels": null,
"multipleChoice": null,
"shape": null,
"steps": null
},
{"id": "id-string",
"body": "What city do you like the most and why?",
"type": 2,
"required": false,
"choices": null,
"createdAt": 1664345317,
"description": null,
"inBank": false,
"labels": null,
"multipleChoice": null,
"shape": null,
"steps": null
},
{"id": "id-string",
"body": "What city do you like the most?",
"type": 3,
"required": false,
"choices": ["London",
"Paris",
"Barcelona",
"Berlin",
"Budapest"
],
"createdAt": 1664345317,
"description": null,
"inBank": false,
"labels": null,
"multipleChoice": true,
"shape": null,
"steps": null
},
{"id": "id-string",
"body": "How much do you like Paris?",
"type": 4,
"required": false,
"choices": ["low",
"medium",
"high"
],
"createdAt": 1664345317,
"description": null,
"inBank": false,
"labels": true,
"multipleChoice": null,
"shape": null,
"steps": null
},
{"id": "id-string",
"body": "On a scale from 1 to 5 how much do you like Barcelona?",
"type": 5,
"required": false,
"choices": ["low",
"medium",
"high"
],
"createdAt": 1664345317,
"description": "This is some extra description.",
"inBank": false,
"labels": true,
"multipleChoice": null,
"shape": 2,
"steps": 5
},
{"id": "id-string",
"body": "On a scale from 1 to 5 how much do you like London?",
"type": 6,
"required": false,
"choices": ["low",
"medium",
"high"
],
"createdAt": 1664345317,
"description": null,
"inBank": false,
"labels": true,
"multipleChoice": null,
"shape": null,
"steps": 5
},
{"id": "id-string",
"body": "What is your email address?",
"type": 7,
"required": false,
"choices": null,
"createdAt": 1664345317,
"description": null,
"inBank": false,
"labels": null,
"multipleChoice": null,
"shape": null,
"steps": null
},
{"id": "id-string",
"body": "What is your phone number?",
"type": 8,
"required": false,
"choices": null,
"createdAt": 1664345317,
"description": null,
"inBank": false,
"labels": null,
"multipleChoice": null,
"shape": null,
"steps": null
},
{"id": "id-string",
"body": "What is your website address?",
"type": 9,
"required": false,
"choices": null,
"createdAt": 1664345317,
"description": null,
"inBank": false,
"labels": null,
"multipleChoice": null,
"shape": null,
"steps": null
},
{"id": "id-string",
"body": "What is your birth date?",
"type": 10,
"required": false,
"choices": null,
"createdAt": 1664345317,
"description": null,
"inBank": false,
"labels": null,
"multipleChoice": null,
"shape": null,
"steps": null
}
],
"appearance": {"mainColor": "#0C635A",
"backgroundColor": "#FFFFFF",
"estimatedTimeToComplete": 5
},
"targeting": {"showOn": [[{"type": 1,
"value": "example.com"
},
{"type": 2,
"value": "http://www.example.com?example=example"
},
{"type": 3,
"value": "example.com"
},
{"type": 4,
"value": "example"
},
{"type": 5,
"value": "example=example"
}
]
],
"hideOn": [[{"type": 1,
"value": "example.com"
},
{"type": 2,
"value": "http://www.example.com?example=example"
},
{"type": 3,
"value": "example.com"
},
{"type": 4,
"value": "example"
}
]
]
}
}
}

Delete Poll

Authentication is needed. For that, the request should have authorization header Authorization:Bearer token-string-value. Also logged in user can see only his own website data (otherwise 403 status code will be received).

Authorizations:

bearerAuth

path Parameters

websiteId required	string <uuid> (uuid) Example: 06d99a32-ee11-11eb-830a-0146de130018 ID of a website
pollId required	string ID of a poll. Pattern is [a-f\d]{24}

Responses

Response samples

4xx
5xx

Content type

application/json

{"error": {"code": "server_error",
"message": "this is error response",
"details": { }
}
}

Activate/Deactivate Poll

Authentication is needed. For that, the request should have authorization header Authorization:Bearer token-string-value. Also logged in user can see only his own website data (otherwise 403 status code will be received).

Authorizations:

bearerAuth

path Parameters

websiteId required	string <uuid> (uuid) Example: 06d99a32-ee11-11eb-830a-0146de130018 ID of a website
pollId required	string ID of a poll. Pattern is [a-f\d]{24}

Request Body schema: application/json

status

integer

Available options are 1 (Inactive), 3 (Active)

Responses

Request samples

Payload

Content type

application/json

{"status": 3
}

Response samples

4xx
5xx

Content type

application/json

{"error": {"code": "server_error",
"message": "this is error response",
"details": { }
}
}

Get Polls count for website

Authentication is needed. For that, the request should have authorization header Authorization:Bearer token-string-value. Also logged in user can see only his own website data (otherwise 403 status code will be received).

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

Responses

Response samples

200
4xx
5xx

Content type

application/json

{"payload": {"count": 3
}
}

Get Poll Text Question Answers

Authentication is needed. For that, the request should have authorization header Authorization:Bearer token-string-value. Also logged in user can see only his own website data (otherwise 403 status code will be received). This endpoint will return avalid response only for question having type 1 (Short Answer). For any other question types will return nulls in response

Authorizations:

bearerAuth

path Parameters

websiteId required	string <uuid> (uuid) Example: 06d99a32-ee11-11eb-830a-0146de130018 ID of a website
pollId required	string ID of a poll. Pattern is [a-f\d]{24}
questionId required	string ID of a poll question. Pattern is [a-f\d]{24}

Responses

Response samples

200
4xx
5xx

Content type

application/json

{"payload": {"id": "string-id",
"type": 1,
"body": "What city do you like the most?",
"description": "This is some extra description.",
"answerCount": 6,
"answers": [{"body": "I like Paris",
"visitor": null,
"createdAt": 1664345317
},
{"body": "Barcelona",
"visitor": null,
"createdAt": 1664345417
},
{"body": "None",
"visitor": null,
"createdAt": 1664345427
},
{"body": "What question is this?",
"visitor": null,
"createdAt": 1664346317
},
{"body": "this is a test response",
"visitor": null,
"createdAt": 1664346417
},
{"body": "NewYork",
"visitor": null,
"createdAt": 1664346617
}
]
}
}

Create Poll Question Answer For Public

Authentication is not needed.

path Parameters

websiteId required	string <uuid> (uuid) Example: 06d99a32-ee11-11eb-830a-0146de130018 ID of a website
pollId required	string ID of a poll. Pattern is [a-f\d]{24}
questionId required	string ID of a poll question. Pattern is [a-f\d]{24}

Request Body schema: application/json

body	string Represents the answer for Short Answer, Long Answer, Email, Website, Phone, Date
value	integer Represents the answer for Slider, Rating, Rating Scale
choices	Array of arrays
visitorKey	string
shownAt	integer <timestamp>

Responses

Request samples

Payload

Content type

application/json

{"body": "My first answer",
"value": 2,
"choices": ["choice1",
"choice3"
],
"visitorKey": "string",
"shownAt": 1608209339
}

Response samples

4xx
5xx

Content type

application/json

{"error": {"code": "server_error",
"message": "this is error response",
"details": { }
}
}

Get Poll for Target

Authentication not needed. Poll questions and appearance will always be included in the response.

Authorizations:

bearerAuth

path Parameters

websiteId required	string <uuid> (uuid) Example: 06d99a32-ee11-11eb-830a-0146de130018 ID of a website
pollId required	string ID of a poll. Pattern is [a-f\d]{24}

query Parameters

	string Current page url. Needs to be a valid url. Used to decide if poll should be displayed
	string Visitor key. Used to decide if poll should be displayed

Responses

Response samples

200
4xx
5xx

Content type

application/json

{"payload": {"id": "string-id",
"createdAt": 1664345317,
"title": "My first poll",
"language": "en",
"logoId": "id-string",
"status": 3,
"advertising": true,
"questions": [{"id": "id-string",
"body": "What city do you like the most?",
"type": 1,
"required": false,
"choices": null,
"createdAt": 1664345317,
"description": null,
"inBank": false,
"labels": null,
"multipleChoice": null,
"shape": null,
"steps": null
},
{"id": "id-string",
"body": "What city do you like the most and why?",
"type": 2,
"required": false,
"choices": null,
"createdAt": 1664345317,
"description": null,
"inBank": false,
"labels": null,
"multipleChoice": null,
"shape": null,
"steps": null
},
{"id": "id-string",
"body": "What city do you like the most?",
"type": 3,
"required": false,
"choices": ["London",
"Paris",
"Barcelona",
"Berlin",
"Budapest"
],
"createdAt": 1664345317,
"description": null,
"inBank": false,
"labels": null,
"multipleChoice": true,
"shape": null,
"steps": null
},
{"id": "id-string",
"body": "How much do you like Paris?",
"type": 4,
"required": false,
"choices": ["low",
"medium",
"high"
],
"createdAt": 1664345317,
"description": null,
"inBank": false,
"labels": true,
"multipleChoice": null,
"shape": null,
"steps": null
},
{"id": "id-string",
"body": "On a scale from 1 to 5 how much do you like Barcelona?",
"type": 5,
"required": false,
"choices": ["low",
"medium",
"high"
],
"createdAt": 1664345317,
"description": "This is some extra description.",
"inBank": false,
"labels": true,
"multipleChoice": null,
"shape": 2,
"steps": 5
},
{"id": "id-string",
"body": "On a scale from 1 to 5 how much do you like London?",
"type": 6,
"required": false,
"choices": ["low",
"medium",
"high"
],
"createdAt": 1664345317,
"description": null,
"inBank": false,
"labels": true,
"multipleChoice": null,
"shape": null,
"steps": 5
},
{"id": "id-string",
"body": "What is your email address?",
"type": 7,
"required": false,
"choices": null,
"createdAt": 1664345317,
"description": null,
"inBank": false,
"labels": null,
"multipleChoice": null,
"shape": null,
"steps": null
},
{"id": "id-string",
"body": "What is your phone number?",
"type": 8,
"required": false,
"choices": null,
"createdAt": 1664345317,
"description": null,
"inBank": false,
"labels": null,
"multipleChoice": null,
"shape": null,
"steps": null
},
{"id": "id-string",
"body": "What is your website address?",
"type": 9,
"required": false,
"choices": null,
"createdAt": 1664345317,
"description": null,
"inBank": false,
"labels": null,
"multipleChoice": null,
"shape": null,
"steps": null
},
{"id": "id-string",
"body": "What is your birth date?",
"type": 10,
"required": false,
"choices": null,
"createdAt": 1664345317,
"description": null,
"inBank": false,
"labels": null,
"multipleChoice": null,
"shape": null,
"steps": null
}
],
"appearance": {"mainColor": "#0C635A",
"backgroundColor": "#FFFFFF",
"bubblePosition": 1,
"hPadding": 10,
"vPadding": 10
}
}
}

Get Poll Logo for Public

Authentication is not needed

path Parameters

websiteId required	string <uuid> (uuid) Example: 06d99a32-ee11-11eb-830a-0146de130018 ID of a website
pollId required	string ID of a poll. Pattern is [a-f\d]{24}

Responses

Response samples

4xx
5xx

Content type

application/json

{"error": {"code": "server_error",
"message": "this is error response",
"details": { }
}
}

Poll dismiss for Public

path Parameters

websiteId required	string <uuid> (uuid) Example: 06d99a32-ee11-11eb-830a-0146de130018 ID of a website
pollId required	string ID of a poll. Pattern is [a-f\d]{24}

Request Body schema: application/json

visitorKey

string

Represents the visitor key for which poll should be dismissed

Responses

Request samples

Payload

Content type

application/json

{"visitorKey": "visitor-id"
}

Response samples

4xx
5xx

Content type

application/json

{"error": {"code": "server_error",
"message": "this is error response",
"details": { }
}
}

Get All Polls Average Completion Rate

Authentication is needed. For that, the request should have authorization header Authorization:Bearer token-string-value. Also logged in user can see only his own website data (otherwise 403 status code will be received).

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

Responses

Response samples

200
4xx
5xx

Content type

application/json

{"payload": {"average-completion-rate": 25.5
}
}

Get All Polls Responses Count

Authentication is needed. For that, the request should have authorization header Authorization:Bearer token-string-value. Also logged in user can see only his own website data (otherwise 403 status code will be received).

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

Responses

Response samples

200
4xx
5xx

Content type

application/json

{"payload": {"count": 400
}
}

Get All Polls Initiates

Authentication is needed. For that, the request should have authorization header Authorization:Bearer token-string-value. Also logged in user can see only his own website data (otherwise 403 status code will be received).

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

Responses

Response samples

200
4xx
5xx

Content type

application/json

{"payload": {"count": 10
}
}

Get Poll Results

Authentication is needed. For that, the request should have authorization header Authorization:Bearer token-string-value. Also logged in user can see only his own website data (otherwise 403 status code will be received).

Authorizations:

bearerAuth

path Parameters

websiteId required	string <uuid> (uuid) Example: 06d99a32-ee11-11eb-830a-0146de130018 ID of a website
pollId required	string ID of a poll. Pattern is [a-f\d]{24}

Responses

Response samples

200
4xx
5xx

Content type

application/json

{"payload": {"totalAnswersCount": 131,
"questions": [{"id": "id-string",
"type": 1,
"body": "What city do you like the most?",
"description": "Question Short Answer Description",
"answerCount": 20,
"answer": [{"body": "answer short 1",
"visitor": null,
"createdAt": 1597939200
}
]
},
{"id": "id-string",
"body": "What city do you like the most and why?",
"type": 2,
"description": "Question Long Answer Description",
"answerCount": 20,
"answer": [{"body": "answer long 1",
"visitor": null,
"createdAt": 1597939200
}
]
},
{"id": "id-string",
"body": "What city do you like the most?",
"description": "Question Multiple Choice Description",
"type": 3,
"required": false,
"answerCount": 17,
"answers": [{"London": 1
},
{"Paris": 0
},
{"Barcelona": 10
},
{"Berlin": 4
},
{"Budapest": 2
}
]
},
{"id": "id-string",
"body": "How much do you like Paris?",
"description": "Question Slider Description",
"type": 4,
"labels": ["low",
"medium",
"high"
],
"answerCount": 16,
"average": 10
},
{"id": "id-string",
"body": "On a scale from 1 to 5 how much do you like Barcelona?",
"description": "Question Rating Description",
"type": 5,
"labels": ["low",
"medium",
"high"
],
"answerCount": 15,
"answers": [1,
7,
7
]
},
{"id": "id-string",
"body": "On a scale from 1 to 5 how much do you like London?",
"type": 6,
"description": "Question Scale Description",
"labels": ["low",
"medium",
"high"
],
"answerCount": 15,
"answers": [1,
6,
8
]
},
{"id": "id-string",
"body": "What is your email address?",
"description": "Question Email Description",
"type": 7,
"answerCount": 10,
"answers": [{"body": "my-email",
"visitor": null,
"createdAt": 1597939200
}
]
},
{"id": "id-string",
"body": "What is your phone number?",
"description": "Question Phone Description",
"type": 8,
"answerCount": 10,
"answers": [{"body": "my-phone",
"visitor": null,
"createdAt": 1597939200
}
]
},
{"id": "id-string",
"body": "What is your website address?",
"description": "Question Website Description",
"type": 9,
"answerCount": 5,
"answers": [{"body": "my-website",
"visitor": null,
"createdAt": 1597939200
}
]
},
{"id": "id-string",
"body": "What is your birth date?",
"description": "Question Date Description",
"type": 10,
"answerCount": 3,
"answers": [{"body": "my-birthday",
"visitor": null,
"createdAt": 1597939200
}
]
}
]
}
}

Get Poll General Stats

Authentication is needed. For that, the request should have authorization header Authorization:Bearer token-string-value. Also logged in user can see only his own website data (otherwise 403 status code will be received).

Authorizations:

bearerAuth

path Parameters

websiteId required	string <uuid> (uuid) Example: 06d99a32-ee11-11eb-830a-0146de130018 ID of a website
pollId required	string ID of a poll. Pattern is [a-f\d]{24}

Responses

Response samples

200
4xx
5xx

Content type

application/json

{"payload": {"pollId": "poll-id",
"initiates": 6,
"responses": 6,
"averageCompletionTime": 50,
"completionRate": 25.5,
"answersPerQuestion": [20,
20,
17,
16,
15,
15,
10,
10,
5,
3
],
"dismissals": 1
}
}

Get Poll Participants

Authentication is needed. For that, the request should have authorization header Authorization:Bearer token-string-value. Also logged in user can see only his own website data (otherwise 403 status code will be received).

Authorizations:

bearerAuth

path Parameters

websiteId required	string <uuid> (uuid) Example: 06d99a32-ee11-11eb-830a-0146de130018 ID of a website
pollId required	string ID of a poll. Pattern is [a-f\d]{24}

query Parameters

page	integer Example: page=1 Page to be requested
pageSize	integer Example: pageSize=20 Number of items per page to be requested

Responses

Response samples

200
4xx
5xx

Content type

application/json

{"payload": {"total": 131,
"items": [{"visitorKey": "string-id",
"type": 0,
"location": "RO",
"deviceType": "desktop",
"platform": "linux",
"browser": "Chrome",
"completionTime": 5,
"completionRate": 100,
"completedAt": 1597939200
}
]
}
}

Filter Poll Participants

Authentication is needed. For that, the request should have authorization header Authorization:Bearer token-string-value. Also logged in user can see only his own website data (otherwise 403 status code will be received).

Authorizations:

bearerAuth

path Parameters

websiteId required	string <uuid> (uuid) Example: 06d99a32-ee11-11eb-830a-0146de130018 ID of a website
pollId required	string ID of a poll. Pattern is [a-f\d]{24}

query Parameters

page	integer Example: page=1 Page to be requested
pageSize	integer Example: pageSize=20 Number of items per page to be requested

Request Body schema: application/json

	object
	object

Responses

Request samples

Payload

Content type

application/json

{"visitor": {"is": ["all"
],
"isNot": ["new"
]
},
"location": {"is": ["DE",
"FR"
],
"isNot": ["RO",
"FR"
]
}
}

Response samples

200
4xx
5xx

Content type

application/json

{"payload": {"total": 131,
"items": [{"visitorKey": "string-id",
"type": 0,
"location": "RO",
"deviceType": "desktop",
"platform": "linux",
"browser": "Chrome",
"completionTime": 5,
"completionRate": 100,
"completedAt": 1597939200
}
]
}
}

Get Poll Visitor Responses

Authentication is needed. For that, the request should have authorization header Authorization:Bearer token-string-value. Also logged in user can see only his own website data (otherwise 403 status code will be received).

Authorizations:

bearerAuth

path Parameters

websiteId required	string <uuid> (uuid) Example: 06d99a32-ee11-11eb-830a-0146de130018 ID of a website
pollId required	string ID of a poll. Pattern is [a-f\d]{24}
visitorId required	string ID of a visitor. Pattern is [-\w.]+

Responses

Response samples

200
4xx
5xx

Content type

application/json

{"payload": {"visitorType": 1,
"responses": [{"questionType": 1,
"questionContent": "What city do you like the most?",
"questionAnswer": "answer short 1"
},
{"questionType": 2,
"questionContent": "What city do you like the most and why?",
"questionAnswer": "answer long 1"
},
{"questionType": 3,
"questionContent": "What city do you like the most?",
"questionAnswer": "London, Paris"
},
{"questionType": 4,
"questionContent": "How much do you like Paris?",
"questionAnswer": "75%"
},
{"questionType": 5,
"questionContent": "On a scale from 1 to 5 how much do you like Barcelona?",
"questionAnswer": "2/5"
},
{"questionType": 6,
"questionContent": "On a scale from 1 to 5 how much do you like London?",
"questionAnswer": "2/5"
},
{"questionType": 7,
"questionContent": "What is your email address?",
"questionAnswer": "my-email"
},
{"questionType": 8,
"questionContent": "What is your phone number?",
"questionAnswer": "my-phone"
},
{"questionType": 9,
"questionContent": "What is your website address?",
"questionAnswer": "my-website"
},
{"questionType": 10,
"questionContent": "What is your birth date?",
"questionAnswer": "my-birthday"
}
]
}
}

Files

Operations about website files

Themes

Operations about website themes

Theme

No authentication is needed.

query Parameters

supportCenterDomain

string

Example: supportCenterDomain=test.com

Responses

Response samples

200
4xx
5xx

Content type

application/json

{"payload": {"supportCenterUrl": "{SUPPORT_CENTER_URL}",
"privacyPolicyUrl": "{PRIVACY_POLICY_URL}",
"imprintUrl": "{IMPRINT_URL}",
"companyName": "{COMPANY_NAME}",
"fontName": "{FONT_NAME}",
"theme": {"colors": {"primary": "{PRIMARY_COLOR}",
"secondary": "{SECONDARY_COLOR}",
"tertiary": "{TERTIARY_COLOR}",
"positive": "{POSITIVE_COLOR}",
"negative": "{NEGATIVE_COLOR}",
"neutral": "{NEUTRAL_COLOR}"
}
},
"logoUrl": "{LOGO_DATA}",
"logoAlt": "{LOGO_ALT_TEXT}"
}
}

Stats

Operations about website stats

Page Visits Stats

Get all website visits within a specified time range and organizes them by day. Also calculates the count of visits for a previous period with the same duration. The results are sorted by day and consider the specified timezone for the data

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12.1,
13.2
]
]
}
]
}

Bounce Rate Stats

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-08-09T23%3A59%3A59.999%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter.
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Responses

Response samples

200
4xx
5xx

Content type

application/json

{"payload": {"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12.1,
13.2
]
]
}
]
}
}

Bounce Rate Stats

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-08-09T23%3A59%3A59.999%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter.
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Request Body schema: application/json
optional

object

Responses

Request samples

Payload

Content type

application/json

{"where": {"and": [{"member": "string",
"operator": "string",
"values": [{"type": "string",
"category": ["string"
]
}
]
}
]
}
}

Response samples

200
4xx
5xx

Content type

application/json

{"payload": {"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12.1,
13.2
]
]
}
]
}
}

Page Referrers Stats

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
page	integer Example: page=1 Page to be requested
pageSize	integer Example: pageSize=20 Number of items per page to be requested
referrerUrl	string Example: referrerUrl=https://google.com the url of the referrer page
pageViewUrl	string Example: pageViewUrl=https://google.com the url of the page
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"meta": {"page": 1,
"pageSize": 10,
"total": 30,
"pageTotal": 9
},
"payload": {"totalCount": 100,
"pageReferrers": [{"url": "https://google.com",
"count": 100
}
]
}
}

Page Internal Referrers Stats

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
page	integer Example: page=1 Page to be requested
pageSize	integer Example: pageSize=20 Number of items per page to be requested
referrerUrl	string Example: referrerUrl=https://google.com the url of the referrer page
pageViewUrl	string Example: pageViewUrl=https://google.com the url of the page
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"meta": {"page": 1,
"pageSize": 10,
"total": 30,
"pageTotal": 9
},
"payload": {"totalCount": 100,
"pageReferrers": [{"url": "https://google.com",
"count": 100
}
]
}
}

Bounce Rate Period

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Responses

Response samples

200
4xx
5xx

Content type

application/json

{"payload": {"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12.1,
13.2
]
]
}
]
}
}

Bounce Rate Stats

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-08-09T23%3A59%3A59.999%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter.
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Request Body schema: application/json
optional

object

Responses

Request samples

Payload

Content type

application/json

{"where": {"and": [{"member": "string",
"operator": "string",
"values": [{"type": "string",
"category": ["string"
]
}
]
}
]
}
}

Response samples

200
4xx
5xx

Content type

application/json

{"payload": {"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12.1,
13.2
]
]
}
]
}
}

Average Session Duration Stats Deprecated

Deprecated: Use /v2/websites/{websiteId}/analytics/sessions instead.

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Request Body schema: application/json
optional

object

Responses

Request samples

Payload

Content type

application/json

{"where": {"and": [{"member": "string",
"operator": "string",
"values": [{"type": "string",
"category": ["string"
]
}
]
}
]
}
}

Response samples

200
4xx
5xx

Content type

application/json

{"payload": {"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12.1,
13.2
]
]
}
]
}
}

User Sessions Stats Deprecated

Deprecated: Use /v2/websites/{websiteId}/analytics/sessions instead.

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12.1,
13.2
]
]
}
]
}

Average Session Pages Stats

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12.1,
13.2
]
]
}
]
}

Notification Settings

Operations about notification settings for standard reports (daily/weekly/monthly)

Get Notification Settings

Authentication is needed. For that, the request should have authorization header Authorization:Bearer token-string-value. Also logged in user can see only his own website data (otherwise 403 status code will be received).

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

Responses

Response samples

200
4xx
5xx

Content type

application/json

{"payload": {"websiteKey": "string-id",
"emailList": [{"value": "email@address.com",
"verified": true
}
],
"reportType": 1
}
}

Update Notification Settings

Authentication is needed. For that, the request should have authorization header Authorization:Bearer token-string-value. Also logged in user can see only his own website data (otherwise 403 status code will be received).

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

Request Body schema: application/json

reportType

string

Responses

Request samples

Payload

Content type

application/json

{"reportType": "1"
}

Response samples

200
4xx
5xx

Content type

application/json

{"payload": {"websiteKey": "string-id",
"emailList": [{"value": "email@address.com",
"verified": true
}
],
"reportType": 1
}
}

Remove Email From List For Notification Settings

Authentication is needed. For that, the request should have authorization header Authorization:Bearer token-string-value. Also logged in user can see only his own website data (otherwise 403 status code will be received).

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

Request Body schema: application/json

email

string

Email Address To Remove From Notification Settings

Responses

Request samples

Payload

Content type

application/json

{"email": "email3@address.com"
}

Response samples

202
4xx
5xx

Content type

application/json

{"payload": {"websiteKey": "string-id",
"emailList": [{"value": "email@address.com",
"verified": true
}
],
"reportType": 1
}
}

Add Email In List For Notification Settings

Authentication is needed. For that, the request should have authorization header Authorization:Bearer token-string-value. Also logged in user can see only his own website data (otherwise 403 status code will be received).

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

Request Body schema: application/json

email

string

New Email Address Added to Notification Settings

Responses

Request samples

Payload

Content type

application/json

{"email": "email3@address.com"
}

Response samples

200
4xx
5xx

Content type

application/json

{"payload": {"websiteKey": "string-id",
"emailList": [{"value": "email3@address.com",
"verified": false
}
],
"reportType": 1
}
}

Confirm Email From List For Notification Settings

Authentication is needed. For that, the request should have authorization header Authorization:Bearer token-string-value. Also logged in user can see only his own website data (otherwise 403 status code will be received).

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

Request Body schema: application/json

email	string
token	string

Responses

Request samples

Payload

Content type

application/json

{"email": "email3@address.com",
"token": "valid-jwt-token"
}

Response samples

204
4xx
5xx

Content type

application/json

{ }

Resend Confirm Email For Email in List For Notification Settings

Authentication is needed. For that, the request should have authorization header Authorization:Bearer token-string-value. Also logged in user can see only his own website data (otherwise 403 status code will be received).

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

Request Body schema: application/json

email

string

Responses

Request samples

Payload

Content type

application/json

{"email": "email3@address.com"
}

Response samples

200
4xx
5xx

Content type

application/json

{"payload": {"websiteKey": "string-id",
"emailList": [{"value": "email3@address.com",
"verified": true
}
],
"reportType": 1
}
}

Notification Settings ABE

Operations about notification settings for ABE reports

Get ABE Notification Settings

Authentication is needed. For that, the request should have authorization header Authorization:Bearer token-string-value. Also logged in user can see only his own website data (otherwise 403 status code will be received).

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

Responses

Response samples

200
4xx
5xx

Content type

application/json

{"payload": {"websiteKey": "string-id",
"abeEmailList": [{"value": "email@address.com",
"verified": true
}
],
"abeActivated": true,
"abeWebsiteErrorsThreshold": {"limit": 30,
"interval": 25
},
"abeNegativeEventsThreshold": {"limit": 25,
"interval": 25
}
}
}

Update ABE Notification Settings

Authentication is needed. For that, the request should have authorization header Authorization:Bearer token-string-value. Also logged in user can see only his own website data (otherwise 403 status code will be received).

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

Request Body schema: application/json

abeActivated	boolean optional
	object optional
	object optional

Responses

Request samples

Payload

Content type

application/json

{"abeActivated": true,
"abeWebsiteErrorsThreshold": {"limit": 30,
"interval": 25
},
"abeNegativeEventsThreshold": {"limit": 25,
"interval": 25
}
}

Response samples

200
4xx
5xx

Content type

application/json

{"payload": {"websiteKey": "string-id",
"abeEmailList": [{"value": "email@address.com",
"verified": true
}
],
"abeActivated": true,
"abeWebsiteErrorsThreshold": {"limit": 30,
"interval": 25
},
"abeNegativeEventsThreshold": {"limit": 25,
"interval": 25
}
}
}

Remove Email From List For ABE Notification Settings

Authentication is needed. For that, the request should have authorization header Authorization:Bearer token-string-value. Also logged in user can see only his own website data (otherwise 403 status code will be received).

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

Request Body schema: application/json

email

string

Email Address To Remove From ABE Notification Settings

Responses

Request samples

Payload

Content type

application/json

{"email": "email3@address.com"
}

Response samples

202
4xx
5xx

Content type

application/json

{"payload": {"websiteKey": "string-id",
"abeEmailList": [{"value": "email@address.com",
"verified": true
}
],
"abeActivated": true,
"abeWebsiteErrorsThreshold": {"limit": 30,
"interval": 25
},
"abeNegativeEventsThreshold": {"limit": 25,
"interval": 25
}
}
}

Add Email In List For ABE Notification Settings

Authentication is needed. For that, the request should have authorization header Authorization:Bearer token-string-value. Also logged in user can see only his own website data (otherwise 403 status code will be received).

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

Request Body schema: application/json

email

string

New Email Address Added to ABE Notification Settings

Responses

Request samples

Payload

Content type

application/json

{"email": "email3@address.com"
}

Response samples

200
4xx
5xx

Content type

application/json

{"payload": {"websiteKey": "string-id",
"abeEmailList": [{"value": "email3@address.com",
"verified": true
}
],
"abeActivated": true,
"abeWebsiteErrorsThreshold": {"limit": 30,
"interval": 25
},
"abeNegativeEventsThreshold": {"limit": 25,
"interval": 25
}
}
}

Confirm Email From List For ABE Notification Settings

Authentication is needed. For that, the request should have authorization header Authorization:Bearer token-string-value. Also logged in user can see only his own website data (otherwise 403 status code will be received).

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

Request Body schema: application/json

email	string
token	string

Responses

Request samples

Payload

Content type

application/json

{"email": "email3@address.com",
"token": "valid-jwt-token"
}

Response samples

204
4xx
5xx

Content type

application/json

{ }

Resend Confirm Email For Email in List For ABE Notification Settings

Authentication is needed. For that, the request should have authorization header Authorization:Bearer token-string-value. Also logged in user can see only his own website data (otherwise 403 status code will be received).

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

Request Body schema: application/json

email

string

Responses

Request samples

Payload

Content type

application/json

{"email": "email3@address.com"
}

Response samples

200
4xx
5xx

Content type

application/json

{"payload": {"websiteKey": "string-id",
"abeEmailList": [{"value": "email@address.com",
"verified": true
}
],
"abeActivated": true,
"abeWebsiteErrorsThreshold": {"limit": 30,
"interval": 25
},
"abeNegativeEventsThreshold": {"limit": 25,
"interval": 25
}
}
}

Website

Operations about website

Get Wix Website

Authentication is needed. For that, the request should have authorization header Authorization:Bearer token-string-value. Also logged in user can see only his own website data (otherwise 403 status code will be received).

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

Responses

Response samples

200
4xx
5xx

Content type

application/json

{"url": "string",
"numberOfMonthlyVisits": 0,
"numberOfDashboardAccesses": 0,
"latestDashboardAccesses": [ ],
"frontendFlags": {"trackingCodeInstalled": true,
"trackingCodeIsInstalledChangedAt": 0,
"acceptedSsr": true,
"0-92816": true,
"lastACmodalViewedAt": 0,
"0-100720": true,
"0-100820": true,
"recordingsSettings": true
},
"metaSiteId": "string",
"email": "string",
"firstName": "string",
"lastName": "string",
"hasFirstLogin": true,
"timezone": "string",
"lastResetDate": 0,
"resetDataRequested": 0,
"migrationStatus": null,
"lastVisitTs": 0,
"isPayable": true,
"hadFirstVisit": true,
"installDate": 0,
"lastInstallDate": 0,
"anonymizeIps": true,
"consentlessTracking": true,
"maxPrivacyMode": true,
"eventTracking": true,
"eventAutoTracking": true,
"ignoreVisitsKey": "string",
"appDate": null,
"status": "string",
"platform": "string",
"country": "string",
"firstWeekDay": 0,
"locale": "string",
"currency": "string",
"companyName": "string",
"businessSector": 0,
"businessSize": "string",
"findUs": "string",
"street": "string",
"zipcode": "string",
"city": "string",
"state": "string",
"vat": "string",
"ipCountryISO": "string",
"crawlerStatus": {"lastSuccess": 0,
"last": { }
}
}

Update Wix Website

Authentication is needed. For that, the request should have authorization header Authorization:Bearer token-string-value. Also logged in user can see only his own website data (otherwise 403 status code will be received).

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

Request Body schema: application/json

url	string website url
email	string website email
firstName	string first name string
lastName	string last name string
timezone	string websites timezone
	object
metaSiteId	string meta site id from WIX
anonymizeIps	boolean true, if anonymize ips were set - DEPRECATED
consentlessTracking	boolean true, if consentless tracking was set
maxPrivacyMode	boolean true, if user chooses to max privacy mode - DEPRECATED
eventTracking	boolean true, if user chooses to track events
eventAutoTracking	boolean if user chooses the event auto tracking option for this website
country	string websites country
firstWeekDay	integer first week day chosen for this website
locale	string websites locale
currency	string websites currency; default EUR
company	string company name for the website
businessSector	integer business sector chosen for the website
businessSize	string business size chosen for the website
findUs	string response for "how did you find us?"
street	string street name
zipCode	string valid zipcode
city	string businesses address
state	string businesses address
vat	string vat identification

Responses

Request samples

Payload

Content type

application/json

{"url": "string",
"email": "string",
"firstName": "string",
"lastName": "string",
"timezone": "string",
"frontendFlags": {"trackingCodeInstalled": true,
"trackingCodeIsInstalledChangedAt": 0,
"acceptedSsr": true,
"0-92816": true,
"lastACmodalViewedAt": 0,
"0-100720": true,
"0-100820": true,
"recordingsSettings": true
},
"metaSiteId": "string",
"anonymizeIps": true,
"consentlessTracking": true,
"maxPrivacyMode": true,
"eventTracking": true,
"eventAutoTracking": true,
"country": "string",
"firstWeekDay": 0,
"locale": "string",
"currency": "string",
"company": "string",
"businessSector": 0,
"businessSize": "string",
"findUs": "string",
"street": "string",
"zipCode": "string",
"city": "string",
"state": "string",
"vat": "string"
}

Response samples

200
4xx
5xx

Content type

application/json

{"url": "string",
"numberOfMonthlyVisits": 0,
"numberOfDashboardAccesses": 0,
"latestDashboardAccesses": [ ],
"frontendFlags": {"trackingCodeInstalled": true,
"trackingCodeIsInstalledChangedAt": 0,
"acceptedSsr": true,
"0-92816": true,
"lastACmodalViewedAt": 0,
"0-100720": true,
"0-100820": true,
"recordingsSettings": true
},
"metaSiteId": "string",
"email": "string",
"firstName": "string",
"lastName": "string",
"hasFirstLogin": true,
"timezone": "string",
"lastResetDate": 0,
"resetDataRequested": 0,
"migrationStatus": null,
"lastVisitTs": 0,
"isPayable": true,
"hadFirstVisit": true,
"installDate": 0,
"lastInstallDate": 0,
"anonymizeIps": true,
"consentlessTracking": true,
"maxPrivacyMode": true,
"eventTracking": true,
"eventAutoTracking": true,
"ignoreVisitsKey": "string",
"appDate": null,
"status": "string",
"platform": "string",
"country": "string",
"firstWeekDay": 0,
"locale": "string",
"currency": "string",
"companyName": "string",
"businessSector": 0,
"businessSize": "string",
"findUs": "string",
"street": "string",
"zipcode": "string",
"city": "string",
"state": "string",
"vat": "string"
}

Get Website Feature Permissions

Authentication is needed. For that, the request should have authorization header Authorization:Bearer token-string-value. Also logged in user can see only his own website data (otherwise 403 status code will be received).

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

Responses

Response samples

200
4xx
5xx

Content type

application/json

{"visits": {"limit": 100000
},
"recordings": {"limit": 15
},
"heatmaps": {"limit": 2
},
"funnels": {"limit": 2
},
"polls": {"limit": 2
},
"surveys": {"limit": 2
},
"isPayable": true,
"ip2company": false,
"visitorSegments": false,
"customDashboard": false,
"countryBasedPrivacy": false,
"feedbackAdvertising": false,
"wixCycleType": 3,
"wixPermissionPack": 1,
"unlimitedVoucher": null
}

Website unsubscribe

Authentication is not needed. Unsubscribe the website from report or abe report or from newsletter list or al of them for provided email

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

email required	string Provided value is removed from listmonk
reportsDisableNotification	boolean When is true, the email value is removed from report's email list
abeReportsDisableNotification	boolean When is true, the email value is removed from abe report's email list

Responses

Response samples

4xx
5xx

Content type

application/json

{"error": {"code": "server_error",
"message": "this is error response",
"details": { }
}
}

Get WIX checkout url

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

Request Body schema: application/json

productId	string Represents the wix plan id
billingCycle	string Represents the plan's billing cycle. Only accepts "MONTHLY" or "YEARLY"
country	string (optional) Website's country code

Responses

Request samples

Payload

Content type

application/json

{"productId": "12342",
"billingCycle": "MONTHLY",
"country": "DE"
}

Response samples

200
4xx
5xx

Content type

application/json

{"redirectUrl": "string"
}

Get Website Payment Plans

Authentication is needed. For that, the request should have authorization header Authorization:Bearer token-string-value. Also logged in user can see only his own website data (otherwise 403 status code will be received).

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

sumoLimit

int

Provided value is optional, can be null or integer

Responses

Response samples

200

Content type

application/json

{"monthly": {"0": {"name": "Basic",
"price": 12.99,
"type": "monthly",
"oldPlanIds": [ ],
"weight": 200,
"active": true,
"order": 1,
"pageScanLimit": 7776000,
"key_service": 24395,
"key_service_unique": "Basic",
"permissions": [{"n": "VISITS_LIMIT",
"value": 500000
},
{"n": "SSR_LIMIT",
"value": 50000
},
{"n": "HEATMAPS_LIMIT",
"value": 25
},
{"n": "FUNNELS_LIMIT",
"value": 16
},
{"n": "POLLS_LIMIT",
"value": 7
},
{"n": "SURVEYS_LIMIT",
"value": 7
},
{"n": "EVENT_TRACKING_LIMIT",
"value": 100
}
],
"id": "24395"
}
},
"yearly": {"0": {"name": "Basic",
"price": 12.99,
"type": "yearly",
"oldPlanIds": [ ],
"weight": 200,
"active": true,
"order": 1,
"pageScanLimit": 7776000,
"key_service": 24395,
"key_service_unique": "Basic",
"permissions": [{"n": "VISITS_LIMIT",
"value": 500000
},
{"n": "SSR_LIMIT",
"value": 50000
},
{"n": "HEATMAPS_LIMIT",
"value": 25
},
{"n": "FUNNELS_LIMIT",
"value": 16
},
{"n": "POLLS_LIMIT",
"value": 7
},
{"n": "SURVEYS_LIMIT",
"value": 7
},
{"n": "EVENT_TRACKING_LIMIT",
"value": 100
}
],
"id": "24396"
}
}
}

Get Wix Payment Plans

Authorizations:

bearerAuth

Responses

Response samples

200

Content type

application/json

{"monthly": {"0": {"name": "Advanced",
"id": "premiumPackage2",
"price": 12.99,
"type": "wix",
"availabilty": "18250 days",
"flag": "w2m",
"oldPlanIds": [ ],
"weight": 200,
"active": true,
"pageScanLimit": 7776000,
"permissions": [{"n": "VISITS_LIMIT",
"value": 50000
},
{"n": "SSR_LIMIT",
"value": 5000
},
{"n": "HEATMAPS_LIMIT",
"value": 10
},
{"n": "FUNNELS_LIMIT",
"value": 4
},
{"n": "POLLS_LIMIT",
"value": 4
},
{"n": "SURVEYS_LIMIT",
"value": 4
},
{"n": "EVENT_TRACKING_LIMIT",
"value": 100
},
{"n": "FULL_DATA_HISTORY_ACCESS",
"value": "unlimited"
},
{"n": "ALARMING_BEHAVIOR_EVENTS",
"value": "unlimited"
},
{"n": "PRIVACY_FRIENDLY_ANALYTICS",
"value": "unlimited"
},
{"n": "UNLIMITED_EXPORTS",
"value": "unlimited"
},
{"n": "COMPANY_REVEAL",
"value": "unavailable"
},
{"n": "VISITOR_SEGMENTS",
"value": "unavailable"
},
{"n": "UNLIMITED_COLLABORATORS",
"value": "unavailable"
},
{"n": "CUSTOM_COUNTRY_DATA",
"value": "unavailable"
},
{"n": "CUSTOM_DASHBOARDS",
"value": "unavailable"
},
{"n": "UNLIMITED_API_ACCESS",
"value": "unavailable"
},
{"n": "PREMIUM_SUPPORT",
"value": "unavailable"
}
]
}
},
"yearly": {"0": {"name": "Advanced",
"id": "premiumPackage2",
"price": 12.99,
"type": "wix",
"availabilty": "18250 days",
"flag": "w2m",
"oldPlanIds": [ ],
"weight": 200,
"active": true,
"pageScanLimit": 7776000,
"permissions": [{"n": "VISITS_LIMIT",
"value": 50000
},
{"n": "SSR_LIMIT",
"value": 5000
},
{"n": "HEATMAPS_LIMIT",
"value": 10
},
{"n": "FUNNELS_LIMIT",
"value": 4
},
{"n": "POLLS_LIMIT",
"value": 4
},
{"n": "SURVEYS_LIMIT",
"value": 4
},
{"n": "EVENT_TRACKING_LIMIT",
"value": 100
},
{"n": "FULL_DATA_HISTORY_ACCESS",
"value": "unlimited"
},
{"n": "ALARMING_BEHAVIOR_EVENTS",
"value": "unlimited"
},
{"n": "PRIVACY_FRIENDLY_ANALYTICS",
"value": "unlimited"
},
{"n": "UNLIMITED_EXPORTS",
"value": "unlimited"
},
{"n": "COMPANY_REVEAL",
"value": "unavailable"
},
{"n": "VISITOR_SEGMENTS",
"value": "unavailable"
},
{"n": "UNLIMITED_COLLABORATORS",
"value": "unavailable"
},
{"n": "CUSTOM_COUNTRY_DATA",
"value": "unavailable"
},
{"n": "CUSTOM_DASHBOARDS",
"value": "unavailable"
},
{"n": "UNLIMITED_API_ACCESS",
"value": "unavailable"
},
{"n": "PREMIUM_SUPPORT",
"value": "unavailable"
}
]
}
}
}

Graph

Operations about graphs

Get Ecom Sessions Graph V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Request Body schema: application/json
required

	object
	Array of objects
	object
	object
	Array of objects
primaryDimension	string optional

Responses

Request samples

Payload

Content type

application/json

{"where": {"and": [{"member": "string",
"operator": "string",
"values": [{"type": "string",
"category": ["string"
]
}
]
}
]
},
"order": [{"member": "string",
"direction": "string",
"priority": 0
}
],
"timeframe": {"from": "2019-08-24T14:15:22Z",
"until": "2019-08-24T14:15:22Z"
},
"pagination": {"page": 0,
"pageSize": 0
},
"segments": [{"id": "string",
"conditions": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
}
}
],
"primaryDimension": "string"
}

Response samples

200
4XX
5xx

Content type

application/json

{"meta": {"page": 1,
"pageSize": 10,
"total": 30,
"pageTotal": 9
},
"payload": {"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12,
13
]
],
"total": 25.3,
"totalAverage": 12.6
}
]
}
}

Get Ecom Sessions Graph V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"meta": {"page": 1,
"pageSize": 10,
"total": 30,
"pageTotal": 9
},
"payload": {"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12,
13
]
],
"total": 25.3,
"totalAverage": 12.6
}
]
}
}

Get Ecom Customers Graph V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Request Body schema: application/json
required

	object
	Array of objects
	object
	object
	Array of objects
primaryDimension	string optional

Responses

Request samples

Payload

Content type

application/json

{"where": {"and": [{"member": "string",
"operator": "string",
"values": [{"type": "string",
"category": ["string"
]
}
]
}
]
},
"order": [{"member": "string",
"direction": "string",
"priority": 0
}
],
"timeframe": {"from": "2019-08-24T14:15:22Z",
"until": "2019-08-24T14:15:22Z"
},
"pagination": {"page": 0,
"pageSize": 0
},
"segments": [{"id": "string",
"conditions": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
}
}
],
"primaryDimension": "string"
}

Response samples

200
4XX
5xx

Content type

application/json

{"meta": {"page": 1,
"pageSize": 10,
"total": 30,
"pageTotal": 9
},
"payload": {"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12,
13
]
],
"total": 25.3,
"totalAverage": 12.6
}
]
}
}

Get Ecom Customers Graph V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"meta": {"page": 1,
"pageSize": 10,
"total": 30,
"pageTotal": 9
},
"payload": {"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12,
13
]
],
"total": 25.3,
"totalAverage": 12.6
}
]
}
}

Get Ecom Orders Graph V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Request Body schema: application/json
required

	object
	Array of objects
	object
	object
	Array of objects
primaryDimension	string optional

Responses

Request samples

Payload

Content type

application/json

{"where": {"and": [{"member": "string",
"operator": "string",
"values": [{"type": "string",
"category": ["string"
]
}
]
}
]
},
"order": [{"member": "string",
"direction": "string",
"priority": 0
}
],
"timeframe": {"from": "2019-08-24T14:15:22Z",
"until": "2019-08-24T14:15:22Z"
},
"pagination": {"page": 0,
"pageSize": 0
},
"segments": [{"id": "string",
"conditions": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
}
}
],
"primaryDimension": "string"
}

Response samples

200
4XX
5xx

Content type

application/json

{"meta": {"page": 1,
"pageSize": 10,
"total": 30,
"pageTotal": 9
},
"payload": {"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12,
13
]
],
"total": 25.3,
"totalAverage": 12.6
}
]
}
}

Get Ecom Orders Graph V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"meta": {"page": 1,
"pageSize": 10,
"total": 30,
"pageTotal": 9
},
"payload": {"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12,
13
]
],
"total": 25.3,
"totalAverage": 12.6
}
]
}
}

Get Ecom Sold Products Graph V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Request Body schema: application/json
required

	object
	Array of objects
	object
	object
	Array of objects
primaryDimension	string optional

Responses

Request samples

Payload

Content type

application/json

{"where": {"and": [{"member": "string",
"operator": "string",
"values": [{"type": "string",
"category": ["string"
]
}
]
}
]
},
"order": [{"member": "string",
"direction": "string",
"priority": 0
}
],
"timeframe": {"from": "2019-08-24T14:15:22Z",
"until": "2019-08-24T14:15:22Z"
},
"pagination": {"page": 0,
"pageSize": 0
},
"segments": [{"id": "string",
"conditions": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
}
}
],
"primaryDimension": "string"
}

Response samples

200
4XX
5xx

Content type

application/json

{"meta": {"page": 1,
"pageSize": 10,
"total": 30,
"pageTotal": 9
},
"payload": {"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12,
13
]
],
"total": 25.3,
"totalAverage": 12.6
}
]
}
}

Get Ecom Sold Products Graph V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"meta": {"page": 1,
"pageSize": 10,
"total": 30,
"pageTotal": 9
},
"payload": {"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12,
13
]
],
"total": 25.3,
"totalAverage": 12.6
}
]
}
}

Get Ecom Gross Revenue Graph V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Request Body schema: application/json
required

	object
	Array of objects
	object
	object
	Array of objects
primaryDimension	string optional

Responses

Request samples

Payload

Content type

application/json

{"where": {"and": [{"member": "string",
"operator": "string",
"values": [{"type": "string",
"category": ["string"
]
}
]
}
]
},
"order": [{"member": "string",
"direction": "string",
"priority": 0
}
],
"timeframe": {"from": "2019-08-24T14:15:22Z",
"until": "2019-08-24T14:15:22Z"
},
"pagination": {"page": 0,
"pageSize": 0
},
"segments": [{"id": "string",
"conditions": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
}
}
],
"primaryDimension": "string"
}

Response samples

200
4XX
5xx

Content type

application/json

{"meta": {"page": 1,
"pageSize": 10,
"total": 30,
"pageTotal": 9
},
"payload": {"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12.1,
13.2
]
],
"total": 25.3,
"totalAverage": 12.6
}
]
}
}

Get Ecom Gross Revenue Graph V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"meta": {"page": 1,
"pageSize": 10,
"total": 30,
"pageTotal": 9
},
"payload": {"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12.1,
13.2
]
],
"total": 25.3,
"totalAverage": 12.6
}
]
}
}

Get Ecom Net Revenue Graph V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Request Body schema: application/json
required

	object
	Array of objects
	object
	object
	Array of objects
primaryDimension	string optional

Responses

Request samples

Payload

Content type

application/json

{"where": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
},
"order": [{"member": "string",
"direction": "string",
"priority": 0
}
],
"timeframe": {"from": "2019-08-24T14:15:22Z",
"until": "2019-08-24T14:15:22Z"
},
"pagination": {"page": 0,
"pageSize": 0
},
"segments": [{"id": "string",
"conditions": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
}
}
],
"primaryDimension": "string"
}

Response samples

200
4XX
5xx

Content type

application/json

{"payload": {"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12.1,
13.2
]
]
}
]
}
}

Get Ecom Net Revenue Graph V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"payload": {"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12.1,
13.2
]
]
}
]
}
}

Get Ecom Session Purchase Ratio Graph V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Request Body schema: application/json
required

	object
	Array of objects
	object
	object
	Array of objects
primaryDimension	string optional

Responses

Request samples

Payload

Content type

application/json

{"where": {"and": [{"member": "string",
"operator": "string",
"values": [{"type": "string",
"category": ["string"
]
}
]
}
]
},
"order": [{"member": "string",
"direction": "string",
"priority": 0
}
],
"timeframe": {"from": "2019-08-24T14:15:22Z",
"until": "2019-08-24T14:15:22Z"
},
"pagination": {"page": 0,
"pageSize": 0
},
"segments": [{"id": "string",
"conditions": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
}
}
],
"primaryDimension": "string"
}

Response samples

200
4XX
5xx

Content type

application/json

{"meta": {"page": 1,
"pageSize": 10,
"total": 30,
"pageTotal": 9
},
"payload": {"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12.1,
13.2
]
],
"total": 25.3,
"totalAverage": 12.6
}
]
}
}

Get Ecom Session Purchase Ratio Graph V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"meta": {"page": 1,
"pageSize": 10,
"total": 30,
"pageTotal": 9
},
"payload": {"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12.1,
13.2
]
],
"total": 25.3,
"totalAverage": 12.6
}
]
}
}

Get Ecom Checkout Purchase Ratio Graph V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Request Body schema: application/json
required

	object
	Array of objects
	object
	object
	Array of objects
primaryDimension	string optional

Responses

Request samples

Payload

Content type

application/json

{"where": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
},
"order": [{"member": "string",
"direction": "string",
"priority": 0
}
],
"timeframe": {"from": "2019-08-24T14:15:22Z",
"until": "2019-08-24T14:15:22Z"
},
"pagination": {"page": 0,
"pageSize": 0
},
"segments": [{"id": "string",
"conditions": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
}
}
],
"primaryDimension": "string"
}

Response samples

200
4XX
5xx

Content type

application/json

{"payload": {"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12.1,
13.2
]
]
}
]
}
}

Get Ecom Checkout Purchase Ratio Graph V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"payload": {"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12.1,
13.2
]
]
}
]
}
}

Get Ecom Revenue By Product V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
items	integer Example: items=10 items
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Request Body schema: application/json
required

	object
	Array of objects
	object
	object
	Array of objects
primaryDimension	string optional

Responses

Request samples

Payload

Content type

application/json

{"where": {"and": [{"member": "string",
"operator": "string",
"values": [{"type": "string",
"category": ["string"
]
}
]
}
]
},
"order": [{"member": "string",
"direction": "string",
"priority": 0
}
],
"timeframe": {"from": "2019-08-24T14:15:22Z",
"until": "2019-08-24T14:15:22Z"
},
"pagination": {"page": 0,
"pageSize": 0
},
"segments": [{"id": "string",
"conditions": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
}
}
],
"primaryDimension": "string"
}

Response samples

200
4XX
5xx

Content type

application/json

{"meta": {"page": 1,
"pageSize": 10,
"total": 30,
"pageTotal": 9
},
"payload": {"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12.1,
13.2
]
],
"total": 25.3,
"totalAverage": 12.6,
"itemId": "uuid-uuid-uuid-uuid"
}
]
}
}

Get Ecom Revenue By Product V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
items	integer Example: items=10 items
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"meta": {"page": 1,
"pageSize": 10,
"total": 30,
"pageTotal": 9
},
"payload": {"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12.1,
13.2
]
],
"total": 25.3,
"totalAverage": 12.6,
"itemId": "uuid-uuid-uuid-uuid"
}
]
}
}

Get Ecom Units Sold By Product V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
items	integer Example: items=10 items
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Request Body schema: application/json
required

	object
	Array of objects
	object
	object
	Array of objects
primaryDimension	string optional

Responses

Request samples

Payload

Content type

application/json

{"where": {"and": [{"member": "string",
"operator": "string",
"values": [{"type": "string",
"category": ["string"
]
}
]
}
]
},
"order": [{"member": "string",
"direction": "string",
"priority": 0
}
],
"timeframe": {"from": "2019-08-24T14:15:22Z",
"until": "2019-08-24T14:15:22Z"
},
"pagination": {"page": 0,
"pageSize": 0
},
"segments": [{"id": "string",
"conditions": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
}
}
],
"primaryDimension": "string"
}

Response samples

200
4XX
5xx

Content type

application/json

{"meta": {"page": 1,
"pageSize": 10,
"total": 30,
"pageTotal": 9
},
"payload": {"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12.1,
13.2
]
],
"total": 25.3,
"totalAverage": 12.6,
"itemId": "uuid-uuid-uuid-uuid"
}
]
}
}

Get Ecom Units Sold By Product V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
items	integer Example: items=10 items
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"meta": {"page": 1,
"pageSize": 10,
"total": 30,
"pageTotal": 9
},
"payload": {"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12.1,
13.2
]
],
"total": 25.3,
"totalAverage": 12.6,
"itemId": "uuid-uuid-uuid-uuid"
}
]
}
}

Get Ecom Checkout Initiated Graph V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Request Body schema: application/json
required

	object
	Array of objects
	object
	object
	Array of objects
primaryDimension	string optional

Responses

Request samples

Payload

Content type

application/json

{"where": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
},
"order": [{"member": "string",
"direction": "string",
"priority": 0
}
],
"timeframe": {"from": "2019-08-24T14:15:22Z",
"until": "2019-08-24T14:15:22Z"
},
"pagination": {"page": 0,
"pageSize": 0
},
"segments": [{"id": "string",
"conditions": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
}
}
],
"primaryDimension": "string"
}

Response samples

200
4XX
5xx

Content type

application/json

{"payload": {"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12,
13
]
]
}
]
}
}

Get Ecom Checkout Initiated Graph V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"payload": {"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12,
13
]
]
}
]
}
}

Get Ecom Cart Viewed Graph V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Request Body schema: application/json
required

	object
	Array of objects
	object
	object
	Array of objects
primaryDimension	string optional

Responses

Request samples

Payload

Content type

application/json

{"where": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
},
"order": [{"member": "string",
"direction": "string",
"priority": 0
}
],
"timeframe": {"from": "2019-08-24T14:15:22Z",
"until": "2019-08-24T14:15:22Z"
},
"pagination": {"page": 0,
"pageSize": 0
},
"segments": [{"id": "string",
"conditions": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
}
}
],
"primaryDimension": "string"
}

Response samples

200
4XX
5xx

Content type

application/json

{"payload": {"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12,
13
]
]
}
]
}
}

Get Ecom Cart Viewed Graph V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"payload": {"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12,
13
]
]
}
]
}
}

Get Ecom Traffic Structure Overview V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Request Body schema: application/json
required

	object
	Array of objects
	object
	object
	Array of objects
primaryDimension	string optional

Responses

Request samples

Payload

Content type

application/json

{"where": {"and": [{"member": "string",
"operator": "string",
"values": [{"type": "string",
"category": ["string"
]
}
]
}
]
},
"order": [{"member": "string",
"direction": "string",
"priority": 0
}
],
"timeframe": {"from": "2019-08-24T14:15:22Z",
"until": "2019-08-24T14:15:22Z"
},
"pagination": {"page": 0,
"pageSize": 0
},
"segments": [{"id": "string",
"conditions": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
}
}
],
"primaryDimension": "string"
}

Response samples

200
4XX
5xx

Content type

application/json

{"payload": {"from": "2019-08-24T14:15:22Z",
"until": "2019-08-24T14:15:22Z",
"points": [{"channelType": 0,
"values": [{"company": "string",
"value": 0
}
]
}
]
}
}

Get Ecom Traffic Structure Overview V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"payload": {"from": "2019-08-24T14:15:22Z",
"until": "2019-08-24T14:15:22Z",
"points": [{"channelType": 0,
"values": [{"company": "string",
"value": 0
}
]
}
]
}
}

Get Ecom Traffic Structure In Depth V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Request Body schema: application/json
required

	object
	Array of objects
	object
	object
	Array of objects
primaryDimension	string optional

Responses

Request samples

Payload

Content type

application/json

{"where": {"and": [{"member": "string",
"operator": "string",
"values": [{"type": "string",
"category": ["string"
]
}
]
}
]
},
"order": [{"member": "string",
"direction": "string",
"priority": 0
}
],
"timeframe": {"from": "2019-08-24T14:15:22Z",
"until": "2019-08-24T14:15:22Z"
},
"pagination": {"page": 0,
"pageSize": 0
},
"segments": [{"id": "string",
"conditions": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
}
}
],
"primaryDimension": "string"
}

Response samples

200
4XX
5xx

Content type

application/json

{"meta": {"page": 1,
"pageSize": 10,
"total": 30,
"pageTotal": 9
},
"payload": {"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12,
13
]
]
}
]
}
}

Get Ecom Traffic Structure In Depth V2

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"meta": {"page": 1,
"pageSize": 10,
"total": 30,
"pageTotal": 9
},
"payload": {"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12,
13
]
]
}
]
}
}

Alarming Events

Operations about alarming events

Get alarming events

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-08-09T23%3A59%3A59.999%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter.
page	integer Example: page=1 Page to be requested
pageSize	integer Example: pageSize=20 Number of items per page to be requested
group required	string Enum: "trigger" "page" Example: group=trigger Groups the results
	Array of objects Example: order=count.asc,percentOfTotal.desc,percentage_change.desc Orders the results from query by name in ascending or descending order.
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Request Body schema: application/json
required

	object
	Array of objects
	object

Responses

Request samples

Payload

Content type

application/json

{"where": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
},
"order": [{"member": "string",
"direction": "string",
"priority": 0
}
],
"pagination": {"page": 0,
"pageSize": 0
}
}

Response samples

200
4XX
5xx

Content type

application/json

{"payload": [{"trigger": "deadClicks",
"count": 10,
"percentOfTotal": 40.35,
"firstAppearance": 1664345317,
"lastAppearance": 1664345317,
"previousCount": 5,
"changeInPercentage": 35.35
}
],
"meta": {"page": 1,
"pageSize": 10,
"total": 30,
"pageTotal": 9
}
}

Get alarming events graph

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
type required	string Enum: "time-series" "pie" "bar" Example: type=time-series
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Request Body schema: application/json
required

object

Responses

Request samples

Payload

Content type

application/json

{"where": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
}
}

Response samples

200
4XX
5xx

Content type

application/json

{"payload": {"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12.1,
13.2
]
]
}
]
},
"meta": {"page": 1,
"pageSize": 10,
"total": 30,
"pageTotal": 9
}
}

Get alarming events graph

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
type required	string Enum: "time-series" "pie" "bar" Example: type=time-series
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"payload": {"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12.1,
13.2
]
]
}
]
},
"meta": {"page": 1,
"pageSize": 10,
"total": 30,
"pageTotal": 9
}
}

Get website usability based on % of sessions having ABEs in the form of a graph

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Request Body schema: application/json
required

object

Responses

Request samples

Payload

Content type

application/json

{"where": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
}
}

Response samples

200
4XX
5xx

Content type

application/json

{"payload": {"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12.1,
13.2
]
]
}
]
},
"meta": {"page": 1,
"pageSize": 10,
"total": 30,
"pageTotal": 9
}
}

Get alarming events page count

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"payload": {"deadClicks": 10,
"rageClicks": 10,
"rapidReloads": 10,
"uTurns": 10,
"scrolls": 10,
"mouseMoves": 10
}
}

Get problematic sessions graph

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
type required	string Enum: "time-series" "pie" "bar" Example: type=time-series

Request Body schema: application/json
required

object

Responses

Request samples

Payload

Content type

application/json

{"where": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
}
}

Response samples

200
4XX
5xx

Content type

application/json

{"payload": {"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12.1,
13.2
]
]
}
]
},
"meta": {"page": 1,
"pageSize": 10,
"total": 30,
"pageTotal": 9
}
}

Get problematic sessions graph

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-07-11T00%3A00%3A00.000%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter
unit required	string Enum: "day" "week" "month" "year" Example: unit=day
type required	string Enum: "time-series" "pie" "bar" Example: type=time-series
timezone	string Timezone of the user.

header Parameters

X-Timezone

string

Timezone of the user.

Responses

Response samples

200
4XX
5xx

Content type

application/json

{"payload": {"labels": ["2022-06-22T15:46:47Z",
"2022-06-22T16:46:47Z"
],
"datasets": [{"label": "label",
"data": [[12.1,
13.2
]
]
}
]
},
"meta": {"page": 1,
"pageSize": 10,
"total": 30,
"pageTotal": 9
}
}

UTM Campaigns

Operations about utm campaigns

Get My Campaigns

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-08-09T23%3A59%3A59.999%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter.
page	integer Example: page=1 Page to be requested
pageSize	integer Example: pageSize=20 Number of items per page to be requested
timezone	string Timezone of the user.
order required	string Enum: "desc" "asc" Example: order=adCampaignLabel.desc,numVisits.asc,visitors.desc,maxVisits.asc Orders the results from query ascending or descending.

header Parameters

X-Timezone

string

Timezone of the user.

Request Body schema: application/json

object

Responses

Request samples

Payload

Content type

application/json

{"where": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
}
}

Response samples

200
4xx
5xx

Content type

application/json

{"payload": [{"campaignKey": "string",
"campaignName": "string",
"firstVisit": 0,
"visitors": 0,
"previousVisitors": 0,
"visits": 0,
"previousVisits": 0,
"topDate": {"date": 0,
"visits": 0
},
"topVisitedPages": [{"url": "string",
"visits": 0
}
],
"topVisitorsCountries": [{"country": "string",
"visits": 0
}
]
}
],
"meta": {"page": 1,
"pageSize": 10,
"total": 30,
"pageTotal": 9
}
}

Get My Campaigns

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-08-09T23%3A59%3A59.999%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter.
page	integer Example: page=1 Page to be requested
pageSize	integer Example: pageSize=20 Number of items per page to be requested
timezone	string Timezone of the user.
order required	string Enum: "desc" "asc" Example: order=adCampaignLabel.desc,numVisits.asc,visitors.desc,maxVisits.asc Orders the results from query ascending or descending.

header Parameters

X-Timezone

string

Timezone of the user.

Responses

Response samples

200
4xx
5xx

Content type

application/json

{"payload": [{"campaignKey": "string",
"campaignName": "string",
"firstVisit": 0,
"visitors": 0,
"previousVisitors": 0,
"visits": 0,
"previousVisits": 0,
"topDate": {"date": 0,
"visits": 0
},
"topVisitedPages": [{"url": "string",
"visits": 0
}
],
"topVisitorsCountries": [{"country": "string",
"visits": 0
}
]
}
],
"meta": {"page": 1,
"pageSize": 10,
"total": 30,
"pageTotal": 9
}
}

Get Campaign Info

Authorizations:

bearerAuth

path Parameters

websiteId required	string <uuid> (uuid) Example: 06d99a32-ee11-11eb-830a-0146de130018 ID of a website
campaignId required	string <uuid> (uuid) Example: 06d99a32-ee11-11eb-830a-0146de130018 ID of a UTM campaign

Responses

Response samples

200
4xx
5xx

Content type

application/json

{"payload": {"adCampaignLabel": "string"
},
"meta": {"page": 1,
"pageSize": 10,
"total": 30,
"pageTotal": 9
}
}

Get Basic KPIs

Authorizations:

bearerAuth

path Parameters

websiteId required	string <uuid> (uuid) Example: 06d99a32-ee11-11eb-830a-0146de130018 ID of a website
campaignId required	string <uuid> (uuid) Example: 06d99a32-ee11-11eb-830a-0146de130018 ID of a UTM campaign

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-08-09T23%3A59%3A59.999%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter.
page	integer Example: page=1 Page to be requested
pageSize	integer Example: pageSize=20 Number of items per page to be requested
timezone	string Timezone of the user.
order required	string Enum: "desc" "asc" Example: order=adCampaignContent.asc,adCampaignTerm.desc,adCampaignMedium.asc,adCampaignSource.asc,adCampaignSourcePlatform.desc,adCampaignCreativeFormat.asc,adCampaignMarketingTactic.desc,newVisitors.asc,returningVisitors.asc,sessions.asc,numVisits.asc,averageSessionDuration.desc,averageBounceRate.asc Orders the results from query ascending or descending.

header Parameters

X-Timezone

string

Timezone of the user.

Request Body schema: application/json

object

Responses

Request samples

Payload

Content type

application/json

{"where": {"and": [{"member": "string",
"operator": "string",
"values": [{ }
]
}
]
}
}

Response samples

200
4xx
5xx

Content type

application/json

{"payload": [{"adCampaignSource": "string",
"adCampaignMedium": "string",
"adCampaignTerm": "string",
"adCampaignContent": "string",
"adCampaignSourcePlatform": "string",
"adCampaignCreativeFormat": "string",
"adCampaignMarketingTactic": "string",
"newVisitors": 0,
"previousNewVisitors": 0,
"returningVisitors": 0,
"previousReturningVisitors": 0,
"visits": 0,
"previousVisits": 0,
"sessions": 0,
"previousSessions": 0,
"averageSessionDuration": 0,
"previousAverageSessionDuration": 0,
"averageBounceRate": 0,
"previousAverageBounceRate": 0
}
],
"meta": {"page": 1,
"pageSize": 10,
"total": 30,
"pageTotal": 9
}
}

Get Basic KPIs

Authorizations:

bearerAuth

path Parameters

websiteId required	string <uuid> (uuid) Example: 06d99a32-ee11-11eb-830a-0146de130018 ID of a website
campaignId required	string <uuid> (uuid) Example: 06d99a32-ee11-11eb-830a-0146de130018 ID of a UTM campaign

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-08-09T23%3A59%3A59.999%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter.
page	integer Example: page=1 Page to be requested
pageSize	integer Example: pageSize=20 Number of items per page to be requested
timezone	string Timezone of the user.
order required	string Enum: "desc" "asc" Example: order=adCampaignContent.asc,adCampaignTerm.desc,adCampaignMedium.asc,adCampaignSource.asc,adCampaignSourcePlatform.desc,adCampaignCreativeFormat.asc,adCampaignMarketingTactic.desc,newVisitors.asc,returningVisitors.asc,sessions.asc,numVisits.asc,averageSessionDuration.desc,averageBounceRate.asc Orders the results from query ascending or descending.

header Parameters

X-Timezone

string

Timezone of the user.

Responses

Response samples

200
4xx
5xx

Content type

application/json

{"payload": [{"adCampaignSource": "string",
"adCampaignMedium": "string",
"adCampaignTerm": "string",
"adCampaignContent": "string",
"adCampaignSourcePlatform": "string",
"adCampaignCreativeFormat": "string",
"adCampaignMarketingTactic": "string",
"newVisitors": 0,
"previousNewVisitors": 0,
"returningVisitors": 0,
"previousReturningVisitors": 0,
"visits": 0,
"previousVisits": 0,
"sessions": 0,
"previousSessions": 0,
"averageSessionDuration": 0,
"previousAverageSessionDuration": 0,
"averageBounceRate": 0,
"previousAverageBounceRate": 0
}
],
"meta": {"page": 1,
"pageSize": 10,
"total": 30,
"pageTotal": 9
}
}

Get the values of UTM campaign parameters

Authorizations:

bearerAuth

path Parameters

websiteId

required

string <uuid> (uuid)

Example: 06d99a32-ee11-11eb-830a-0146de130018

ID of a website

query Parameters

from required	string <date-time> (urlEncodedISO8601) Example: from=2024-08-09T23%3A59%3A59.999%2B02%3A00 Lower bound date filter
until required	string <date-time> (urlEncodedISO8601) Example: until=2024-08-09T23%3A59%3A59.999%2B02%3A00 Upper bound date filter.
fields	Array of strings Items Enum: "label" "term" "source" "medium" "content" "platform" "creativeFormat"

TWIPLA API (Alpha Version - Work in Progress) (V2)

Overview

Introduction

Pagination

Time Filtering

Field Filtering

Grouping

Ordering

Time series

Parameters

Authentication

Create Standard Token

Request Body schema: application/jsonrequired

Responses

Request samples

Response samples

Refresh Standard Token

Request Body schema: application/jsonrequired

Responses

Request samples

Response samples

Create 3AS Token

Request Body schema: application/jsonrequired

Responses

Request samples

Response samples

Visits

Visits graph data V2

Authorizations:

path Parameters

query Parameters

Responses

Response samples

Visits graph filtered data V2

Authorizations:

path Parameters

query Parameters

Request Body schema: application/jsonrequired

Responses

Request samples

Response samples

Visits V2

Authorizations:

path Parameters

query Parameters

Request Body schema: application/jsonoptional

Responses

Request samples

Response samples

Visits count

Authorizations:

path Parameters

query Parameters

header Parameters

Responses

Response samples

Visit charts by period

Authorizations:

path Parameters

query Parameters

header Parameters

Responses

Response samples

Page Visits Stats

Authorizations:

path Parameters

query Parameters

header Parameters

Responses

Response samples

Visits by company name

Authorizations:

path Parameters

query Parameters

Responses

Response samples

Overview page visits

Authorizations:

path Parameters

query Parameters

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
optional

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required