TikTok-Posts per API planen

Einen TikTok-Post für eine bestimmte Zeit planen

Der direkteste Ansatz ist, ein exaktes Veröffentlichungsdatum festzulegen. Fügen Sie den Parameter scheduled_date (ISO-8601-Format) und eine timezone (IANA-Format) zu Ihrem Upload-Request hinzu. Die API akzeptiert Daten bis zu 365 Tage in der Zukunft.

Hier ist ein cURL-Beispiel, das ein TikTok-Video für den 22. September um 10:00 Uhr New Yorker Zeit plant, mit der Privatsphäre auf öffentlich gesetzt und Duetten deaktiviert:

curl -X POST https://api.upload-post.com/api/upload \
  -H "Autorisierung: Apikey Ihr-API-Schlüssel-hier" \
  -F "[email protected]" \
  -F "user=mybrand" \
  -F "title=Morning routine that changed everything #fyp #routine" \
  -F "platform[]=tiktok" \
  -F "scheduled_date=2025-09-22T10:00:00Z" \
  -F "timezone=America/New_York" \
  -F "privacy_level=PUBLIC" \
  -F "disable_duet=false" \
  -F "disable_comment=false" \
  -F "disable_stitch=false"

Wenn der Post erfolgreich geplant wurde, antwortet die API mit einem 202 Statuscode und einer job_id:

{
  "success": true,
  "job_id": "scheduler_job_abc123",
  "scheduled_date": "2025-09-22T10:00:00Z"
}

Speichern Sie diese job_id. Sie benötigen sie, um den Post später zu bearbeiten, umzuplanen oder abzubrechen. Sie können auch jederzeit alle Ihre geplanten Posts auflisten:

curl https://api.upload-post.com/api/uploadposts/schedule \
  -H "Autorisierung: Apikey Ihr-API-Schlüssel-hier"

Dies gibt ein Array aller ausstehenden Jobs mit ihrer job_id, scheduled_date, Plattformdetails und einer Vorschau-URL des Contents zurück. Für einen tieferen Einblick in die Planung über alle Plattformen hinweg, lesen Sie die allgemeine Planungsanleitung.

Die Warteschlange für automatisches Planen nutzen

Exakte Daten zu wählen funktioniert, wenn Sie nur wenige Posts haben. Aber wenn Sie Content in großen Mengen produzieren, wird das manuelle Auswählen einer Zeit für jedes Video schnell mühsam. Das Warteschlangensystem löst dieses Problem. Sie definieren Ihren bevorzugten Veröffentlichungsplan einmalig, und dann wird jedem hinzugefügten Content automatisch der nächste verfügbare Slot zugewiesen.

Ihren Warteschlangen-Zeitplan konfigurieren

Teilen Sie dem System zunächst mit, wann Content veröffentlicht werden soll. Dieses Beispiel richtet drei Slots pro Tag ein, Montag bis Freitag, in der New Yorker Zeitzone:

curl -X POST https://api.upload-post.com/api/uploadposts/queue/settings \
  -H "Autorisierung: Apikey Ihr-API-Schlüssel-hier" \
  -H "Content-Type: application/json" \
  -d '{
    "timezone": "America/New_York",
    "slots": [
      { "hour": 8, "minute": 0 },
      { "hour": 12, "minute": 30 },
      { "hour": 18, "minute": 0 }
    ],
    "days": [0, 1, 2, 3, 4]
  }'

Das ergibt 15 TikTok-Slots pro Woche: 8:00 Uhr, 12:30 Uhr und 18:00 Uhr, Montag bis Freitag. Sie können bis zu 24 Slots pro Tag definieren und Wochenenden einbeziehen, indem Sie die Tage 5 und 6 hinzufügen.

Inhalte zur Warteschlange hinzufügen

Anstatt jetzt ein scheduled_date zu übergeben, setzen Sie add_to_queue=true. Das System füllt den nächsten freien Slot automatisch:

curl -X POST https://api.upload-post.com/api/upload \
  -H "Autorisierung: Apikey Ihr-API-Schlüssel-hier" \
  -F "[email protected]" \
  -F "user=mybrand" \
  -F "title=POV: you finally automated your TikTok posting #devlife" \
  -F "platform[]=tiktok" \
  -F "add_to_queue=true" \
  -F "privacy_level=PUBLIC"

