Analytics

Get video analytics

Viewing analytics for one video: plays, unique sessions, watch time, plays per day, retention per one-percent slice, geography, referrers, UTM traffic sources, and call-to-action clicks. Available to the video's creator, its collaborators, and workspace members it is shared with. Dates are whole UTC days; omit both for all time.

get/v1/videos/{id}/analytics

Path parameters

idstring required

Unique video identifier

Example:vid_abc123def456

Unique video identifier

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)

Response

ctaClicksinteger required

Clicks on the video's call-to-action button in the range

endDatestring nullable required

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

startDatestring nullable required

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

timezonestring required

Time zone used to bucket viewsOverTime

videoIdstring required

Example response

{
  "ctaClicks": 37,
  "geoBreakdown": [
    {
      "country": "US"
    }
  ],
  "referrerBreakdown": [
    {
      "referrerDomain": "linkedin.com"
    }
  ],
  "retention": [
    {
      "percent": 42
    }
  ],
  "summary": {
    "avgPercentViewed": 63.5,
    "pageOpens": 1610,
    "totalViews": 1280,
    "totalWatchTimeSeconds": 48210.4,
    "uniqueSessions": 940
  },
  "timezone": "UTC",
  "trafficSources": [
    {
      "campaign": "launch-week",
      "medium": "email",
      "source": "newsletter"
    }
  ],
  "videoId": "vid_abc123def456",
  "viewsOverTime": [
    {
      "date": "2026-01-14"
    }
  ]
}

Changes

Changed in 2 of the 19 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 19 revisions, 1 has no diff computed.

Full history