APIAPI Pubblicazione Social

Programma il video finito
senza aprire una dashboard

Una chiamata mette in coda un video renderizzato su un account collegato, al minuto che scegli. Rileggi il calendario, filtra la coda per stato, e lascia che un webhook firmato ti dica quando è davvero uscito.

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

Ottieni una chiave API Riferimento API

Tre chiamate, dal rendering al pubblicato

Trova la destinazione una volta, poi programma quanto vuoi.

Trova la destinazione

Gli account collegati sono in sola lettura via API: si collegano una volta dalla dashboard, perché il materiale OAuth non deve mai lasciare il server. Elencali e tieni l'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"

Programma il post

Un video, un account, un momento e una didascalia. La chiamata restituisce il post in coda, non uno pubblicato: il tuo scheduler resta la fonte di verità.

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"
  }'

Guardalo uscire

Leggi il calendario raggruppato per giorno, filtra la coda per stato, oppure prendi post.published e smetti di chiedere. Gli errori arrivano allo stesso modo, con il motivo allegato.

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"

Cosa accetta un post programmato

Quattro campi. Il file renderizzato, la destinazione, il minuto e le parole.

video_id

Il video da pubblicare. Deve essere renderizzato: la coda pubblica un file, non una timeline.

account_id

Su quale account collegato va. Un post, una destinazione, così un errore non trascina mai gli altri.

scheduled_at

Quando deve uscire. Tutto ciò che la piattaforma accetta, anche subito.

caption

La didascalia che lo accompagna. Hashtag e menzioni viaggiano lì dentro, esattamente come scritti.

La coda, leggibile in entrambi i sensi

Il calendario risponde a "cosa esce questa settimana"; la risorsa risponde a "che fine ha fatto questo video". Entrambi sono filtrabili, quindi una dashboard si costruisce senza un solo endpoint in più.

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

Sapere quando è uscito davvero

Programmare è una promessa, non un risultato. post.published scatta quando la piattaforma ha accettato, anche su una pubblicazione parziale, dove il payload porta il risultato per account.

post.publishedpost.failed

Le domande che gli sviluppatori fanno per prime

Posso collegare un account via API?

No, ed è voluto. Gli account si collegano dalla dashboard perché i token OAuth non lascino mai il server; l'API può elencarli e pubblicarci sopra, nient'altro.

Cosa succede se una piattaforma rifiuta il post?

Il post resta in coda con stato di errore e post.failed scatta con il motivo. Niente viene ritentato in silenzio alle tue spalle.

Posso pubblicare lo stesso video su più account?

Sì: una chiamata per destinazione. Tenerle separate evita che una piattaforma che rifiuta una didascalia annulli tutte le altre.

Come costruisco una vista calendario?

publishing.calendar restituisce i post programmati raggruppati per giorno fra due date. Per qualcosa di più specifico, filtra la risorsa scheduled_posts su status, platform o video_id.

Specifica OpenAPI Codici di errore Esplora l'API