Skip to main content

​
Path Parameters

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

​
Query Parameters

​
string
default:"US"
Content region (ISO 3166-1 alpha-2). Examples: US, GB, DE, JP.
​
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.
​
string
The Shorts video id.
​
string
Short title (nullable).
​
string
Full watch URL (nullable).
​
string
Short description (nullable).
​
integer
Duration in seconds (nullable).
​
integer
View count (nullable).
​
integer
Like count (nullable).
​
integer
Comment count (nullable).
​
string
Uploader channel id (nullable).
​
string
Uploader channel name (nullable).
​
string
Uploader @handle (nullable).
​
boolean
Whether the channel is verified (nullable).
​
string
ISO 8601 publish timestamp (nullable).
​
array
Hashtags used in the Short.
​
string
Best/primary thumbnail URL (nullable).
​
string
Vertical (portrait) thumbnail URL (nullable).
​
boolean
Always true for Shorts.
​
string
Sound id used by the Short (nullable).
​
string
Sound title (nullable).
​
string
Sound artist (nullable).
​
string
ISO 8601 timestamp when the Short was scraped.

​
Example Response

​
Shorts by Sound

To list Shorts that use a given sound, call:
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.