APIAPI til udgivelse på sociale medier

Planlæg den færdige video
uden at åbne et dashboard

Ét kald sætter en renderet video i kø på en forbundet konto, på det minut du vælger. Læs kalenderen tilbage, filtrér køen på status, og lad et signeret webhook fortælle, hvornår den faktisk gik ud.

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

Få en API-nøgle API-reference

Tre kald, fra rendering til udgivet

Find destinationen én gang, og planlæg derefter så meget du vil.

Find destinationen

Forbundne konti er skrivebeskyttede via API-et: de forbindes én gang fra dashboardet, fordi OAuth-materiale aldrig må forlade serveren. Hent listen, og gem id-et.

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"

Planlæg opslaget

En video, en konto, et tidspunkt og en billedtekst. Kaldet returnerer det køede opslag, ikke et udgivet, så din egen planlægger forbliver sandhedskilden.

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å ud

Læs kalenderen grupperet per dag, filtrér køen på status, eller tag post.published og hold op med at spørge. Fejl kommer på samme måde, med årsagen vedhæftet.

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"

Hvad et planlagt opslag tager imod

Fire felter. Den renderede fil, destinationen, minuttet og ordene.

video_id

Videoen der skal udgives. Den skal være renderet: køen udgiver en fil, ikke en tidslinje.

account_id

Hvilken forbundet konto den går til. Ét opslag, én destination, så en fejl aldrig trækker de andre med.

scheduled_at

Hvornår det skal ud. Alt hvad platformen accepterer, også med det samme.

caption

Billedteksten der følger med. Hashtags og omtaler rejser inde i den, præcis som de blev skrevet.

Køen kan læses begge veje

Kalenderen svarer på "hvad går ud i denne uge"; ressourcen svarer på "hvad blev der af denne video". Begge kan filtreres, så et dashboard bygges uden en eneste ekstra endpoint.

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

Få at vide, hvornår det faktisk blev slået op

En planlægning er et løfte, ikke et resultat. post.published udløses, når platformen har accepteret, også ved en delvis udgivelse, hvor payloaden bærer udfaldet per konto.

post.publishedpost.failed

Det udviklere spørger om først

Kan jeg forbinde en konto via API-et?

Nej, og det er bevidst. Konti forbindes fra dashboardet, så OAuth-tokens aldrig forlader serveren; API-et kan liste dem og udgive til dem, ikke andet.

Hvad sker der, hvis en platform afviser opslaget?

Opslaget bliver i køen med fejlstatus, og post.failed udløses med årsagen. Intet forsøges igen i stilhed bag din ryg.

Kan jeg udgive den samme video til flere konti?

Ja: ét kald per destination. At holde dem adskilt betyder, at en platform, der afviser en billedtekst, aldrig aflyser de andre.

Hvordan bygger jeg en kalendervisning?

publishing.calendar returnerer de planlagte opslag grupperet per dag mellem to datoer. Vil du have noget mere specifikt, så filtrér ressourcen scheduled_posts på status, platform eller video_id.

OpenAPI-spec Fejlkoder Udforsk API'et