# ai_analytics_engagement_orgs_videos_retrieve

Get video engagement metrics on a per-course basis.

This endpoint provides a paginated list of courses with video engagement metrics
including view counts, completion rates, and time spent on videos.

Query Parameters:
    page (int, optional): Page number for pagination
    length (int, optional): Number of items per page

Returns:
    A paginated list of courses with their video engagement metrics.

Endpoint: GET /api/ai-analytics/engagement/orgs/{org}/videos/
Version: 3.59.0-ai-plus
Security: PlatformApiKeyAuthentication

## Query parameters:

  - `department_id` (integer)
    When  is passed, it allows to filter data for only user content groups for the specified department

  - `format` (string)
    Format

*  - json
    Enum: "json"

  - `include_main_platform` (boolean)
    Include main platform data

  - `length` (integer)
    Size of data to return

  - `page` (integer)
    Page offset

## Path parameters:

  - `org` (string, required)

## Response 200 fields (application/json):

  - `data` (array)

  - `data.name` (string, required)
    Course name

  - `data.course_id` (string, required)
    edx Course Id

  - `data.num_vids` (integer, required)
    Number of videos in course

  - `data.num_watched` (integer, required)
    Number of videos watched

  - `data.time_watched` (integer, required)
    Total time spent by all users watching videos

  - `data.avg_percent_watched` (number, required)
    Average percentage of videos watched per user per course

  - `data.avg_time_watched` (number, required)
    Average time spent per learner

  - `pagination` (object, required)

  - `pagination.totalItems` (integer, required)
    Total records

  - `pagination.currentPage` (integer, required)
    Current Page

  - `pagination.perPage` (integer, required)
    Size of data returned per page

  - `pagination.totalPages` (integer, required)
    Amount of pages