APIAPI de Publicação em Redes Sociais

Agende o vídeo terminado
sem abrir nenhum painel

Uma chamada põe um vídeo renderizado na fila de uma conta ligada, ao minuto que escolher. Releia o calendário, filtre a fila por estado e deixe um webhook assinado dizer-lhe quando saiu mesmo.

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

Obter uma chave API Referência da API

Três chamadas, do render ao publicado

Encontre o destino uma vez e depois agende o que quiser.

Encontre o destino

As contas ligadas são de leitura apenas pela API: ligam-se uma vez a partir do painel, porque o material OAuth nunca deve sair do servidor. Liste-as e guarde o 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"

Agende a publicação

Um vídeo, uma conta, um momento e uma legenda. A chamada devolve a publicação em fila, não uma publicada, por isso o seu agendador continua a ser a fonte de verdade.

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

Veja-a sair

Leia o calendário agrupado por dia, filtre a fila por estado, ou apanhe o post.published e deixe de perguntar. As falhas chegam do mesmo modo, com o motivo anexado.

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"

O que uma publicação agendada aceita

Quatro campos. O ficheiro renderizado, o destino, o minuto e as palavras.

video_id

O vídeo a publicar. Tem de estar renderizado: a fila publica um ficheiro, não uma timeline.

account_id

Para que conta ligada vai. Uma publicação, um destino, para que uma falha nunca arraste as outras.

scheduled_at

Quando deve sair. Tudo o que a plataforma aceitar, incluindo já.

caption

A legenda que a acompanha. Hashtags e menções viajam lá dentro, exatamente como escritas.

A fila, legível nos dois sentidos

O calendário responde a "o que sai esta semana"; o recurso responde a "o que aconteceu a este vídeo". Ambos são filtráveis, por isso um painel constrói-se sem um único endpoint a mais.

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

Saiba quando publicou mesmo

Agendar é uma promessa, não um resultado. O post.published dispara quando a plataforma aceitou, incluindo numa publicação parcial, em que o payload leva o resultado por conta.

post.publishedpost.failed

O que os programadores perguntam primeiro

Posso ligar uma conta pela API?

Não, e é deliberado. As contas ligam-se pelo painel para que os tokens OAuth nunca saiam do servidor; a API pode listá-las e publicar nelas, mais nada.

O que acontece se uma plataforma recusar a publicação?

A publicação fica na fila com estado de erro e o post.failed dispara com o motivo. Nada é repetido em silêncio nas suas costas.

Posso publicar o mesmo vídeo em várias contas?

Sim: uma chamada por destino. Mantê-las separadas evita que uma plataforma que recusa uma legenda cancele todas as outras.

Como construo uma vista de calendário?

O publishing.calendar devolve as publicações agendadas agrupadas por dia entre duas datas. Para algo mais específico, filtre o recurso scheduled_posts por status, platform ou video_id.

Especificação OpenAPI Códigos de erro Explorar a API