Titel, Tags, Privatsphäre und Shorts: Upload YouTube Video Through API
Mit einem authentifizierten POST laden Sie ein YouTube-Video über die API hoch - mit Titel, bis zu 20 Tags, einem Privatsphäre-Status und einer bestehenden Playlist-ID. YouTube ist hier ausschließlich Video - keine Community-Beiträge, keine Bild- oder Textposts -, der Payload ist also klein und die Regeln sind streng.
Jede YouTube-spezifische Option sitzt in einem Objekt
youtubeConfigs trägt postType, videoTitle, tags, categoryId, privacyStatus, playlistId sowie die Flags für Benachrichtigung, Embedding, Kinder-Kennzeichnung und Lizenz - und reist auf demselben POST /social-posts Request mit, der die hochgeladene Datei referenziert.
Das Vertrauen von Creatorn und Teams
Erfahren Sie, wie Creator, Marketer und kleine Unternehmen AdaptlyPost nutzen, um konsistent zu bleiben und jede Woche Stunden zu sparen.
Ich bin Softwareentwickler, kein Marketer. Meine Partnerin betreibt eine TikTok-Seite, also helfe ich aus und plane ihre Posts: ich mache alles auf einmal und die KI übernimmt die Texte. Kostet mich jetzt etwa 20 Minuten pro Woche.
Softwareentwickler
Ich betreibe meine Nail-Art-Seite und eine persönliche Marke. Beides über ein Dashboard zu planen hat alles verändert, ich poste jetzt wirklich regelmäßig und mein Engagement ist innerhalb eines Monats spürbar gestiegen.
Content Creatorin
Ich bin SWE und ehrlich gesagt schlecht darin, regelmäßig zu posten. Ich plane einfach eine Woche voller Updates für meine persönliche Marke, wann immer ich eine freie Minute habe, und die KI entwirft die Texte pro Plattform, sodass ich dasselbe nicht fünfmal umschreiben muss.
Softwareentwickler
Ich bin Softwareentwickler, kein Marketer. Meine Partnerin betreibt eine TikTok-Seite, also helfe ich aus und plane ihre Posts: ich mache alles auf einmal und die KI übernimmt die Texte. Kostet mich jetzt etwa 20 Minuten pro Woche.
Softwareentwickler
Ich betreibe meine Nail-Art-Seite und eine persönliche Marke. Beides über ein Dashboard zu planen hat alles verändert, ich poste jetzt wirklich regelmäßig und mein Engagement ist innerhalb eines Monats spürbar gestiegen.
Content Creatorin
Ich bin SWE und ehrlich gesagt schlecht darin, regelmäßig zu posten. Ich plane einfach eine Woche voller Updates für meine persönliche Marke, wann immer ich eine freie Minute habe, und die KI entwirft die Texte pro Plattform, sodass ich dasselbe nicht fünfmal umschreiben muss.
Softwareentwickler
Ich bin Softwareentwickler, kein Marketer. Meine Partnerin betreibt eine TikTok-Seite, also helfe ich aus und plane ihre Posts: ich mache alles auf einmal und die KI übernimmt die Texte. Kostet mich jetzt etwa 20 Minuten pro Woche.
Softwareentwickler
Ich betreibe meine Nail-Art-Seite und eine persönliche Marke. Beides über ein Dashboard zu planen hat alles verändert, ich poste jetzt wirklich regelmäßig und mein Engagement ist innerhalb eines Monats spürbar gestiegen.
Content Creatorin
Ich bin SWE und ehrlich gesagt schlecht darin, regelmäßig zu posten. Ich plane einfach eine Woche voller Updates für meine persönliche Marke, wann immer ich eine freie Minute habe, und die KI entwirft die Texte pro Plattform, sodass ich dasselbe nicht fünfmal umschreiben muss.
Softwareentwickler
Ich bin kein Social-Media-Mensch, aber ich muss meine Arbeit irgendwo zeigen. Der KI-Texter erstellt einen brauchbaren Entwurf, ich passe ihn etwas an, plane ihn ein, fertig. Von einmal im Monat zu dreimal pro Woche.
Freelance-Designer
Wir haben unseren OpenClaw-Agenten mit AdaptlyPost verbunden und jetzt postet unsere KI Produkt-Updates automatisch auf allen Kanälen. Klingt futuristisch, funktioniert aber einfach. Die API-Integration war unkompliziert.
Startup-Gründer
Ich bin kein Social-Media-Mensch, aber ich muss meine Arbeit irgendwo zeigen. Der KI-Texter erstellt einen brauchbaren Entwurf, ich passe ihn etwas an, plane ihn ein, fertig. Von einmal im Monat zu dreimal pro Woche.
Freelance-Designer
Wir haben unseren OpenClaw-Agenten mit AdaptlyPost verbunden und jetzt postet unsere KI Produkt-Updates automatisch auf allen Kanälen. Klingt futuristisch, funktioniert aber einfach. Die API-Integration war unkompliziert.
Startup-Gründer
Ich bin kein Social-Media-Mensch, aber ich muss meine Arbeit irgendwo zeigen. Der KI-Texter erstellt einen brauchbaren Entwurf, ich passe ihn etwas an, plane ihn ein, fertig. Von einmal im Monat zu dreimal pro Woche.
Freelance-Designer
Wir haben unseren OpenClaw-Agenten mit AdaptlyPost verbunden und jetzt postet unsere KI Produkt-Updates automatisch auf allen Kanälen. Klingt futuristisch, funktioniert aber einfach. Die API-Integration war unkompliziert.
Startup-Gründer
Vom leeren Terminal zum veröffentlichten Upload
Key erstellen, dann den Kanal nachschlagen
Keys werden im Dashboard unter Settings > API Tokens ausgestellt und beginnen mit adaptly_. Senden Sie sie als `Authorization: Bearer <key>` an https://post.adaptlypost.com/post/api/v1. Der Kanal selbst wird per OAuth im Dashboard verbunden - es gibt keinen Endpunkt, der einen YouTube-Kanal verbindet, trennt oder auf seinen Zustand prüft - und `GET /social-accounts` liefert dann seine id, platform und displayName zur Referenzierung im Post. Ein Call zielt auf einen YouTube-Kanal: Ein zweiter Kanal ist ein zweiter Call, und zwei YouTube-Konten in einem Payload werden mit einem 400 abgelehnt.
Datei hochschieben, dann POST /social-posts mit youtubeConfigs
Akzeptiert werden nur video/mp4 und video/quicktime, und `POST /upload-urls` weist jeden anderen MIME-Typ rundweg ab. Fordern Sie dort also vorsignierte URLs an (1-20 Dateien, eine Stunde gültig), PUTten Sie die Datei und erstellen Sie den Post mit `text`, `platforms: ["YOUTUBE"]`, `timezone` (IANA, z. B. "Europe/Berlin"), `contentType: "VIDEO"` und einem `youtubeConfigs`-Objekt. Die Liste der von YouTube unterstützten Content-Typen umfasst VIDEO, und die maximale Bildanzahl pro Post ist 0 - ein IMAGE- oder TEXT-Post, der YouTube einschließt, erreicht den Kanal also nie. Der Request-Body wird synchron validiert: ein `videoTitle` über 100 Zeichen, mehr als 20 `tags`, ein fehlendes Pflichtfeld oder ein nicht unterstützter Content-Typ kommen allesamt als 400 am Create-Call selbst zurück, ohne dass ein Post-Datensatz geschrieben wird und ohne dass es etwas zu wiederholen gäbe. `postType: "SHORTS"` verlangt eine 9:16-Datei von höchstens 60 Sekunden, prüfen Sie Seitenverhältnis und Dauer also vor dem Call. Ergänzen Sie `scheduledAt`, um zu planen statt sofort zu veröffentlichen.
platformPostId auslesen oder korrigieren und erneut senden
`GET /social-posts/:id/results` liefert den YouTube-Eintrag mit `status`, `publishedAt`, `errorMessage` und `platformPostId` - der rohen YouTube-Video-ID. Eine Watch-URL wird nie zurückgegeben, bauen Sie den Link also selbst aus dieser ID. Dieser Endpunkt meldet, was YouTube getan hat, nachdem wir den Upload angenommen und ausgeliefert haben, nicht ob der Payload wohlgeformt war - fehlerhafte Payloads kommen gar nicht so weit, weil sie beim Create mit einem 400 gescheitert sind. Was in `errorMessage` auftaucht, kommt von der Kanalseite: eine `playlistId`, die es auf dem verbundenen Kanal nicht gibt, eine vom Kanalinhaber widerrufene OAuth-Freigabe oder ein Upload, den YouTube bei der eigenen Verarbeitung abgelehnt oder gedrosselt hat. Beheben Sie die Ursache und rufen Sie `POST /social-posts/:id/retry` mit den fehlgeschlagenen `platformIds` auf, statt den Post neu anzulegen. Eine Sandbox gibt es nirgends in der API, dem Trockenlauf am nächsten kommt daher eine Veröffentlichung mit `privacyStatus: "PRIVATE"`, die Sie anschließend in YouTube Studio umstellen.
Einfache, transparente Preise
Wähle den perfekten Plan
30 verbundene Social-Media-Konten
Unbegrenzte geplante Posts
1 Teammitglied
3 Arbeitsbereiche
150 Credits/Monat
KI-Captions
KI-Bildstudio
API-Zugang & OpenClaw-Integration
Bild-, Video- & Karussell-Posts
Beliebtester
60 verbundene Social-Media-Konten
Unbegrenzte geplante Posts
5 Teammitglieder
15 Arbeitsbereiche
400 Credits/Monat
KI-Captions
KI-Bildstudio
API-Zugang & OpenClaw-Integration
Bild-, Video- & Karussell-Posts
100 verbundene Social-Media-Konten
Unbegrenzte geplante Posts
20 Teammitglieder
50 Arbeitsbereiche
1000 Credits/Monat
KI-Captions
KI-Bildstudio
API-Zugang & OpenClaw-Integration
Bild-, Video- & Karussell-Posts
Alle Pläne: 7 Tage gratis testen
Möchten Sie den vollständigen Funktionsvergleich sehen? Preisseite ansehen
Was Sie an einem YouTube-Upload tatsächlich setzen können
Long-Form-Uploads mit angehängten Metadaten
`postType: "VIDEO"` veröffentlicht einen normalen Upload. `videoTitle` setzt den Titel mit einer Obergrenze von 100 Zeichen, `tags` nimmt bis zu 20 Strings, `categoryId` nimmt die numerische Kategorie-ID von YouTube, und der Post-`text` reist als Beschreibungstext mit dem Video mit. Darüber hinaus ist nichts setzbar: Felder für Thumbnails, Kapitel, Endcards, Untertitel oder Premieren gibt es in dieser API nicht.
Shorts über denselben Endpunkt
Stellen Sie `postType` auf `"SHORTS"`, um YouTube Shorts per API hochzuladen - derselbe Endpunkt, dasselbe youtubeConfigs, dieselbe upload-urls-Pipeline. Entscheidend ist das Medium, nicht das Flag: Ein Short verlangt ein Seitenverhältnis von 9:16 und eine Dauer von höchstens 60 Sekunden, prüfen Sie Abmessungen und Dauer also vor dem Call statt danach.
Privatsphäre, Benachrichtigungen und die Zielgruppen-Kennzeichnung
`privacyStatus` akzeptiert PUBLIC, UNLISTED oder PRIVATE. `notifySubscribers` entscheidet, ob die Abonnenten des Kanals benachrichtigt werden, `allowEmbedding` setzt die Einbettungsberechtigung, `madeForKids` trägt die Zielgruppen-Kennzeichnung und `license` setzt die Videolizenz. Alle gelten pro Post, ein Stapel Archiv-Uploads kann also privat und lautlos rausgehen, während ein Launch-Video öffentlich erscheint und benachrichtigt.
Den Upload einer bestehenden Playlist hinzufügen
Setzen Sie `playlistId` in youtubeConfigs, und der fertige Upload wird in diese Playlist einsortiert. Sie muss bereits existieren - die API kann zu einer Playlist hinzufügen, aber keine anlegen, umbenennen, umsortieren oder auflisten -, kopieren Sie die ID also aus YouTube Studio (der `list=`-Wert in der Playlist-URL) und legen Sie sie in Ihrer eigenen Konfiguration ab. Ist die ID falsch, zeigt sich das am YouTube-Eintrag, den `/results` zurückgibt.
Verdrahten Sie Ihren ersten YouTube-Upload
Erstellen Sie einen Key unter Settings > API Tokens, importieren Sie GET /openapi.json in Ihren HTTP-Client, Make oder n8n, und der erste Upload ist einen POST entfernt. Testen Sie mit privacyStatus PRIVATE, bevor Sie öffentlich gehen.