APIAPI för publicering i sociala medier

Schemalägg den färdiga videon
utan att öppna någon panel

Ett anrop köar en renderad video på ett anslutet konto, på minuten du väljer. Läs tillbaka kalendern, filtrera kön på status, och låt en signerad webhook berätta när den faktiskt gick ut.

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

Skaffa en API-nyckel API-referens

Tre anrop, från rendering till publicerat

Hitta destinationen en gång och schemalägg sedan hur mycket du vill.

Hitta destinationen

Anslutna konton är skrivskyddade via API:t: de kopplas en gång från panelen, eftersom OAuth-material aldrig får lämna servern. Lista dem och behåll id:t.

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"

Schemalägg inlägget

En video, ett konto, en tidpunkt och en bildtext. Anropet returnerar det köade inlägget, inte ett publicerat, så din egen schemaläggare förblir sanningskällan.

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

Se det gå ut

Läs kalendern grupperad per dag, filtrera kön på status, eller ta post.published och sluta fråga. Misslyckanden kommer på samma sätt, med orsaken bifogad.

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"

Vad ett schemalagt inlägg tar emot

Fyra fält. Den renderade filen, destinationen, minuten och orden.

video_id

Videon som ska publiceras. Den måste vara renderad: kön publicerar en fil, inte en tidslinje.

account_id

Vilket anslutet konto den går till. Ett inlägg, en destination, så att ett misslyckande aldrig drar med sig de andra.

scheduled_at

När det ska gå ut. Allt plattformen accepterar, även med en gång.

caption

Bildtexten som följer med. Hashtaggar och omnämnanden reser inuti den, precis som de skrevs.

Kön, läsbar åt båda hållen

Kalendern svarar på "vad går ut den här veckan"; resursen svarar på "vad hände med den här videon". Båda går att filtrera, så en panel byggs utan en enda extra endpoint.

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

Vet när den faktiskt publicerades

Ett schema är ett löfte, inte ett resultat. post.published avfyras när plattformen accepterade, även vid en delvis publicering, där nyttolasten bär utfallet per konto.

post.publishedpost.failed

Det utvecklare frågar först

Kan jag ansluta ett konto via API:t?

Nej, och det är avsiktligt. Konton ansluts från panelen så att OAuth-tokens aldrig lämnar servern; API:t kan lista dem och publicera till dem, inget annat.

Vad händer om en plattform nekar inlägget?

Inlägget ligger kvar i kön med felstatus och post.failed avfyras med orsaken. Inget görs om i tysthet bakom ryggen på dig.

Kan jag publicera samma video till flera konton?

Ja: ett anrop per destination. Att hålla dem åtskilda gör att en plattform som nekar en bildtext aldrig ställer in de andra.

Hur bygger jag en kalendervy?

publishing.calendar returnerar de schemalagda inläggen grupperade per dag mellan två datum. Vill du ha något mer specifikt, filtrera resursen scheduled_posts på status, platform eller video_id.

OpenAPI-spec Felkoder Utforska API:et