APISocial-Media-Publishing-API

Plane das fertige Video
ohne ein Dashboard zu öffnen

Ein Aufruf reiht ein gerendertes Video auf einem verbundenen Konto zur gewünschten Minute ein. Lies den Kalender zurück, filtere die Warteschlange nach Status, und lass einen signierten Webhook sagen, wann es wirklich raus war.

POSThttps://autostud.ai/api/v1/actions/publishing.schedule_post

API-Schlüssel holen API-Referenz

Drei Aufrufe, vom Render zum Post

Ziel einmal finden, danach so viel planen, wie du willst.

Das Ziel finden

Verbundene Konten sind über die API nur lesbar: Sie werden einmal im Dashboard verknüpft, weil OAuth-Material den Server nie verlassen darf. Liste sie auf und merk dir die ID.

export AUTOSTUD_API_KEY="sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

# Read-only on purpose: accounts are connected from the dashboard,
# so the OAuth tokens never leave the server.
curl "https://autostud.ai/api/v1/social_accounts?status=active&limit=10" \
  -H "Authorization: Bearer $AUTOSTUD_API_KEY"

Den Post planen

Ein Video, ein Konto, ein Zeitpunkt und ein Text. Der Aufruf liefert den eingereihten Post zurück, keinen veröffentlichten, damit dein eigener Scheduler die Wahrheit bleibt.

curl -X POST https://autostud.ai/api/v1/actions/publishing.schedule_post \
  -H "Authorization: Bearer $AUTOSTUD_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: lighthouse-ep12-tiktok" \
  -d '{
    "video_id": "0f4c8b71-2d95-47a3-9e6c-15b8ad7f3c20",
    "account_id": "9a2c6f18-4b70-4d35-8e91-0f7d3c84b562",
    "scheduled_at": "2026-08-21T18:30:00.000Z",
    "caption": "Episode 12: the keeper who never slept #lighthouse"
  }'

Zusehen, wie er rausgeht

Lies den Kalender nach Tagen gruppiert, filtere die Warteschlange nach Status, oder nimm post.published und hör auf zu fragen. Fehlschläge kommen genauso, mit dem Grund dabei.

curl -X POST https://autostud.ai/api/v1/actions/publishing.calendar \
  -H "Authorization: Bearer $AUTOSTUD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "from": "2026-08-17", "to": "2026-08-24" }'

# Need something more specific? The queue is a plain resource:
curl "https://autostud.ai/api/v1/scheduled_posts?status=error&platform=tiktok" \
  -H "Authorization: Bearer $AUTOSTUD_API_KEY"

Was ein geplanter Post annimmt

Vier Felder. Die gerenderte Datei, das Ziel, die Minute und die Worte.

video_id

Das zu veröffentlichende Video. Es muss gerendert sein: Die Warteschlange postet eine Datei, keine Timeline.

account_id

Auf welches verbundene Konto es geht. Ein Post, ein Ziel, damit ein Fehlschlag nie die anderen mitreißt.

scheduled_at

Wann es rausgehen soll. Alles, was die Plattform akzeptiert, auch sofort.

caption

Die Bildunterschrift dazu. Hashtags und Erwähnungen reisen darin mit, genau wie getippt.

Die Warteschlange, in beide Richtungen lesbar

Der Kalender beantwortet "was geht diese Woche raus", die Ressource beantwortet "was ist aus diesem Video geworden". Beide sind filterbar, ein Dashboard entsteht also ohne einen einzigen zusätzlichen Endpunkt.

GET /api/v1/social_accountsGET /api/v1/scheduled_postspublishing.calendar

Erfahre, wann es wirklich gepostet wurde

Ein Termin ist ein Versprechen, kein Ergebnis. post.published feuert, wenn die Plattform angenommen hat, auch bei einer Teilveröffentlichung, wo das Payload das Ergebnis pro Konto trägt.

post.publishedpost.failed

Was Entwickler zuerst fragen

Kann ich ein Konto über die API verbinden?

Nein, und das ist Absicht. Konten werden im Dashboard verbunden, damit die OAuth-Token den Server nie verlassen; die API kann sie auflisten und darauf veröffentlichen, mehr nicht.

Was passiert, wenn eine Plattform den Post ablehnt?

Der Post bleibt mit Fehlerstatus in der Warteschlange, und post.failed feuert mit dem Grund. Nichts wird still hinter deinem Rücken wiederholt.

Kann ich dasselbe Video auf mehrere Konten posten?

Ja: ein Aufruf pro Ziel. Getrennt zu bleiben verhindert, dass eine Plattform, die einen Text ablehnt, alle anderen mitkippt.

Wie baue ich eine Kalenderansicht?

publishing.calendar liefert die geplanten Posts zwischen zwei Daten nach Tagen gruppiert. Für Genaueres filtere die Ressource scheduled_posts nach status, platform oder video_id.

OpenAPI-Spezifikation Fehlercodes API entdecken