---
title: "Retrieve the shorts tab for a YouTube channel"
method: GET
path: "/youtube/channel/{id}/shorts"
tags: ["YouTube"]
---

# Retrieve the shorts tab for a YouTube channel

`GET /youtube/channel/{id}/shorts`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/youtube/channel/{id}/shorts`
- Auth: API key in header `x-api-key`

Returns the first page of Shorts from a YouTube channel's Shorts tab. `id` accepts a channel id, `@handle`, `/c` or `/user` path, or a full channel URL. Each short has its position, video id, title, URL, thumbnail and view count text.

## Path parameters

- `id` string, required

## Headers

- `x-api-key` string, required

## Response `200`

OK

- YoutubeChannelShortsResponseDoc
  - `code` integer
  - `data` YoutubeChannelShortsResponse
    - `channel_id` string: YouTube channel ID, starting with `UC`.
    - `channel_title` string: Channel name as shown on YouTube.
    - `channel_url` string: Link to the channel on YouTube.
    - `handle` string: Channel handle, starting with `@`.
    - `shorts` YoutubeChannelShort[]: YouTube Shorts published by the channel.
      - `position` integer: Position of the Short in the channel's Shorts list, starting at 1.
      - `thumbnail` string: URL of the Short's thumbnail image.
      - `title` string: Title of the Short.
      - `url` string: Link to the Short on YouTube.
      - `video_id` string: YouTube video ID of the Short.
      - `view_count` string: View count as YouTube displays it, such as `1.2M views`.
    - `thumbnail` string: URL of the channel's avatar image.
  - `msg` string

## Other responses

- `400`: Missing or invalid parameters
- `429`: Rate limit exceeded
- `500`: Internal server error

---

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