APISocial Media Publishing API

Plan de afgewerkte video in
zonder een dashboard te openen

Eén call zet een gerenderde video in de wachtrij op een gekoppeld account, op de minuut die jij kiest. Lees de kalender terug, filter de wachtrij op status, en laat een ondertekende webhook zeggen wanneer hij er echt uit ging.

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

Drie calls, van render tot gepubliceerd

Vind de bestemming één keer en plan daarna zoveel je wilt.

  1. 1

    Vind de bestemming

    Gekoppelde accounts zijn via de API alleen leesbaar: ze worden één keer vanuit het dashboard gekoppeld, want OAuth-materiaal mag de server nooit verlaten. Vraag ze op en bewaar het 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"
  2. 2

    Plan de post

    Een video, een account, een moment en een bijschrift. De call geeft de ingeplande post terug, geen gepubliceerde, zodat je eigen planner de bron van waarheid blijft.

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

    Kijk hem eruit gaan

    Lees de kalender per dag gegroepeerd, filter de wachtrij op status, of pak post.published en stop met vragen. Mislukkingen komen net zo binnen, met de reden erbij.

    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"

Wat een geplande post aanneemt

Vier velden. Het gerenderde bestand, de bestemming, de minuut en de woorden.

video_id

De video die gepubliceerd wordt. Hij moet gerenderd zijn: de wachtrij post een bestand, geen tijdlijn.

account_id

Naar welk gekoppeld account hij gaat. Eén post, één bestemming, zodat een mislukking nooit de rest meesleurt.

scheduled_at

Wanneer hij eruit moet. Alles wat het platform accepteert, ook nu meteen.

caption

Het bijschrift dat meegaat. Hashtags en vermeldingen reizen erin mee, precies zoals getypt.

De wachtrij, beide kanten op leesbaar

De kalender beantwoordt "wat gaat er deze week uit"; de resource beantwoordt "wat is er met deze video gebeurd". Beide zijn filterbaar, dus een dashboard bouw je zonder één extra endpoint.

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

Weet wanneer hij echt geplaatst is

Inplannen is een belofte, geen resultaat. post.published vuurt wanneer het platform hem accepteerde, ook bij een gedeeltelijke publicatie, waar de payload het resultaat per account draagt.

post.publishedpost.failed

Wat ontwikkelaars het eerst vragen

Kan ik een account via de API koppelen?

Nee, en dat is bewust. Accounts koppel je vanuit het dashboard zodat de OAuth-tokens de server nooit verlaten; de API kan ze opsommen en erop publiceren, meer niet.

Wat als een platform de post weigert?

De post blijft in de wachtrij met een foutstatus en post.failed vuurt met de reden. Er wordt niets stilletjes achter je rug opnieuw geprobeerd.

Kan ik dezelfde video naar meerdere accounts sturen?

Ja: één call per bestemming. Ze gescheiden houden betekent dat één platform dat een bijschrift weigert de rest niet annuleert.

Hoe bouw ik een kalenderweergave?

publishing.calendar geeft de geplande posts per dag gegroepeerd tussen twee datums terug. Wil je het specifieker, filter dan de resource scheduled_posts op status, platform of video_id.

Klaar om te maken?

Maak virale video's in enkele minuten. Geen creditcard nodig voor de gratis proefperiode.

Veilig betalen
Direct toegang
Altijd opzegbaar