APIAPI de Publicación en Redes Sociales

Programa el vídeo terminado
sin abrir ningún panel

Una llamada encola un vídeo renderizado en una cuenta conectada al minuto que elijas. Vuelve a leer el calendario, filtra la cola por estado y deja que un webhook firmado te diga cuándo salió de verdad.

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

Consigue una clave API Referencia de la API

Tres llamadas, del render a lo publicado

Encuentra el destino una vez y luego programa cuanto quieras.

Encuentra el destino

Las cuentas conectadas son de solo lectura por la API: se enlazan una vez desde el panel, porque el material OAuth nunca debe salir del servidor. Lístalas y quédate con el 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"

Programa la publicación

Un vídeo, una cuenta, un momento y un texto. La llamada devuelve la publicación en cola, no una publicada, así que tu propio planificador sigue siendo la fuente de verdad.

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

Míralo salir

Lee el calendario agrupado por día, filtra la cola por estado, o coge post.published y deja de preguntar. Los fallos llegan igual, con el motivo adjunto.

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"

Qué acepta una publicación programada

Cuatro campos. El archivo renderizado, el destino, el minuto y las palabras.

video_id

El vídeo a publicar. Tiene que estar renderizado: la cola publica un archivo, no una línea de tiempo.

account_id

A qué cuenta conectada va. Una publicación, un destino, así un fallo nunca arrastra a las demás.

scheduled_at

Cuándo debe salir. Lo que la plataforma acepte, incluido ahora mismo.

caption

El texto que la acompaña. Hashtags y menciones viajan dentro, exactamente como se escribieron.

La cola, legible en ambos sentidos

El calendario responde a "qué sale esta semana"; el recurso responde a "qué pasó con este vídeo". Ambos se filtran, así que un panel se construye sin un solo endpoint extra.

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

Entérate de cuándo se publicó de verdad

Programar es una promesa, no un resultado. post.published se dispara cuando la plataforma lo aceptó, incluso en una publicación parcial, donde el payload lleva el resultado por cuenta.

post.publishedpost.failed

Lo que preguntan primero los desarrolladores

¿Puedo conectar una cuenta por la API?

No, y es deliberado. Las cuentas se conectan desde el panel para que los tokens OAuth nunca salgan del servidor; la API puede listarlas y publicar en ellas, nada más.

¿Qué pasa si una plataforma rechaza la publicación?

La publicación queda en la cola con estado de error y post.failed se dispara con el motivo. Nada se reintenta en silencio a tus espaldas.

¿Puedo publicar el mismo vídeo en varias cuentas?

Sí: una llamada por destino. Mantenerlas separadas evita que una plataforma que rechaza un texto cancele todas las demás.

¿Cómo construyo una vista de calendario?

publishing.calendar devuelve las publicaciones programadas agrupadas por día entre dos fechas. Para algo más concreto, filtra el recurso scheduled_posts por status, platform o video_id.

Especificación OpenAPI Códigos de error Explorar la API