Como Agendar Posts no TikTok com uma API

Agende um post no TikTok para um horário específico

A abordagem mais direta e definir uma data exata de publicacao. Adicione o parametro scheduled_date (formato ISO-8601) e um timezone (formato IANA) a sua requisicao de upload. A API aceita datas de ate 365 dias no futuro.

Aqui esta um exemplo com cURL que agenda um video do TikTok para 22 de setembro as 10:00 da manha no horario de Nova York, com privacidade definida como publica e duetos desabilitados:

curl -X POST https://api.upload-post.com/api/upload \
  -H "Autorização: Apikey sua-api-key-aqui" \
  -F "[email protected]" \
  -F "user=mybrand" \
  -F "title=Morning routine that changed everything #fyp #routine" \
  -F "platform[]=tiktok" \
  -F "scheduled_date=2025-09-22T10:00:00Z" \
  -F "timezone=America/New_York" \
  -F "privacy_level=PUBLIC" \
  -F "disable_duet=false" \
  -F "disable_comment=false" \
  -F "disable_stitch=false"

Quando o post e agendado com sucesso, a API responde com um codigo de status 202 e um job_id:

{
  "success": true,
  "job_id": "scheduler_job_abc123",
  "scheduled_date": "2025-09-22T10:00:00Z"
}

Salve esse job_id. Voce vai precisar dele para editar, reagendar ou cancelar o post depois. Voce tambem pode listar todos os seus posts agendados pendentes a qualquer momento:

curl https://api.upload-post.com/api/uploadposts/schedule \
  -H "Autorização: Apikey sua-api-key-aqui"

Isso retorna um array de todos os jobs pendentes com seu job_id, scheduled_date, detalhes da plataforma e uma URL de preview do conteudo. Para um olhar mais aprofundado sobre agendamento em todas as plataformas, veja o guia geral de agendamento.

Use a fila para agendamento automático

Escolher datas exatas funciona quando voce tem poucos posts. Mas se voce esta produzindo conteudo em lote, escolher manualmente um horario para cada video fica tedioso rapidamente. O sistema de filas resolve isso. Voce define sua programacao de postagem preferida uma vez, e todo conteudo que voce adicionar recebe automaticamente o proximo horario disponivel.

Configure seu queue schedule

Primeiro, diga ao sistema quando voce quer que o conteudo seja publicado. Este exemplo configura tres horarios por dia, de segunda a sexta, no fuso horario de Nova York:

curl -X POST https://api.upload-post.com/api/uploadposts/queue/settings \
  -H "Autorização: Apikey sua-api-key-aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "timezone": "America/New_York",
    "slots": [
      { "hour": 8, "minute": 0 },
      { "hour": 12, "minute": 30 },
      { "hour": 18, "minute": 0 }
    ],
    "days": [0, 1, 2, 3, 4]
  }'

Isso da a voce 15 horarios para TikTok por semana: 8:00, 12:30 e 18:00, de segunda a sexta. Voce pode definir ate 24 horarios por dia e incluir fins de semana adicionando os dias 5 e 6.

Adicione conteúdo à fila

Agora, em vez de passar um scheduled_date, defina add_to_queue=true. O sistema preenche o proximo horario disponivel automaticamente:

curl -X POST https://api.upload-post.com/api/upload \
  -H "Autorização: Apikey sua-api-key-aqui" \
  -F "[email protected]" \
  -F "user=mybrand" \
  -F "title=POV: you finally automated your TikTok posting #devlife" \
  -F "platform[]=tiktok" \
  -F "add_to_queue=true" \
  -F "privacy_level=PUBLIC"

Se for quarta-feira as 14h, esse video sera colocado no horario das 18:00 do mesmo dia. Se todos os horarios de quarta estiverem cheios, ele vai para quinta-feira as 8:00. Voce pode visualizar os proximos horarios disponiveis antes de adicionar conteudo:

curl https://api.upload-post.com/api/uploadposts/queue/preview?count=10 \
  -H "Autorização: Apikey sua-api-key-aqui"

Isso retorna os proximos 10 horarios disponiveis com suas datas e horarios exatos, para que voce saiba exatamente quando cada post na fila sera publicado.

Configurações específicas do TikTok que você deve conhecer

A API do TikTok expoe varios parametros que outras plataformas nao possuem. Alguns sao opcionais, mas alguns sao legalmente obrigatorios em certas situacoes. Aqui esta a referencia completa:

Uma nota sobre conteudo de marca: se voce esta criando conteudo patrocinado, voce deve definir brand_content_toggle=true. Isso nao e opcional. Tanto o FTC nos EUA quanto regulamentacoes equivalentes da UE exigem divulgacao clara de parcerias pagas. O TikTok tambem aplica isso do lado deles, entao nao sinalizar corretamente pode resultar na remocao do conteudo. Se voce esta promovendo seu proprio negocio (nao uma marca de terceiros), use brand_organic_toggle=true em vez disso.

Para conteudo gerado por IA, definir is_aigc=true adiciona um rotulo de divulgacao visivel aos espectadores. A medida que as regulamentacoes de conteudo de IA evoluem, sinalizar isso proativamente e uma boa pratica.

Agende posts no TikTok com Python

O guia de automacao com Python cobre o SDK em profundidade. Aqui esta um exemplo pratico para o TikTok: agendamento em lote de todos os videos de uma pasta, cada um com uma hora de intervalo, comecando amanha de manha.

