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 is cardId 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-favoriteda 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