Analytics

Get workspace analytics

Viewing analytics aggregated across videos: by default every video shared with the workspace, or with scope=mine only the videos you created. Includes the same summary, plays per day, retention, geography and referrer breakdowns as a single video, plus the videos ranked by plays. Only topVideos is paginated; pass pagination.nextCursor as cursor for the next page. Dates are whole UTC days; omit both for all time.

get/v1/analytics

Query parameters

startDatestring

First day of the range, inclusive, as YYYY-MM-DD in UTC. Omit to start from the first recorded view.

Example:2026-01-01

First day of the range, inclusive, as YYYY-MM-DD in UTC. Omit to start from the first recorded view.

endDatestring

Last day of the range, inclusive, as YYYY-MM-DD in UTC. Omit to run through today.

Example:2026-01-01

Last day of the range, inclusive, as YYYY-MM-DD in UTC. Omit to run through today.

timezonestring

IANA time zone used to bucket viewsOverTime into days (default: UTC)

Example:America/New_York

IANA time zone used to bucket viewsOverTime into days (default: UTC)

scope'workspace' | 'mine'

workspace: every video shared with the workspace. mine: videos the authenticated user created.

Example:workspace

Which videos to aggregate (default: workspace)

limitinteger

Top videos per page (default: 20, max: 100)

Example:20

Top videos per page (default: 20, max: 100)

cursorstring

Opaque cursor for the next page of top videos, from the previous response's pagination.nextCursor

Response

endDatestring nullable required

The endDate that was applied, or null for no upper bound

scope'workspace' | 'mine' required

workspace: every video shared with the workspace. mine: videos the authenticated user created.

startDatestring nullable required

The startDate that was applied, or null for no lower bound

timezonestring required

Time zone used to bucket viewsOverTime

Example response

{
  "geoBreakdown": [
    {
      "country": "US"
    }
  ],
  "pagination": {
    "hasMore": true,
    "nextCursor": "eyJpZCI6IjEyMyJ9"
  },
  "referrerBreakdown": [
    {
      "referrerDomain": "linkedin.com"
    }
  ],
  "retention": [
    {
      "percent": 42
    }
  ],
  "scope": "workspace",
  "summary": {
    "avgPercentViewed": 63.5,
    "pageOpens": 1610,
    "totalViews": 1280,
    "totalWatchTimeSeconds": 48210.4,
    "uniqueSessions": 940
  },
  "timezone": "UTC",
  "topVideos": [
    {
      "avgPercentViewed": 71.2,
      "name": "Q3 product update",
      "videoId": "vid_abc123def456"
    }
  ],
  "viewsOverTime": [
    {
      "date": "2026-01-14"
    }
  ]
}

Changes

Changed in 2 of the 18 revisions of this API.91

Sep 28, 2026ac47c99c144f9See the full diff
- ●
  added the new edit_conflict enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new edit_conflict enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new edit_conflict enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new edit_conflict enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new edit_conflict enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new edit_conflict enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new edit_conflict enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new edit_conflict enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new edit_conflict enum value to the response property for the response status
  response-property-enum-value-added
Sep 13, 20266bf5f3a6bf731See the full diff
- ○
  endpoint added
  endpoint-added

Of the 18 revisions, 1 has no diff computed.

Full history