YouTube Shorts API Guide 2026: Everything Creators Need to Know
Loopi Team
•
2026-01-28
•
5 min read
Key Takeaways
✓
Vertical videos under 3 minutes are automatically classified as Shorts — no API flag needed
✓
You control: title, description, tags, privacy status, scheduled publish time, and thumbnail
✓
You cannot force a vertical video to be treated as a regular video if it meets Shorts criteria
✓
Shorts thumbnails can only be customized via YouTube Studio, not the API
✓
There is no 'Shorts' parameter in the API — YouTube decides based on your video's properties
Ever wondered how YouTube identifies Shorts? Here's the complete guide to what actually happens when you create a Short through the YouTube Data API.
How YouTube Automatically Classifies Shorts
There is no separate API endpoint for "Shorts" on YouTube. Instead, YouTube automatically classifies uploads based on their metadata and content characteristics.
Key Point: You don't tell YouTube that a video is a Short — YouTube decides based on your video's properties.
Shorts Classification Criteria
| Criteria | Requirement | Notes |
|---|---|---|
| Duration | ≤ 3 minutes (180 seconds) | Hard limit as of 2026 |
| Aspect Ratio | 9:16 (vertical) preferred | Square (1:1) also works |
| Resolution | 1080×1920 optimal | Minimum 720p recommended |
What You CAN Control via the API
- Title — Can include #Shorts hashtag (optional but helps discoverability)
- Description — Full text support, links, hashtags
- Tags — Standard video tags apply
- Privacy Status — public, private, or unlisted
- Scheduled Publishing — Set a future publish time
- Category — Standard YouTube categories
- Custom Thumbnails — Supported for Shorts; displayed vertically in the Shorts feed
What You CANNOT Control via the API
- Forcing Shorts Classification — YouTube decides automatically
- Shorts-Specific Analytics — Must use YouTube Studio or YouTube Analytics API
- Shorts Shelf Placement — Determined by YouTube's algorithm
Common Scenarios
| Upload Specs | Result |
|---|---|
| 60s, 9:16 vertical, 1080×1920 | Short |
| 90s, 1:1 square, 1080×1080 | Short |
| 150s, 9:16 vertical, 1080×1920 | Short |
| 4 minutes, 9:16 vertical | Regular Video (exceeds 3 min) |
| 60s, 16:9 horizontal, 1920×1080 | Regular Video (horizontal) |
Best Practices for Shorts via API
- Keep videos under 3 minutes (60 seconds is optimal for engagement)
- Use vertical format (9:16 aspect ratio)
- Include
#Shortsin the title or description for discoverability - Optimize for mobile viewing — centered text, large fonts
API Code Example
// Uploading a Short via YouTube Data API v3
const uploadShort = async (videoFile, accessToken) => {
const metadata = {
snippet: {
title: "Amazing Cooking Hack #Shorts",
description: "Quick tip for perfect eggs!\n\n#cooking #shorts",
tags: ["cooking", "shorts", "tips"],
categoryId: "26" // How-to & Style
},
status: {
privacyStatus: "public",
selfDeclaredMadeForKids: false
}
};
// Upload using resumable upload endpoint
// YouTube will automatically classify as Short
// based on duration and aspect ratio
};Conclusion
The YouTube API doesn't have special "Shorts" parameters — it's all about your video's properties. Keep it vertical, keep it under 3 minutes, and YouTube handles the rest.