videosSummary

Query

Summarizes videos over a time range.

Response

Returns VideosSummary

Arguments

Name	Type	Description
`startTime`	`DateTimeOffset!`	Start time for the summary.
`endTime`	`DateTimeOffset!`	End time for the summary.
`filter`	`FilterVideosSummaryInput`	If provided, only summarize videos matching the filter.
`bucketingStrategy`	`BucketingStrategy!`	How to bucket videos. Defaults to `ACTIVE`. Default: `ACTIVE`
`videosBucket`	`VideosSummaryBucketType`	If provided, group the summary buckets by the provided grouping types.

Example

query videosSummary(
  $startTime: DateTimeOffset!,
  $endTime: DateTimeOffset!,
  $filter: FilterVideosSummaryInput,
  $bucketingStrategy: BucketingStrategy!,
  $videosBucket: VideosSummaryBucketType
) {
  videosSummary(
    startTime: $startTime,
    endTime: $endTime,
    filter: $filter,
    bucketingStrategy: $bucketingStrategy,
    videosBucket: $videosBucket
  ) {
    total
    startedCount
    endedCount
    summaryStatistics {
      duration {
        min
        average
        max
      }
    }
    buckets {
      key {
        __typename
      }
      total
      startedCount
      endedCount
      summaryStatistics {
        __typename
      }
    }
    highestTotalBuckets {
      key {
        __typename
      }
      total
    }
  }
}

{
  "startTime": "2025-01-01T00:00:00.000Z",
  "endTime": "2025-01-01T00:00:00.000Z",
  "bucketingStrategy": "ACTIVE"
}

{
  "data": {
    "videosSummary": {
      "total": 666,
      "startedCount": 387,
      "endedCount": 288,
      "summaryStatistics": {
        "duration": {
          "min": "PT1H",
          "average": "PT1H",
          "max": "PT1H"
        }
      },
      "buckets": [
        {
          "key": {
            "__typename": "VideosSummaryBucketKey"
          },
          "total": 62,
          "startedCount": 543,
          "endedCount": 409,
          "summaryStatistics": {
            "__typename": "VideosSummaryStatistics"
          }
        }
      ],
      "highestTotalBuckets": [
        {
          "key": {
            "__typename": "VideosSummaryBucketKey"
          },
          "total": 345
        }
      ]
    }
  }
}