---
title: "Trending Videos"
method: GET
path: "/v1/data/youtube/trending/"
tags: ["YouTube: Trending"]
---

# Trending Videos

`GET /v1/data/youtube/trending/`

## Request

- Base URL: `https://api.superagnt.com`
- URL: `https://api.superagnt.com/v1/data/youtube/trending/`
- Auth: API key in header `Authorization`

This endpoint returns the list of trending videos given a country

## Query parameters

- `country` string
- `lang` string
- `section` 'Now' | 'Music' | 'Movies' | 'Gaming'

## Response `200`

Response

- object
  - `number_of_videos` string
  - `country` string
  - `lang` string
  - `timezone` string
  - `videos` object[]
    - `video_id` string, required
    - `title` string
    - `author` string
    - `number_of_views` integer
    - `video_length` string
    - `description` string
    - `is_live_content` string
    - `published_time` string
    - `channel_id` string
    - `category` string
    - `type` string
    - `keywords` string[]
    - `thumbnails` object[]

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/superagnt/apis/superagnt-api.md) · [All operations](https://skmtc.dev/superagnt/apis/superagnt-api/llms.txt) · [OpenAPI document](https://skmtc.dev/superagnt/apis/superagnt-api/revisions/b2d8de30ccf0?raw)
