APIAPI for publisering i sosiale medier

Planlegg den ferdige videoen
uten å åpne et dashbord

Ett kall køer en rendret video på en tilkoblet konto, på minuttet du velger. Les kalenderen tilbake, filtrer køen på status, og la et signert webhook fortelle når den faktisk gikk ut.

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

Skaff en API-nøkkel API-referanse

Tre kall, fra rendering til publisert

Finn destinasjonen én gang, og planlegg så mye du vil etterpå.

Finn destinasjonen

Tilkoblede kontoer er skrivebeskyttet via API-et: de kobles til én gang fra dashbordet, fordi OAuth-materiale aldri skal forlate serveren. Hent listen og ta vare på id-en.

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"

Planlegg innlegget

En video, en konto, et tidspunkt og en bildetekst. Kallet returnerer det køede innlegget, ikke et publisert, så din egen planlegger forblir sannhetskilden.

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

Les kalenderen gruppert per dag, filtrer køen på status, eller ta post.published og slutt å spørre. Feil kommer på samme måte, med årsaken vedlagt.

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"

Hva et planlagt innlegg tar imot

Fire felter. Den rendrede filen, destinasjonen, minuttet og ordene.

video_id

Videoen som skal publiseres. Den må være rendret: køen publiserer en fil, ikke en tidslinje.

account_id

Hvilken tilkoblet konto den går til. Ett innlegg, én destinasjon, slik at en feil aldri drar med seg de andre.

scheduled_at

Når det skal ut. Alt plattformen godtar, også med en gang.

caption

Bildeteksten som følger med. Emneknagger og omtaler reiser inni den, akkurat som de ble skrevet.

Køen kan leses begge veier

Kalenderen svarer på "hva går ut denne uken"; ressursen svarer på "hva ble det av denne videoen". Begge kan filtreres, så et dashbord bygges uten ett eneste ekstra endepunkt.

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

Vit når det faktisk ble lagt ut

En planlegging er et løfte, ikke et resultat. post.published utløses når plattformen har godtatt, også ved en delvis publisering, der nyttelasten bærer utfallet per konto.

post.publishedpost.failed

Det utviklere spør om først

Kan jeg koble til en konto via API-et?

Nei, og det er med vilje. Kontoer kobles til fra dashbordet slik at OAuth-tokenene aldri forlater serveren; API-et kan liste dem og publisere til dem, ikke noe mer.

Hva skjer hvis en plattform avviser innlegget?

Innlegget blir liggende i køen med feilstatus, og post.failed utløses med årsaken. Ingenting prøves på nytt i stillhet bak ryggen din.

Kan jeg publisere den samme videoen til flere kontoer?

Ja: ett kall per destinasjon. Å holde dem adskilt gjør at en plattform som avviser en bildetekst aldri avlyser de andre.

Hvordan bygger jeg en kalendervisning?

publishing.calendar returnerer de planlagte innleggene gruppert per dag mellom to datoer. Vil du ha noe mer spesifikt, filtrer ressursen scheduled_posts på status, platform eller video_id.

OpenAPI-spesifikasjon Feilkoder Utforsk API-et