Wenn es Mittwoch 14 Uhr ist, wird dieses Video für 18:00 Uhr am selben Tag eingeplant. Wenn alle Mittwochs-Slots belegt sind, wird es auf Donnerstag 8:00 Uhr verschoben. Sie können bevorstehende verfügbare Slots vor dem Hinzufügen von Content anzeigen:

curl https://api.upload-post.com/api/uploadposts/queue/preview?count=10 \
  -H "Autorisierung: Apikey Ihr-API-Schlüssel-hier"

Dies gibt die nächsten 10 verfügbaren Slots mit ihren exakten Daten und Uhrzeiten zurück, sodass Sie genau wissen, wann jeder eingereihte Post veröffentlicht wird.

TikTok-spezifische Einstellungen, die Sie kennen sollten

TikToks API stellt mehrere Parameter bereit, die andere Plattformen nicht haben. Einige sind optional, aber einige wenige sind in bestimmten Situationen gesetzlich vorgeschrieben. Hier ist die vollständige Referenz:

Ein Hinweis zu Brand Content: Wenn Sie gesponserte Inhalte erstellen, müssen Sie brand_content_toggle=true setzen. Dies ist nicht optional. Sowohl die FTC in den USA als auch die entsprechenden EU-Vorschriften verlangen eine klare Offenlegung bezahlter Partnerschaften. TikTok setzt dies auch auf ihrer Seite durch, sodass ein Versäumnis der korrekten Kennzeichnung zur Entfernung des Contents führen kann. Wenn Sie Ihr eigenes Unternehmen bewerben (nicht eine Drittanbieter-Marke), verwenden Sie stattdessen brand_organic_toggle=true.

Für KI-generierten Content fügt die Einstellung is_aigc=true ein für Zuschauer sichtbares Offenlegungslabel hinzu. Da sich die Vorschriften für KI-Content weiterentwickeln, ist eine proaktive Kennzeichnung eine gute Praxis.

TikTok-Posts mit Python planen

Die Python-Automatisierungsanleitung behandelt das SDK ausführlich. Hier ist ein praktisches Beispiel für TikTok: Batch-Planung jedes Videos in einem Ordner, jeweils eine Stunde versetzt, ab morgen früh.

import os
import glob
from datetime import datetime, timedelta
from upload_post import UploadPostClient

client = UploadPostClient(api_key="your-api-key-here")

video_folder = "/path/to/tiktok-videos"
videos = sorted(glob.glob(os.path.join(video_folder, "*.mp4")))

# Start scheduling from tomorrow at 9 AM Eastern
base_time = (datetime.now() + timedelta(days=1)).replace(
    hour=9, minute=0, second=0, microsecond=0
)

print(f"Found {len(videos)} videos to schedule")

for i, video_path in enumerate(videos):
    publish_time = base_time + timedelta(hours=i)
    filename = os.path.basename(video_path)
    title = filename.replace(".mp4", "").replace("-", " ").replace("_", " ")

    try:
        response = client.upload_video(
            video_path=video_path,
            title=title,
            user="mybrand",
            platforms=["tiktok"],
            scheduled_date=publish_time.isoformat(),
            timezone="America/New_York",
            privacy_level="ÖFFENTLICH",
            disable_duet=False,
            disable_comment=False,
            cover_timestamp=3000,
            async_upload=True
        )
        job_id = response.get("job_id", "pending")
        print(f"[{i+1}/{len(videos)}] Scheduled {filename} for {publish_time} (Job: {job_id})")
    except Exception as e:
        print(f"[{i+1}/{len(videos)}] Failed: {filename} - {e}")

print("Alle Videos geplant!")

Dieses Skript plant jedes Video im Abstand von einer Stunde. Sie können das timedelta an Ihren bevorzugten Rhythmus anpassen. Beachten Sie, dass TikTok ein tägliches Limit von 15 Uploads pro 24-Stunden-Rollzeitraum pro Konto durchsetzt. Wenn Sie mehr als 15 Videos haben, verteilen Sie sie über mehrere Tage oder nutzen Sie das Warteschlangensystem, das Limits automatisch verwaltet.

Sie können dies auch mit der FFmpeg API kombinieren, um Videos vor der Planung zu skalieren oder zuzuschneiden, oder den Social-Media-Feiertagskalender nutzen, um Ihre Veröffentlichungstermine mit Trendthemen abzustimmen.

