Guia da API do TikTok para 2026: da sua aplicação à primeira publicação
Para passar de uma aplicação de programador a uma primeira publicação no TikTok em 2026, registe-se como empresa na API for Business do TikTok, crie uma aplicação com a permissão TikTok Accounts, peça ao titular da conta que a autorize, troque o código por um token de acesso válido durante 24 horas e chame /business/video/publish/ com um URL de vídeo verificado. Acompanhe o share_id devolvido até PUBLISH_COMPLETE e, depois, acrescente comentários, webhooks e insights.
O easyCoexistence trata do lado do programador por si: a sua própria aplicação da API for Business e a sua própria rota verificada para media, com tokens renovados e cada conta verificada aproximadamente de 6 em 6 horas, para que o Claude, o ChatGPT ou a sua plataforma publique, responda a comentários e leia insights no TikTok através de um conector MCP ou da Partner API.
Quando o TikTok responde a um registo de programador, o que exige um e-mail de um domínio empresarial verificado e um site da empresa.
Data a partir da qual novas apps e pedidos de scopes que incluam TikTok Accounts exigem primeiro o Accounts API Access Application Form.
Duração do auth_code que devolve a aprovação do titular; funciona numa única troca em /tt_user/oauth2/token/.
O que devolvem os dois endpoints de publicação, passado como publish_id a /business/publish/status/ para acompanhar a publicação.
Modo de visualização que o TikTok aplica a conteúdos publicados através da Content Posting API por aplicações que ainda não auditou.
Chamadas por conta autorizada em cada endpoint da Accounts API, dentro de um orçamento de 600 por minuto para a aplicação no nível Basic.
Qual é o caminho desde uma aplicação de programador do TikTok até à primeira publicação?
Cinco etapas na API for Business do TikTok, cada uma com uma revisão ou verificação própria. O registo e a revisão da aplicação acontecem uma vez, a autorização acontece uma vez por cada conta que a aplicação gere, e as duas últimas etapas repetem-se em cada publicação. As secções seguintes percorrem-nas por ordem, com o endpoint, o campo e o limite de cada uma:
Qual a API do TikTok de que precisa?
A que corresponde ao trabalho. O TikTok tem dois portais de programadores: business-api.tiktok.com, para a API for Business, e developers.tiktok.com, o TikTok for Developers, onde estão as APIs Content Posting, Display e Research. Para gerir as publicações, os comentários e os insights de contas que uma empresa detém ou serve, a API for Business é a que tem os endpoints de comentários e os webhooks de comentários:
Que contas do TikTok pode a aplicação gerir?
Contas pessoais e empresariais, sem distinção. A Accounts API do TikTok tem três níveis: a conta geral do TikTok, com que todos começam; uma conta com Advanced Access, ligada a uma conta TikTok for Business ou a um Business Center não verificado; e a conta Business verificada. Os endpoints de publicação e de comentários não exigem nenhum nível de conta, mas alguns campos de insights, a Mentions API e a Business Messaging API exigem Advanced Access ou uma conta Business verificada.
Como se registam e aprovam a aplicação?
Como empresa, no portal TikTok for Business Developers, em três passos que o TikTok revê:
- Registo de programador: um e-mail de domínio empresarial verificado e um site público da empresa, num domínio que a empresa detém; o TikTok responde em três dias úteis e não admite programadores individuais.
- Accounts API Access Application Form: obrigatório desde 20 de março de 2026, antes de uma nova aplicação ou de um aumento de scopes que inclua a permissão TikTok Accounts.
- Aplicação de programador: as utilizações previstas e quem pode aceder a ela, um URL de redirecionamento e a permissão TikTok Accounts, revistas em 2 a 3 dias úteis, com até cinco aplicações por programador.
Que permissões e scopes precisa a aplicação?
Duas camadas, atribuídas por pessoas diferentes. A aplicação de programador detém permissões em TikTok Accounts, escolhidas em Scope of permission e revistas pelo TikTok, e cada uma abre endpoints. A aprovação do titular da conta coloca scopes no token de acesso, e estes desbloqueiam campos e funcionalidades, como user.insights para métricas diárias da conta, video.list e video.insights para dados das publicações, video.upload para rascunhos e comment.list para o webhook de comentários. /tt_user/token_info/get/ lista os scopes que um token transporta.
Como é que uma conta autoriza a aplicação, e para que servem os tokens?
O titular abre o URL de autorização do titular da conta da aplicação, que se encontra em My Apps, App Detail, Basic Information, e aprova as suas permissões. O TikTok redireciona para o URL de redirecionamento da aplicação com um auth_code, e o servidor troca-o em /tt_user/oauth2/token/ por um token de acesso válido durante 24 horas, um token de atualização válido durante um ano e o open_id da conta. O token segue no cabeçalho Access-Token, e o open_id segue como business_id em cada chamada à Accounts API; /tt_user/oauth2/refresh_token/ renova o token.
Como se publica um vídeo e uma publicação de fotografias?
Com um POST em cada caso, a partir de URL que o próprio TikTok transfere, num domínio ou prefixo de URL verificado para a aplicação. /business/video/publish/ recebe business_id, video_url e post_info, que contém a legenda e as etiquetas de marca e é obrigatório mesmo quando vazio. /business/photo/publish/ recebe até 35 photo_images em JPG, JPEG ou WebP e um post_info cujo privacy_level é obrigatório. Ambos devolvem um share_id, e o TikTok publica até seis publicações por minuto e 15 por dia por conta através de cada um.
Como se confirma que a publicação ficou no ar?
Pergunta-se a /business/publish/status/ com business_id e o share_id como publish_id, ou subscreve-se a aplicação aos webhooks de publicação. O estado passa de PROCESSING_DOWNLOAD a PUBLISH_COMPLETE, ou fica em FAILED com um motivo como frame_rate_check_failed, e SEND_TO_USER_INBOX marca um rascunho. Os post_ids chegam quando a publicação já é visível publicamente, até três minutos após PUBLISH_COMPLETE, e /business/video/list/ filtra por esses IDs para ler as métricas da publicação.
Como se leem e respondem os comentários?
Nas publicações da própria conta, por video_id, que é o item_id de /business/video/list/. GET /business/comment/list/ devolve comentários públicos e ocultos, até 30 por página, e POST /business/comment/reply/create/ publica uma resposta pública de até 1,200 caracteres, limite que o TikTok subiu de 150 em 7 de agosto de 2026. Outros endpoints ocultam um comentário ou voltam a mostrá-lo, e apagam os comentários que a própria conta escreveu.
Como funcionam os webhooks na API for Business?
Por aplicação e não por conta. POST /business/webhook/update/ com o app_id, o secret, um event_type e um callback_url HTTPS subscreve a aplicação: VIDEO traz os quatro eventos de publicação de vídeo, e COMMENT traz comment.update até cinco minutos após uma alteração. Cada entrega é assinada no cabeçalho Tiktok-Signature com um HMAC-SHA256 que usa o segredo da aplicação como chave, exige uma resposta HTTP 200 de imediato e, se não a receber, é repetida durante até 72 horas.
De onde vêm os insights?
De dois endpoints. GET /business/get/ devolve o perfil e as métricas diárias da conta, como followers_count, video_views, profile_views e likes, até 60 dias atrás em UTC. GET /business/video/list/ devolve os totais vitalícios de cada publicação, desde video_views e reach até average_time_watched, até 20 publicações por página. A maioria dos totais chega com 24 a 48 horas de atraso, e cada campo precisa do seu scope no token.
Que limites moldam a integração?
Quatro, contados cada um por si:
- 40 chamadas por minuto por conta autorizada em cada endpoint da Accounts API.
- 600 chamadas por minuto para as chamadas à Accounts API de uma aplicação em conjunto, no nível Basic, e 1,000 acima desse nível.
- Seis publicações por minuto e 15 por dia por conta em cada endpoint de publicação.
- Código 40100 numa resposta HTTP 200 quando o TikTok limita uma chamada: pausar 5 minutos após um limite por minuto, ou até às 00:00 UTC após um limite diário.
Qual é o caminho através do easyCoexistence?
Mais curto, porque o easyCoexistence já tratou do lado do programador, com a sua própria aplicação da API for Business e a sua própria rota verificada para media. Uma conta pessoal ou Business liga-se ao iniciar sessão no TikTok, e depois o Claude, o ChatGPT ou a sua própria plataforma trabalha com ela através de um conector MCP ou da Partner API, sem registo, revisão de aplicação nem servidor de tokens próprio:
Erros comuns
- Submeter a aplicação antes do formulário de acesso. Desde 20 de março de 2026, o TikTok exige primeiro o Accounts API Access Application Form para uma nova aplicação ou um novo pedido de scopes que inclua TikTok Accounts.
- Alojar media num domínio que a aplicação não verificou. O próprio TikTok transfere o video_url e os photo_images e recusa URL fora de um domínio ou prefixo de URL verificado.
- Desenhar para uma só conta. Os tokens, o business_id e o limite de 40 por minuto pertencem a cada conta, enquanto as definições dos webhooks e o orçamento de chamadas combinado pertencem à aplicação, por isso modele os dois níveis desde o início.
- Pedir só os scopes que a funcionalidade atual precisa. Um token mantém os scopes que o titular aprovou, por isso acrescentar comentários ou insights mais tarde obriga cada titular a autorizar a aplicação de novo.
De US$ 9 a US$ 0.75 por ligação por mês, a descer à medida que acrescenta ligações, com os primeiros 3 dias gratuitos.
Perguntas frequentes
Preciso de uma aplicação de programador separada do TikTok para cada conta de cliente?
Não. Uma aplicação de programador serve as contas que a autorizam, cada uma com o seu próprio token e business_id, e o TikTok permite até cinco aplicações por programador.
A Accounts API é igual à Marketing API do TikTok?
Não. As duas estão na API for Business, mas a Marketing API gere anúncios com tokens de anunciante que não expiram, enquanto a Accounts API usa tokens de conta do TikTok que duram um dia.
Que versão da API do TikTok deve usar o código novo?
A v1.3, disponível desde 15 de agosto de 2022 sem data de fim definida. A v1.2 deixou de receber atualizações após 15 de agosto de 2023, e o TikTok só faz alterações incompatíveis em versões novas.
Quanto custa o easyCoexistence por conta do TikTok?
De US$ 9 a US$ 0.75 por ligação por mês, conforme o escalão em que se situa o total de contas, com os primeiros 3 dias gratuitos. Cada conta do TikTok é uma ligação.
Continue a ler
Ligue o seu primeiro canal em dois minutos.
Sem revisões de plataformas para esperar. Ligue o WhatsApp, o Instagram, o TikTok ou outro canal, peça depois à sua IA que publique, responda ou faça um relatório, e veja-a trabalhar.
- 3 dias grátis
- Cancele quando quiser
- Só APIs oficiais
- Monitorizado 24/7
Verificado em