---
title: "Get Videos"
method: GET
path: "/admin/tutorial-video-metrics/videos"
tags: ["admin_tutorial_video_metrics"]
---

# Get Videos

`GET /admin/tutorial-video-metrics/videos`

## Request

- Base URL: `https://api.excellence-ai.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.excellence-ai.com/admin/tutorial-video-metrics/videos`
- Auth: OAuth 2 (password, token URL `api/login`)

One row per video key and file: a dubbed file published under a new
URL shows next to the AI-voice one instead of being averaged with it.

## Query parameters

- `start` string, date-time
- `end` string, date-time
- `device` string
- `school_id` string, nullable
- `rating` integer, nullable
- `rating_max` integer, nullable
- `video_key` string, nullable

## Response `200`

Successful Response

- TutorialVideoBreakdownRow[]
  - `video_key` string, required
  - `video_url` string, nullable
  - `video_title` string, nullable
  - `ratings_count` integer, required
  - `average_rating` number, required
  - `high_rating_rate` number, required
  - `min_duration_seconds` number, nullable
  - `max_duration_seconds` number, nullable
  - `first_rated_at` string, date-time, required
  - `last_rated_at` string, date-time, required
  - `likes_count` integer

## Other responses

- `422`: Validation Error

## Changes

> 55 revisions in range; 1 not diffed.

- **2026-10-23** `aa42640c0a6b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/excellence-ai/apis/excellence-learning/changes/admin/tutorial-video-metrics/videos/get.md)

---

[API](https://skmtc.dev/excellence-ai/apis/excellence-learning.md) - [All operations](https://skmtc.dev/excellence-ai/apis/excellence-learning/llms.txt) - [OpenAPI document](https://skmtc.dev/excellence-ai/apis/excellence-learning/revisions/379e4a57dee8?raw)