No-Code: TikTok-Posts mit n8n planen

Wenn Sie visuelle Automatisierung dem Schreiben von Code vorziehen, ist n8n eine ausgezeichnete Option. Das Setup verwendet den HTTP-Request-Node, um die Upload-Post API aufzurufen, und Sie können es über Google Sheets, Google Drive, Airtable oder einen manuellen Button auslösen.

Der grundlegende Ablauf sieht so aus:

1. Trigger-Node: wird nach einem Zeitplan, einer neuen Tabellenzeile oder einer neuen Datei in einem Cloud-Ordner ausgelöst.
2. HTTP-Request-Node: sendet einen multipart/form-data POST an https://api.upload-post.com/api/upload mit Ihrem API-Schlüssel, der Videodatei, dem Titel, platform[]=tiktok und add_to_queue=true.
3. Optional: eine Slack- oder E-Mail-Benachrichtigung, wenn der Upload erfolgreich ist oder fehlschlägt.

Wir haben eine vorgefertigte TikTok-Upload-Vorlage für n8n, die Sie mit einem Klick importieren können. Durchsuchen Sie alle verfügbaren n8n-Vorlagen für weitere Automatisierungsideen. Sie können dies auch mit Make.com einrichten, wenn das Ihre bevorzugte Automatisierungsplattform ist.

TikTok-Videoanforderungen

Stellen Sie vor der Planung sicher, dass Ihre Videos den TikTok-Spezifikationen entsprechen. Das Hochladen einer Datei, die diese Anforderungen nicht erfüllt, führt zu einem fehlgeschlagenen Post.

Wenn Ihre Quellvideos im falschen Format oder Seitenverhältnis vorliegen, kann die FFmpeg API die Konvertierung in der Cloud vor der Veröffentlichung übernehmen. Sie können auch YouTube-Videos automatisch für TikTok umwandeln.

Häufig gestellte Fragen

Kann ich TikTok-Posts kostenlos planen?

Ja. Upload-Post bietet eine kostenlose Stufe mit 10 Uploads pro Monat, und die Planungsfunktion ist in allen Tarifen verfügbar, einschließlich der kostenlosen Stufe. Sie können Posts mit exakten Daten planen oder das Warteschlangensystem kostenlos nutzen. Wenn Sie mehr Volumen benötigen, beginnen kostenpflichtige Tarife zu einem erschwinglichen Preis ohne langfristige Bindung.

Was passiert, wenn TikTok zum geplanten Zeitpunkt meines Posts nicht erreichbar ist?

Upload-Post wiederholt fehlgeschlagene Uploads automatisch. Wenn TikToks API zum geplanten Zeitpunkt vorübergehend nicht verfügbar ist, versucht das System in den folgenden Minuten erneut zu veröffentlichen. Wenn das Problem fortbesteht, erhalten Sie eine Benachrichtigung über Webhooks (falls konfiguriert) oder Sie können den Status über den Endpunkt GET /api/uploadposts/status?job_id=your_job_id prüfen. Ihr Content geht niemals verloren.

Kann ich gleichzeitig auf TikTok und Instagram planen?

Absolut. Übergeben Sie einfach mehrere Plattformen im selben Request: platform[]=tiktok und platform[]=instagram. Das gleiche Video, der gleiche Titel und das gleiche geplante Datum gelten für alle Plattformen. Wenn Sie unterschiedliche Beschriftungen pro Plattform benötigen, verwenden Sie den Parameter tiktok_title für TikTok-spezifischen Text, während das Haupt-title-Feld an andere Plattformen geht. Lesen Sie unsere Anleitung zum Bulk Upload of Videos über Plattformen hinweg für fortgeschrittenere Multi-Plattform-Arbeitsabläufe.

Wie weit im Voraus kann ich TikTok-Posts planen?

Bis zu 365 Tage. Der Parameter scheduled_date akzeptiert jedes Datum innerhalb des nächsten Jahres. In Kombination mit dem Warteschlangensystem könnten Sie theoretisch ein ganzes Jahr Content in einer einzigen Batch-Sitzung füllen. Die meisten Nutzer planen ein bis vier Wochen voraus, was ein gutes Gleichgewicht zwischen Planung und Flexibilität darstellt. Unser Social-Media-Feiertagskalender kann Ihnen helfen, Content rund um wichtige Termine im Laufe des Jahres zu planen.