Social-Media-Posts per API planen

Die zwei Wege, Content zu planen

Upload-Post bietet Ihnen zwei Ansätze für die Planung. Sie können ein genaues Datum und eine Uhrzeit mit dem Parameter scheduled_date festlegen, oder Sie lassen das System den besten Zeitpunkt über das Warteschlangensystem bestimmen. Beide funktionieren auf jedem Endpoint: Video-Uploads, Foto-Uploads und Text-Posts.

Option A: Für ein bestimmtes Datum und Uhrzeit planen

Fügen Sie den Parameter scheduled_date zu einem beliebigen Upload-Request hinzu. Das Format ist ISO-8601 und Sie können bis zu 365 Tage im Voraus planen.

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=Coming soon... stay tuned!" \
  -F "platform[]=tiktok" \
  -F "platform[]=instagram" \
  -F "scheduled_date=2025-09-22T10:00:00Z" \
  -F "timezone=Europe/Madrid"

Ein paar wichtige Details: Das Datum ist standardmässig in UTC, aber Sie können einen timezone Parameter im IANA-Format übergeben (wie America/New_York, Europa/Berlin, Asia/Tokyo), damit der Post zur richtigen Ortszeit live geht. Das erspart Ihnen die Zeitzonen-Rechnerei.

Wenn ein Post erfolgreich geplant wird, antwortet die API mit Status 202 und enthält eine job_id:

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

Bewahren Sie diese job_id auf, denn Sie brauchen sie, wenn Sie den Post später bearbeiten oder stornieren möchten.

Option B: Das Warteschlangensystem nutzen

Die Warteschlange ist perfekt, wenn Sie konsistentes Posting wollen, ohne genaue Zeiten festzulegen. Anstatt ein Datum zu wählen, setzen Sie add_to_queue=true und Upload-Post weist den nächsten verfügbaren Zeitslot basierend auf Ihrem konfigurierten Zeitplan zu.

Warteschlange einrichten

Zuerst konfigurieren Sie Ihre Warteschlangen-Einstellungen. Sie definieren, an welchen Tagen und zu welchen Zeitslots Sie posten möchten:

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": 9, "minute": 0 },
      { "hour": 12, "minute": 30 },
      { "hour": 17, "minute": 0 }
    ],
    "days": [0, 1, 2, 3, 4]
  }'

Dieses Beispiel veröffentlicht um 9:00 Uhr, 12:30 Uhr und 17:00 Uhr (New Yorker Zeit), Montag bis Freitag. Sie können bis zu 24 Slots pro Tag definieren.

Inhalte zur Warteschlange hinzufügen

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=Monday motivation" \
  -F "platform[]=tiktok" \
  -F "platform[]=instagram" \
  -F "add_to_queue=true"

Upload-Post weist diesem Post automatisch den nächsten offenen Slot zu. Wenn es Mittwoch 14 Uhr ist, wird der Post für 17:00 Uhr desselben Tages geplant. Wenn alle Mittwoch-Slots belegt sind, geht es weiter zum Donnerstag um 9:00 Uhr.

Vorschau der kommenden Warteschlangen-Slots

Möchten Sie sehen, welche Zeiten verfügbar sind, bevor Sie Content einreihen? Nutzen Sie den Preview-Endpoint:

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

Das gibt die nächsten 10 verfügbaren Slots mit ihren genauen Daten und Uhrzeiten zurück. Sie können bis zu 50 auf einmal abfragen.

Geplante Posts verwalten

Sobald Content geplant ist, haben Sie über die API die volle Kontrolle darüber.

List all scheduled posts

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

Gibt ein Array ausstehender Jobs mit ihrer job_id, scheduled_date, Plattform-Details und einer Vorschau-URL des Contents zurück.

Einen geplanten Post bearbeiten

Müssen Sie das Veröffentlichungsdatum ändern oder die Beschreibung aktualisieren? Nutzen Sie einen PATCH-Request:

curl -X PATCH https://api.upload-post.com/api/uploadposts/schedule/scheduler_job_abc123 \
  -H "Autorisierung: Apikey Ihr-API-Schlüssel-hier" \
  -H "Content-Type: application/json" \
  -d '{
    "scheduled_date": "2025-09-25T14:00:00Z",
    "title": "Aktualisierte Bildunterschrift mit besseren Hashtags"
  }'

Einen geplanten Post stornieren

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

Der Post und seine hochgeladenen Assets werden sofort entfernt.

Einen Content-Kalender mit der Warteschlange aufbauen

Hier ist ein praktischer Workflow, den viele Agenturen nutzen. Sie produzieren Content am Montag im Batch, laden alles in die Warteschlange hoch, und das System verteilt es automatisch über die Woche. Sie müssen nicht am Mittwoch um 9 Uhr online sein, um den Veröffentlichen-Button zu drücken.

Das ist besonders leistungsstark in Kombination mit Tools wie n8n oder Make.com. Zum Beispiel können Sie einen Workflow einrichten, bei dem neue Dateien in einem Google Drive Ordner automatisch zur Warteschlange hinzugefügt werden. Schauen Sie sich unser Google Sheets Planungs-Template für n8n für ein fertiges Setup an.

Unser Social-Media-Feiertagskalender ist ebenfalls praktisch, um Content rund um wichtige Termine im Jahr zu planen.

Planung mit Python

from upload_post import UploadPostClient
from datetime import datetime, timedelta

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

# Schedule a video for tomorrow at 10 AM Madrid time
publish_date = (datetime.now() + timedelta(days=1)).replace(
    hour=10, minute=0, second=0
)

response = client.upload_video(
    video_path="/path/to/video.mp4",
    title="Geplant von Python",
    user="mybrand",
    platforms=["tiktok", "instagram", "youtube"],
    scheduled_date=publish_date.isoformat(),
    timezone="Europe/Madrid"
)

print(f"Geplant! Job-ID: {response['job_id']}")

Tägliche Upload-Limits pro Plattform

Wenn Sie viel Content planen, beachten Sie, dass jede Plattform tägliche Limits durchsetzt. Das sind rollende 24-Stunden-Fenster pro verbundenem Konto:

Das Warteschlangensystem respektiert diese Limits automatisch und plant nicht zu viel für eine Plattform ein.

Häufig gestellte Fragen

Kann ich denselben Content für verschiedene Zeiten auf verschiedenen Plattformen planen?

Nicht in einem einzigen Request, aber Sie können separate Requests für jede Plattform mit unterschiedlichen scheduled_date Werten senden. Oder nutzen Sie das Warteschlangensystem, das automatisch verteilt.

Was passiert, wenn ein geplanter Post fehlschlägt?

Sie erhalten eine Benachrichtigung über Webhooks (falls konfiguriert) mit den Fehlerdetails. Sie können den Status auch mit dem GET /api/uploadposts/status?job_id=your_job_id Endpoint prüfen.

Kann ich die Planung mit den No-Code-Tools kombinieren?

Auf jeden Fall. Sowohl n8n als auch Make.com können die Parameter scheduled_date oder add_to_queue über das HTTP-Request-Modul senden. Das bedeutet, Sie können einen visuellen Workflow bauen, der aus einer Tabelle liest und alles automatisch plant.