APIAPI Publication Réseaux Sociaux

Programmez la vidéo finie
sans ouvrir un dashboard

Un appel met une vidéo rendue en file sur un compte connecté, à la minute choisie. Relisez le calendrier, filtrez la file par statut, et laissez un webhook signé vous dire quand elle est vraiment partie.

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

Obtenir une clé API Référence API

Trois appels, du rendu à la publication

Trouvez la destination une fois, puis programmez autant que vous voulez.

Trouvez la destination

Les comptes connectés sont en lecture seule via l'API : ils se relient une fois depuis le dashboard, parce que le matériel OAuth ne doit jamais quitter le serveur. Listez-les et gardez l'identifiant.

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"

Programmez le post

Une vidéo, un compte, un moment et une légende. L'appel renvoie le post en file, pas un post publié : votre propre planificateur reste la source de vérité.

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

Regardez-le partir

Relisez le calendrier jour par jour, filtrez la file par statut, ou prenez post.published et arrêtez de demander. Les échecs arrivent pareil, avec la raison attachée.

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"

Ce que prend un post programmé

Quatre champs. Le fichier rendu, la destination, la minute et les mots.

video_id

La vidéo à publier. Elle doit être rendue : la file poste un fichier, pas une timeline.

account_id

Sur quel compte connecté elle part. Un post, une destination : un échec n'entraîne jamais les autres.

scheduled_at

Quand elle doit sortir. Tout ce que la plateforme accepte, y compris tout de suite.

caption

La légende qui l'accompagne. Hashtags et mentions voyagent dedans, exactement tels que saisis.

La file, lisible dans les deux sens

Le calendrier répond à « qu'est-ce qui sort cette semaine ? » ; la ressource répond à « qu'est devenue cette vidéo ? ». Les deux sont filtrables : un dashboard se construit sans un seul endpoint de plus.

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

Sachez quand c'est vraiment parti

Une programmation est une promesse, pas un résultat. post.published se déclenche quand la plateforme a accepté, y compris sur une publication partielle, où la charge utile porte le résultat par compte.

post.publishedpost.failed

Les questions que les développeurs posent en premier

Puis-je connecter un compte via l'API ?

Non, et c'est délibéré. Les comptes se connectent depuis le dashboard pour que les jetons OAuth ne quittent jamais le serveur ; l'API peut les lister et publier dessus, rien d'autre.

Que se passe-t-il si une plateforme refuse le post ?

Le post reste dans la file avec un statut d'erreur et post.failed se déclenche avec la raison. Rien n'est réessayé silencieusement dans votre dos.

Puis-je publier la même vidéo sur plusieurs comptes ?

Oui : un appel par destination. Les garder séparés évite qu'une plateforme refusant une légende annule toutes les autres.

Comment construire une vue calendrier ?

publishing.calendar renvoie les posts programmés groupés par jour entre deux dates. Pour plus précis, filtrez la ressource scheduled_posts sur status, platform ou video_id.

Spécification OpenAPI Codes d'erreur Découvrir l'API