---
title: "Stats Top Videos Endpoint"
method: GET
path: "/stats/top-videos"
tags: ["statistics"]
---

# Stats Top Videos Endpoint

`GET /stats/top-videos`

## Request

- Base URL: `https://api.sumvid.app` (the document declares no server; this is the origin it was published from)
- URL: `https://api.sumvid.app/stats/top-videos`
- Auth: none declared

Most-requested videos over the window, ranked by request count (with the
distinct-user count and display metadata alongside). `lang` is the
reader's language: titles come from the summary in that language when one
exists (else English, else YouTube's). Reads never generate translations.

## Query parameters

- `window` string, nullable
- `limit` integer
- `lang` string, nullable

## Response `200`

Successful Response

- TopVideosResponse
  - `requested_language` string
  - `window` string, required
  - `videos` TopVideo[], required
    - `youtube_video_id` string, required
    - `video_url` string, required
    - `title` string, nullable
    - `original_title` string, nullable
    - `language_code` string, nullable
    - `channel` string, nullable
    - `thumbnail_url` string, nullable
    - `duration_seconds` integer, nullable
    - `first_transcribed_at` string, date-time, required
    - `requests` integer, required
    - `unique_users` integer, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/sumvid/apis/summarize-vid.md) · [All operations](https://skmtc.dev/sumvid/apis/summarize-vid/llms.txt) · [OpenAPI document](https://skmtc.dev/sumvid/apis/summarize-vid/revisions/c03d66e07deb?raw)