Upload YouTube Shorts with the API: videos.insert, quota, 2026 rules
How to upload a YouTube Short with the Data API's videos.insert: what makes it a Short, the 2026 quota and audit changes, a working example and common errors.
By Abondy ResearchPublished 7 min read
In short: There is no separate Shorts upload API. You upload a Short with the YouTube Data API's videos.insert, the same method as any video, and YouTube treats it as a Short when the file is vertical or square and up to 3 minutes long. Each call costs 1 unit from its own bucket of 100 uploads a day per project. Since November 2, 2026, uploads from unverified projects are no longer locked to private, so the audit now matters mainly when you need more than the default quota.
Every Google rule below is quoted from Google's docs, read November 22, 2026. The YouTube Data API changed several times in 2026, so check the date on any guide you follow, this one included.
Is there a YouTube Shorts upload API?
No. The videos.insert reference has no Shorts setting. What makes a video a Short is the file itself. YouTube's upload help page says to select a short-video file "Up to 3 minutes. With a square or vertical aspect ratio." Its three-minute Shorts page says videos uploaded on or after October 15, 2024 "with a square or vertical aspect ratio up to three minutes in length will be categorized as Shorts".
So the job is: make a vertical or square file of 3 minutes or less, then upload it like any other video. Pixel and file limits for Shorts and the other apps are in TikTok, Reels and Shorts video sizes.
What changed in the YouTube API in 2025 and 2026?
Many guides still describe rules that no longer apply. These dates come from Google's revision history:
| Date | Change |
|---|---|
| December 4, 2025 | Upload cost changed "from approximately 1600 units to approximately 100 units" |
| June 1, 2026 | videos.insert and search.list "will be charged to their own respective quota buckets" |
| November 2, 2026 | Uploads from unverified projects "are no longer restricted to private viewing mode", reversing the July 28, 2020 rule |
| November 3, 2026 | thumbnails.set "now supports uploading custom thumbnails for YouTube Shorts after video processing is complete" |
| November 16, 2026 | Public view counts now include co-views |
If a guide says an upload costs 1,600 units, or that your Shorts will stay private until an audit, it was written before these changes.
What do you need before the first upload?
- A Google Cloud project with the YouTube Data API enabled.
- An OAuth client. Google's upload guide uses a Desktop client saved as
client_secrets.json. - The upload scope,
https://www.googleapis.com/auth/youtube.upload. An API key alone can't upload. Google's developer policies say an app "does need user authorization to upload a video to the user's YouTube channel." - The channel owner's consent. The same policies say you must not "automate or trigger views, uploads, comments, likes, dislikes, or other actions without the user's prior specific and express consent". If your app uploads, it "must clearly display an option for the user to choose" public, private or unlisted.
How do you upload a Short with videos.insert?
This Python example uses Google's client libraries (google-api-python-client and google-auth-oauthlib). It uploads a vertical file as private, which is the safe choice while testing.
from google_auth_oauthlib.flow import InstalledAppFlow
from googleapiclient.discovery import build
from googleapiclient.http import MediaFileUpload
SCOPES = ["https://www.googleapis.com/auth/youtube.upload"]
creds = InstalledAppFlow.from_client_secrets_file("client_secrets.json", SCOPES).run_local_server(port=0)
youtube = build("youtube", "v3", credentials=creds)
body = {
"snippet": {"title": "Three crates, one try", "description": "Made with our app.", "categoryId": "22"},
"status": {"privacyStatus": "private", "selfDeclaredMadeForKids": False},
}
media = MediaFileUpload("short_9x16.mp4", mimetype="video/mp4", chunksize=-1, resumable=True)
request = youtube.videos().insert(
part="snippet,status",
body=body,
media_body=media,
notifySubscribers=False,
)
response = None
while response is None:
_, response = request.next_chunk()
print("Uploaded video ID:", response["id"])
What each field does, from Google's video resource and insert pages:
| Field | What the docs say |
|---|---|
snippet.title | "maximum length of 100 characters" |
snippet.description | "maximum length of 5000 bytes" |
status.privacyStatus | If you leave it out, it "defaults to public". "Certain uploads might default to private based on creator account settings" |
status.publishAt | Schedules a video. It "can be set only if the privacy status of the video is private" |
notifySubscribers (query parameter) | Defaults to true. "a channel owner who is uploading many videos might prefer to set the value to False" |
How does the resumable upload work without a client library?
Google's resumable upload guide describes the steps. First, start a session with the metadata:
curl -i -X POST "https://www.googleapis.com/upload/youtube/v3/videos?uploadType=resumable&part=snippet,status" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json; charset=UTF-8" \
-H "X-Upload-Content-Length: $(stat -c%s short_9x16.mp4)" \
-H "X-Upload-Content-Type: video/mp4" \
-d '{"snippet": {"title": "Three crates, one try"}, "status": {"privacyStatus": "private"}}'
The answer is a 200 with a Location header. That URL is your upload session. Then send the file to it:
curl -X PUT "$LOCATION" -H "Authorization: Bearer $TOKEN" -H "Content-Type: video/mp4" --data-binary @short_9x16.mp4
A 201 means the upload worked, and the body is the new video resource. On a 500, 502, 503 or 504, the guide says your code "should use an exponential backoff strategy when resuming uploads". It also warns that "each resumable session URI has a finite lifetime and eventually expires", so resume soon after a failure.
How many Shorts can you upload a day with the API?
Google's quota page says new projects get "100 search.list calls, 100 videos.insert calls, and 10,000 units per day combined for all other endpoints", and "Daily quotas reset at midnight Pacific Time (PT)." The insert page puts it as "Quota impact: 100 calls per day. A call to this method has a quota cost of 1 unit in the Video Uploads quota bucket."
Other calls you'll make around an upload come out of the shared 10,000 units:
| Call | Units | Bucket |
|---|---|---|
videos.insert | 1 | Video Uploads, 100 a day |
thumbnails.set | 50 | Shared 10,000 |
videos.update | 50 | Shared 10,000 |
videos.list | 1 | Shared 10,000 |
So custom thumbnails for 100 Shorts would use 5,000 of the shared units.
Two errors look alike but aren't. From Google's errors page:
quotaExceeded(403): "you have exceeded your quota." That's your project's limit.uploadLimitExceeded(400): "The channel's daily video upload limit has been reached. This is a YouTube platform restriction and is entirely separate from your Google Cloud project's API quota."
Channel limits and the other apps' caps are in daily upload limits.
Do you still need a YouTube API audit?
For public uploads, no longer. For more quota, yes. Google's audit page says: "If you would like to request additional quota beyond the default allocation, you must first complete an audit", through the "YouTube API Services - Audit and Quota Extension Form". The developer policies add that extra quota is for "the approved use case" only. If your use changes, you must resubmit. Google also says it runs "periodic audits" and will contact you when yours is due. Whether any of this costs money, on YouTube and the other apps, is covered in what social media APIs cost.
Why does my API upload show as private?
Since November 2, 2026, it shouldn't be because your project is unverified. Check three things:
privacyStatusin your request. Private and scheduled uploads stay private until their time.- The account's age. YouTube's upload help page says "The default video privacy setting for creators aged 13–17 is private."
- Copyright claims. YouTube's three-minute Shorts page says a Short "over one minute in duration with an active copyright claim of any type ... will be blocked globally".
How is Abondy's API different?
Abondy's API doesn't upload to your channel. You send a video, Abondy's video model makes versions, and real people post those versions on their own YouTube Shorts, TikTok, Instagram Reels and Facebook accounts. A brand that wants Shorts only sends "platforms": ["youtube"] with the order. The request format is in post one video to four apps in one call.
| YouTube Data API | Abondy API | |
|---|---|---|
| Posts to | Channels that authorized your app | Posters' own accounts |
| Your own channel | Yes | No |
| Apps | YouTube | YouTube Shorts, TikTok, Instagram Reels, Facebook |
| Limits | 100 videos.insert calls a day per project by default | 60 calls a minute, 10 orders a minute, 1 to 10,000 uploads an order |
| Price | Not covered here | $0.30 a post and $0.05 a video made, from a prepaid API balance |
Each version goes up at most once per app, and versions that look too alike are held back. Webhooks report when an upload goes live or is taken down. The same tools work from Claude, ChatGPT or Cursor through our MCP server. For TikTok's own posting API, see how to post a video with the TikTok API.
Questions people ask
Can you upload YouTube Shorts with the API?
Yes. Use videos.insert with a vertical or square file of 3 minutes or less. There is no separate Shorts endpoint or flag.
How many quota units does a YouTube upload cost?
1 unit, from its own Video Uploads bucket of 100 calls a day per project by default. Before June 2026, uploads shared the 10,000-unit pool.
Why were API uploads locked to private?
From July 28, 2020, uploads from unverified projects were restricted to private until an audit. Google reversed that on November 2, 2026.
Can I schedule a Short with the API?
Yes. Upload it as private and set status.publishAt. Google's docs say publishAt can only be set on private videos.
Can I set a custom thumbnail on a Short through the API?
Yes, since November 3, 2026. Call thumbnails.set after processing is complete. It costs 50 units.
If you want real people to post your video rather than your own channel, get a key on the developers page.
Read next
- Developers · 22 Nov 2026 · 10 min read
Daily upload limits: YouTube, TikTok, Instagram, Facebook, API vs app
How many videos each app lets you post a day, in the app and through its API, from the official docs read November 21, 2026, and the error you get at the cap.
- Developers · 20 Nov 2026 · 6 min read
Post one video to TikTok, Shorts, Reels and Facebook in one API call
Each app's own posting API and its limits, checked November 20, 2026, and how one Abondy API call posts a video to all four apps on real people's accounts.
- Developers · 22 Nov 2026 · 9 min read
Is the YouTube API free? What YouTube, TikTok, Meta and X charge
YouTube, TikTok, Instagram, Facebook and Threads list no fee for their APIs; X charges per request. Quotas, audits and fees from each one's docs.
