Event data

Summarize properties by event

GET/api/websites/{websiteId}/event-data/events

Returns property names, types, and counts grouped by event name. When an event is specified, also groups by property value.

Headers

Name	Type	Description
Authorizationrequired	string	Authentication credentials, e.g. `Bearer <token>`.

Name	Type	Description
websiteIdrequired	string	ID of the website.

Name	Type	Description
startAtrequired	integer	Start of the date range as a Unix timestamp in milliseconds.
endAtrequired	integer	End of the date range as a Unix timestamp in milliseconds.
event	string	Filter by custom event name.
path	string	Filter by page URL path.
referrer	string	Filter by referring URL.
title	string	Filter by page title.
query	string	Filter by page URL query string.
os	string	Operating system used by the visitor.
browser	string	Browser used by the visitor.
device	string	Device category used by the visitor.
country	string	Country code of the visitor.
region	string	Region or subdivision of the visitor.
city	string	City of the visitor.
tag	string	Tag attached to the tracked activity.
hostname	string	Hostname on which the activity occurred.
distinctId	string	Custom identifier assigned to the visitor.
language	string	Preferred language reported by the visitor browser.
utmSource	string	UTM campaign source.
utmMedium	string	UTM campaign medium.
utmCampaign	string	UTM campaign name.
utmContent	string	UTM campaign content.
utmTerm	string	UTM campaign search term.
excludeBounce	string	Set a non-empty value to exclude visits with only one pageview.
segment	string	ID of a saved segment used to filter results.
cohort	string	ID of a saved cohort used to filter visitors.
eventType	integer	Event type: 1 for a pageview or 2 for a custom event.
match	enum<string>	Whether records must match all filters or any filter. Options: `all`, `any`

200The operation completed successfully.

Name	Type	Description
dataTyperequired	number	Data type of the custom property.
eventName	string	Name of the custom event.
propertyNamerequired	string	Name of the custom event or session property.
propertyValue	string	Value of the custom property.
totalrequired	number

200 example

[
  {
    "dataType": 0,
    "eventName": "string",
    "propertyName": "string",
    "propertyValue": "string",
    "total": 0
  }
]

400Bad request.

Name	Type	Description
errorrequired	object	Error details returned when the operation fails.

400 example

{
  "error": {
    "code": "bad-request",
    "message": "Bad request.",
    "status": 400
  }
}

401Unauthorized.

Name	Type	Description
errorrequired	object	Error details returned when the operation fails.

401 example

{
  "error": {
    "code": "unauthorized",
    "message": "Unauthorized.",
    "status": 401
  }
}

cURL

curl -X GET 'https://api.example.com/api/websites/{websiteId}/event-data/events?startAt=0&endAt=0' \
  -H 'Authorization: Bearer <token>'