Ratgeber · 2026-11-07

TikTok-Videos per API planen

TikTok erlaubt das Veröffentlichen über eine offizielle Schnittstelle, stellt dafür aber strengere Regeln auf als die meisten anderen Plattformen. Dieser Artikel erklärt den Ablauf, die Grenzen und was das für geplante Beiträge bedeutet.

Wer TikTok-Videos automatisch veröffentlichen will, kommt an der Content Posting API nicht vorbei. Werkzeuge, die stattdessen die TikTok-App fernsteuern oder sich mit Ihrem Passwort anmelden, verstoßen gegen die Regeln von TikTok und gefährden Ihr Konto. Video Automation nutzt ausschließlich die offizielle API.

Zwei Wege: direkt veröffentlichen oder als Entwurf

Die API kennt zwei Arten, ein Video zu übergeben:

Weg	Berechtigung	Was passiert
Direct Post	`video.publish`	Das Video wird mit Beschreibung und Sichtbarkeit direkt veröffentlicht.
Upload in den Posteingang	`video.upload`	Das Video landet als Entwurf in der TikTok-App. Der Kontoinhaber erhält eine Benachrichtigung und veröffentlicht es dort selbst.

Der Entwurfsweg ist nützlich, wenn jemand vor der Veröffentlichung noch Musik oder Effekte in der App ergänzen will. In Video Automation wählen Sie ihn mit post_mode=MEDIA_UPLOAD.

Der Ablauf beim direkten Veröffentlichen

1. creator_info abfragen

Vor jedem Beitrag muss eine Anwendung creator_info/query aufrufen. TikTok liefert darin unter anderem:

Name und Profilbild des Kontos,
die erlaubten Sichtbarkeitsstufen (privacy_level_options),
ob Kommentare, Duette und Stitches im Konto abgeschaltet sind,
die maximale Videolänge, die dieses Konto veröffentlichen darf.

Die gewählte Sichtbarkeit muss eine dieser Optionen sein. Sonst lehnt TikTok den Beitrag ab. Video Automation fragt creator_info unmittelbar vor dem Veröffentlichen ab, also auch bei geplanten Beiträgen zum geplanten Zeitpunkt.

2. Upload starten

Mit video/init übergibt die Anwendung Beschreibung (bis 2.200 Zeichen), Sichtbarkeit, die Schalter für Kommentare, Duette und Stitches sowie Angaben zu Werbeinhalten und KI-Kennzeichnung. TikTok antwortet mit einer Upload-Adresse, die eine Stunde gilt.

3. Datei in Teilen übertragen

Die Datei wird in Teilen nacheinander hochgeladen. Jeder Teil ist zwischen 5 und 64 MB groß, der letzte darf bis zu 128 MB haben. Dateien unter 5 MB gehen in einem Stück. Ein Video darf bis zu 4 GB groß sein. Die zulässige Länge hängt vom Konto ab und steht in creator_info.

4. Status abfragen

TikTok verarbeitet das Video danach. Video Automation fragt den Status ab, bis TikTok die Veröffentlichung bestätigt, und meldet das Ergebnis im Verlauf und auf Wunsch per Webhook.

Grenzen, die Sie kennen sollten

Ungeprüfte Anwendungen

Bevor TikTok eine Anwendung für das öffentliche Veröffentlichen freigibt, durchläuft sie eine App-Prüfung und anschließend ein eigenes Audit für Direct Post. Bis dahin gilt laut TikTok:

Alle Beiträge werden nur privat veröffentlicht (SELF_ONLY).
Das Konto muss beim Veröffentlichen auf privat gestellt sein.
Höchstens fünf Konten können innerhalb von 24 Stunden über die Anwendung veröffentlichen.

Das gilt für jede neue Anwendung, auch für unsere. Den aktuellen Stand unserer TikTok-Freigabe finden Sie in den häufigen Fragen. Der Entwurfsweg ist davon nicht betroffen, weil dort der Kontoinhaber selbst veröffentlicht.

Mengenbegrenzungen

Pro Konto lässt TikTok typischerweise rund 15 Beiträge am Tag über die API zu, zusammengezählt über alle Anwendungen.
Pro Zugangstoken sind sechs Upload-Starts je Minute erlaubt.

Wer mehr veröffentlichen will, sollte Beiträge über den Tag verteilen. Genau dafür ist die Planung da.

Vorgaben für die Oberfläche

TikTok prüft im Audit auch, wie eine Anwendung den Nutzer fragt. Die Sichtbarkeit darf nicht vorausgewählt sein, Kommentare, Duette und Stitches müssen zunächst ausgeschaltet sein, und vor dem Veröffentlichen muss ein Hinweis auf die Bestätigung zur Musiknutzung von TikTok stehen. Bei Werbeinhalten kommen eigene Kennzeichnungen hinzu. Diese Angaben treffen Sie in Video Automation beim Planen. Das ist der Grund, warum es bei TikTok kein vollständig „blindes“ Veröffentlichen gibt: Sie bestätigen die Einstellungen pro Beitrag, wir führen ihn später aus.

Einen TikTok-Beitrag planen

Über die API sieht ein geplanter Beitrag so aus:

curl -X POST "https://my-video-automation.com/api/upload" \
  -H "Authorization: Apikey YOUR_KEY" \
  -F user=baeckerei_schmidt \
  -F "platform[]=tiktok" \
  -F title="So entsteht unser Roggenbrot #backen" \
  -F privacy_level=PUBLIC_TO_EVERYONE \
  -F disable_comment=false \
  -F disable_duet=true \
  -F disable_stitch=true \
  -F video=@brot.mp4 \
  -F scheduled_date=2026-11-15T07:30:00 \
  -F timezone=Europe/Berlin

Erlaubt das Konto zum geplanten Zeitpunkt die gewählte Sichtbarkeit nicht, schlägt der Beitrag mit dem Fehlercode tiktok_privacy_unavailable fehl, und die Fehlermeldung nennt die erlaubten Stufen. Ist für Ihr Konto eine Einstellung nicht möglich, zum Beispiel weil Duette im Konto abgeschaltet sind, übernehmen wir die Kontoeinstellung.

Werbung und KI kennzeichnen

brand_organic_toggle=true kennzeichnet Werbung für Ihr eigenes Unternehmen.
brand_content_toggle=true kennzeichnet eine bezahlte Partnerschaft. Solche Beiträge dürfen nicht privat sein.
is_aigc=true oder plattformübergreifend is_ai_generated=true kennzeichnet KI-generierte Inhalte.

Für die Kennzeichnung sind Sie als Kunde verantwortlich, so steht es auch in unseren AGB.

Verbindung und Tokens

Verbunden wird das TikTok-Konto über TikToks eigene Anmeldung (OAuth). Wir sehen Ihr Passwort nie. Das Zugangstoken gilt zwei Stunden, das Aktualisierungstoken 180 Tage. Wir speichern beide mit AES-256-GCM verschlüsselt auf unseren Servern in Deutschland. Trennen Sie das Konto in TikTok unter den Einstellungen für Sicherheit und Berechtigungen, meldet TikTok uns das, und wir entfernen das Konto auch bei uns.

Gleichzeitig auf anderen Plattformen

Ein Video im Hochformat passt meist auch zu YouTube Shorts und Instagram Reels. Ergänzen Sie dafür weitere platform[]-Felder. Jede Plattform zählt als eigener Upload. Hinweise zu Shorts finden Sie im Artikel YouTube Shorts automatisch hochladen, die Kontingente unter Preise und alle Felder auf der Seite API.