import os
import glob
from datetime import datetime, timedelta
from upload_post import UploadPostClient

client = UploadPostClient(api_key="your-api-key-here")

video_folder = "/path/to/tiktok-videos"
videos = sorted(glob.glob(os.path.join(video_folder, "*.mp4")))

# Start scheduling from tomorrow at 9 AM Eastern
base_time = (datetime.now() + timedelta(days=1)).replace(
    hour=9, minute=0, second=0, microsecond=0
)

print(f"Found {len(videos)} videos to schedule")

for i, video_path in enumerate(videos):
    publish_time = base_time + timedelta(hours=i)
    filename = os.path.basename(video_path)
    title = filename.replace(".mp4", "").replace("-", " ").replace("_", " ")

    try:
        response = client.upload_video(
            video_path=video_path,
            title=title,
            user="mybrand",
            platforms=["tiktok"],
            scheduled_date=publish_time.isoformat(),
            timezone="America/New_York",
            privacy_level="PÚBLICO",
            disable_duet=False,
            disable_comment=False,
            cover_timestamp=3000,
            async_upload=True
        )
        job_id = response.get("job_id", "pending")
        print(f"[{i+1}/{len(videos)}] Scheduled {filename} for {publish_time} (Job: {job_id})")
    except Exception as e:
        print(f"[{i+1}/{len(videos)}] Failed: {filename} - {e}")

print("Todos os vídeos agendados!")

Este script espaca cada video com uma hora de intervalo. Voce pode ajustar o timedelta para corresponder a sua cadencia preferida. Lembre-se de que o TikTok impoe um limite diario de 15 uploads por janela rolante de 24 horas por conta. Se voce tem mais de 15 videos, distribua-os em varios dias ou use o sistema de filas, que lida com limites automaticamente.

Voce tambem pode combinar isso com a API do FFmpeg para redimensionar ou cortar videos antes de agendar, ou usar o calendario de datas comemorativas para redes sociais para alinhar suas datas de publicacao com topicos em alta.

Sem código: Agende posts no TikTok com n8n

Se voce prefere automacao visual em vez de escrever codigo, o n8n e uma excelente opcao. A configuracao usa o node HTTP Request para chamar a API do Upload-Post, e voce pode dispara-lo a partir do Google Sheets, Google Drive, Airtable ou um botao manual.

O fluxo basico funciona assim:

1. Nó de trigger: dispara em uma programacao, uma nova linha na planilha ou um novo arquivo em uma pasta na nuvem.
2. Requisição HTTP do nó: envia um POST multipart/form-data para https://api.upload-post.com/api/upload com sua API key, arquivo de video, titulo, platform[]=tiktok e add_to_queue=true.
3. Opcional: uma notificacao por Slack ou email quando o upload for bem-sucedido ou falhar.

Temos um template pronto de upload do TikTok para n8n que voce pode importar com um clique. Navegue por todos os templates do n8n disponiveis para mais ideias de automacao. Voce tambem pode configurar isso com o Make.com se essa for sua plataforma de automacao preferida.

Requisitos de vídeo do TikTok

Antes de agendar, certifique-se de que seus videos atendem as especificacoes do TikTok. Enviar um arquivo que nao atende a esses requisitos resultara em um post com falha.

Se seus videos de origem estao no formato ou proporcao errados, a API do FFmpeg pode fazer a conversao na nuvem antes da publicacao. Voce tambem pode reaproveitar videos do YouTube para o TikTok automaticamente.

Perguntas frequentes

Posso agendar posts no TikTok de graça?

Sim. O Upload-Post inclui um plano gratuito com 10 uploads por mes, e o agendamento esta disponivel em todos os planos, incluindo o gratuito. Voce pode agendar posts com datas exatas ou usar o sistema de filas sem custo. Se precisar de mais volume, os planos pagos comecam com um preco acessivel e sem compromisso de longo prazo.

O que acontece se o TikTok estiver fora do ar quando meu post estiver agendado?

O Upload-Post retenta automaticamente uploads com falha. Se a API do TikTok estiver temporariamente indisponivel no horario agendado, o sistema tentara publicar novamente nos minutos seguintes. Se o problema persistir, voce recebera uma notificacao por webhooks (se configurado) ou pode verificar o status usando o endpoint GET /api/uploadposts/status?job_id=your_job_id. Seu conteudo nunca e perdido.

Posso agendar para o TikTok e Instagram ao mesmo tempo?

Com certeza. Basta passar multiplas plataformas na mesma requisicao: platform[]=tiktok e platform[]=instagram. O mesmo video, titulo e data agendada se aplicam a todas as plataformas. Se voce precisa de legendas diferentes por plataforma, use o parametro tiktok_title para texto especifico do TikTok enquanto o campo principal title vai para as outras plataformas. Veja nosso guia sobre como fazer upload de videos em massa em multiplas plataformas para fluxos de trabalho multiplataforma mais avancados.

Com quanta antecedência posso agendar posts no TikTok?

Ate 365 dias. O parametro scheduled_date aceita qualquer data dentro do proximo ano. Combinado com o sistema de filas, voce poderia teoricamente preencher um ano inteiro de conteudo em uma unica sessao de agendamento em lote. A maioria dos usuarios agenda de uma a quatro semanas a frente, o que e um bom equilibrio entre planejamento e flexibilidade. Nosso calendario de datas comemorativas para redes sociais pode ajudar voce a planejar conteudo em torno de datas importantes ao longo do ano.