Skip to main content

​
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; 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

{
  "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: 
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.
A Short-detail request and a shorts-by-sound page each cost 5 credits. Failed requests are not charged.