> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scrapebadger.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Short

> Full detail for a single YouTube Short (vertical reel), including its sound.

## Path Parameters

**video\_id** `string` *required*

The Shorts video id (the id from a `/shorts/{id}` URL, e.g. `aBcD1234efg`).

## Query Parameters

**gl** `string` (default: US)

Content region (ISO 3166-1 alpha-2). Examples: `US`, `GB`, `DE`, `JP`.

**hl** `string` (default: en)

UI / interface language (BCP-47). Examples: `en`, `de`, `fr`, `ja`.

## Response

A Short is a `Video` with `is_short: true` plus a Shorts-specific vertical thumbnail and sound fields. The full field set matches [Get Video](https://docs.scrapebadger.com/api-reference/endpoint/youtube/get-video.md); the most relevant Shorts fields are listed below.

**video\_id** `string`

The Shorts video id.

**title** `string`

Short title (nullable).

**url** `string`

Full watch URL (nullable).

**description** `string`

Short description (nullable).

**length\_seconds** `integer`

Duration in seconds (nullable).

**view\_count** `integer`

View count (nullable).

**like\_count** `integer`

Like count (nullable).

**comment\_count** `integer`

Comment count (nullable).

**channel\_id** `string`

Uploader channel id (nullable).

**channel\_name** `string`

Uploader channel name (nullable).

**channel\_username** `string`

Uploader `@handle` (nullable).

**channel\_is\_verified** `boolean`

Whether the channel is verified (nullable).

**published\_at** `string`

ISO 8601 publish timestamp (nullable).

**hashtags** `array`

Hashtags used in the Short.

**thumbnail** `string`

Best/primary thumbnail URL (nullable).

**thumbnail\_vertical** `string`

Vertical (portrait) thumbnail URL (nullable).

**is\_short** `boolean`

Always `true` for Shorts.

**sound\_id** `string`

Sound id used by the Short (nullable).

**sound\_title** `string`

Sound title (nullable).

**sound\_artist** `string`

Sound artist (nullable).

**scraped\_at** `string`

ISO 8601 timestamp when the Short was scraped.

### Example Response

```json theme={null}
{
  "video_id": "aBcD1234efg",
  "title": "60-second pasta hack #shorts",
  "url": "https://www.youtube.com/shorts/aBcD1234efg",
  "length_seconds": 58,
  "view_count": 8200000,
  "like_count": 410000,
  "comment_count": 3200,
  "channel_id": "UCabc123",
  "channel_name": "Quick Recipes",
  "channel_username": "@QuickRecipes",
  "channel_is_verified": true,
  "published_at": "2026-05-30T00:00:00Z",
  "hashtags": ["#shorts", "#cooking"],
  "thumbnail": "https://i.ytimg.com/vi/aBcD1234efg/hqdefault.jpg",
  "thumbnail_vertical": "https://i.ytimg.com/vi/aBcD1234efg/oardefault.jpg",
  "is_short": true,
  "sound_id": "MPSDxyz123",
  "sound_title": "Original audio",
  "sound_artist": "Quick Recipes",
  "scraped_at": "2026-06-21T12:00:00Z"
}
```

## Shorts by Sound

To list Shorts that use a given sound, call:

```bash theme={null}
curl "https://scrapebadger.com/v1/youtube/shorts/by_sound/MPSDxyz123" \
  -H "X-API-Key: YOUR_API_KEY"
```

This returns an `items` array of Shorts plus a `continuation` token for pagination.

> [!NOTE]
>
> A Short-detail request and a shorts-by-sound page each cost **8 credits**. Failed requests are not charged.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.