Skip to content
SocialHelper
Get API key

Post to YouTube and read it back from one API.

Publish to YouTube and run its tools from your app or your AI agent, with the same API key and MCP server.

Live Connects with OAuth Receives posts 2 tools

What you can post

YouTube limits.

These are the limits the API enforces for YouTube, read straight from the code. Every post is checked against them before anything is sent.

Each post uploads one video. The post text becomes the video description, and the title option is required.
Text
5,000 bytes (accented letters and emoji take several)
Images
Not supported
Video
Up to 1 per post · MP4, MOV, WEBM, MPEG, AVI, WMV, FLV, 3GP · 60 MB
Media
Required on every post
overrides.youtube.title* required
string · The video title: up to 100 characters, without < or >. The post text becomes the description.
overrides.youtube.privacy
string · Who can watch the video. Default "public". public | unlisted | private
overrides.youtube.tags
array · Keyword tags, as a list of strings. Up to 500 characters in all: commas between tags count, and a tag containing a space counts 2 more (YouTube quotes it).
overrides.youtube.category_id
string · The YouTube video category ID, as a string. Default "22" (People & Blogs).
overrides.youtube.made_for_kids
boolean · Whether the video is made for kids, as YouTube requires creators to declare (COPPA). Default false.
overrides.youtube.notify_subscribers
boolean · Whether YouTube notifies the channel's subscribers about the new video. Default true.

Post with one request

Your first YouTube post.

Send the text and the account ID. Add an Idempotency-Key so a retried request never posts twice. The response lists each account with its own status and, once it’s live, the post’s URL.

curl https://socialhelper.app/api/v1/posts \
  -H "Authorization: Bearer $SOCIALHELPER_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
      "text": "We just shipped dark mode. Try it tonight 🌙",
      "accounts": [
          "ACCOUNT_ID"
      ],
      "media": [
          "MEDIA_ID"
      ],
      "overrides": {
          "youtube": {
              "title": "Dark mode is here"
          }
      }
  }'

Tools

YouTube tools.

Call them with POST /api/v1/accounts/{id}/tools/{tool}, or let your agent use list_account_tools and run_account_tool over MCP. Results come back straight away.

list_videos

read-only

List the channel's most recent uploads, newest first, with title, publish time, privacy and view, like and comment counts. Counts are null where the owner hid them.

max_results integer
How many videos to return (1–50). default: 10

channel_stats

read-only

Get the channel's totals: subscribers (rounded down to three significant figures by YouTube), views and public videos.

Connect

Connect YouTube once.

Open Accounts in the SocialHelper dashboard and choose YouTube. You sign in on YouTube’s own screen and approve access; SocialHelper stores the connection encrypted. You don’t need a YouTube developer app of your own.

  1. 1

    Open Accounts

    In the dashboard, choose YouTube.

  2. 2

    Sign in on YouTube

    Approve access on YouTube’s own screen.

  3. 3

    Use the account ID

    GET /api/v1/accounts lists the account with its ID, whether it can publish, and its tools.

SocialHelper calls YouTube’s official API for you. YouTube API reference ↗

FAQ

YouTube questions.

How long can a YouTube post be?

5,000, counted the way YouTube counts it. SocialHelper checks the length before posting, and if it doesn’t fit nothing is sent.

Can I post images or video to YouTube?

Images aren’t supported. Up to 1 video per post.

Do I need my own YouTube developer app?

No. You connect with a normal YouTube sign-in through SocialHelper’s own app.

Can my AI agent use YouTube?

Yes. Connect the SocialHelper MCP server at https://socialhelper.app/mcp and your agent can post to YouTube and run its tools.

How much does it cost?

SocialHelper is free during early access, YouTube included.

Ship your YouTube integration today.

Create a free account, connect an account and send your first post in a few minutes.