Engagement

GET /api/analytics/engagement

Per-second retention curve for one content item.

Requires analytics.read. See Overview for shared parameters and category scope.

Parameters

Parameter	Required	Description
`contentId`	Yes	Video id or live event id
`contentType`	No	`vod` (default) or `live`
`from`, `to`	No	ISO 8601 range
`maxSeconds`	No	Cap the retention curve length

Request


curl -X GET "https://app.ignitevideo.cloud/api/analytics/engagement?contentId=VIDEO_ID&contentType=vod" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response


{
  "contentType": "vod" | "live",
  "contentId": string,
  "from": string,
  "to": string,
  "totalSessions": number,
  "retention": [
    {
      "second": number,
      "watched": number,
      "reached": number,
      "watchedRatio": number,
      "reachedRatio": number
    },
    [...]
  ]
}