3 days free on every plan · Try any plan before you pay.

Start free trialStart

BlogDevelopers

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:

DateChange
December 4, 2025Upload cost changed "from approximately 1600 units to approximately 100 units"
June 1, 2026videos.insert and search.list "will be charged to their own respective quota buckets"
November 2, 2026Uploads from unverified projects "are no longer restricted to private viewing mode", reversing the July 28, 2020 rule
November 3, 2026thumbnails.set "now supports uploading custom thumbnails for YouTube Shorts after video processing is complete"
November 16, 2026Public 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:

FieldWhat the docs say
snippet.title"maximum length of 100 characters"
snippet.description"maximum length of 5000 bytes"
status.privacyStatusIf you leave it out, it "defaults to public". "Certain uploads might default to private based on creator account settings"
status.publishAtSchedules 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:

CallUnitsBucket
videos.insert1Video Uploads, 100 a day
thumbnails.set50Shared 10,000
videos.update50Shared 10,000
videos.list1Shared 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:

  1. privacyStatus in your request. Private and scheduled uploads stay private until their time.
  2. The account's age. YouTube's upload help page says "The default video privacy setting for creators aged 13–17 is private."
  3. 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 APIAbondy API
Posts toChannels that authorized your appPosters' own accounts
Your own channelYesNo
AppsYouTubeYouTube Shorts, TikTok, Instagram Reels, Facebook
Limits100 videos.insert calls a day per project by default60 calls a minute, 10 orders a minute, 1 to 10,000 uploads an order
PriceNot 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