Limites de publicação por API que derrubam seus envios

Quando um lote de publicações falha no meio do expediente, a causa mais comum não é defeito na ferramenta: são os limites de publicação por API que Instagram, TikTok e YouTube aplicam a qualquer aplicativo que publica em nome de uma conta. Cada rede tem cotas próprias, estados de erro silenciosos e prazos de expiração de mídia. Quem gerencia várias contas precisa desses números antes de escalar o volume, porque eles transformam um agendamento impecável em uma falha sem aviso.

Limites por rede na prática

No Instagram, a conta é o limite, não o aplicativo. Confira a cota de publicação aplicável à conta e ao fluxo de API atuais antes de preparar um lote. Cada carrossel conta como uma única publicação nessa cota, e trocar de ferramenta de agendamento não muda esse número: a cota pertence à conta e acompanha o período móvel, então o pico de ontem ainda consome parte da capacidade de hoje. A documentação oficial da API de publicação do Instagram lista ainda outras restrições que surpreendem quem vem do app: suporte a imagens e Stories depende do fluxo de API, do formato e da elegibilidade da conta; confirme a documentação atual em vez de aplicar uma proibição genérica.

No TikTok, existem duas cotas distintas. A primeira é de fluxo. Cada token de acesso do TikTok pode fazer no máximo 6 requisições de inicialização de publicação por minuto. Esse teto pesa quando um lote grande é disparado de uma só vez. A segunda é diária. O TikTok rejeita novas publicações com o erro spam_risk_too_many_posts quando a cota diária de posts via API do usuário é atingida. A lista completa de códigos de erro está na referência oficial do Direct Post, que detalha cada campo do envio, incluindo o limite de 2200 caracteres da legenda em UTF-16.

Há ainda uma barreira de auditoria no TikTok que muita gente descobre tarde: todo conteúdo postado por clientes de API não auditados fica restrito ao modo de visualização privado até que o aplicativo passe pela auditoria da plataforma. Em termos práticos, o post entra sem erro nenhum e aparece como privado, o que confunde equipes acostumadas a ler falhas explícitas.

No YouTube, o ponto sensível é outro. O envio pela API define status de privacidade explícito, e os valores válidos são public, private e unlisted. O guia oficial de upload da API do YouTube recomenda upload retomável com espera exponencial entre tentativas, prática que evita perder um vídeo grande por uma queda de rede no meio da transferência.

Sinais de que o limite chegou

No Instagram, o relógio é do contêiner de mídia. Um contêiner de mídia do Instagram não publicado em 24 horas expira e precisa ser criado de novo. Se a ferramenta cria o contêiner na hora do agendamento e a publicação só sai três dias depois, a falha chega como EXPIRED na consulta de status, não como erro na tela de planejamento. A própria Meta recomenda checar o status uma vez por minuto, por no máximo cinco minutos, ao esperar a conclusão de um contêiner de vídeo.

No TikTok, os erros vêm com nome. O código rate_limit_exceeded indica excesso de requisições, access_token_invalid aponta token vencido e privacy_level_option_mismatch revela que o nível de privacidade pedido não está entre as opções que a conta do criador aceita. Tratar esses códigos como lista de verificação encurta o diagnóstico de horas para minutos, porque cada um tem correção diferente: espaçar os envios, reconectar a conta ou rever a configuração de privacidade.

Um padrão silencioso merece atenção separada: quando um vídeo aparece como publicado no TikTok mas só é visível para a própria conta, a explicação mais provável é a restrição de cliente não auditado, não uma pane na publicação. Diagnosticar por código de erro e por visibilidade real do post evita apontar a causa errada para o cliente.

Checklist antes de agendar em lote

1. Conte quantas publicações via API a conta do Instagram fez nas últimas 24 horas e confira a capacidade disponível antes de aprovar o lote.
2. Espalhe os envios ao TikTok em janelas de um minuto, respeitando até 6 inicializações de publicação por minuto por conta.
3. Confirme que o nível de privacidade escolhido existe nas opções da conta do criador, não apenas no padrão da ferramenta.
4. Verifique se a integração do TikTok já passou pela auditoria quando o post precisa ser público de verdade.
5. Programe a criação do contêiner do Instagram para perto do horário de publicação, evitando a expiração de 24 horas.
6. Defina explicitamente o status de privacidade no envio ao YouTube e prefira upload retomável para arquivos grandes.

Como proteger a operação

Com os números na mesa, proteção vira aritmética: uma conta do Instagram agendada para 30 posts em um único dia vai falhar em algum momento, independentemente da ferramenta usada. Distribua o lote por mais dias, reduza a frequência por conta e trate cota como capacidade planejada, não como imprevisto do meio da semana.

Monitore o resultado depois da publicação, não só antes. Consultar o estado do contêiner no Instagram e o status de publicação no TikTok é o que separa uma falha detectada em minutos de uma falha descoberta pelo cliente dias depois. Para os limites de formato, privacidade e frequência de cada plataforma no dia a dia, o resumo de regras e limites de agendamento por rede em regras e limites de agendamento de posts por rede funciona como referência rápida na montagem do calendário.

Limite resolvido não significa conteúdo pronto. Depois de garantir a capacidade de publicação, valide o arquivo em si: o passo a passo de como testar um vídeo antes de publicar evita gastar cota de API com vídeo errado, legenda quebrada ou capa escolhida no frame errado. Cota desperdiçada com retrabalho é o limite mais fácil de evitar e o mais esquecido.