List Analytics Data
The raw data that powers Guru's Analytics Dashboard is available for export.
API Endpoint
GET /v1/teams/{teamId}/analytics?fromDate=&toDate=
URL Parameters
teamId
the ID of the Team
Query Parameters
All query parameters are optional.
-
fromDate
indicates the request should return all events with a date greater than or equal to this date -
toDate
indicates the request should return all events with a date less than or equal to this date
The date value in the fromDate
and toDate
query parameters must be in one of the ISO-8601 formats...
yyyy-MM-ddZ
(i.e. 2015-02-01+04:00
)
yyyy-MM-ddTHH:mmZ
(i.e. 2015-02-01T15:01+04:00
)
yyyy-MM-ddTHH:mm:ssZ
(i.e. 2015-02-01T15:01:30+04:00
)
yyyy-MM-ddTHH:mm:ss.SSSZ
(i.e. 2015-02-01T15:01:30.000+04:00
)
NOTE - If you do not give a timezone in your request, it will default to +00:00
.
Sample Request
To return all analytics events since January 1st, 2016 at 5:30am UTC, a fromDate
of 2016-01-01T05:30:00+00:00
is specified. When URL encoding the query parameters, the full URL is as follows...
https://api.getguru.com/api/v1/teams/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/analytics?fromDate=2016-01-01T05:30:00+00:00
To return all analytics events between September 4th, 2020 and Septermber 7th, 2020 (including all events on the 7th), a fromDate
of 2020-09-04T00:00:00
is specified and a toDate
of 2020-09-08T00:00:00
https://api.getguru.com/api/v1/teams/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/analytics?fromDate=2020-09-04T00:00:00&toDate=2020-09-08T00:00:00
Sample Response
The response will contain an array of event objects. Fields include...
-
eventType
string value indicating the type of event -
eventDate
the date the event occurred, in ISO-8601 format -
user
email address of the user performing the event -
properties
map of key-value pairs. Values vary depending on the event type. The most common property iscardId
and is the ID of the card the event applies to
Results for these calls can be paged. See the Paging documentation for more information.
[
{
"type" : "fact-viewed",
"user" : "[email protected]",
"eventDate" : "2016-01-20T03:10:11.351+0000",
"properties" : {
"cardId" : "yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy"
}
},
...
]
Analytics Event Types
Below is a list of event types that our API Analytics tracks:
-
card-created
a new card as been published -
card-comment-created
a user has commented on a card -
card-copied
a user either copied the content within the card or clicked on the "Card Copied content" button while viewing a card -
card-deleted
a card has been archived -
card-favorited
a user clicked the heart icon to add the card to "My Favorite Card" list -
card-shared-to-team
a user made a private card to a team shared card or created a new card which is team shared -
card-updated
a user made edits to a card -
card-verified
a user has verified a card -
card-viewed
a user clicked & viewed a card -
card-unfavorited
a user removed a card from their "My Favorite Card" list -
search
a user performed a type ahead search and click on one of the Top Title Matches or typed in the search bar to see the Search Results -
board-created
a user created a new folder within a Collection -
board-updated
a user edited an existing folder within a Collection -
board-deleted
a user deleted an existing folder within a Collection -
board-viewed
a user viewed an existing folder within a Collection -
card-link-copied
a user clicked on the "Card Copy link" button while viewing a card -
card-file-link-viewed
a user viewed a link to a file that is uploaded to a card and displayed in the card's file viewer -
question-answered
a user answered a question in the "Ask the Experts" feature -
question-created
a user created a question in the "Ask the Experts" feature -
question-deleted
a user deleted a question in the "Ask the Experts" feature -
login
a user logged into Guru
Updated 10 months ago