Alterações à API do TikTok em 2026: o que deixou de funcionar e o que fazer
Quatro alterações à API do TikTok em 2026 exigem ação: o TikTok for Developers documenta agora tokens de acesso com 2 horas de validade e tokens de atualização de 180 dias que são substituídos a cada renovação (2 de novembro); is_business_account indica apenas uma Verified Business Account (16 de outubro); as novas aplicações da Accounts API precisam do formulário de acesso do TikTok (20 de março); e as contas sandbox da API for Business terminam a 1 de dezembro. A maioria das outras alterações acrescenta campos, como o texto do comentário nos webhooks.
A easyCoexistence mantém a sua ligação ao TikTok atualizada para o Claude, o ChatGPT ou a sua própria plataforma: tokens renovados com antecedência, has_advanced_access e is_business_account nos campos de perfil por predefinição, eventos de comentários reencaminhados com o respetivo texto, e o token da conta obtido em get_social_credentials para o resto da API for Business.
As páginas de tokens do TikTok for Developers foram atualizadas: os tokens de acesso de utilizador duram 2 horas, e os tokens de atualização duram 180 dias e são substituídos a cada atualização.
Desde então, is_business_account em /business/get/ marca apenas as Verified Business Accounts, e has_advanced_access indica o Advanced Access.
Número de caracteres que um comentário ou resposta pode conter através da API desde 7 de agosto de 2026, passando de 150.
Quando o TikTok acrescentou o texto do comentário ao evento webhook comment.update.
Início da regra segundo a qual uma nova aplicação ou um aumento de permissões com o TikTok Accounts exige o Formulário de Pedido de Acesso à Accounts API.
Data em que o TikTok descontinua as contas sandbox da API for Business e recomenda contas de teste em produção.
Quais das alterações à API do TikTok de 2026 provocam falhas?
As páginas What's New e de referência em business-api.tiktok.com, bem como o Changelog e as páginas de tokens em developers.tiktok.com, registam estas alterações de 2026 às APIs que gerem as contas e o respetivo conteúdo. Da mais recente para a mais antiga, com a data futura no topo; a maioria acrescenta campos, e algumas exigem ação:
| What breaks | The fix | |
|---|---|---|
| Dec 1: sandbox accounts end | Tests against sandbox-ads.tiktok.com | A test account in production |
| Nov 2: shorter developer tokens | Daily refresh jobs and reused refresh tokens | Refresh within expires_in and save each new refresh_token |
| Oct 16: is_business_account | Checks that read it as Advanced Access | Read has_advanced_access as well |
| Sep 25: hashtag post counts | Nothing; the order follows post counts | Rank with the new post_count |
| Aug 7: 1,200-character comments | Nothing; 150 is no longer the cap | Lift your own 150 limit |
| Jul 24: location tags | Nothing | Optional location_id with location_name |
| Jun 18: text in comment.update | Nothing | Read text from the event |
| May 21: Research API fields | Nothing | favorites_count and display_name |
| May 15: is_ad on posts | Nothing | An optional field to request |
| Mar 20: access form | App or scope requests without it | Submit the form first |
| Feb 26: Research API coverage | Comparisons with earlier pulls | Pull the baseline again |
| Feb 13: images in comments | Code that expects text on each comment | Handle image_url |
| Jan 16: commercial music | Nothing | Optional music_sound_info |
O que termina a 1 de dezembro de 2026?
As contas sandbox da API for Business. A página sandbox do TikTok diz que serão descontinuadas até 1 de dezembro de 2026 e aconselha a criar a sua própria conta de teste em produção. São contas de anúncios com dados de relatórios simulados em https://sandbox-ads.tiktok.com/open_api, pelo que os testes da Accounts API passam para uma conta real do TikTok reservada para testes, com o URL de vídeo de teste que o TikTok indica para /business/video/publish/.
O que mudou nos tokens do TikTok for Developers a 2 de novembro de 2026?
As páginas de tokens passam a dar aos tokens de acesso de utilizador 2 horas a contar da emissão, e aos tokens de atualização 180 dias a contar da primeira emissão, e os tokens de atualização passam a ser substituídos a cada atualização: uma atualização bem-sucedida devolve um novo refresh_token e invalida de imediato o que foi enviado. O que deixa de funcionar é uma tarefa que atualiza uma vez por dia ou reutiliza um refresh token guardado. A correção é atualizar dentro do expires_in, guardar cada novo refresh_token antes de o usar e planear a reautorização dentro de 180 dias. O guia de autenticação da API for Business continua a dar aos tokens de conta do TikTok um dia e um ano.
O que mudou em is_business_account a 16 de outubro de 2026?
O TikTok acrescentou has_advanced_access a /business/get/, como valor para fields e como campo de resposta, e restringiu is_business_account a significar apenas uma Verified Business Account. O código que lia is_business_account como sinal de Advanced Access passa a receber false para contas que têm Advanced Access sem verificação. A correção é pedir os dois campos, que exigem o âmbito user.account.type, e condicionar as funcionalidades que o Advanced Access desbloqueia a um dos dois ser verdadeiro.
O que mudou nas sugestões de hashtags a 25 de setembro de 2026?
/business/hashtag/suggestion/ ganhou post_count, o número de publicações que já usaram cada hashtag recomendada, e as suas 10 sugestões passam a estar ordenadas pelo número de publicações depois de uma correspondência exata, o que, segundo o TikTok, replica as recomendações dentro da aplicação. Nada foi removido, por isso o código existente continua a funcionar; uma classificação construída sobre a ordem antiga muda, e post_count serve precisamente para ordenar por ela.
O que mudou no texto dos comentários a 7 de agosto de 2026?
O TikTok aumentou o limite de texto em /business/comment/create/ e /business/comment/reply/create/ de 150 para 1 200 caracteres, e também na resposta a uma menção a comentário da Mentions API. Nada deixa de funcionar. O código que cortava as respostas aos 150 caracteres por causa do TikTok pode permitir que sejam mais longas, tendo em conta o aviso do TikTok de que muitos comentários muito parecidos publicados em pouco tempo podem ser assinalados como spam.
Quais das adições de 2026 não exigem alteração no código?
Três adições de publicação e de post são campos opcionais que os pedidos existentes podem ignorar:
- 24 de julho: /business/publish/location/ lista as etiquetas de localização de uma conta, e os endpoints de publicação aceitam
location_idcomlocation_name, que é obrigatório em conjunto com ele. - 15 de maio:
is_adem /business/video/list/, como campo a pedir e como valor de resposta, indica se uma publicação está a ser promovida como anúncio. - 16 de janeiro:
music_sound_infonos endpoints de publicação de vídeo e foto associa uma faixa da Commercial Music Library.
O que mudou nos webhooks de comentários a 18 de junho de 2026?
comment.update passou a incluir text, o conteúdo do comentário ou da resposta, junto a comment_id, video_id, comment_action e ao unique_identifier de quem comentou. Quem recebe pode ler as palavras a partir do evento em vez de chamar /business/comment/list/; o nome a apresentar e o nome de utilizador de quem comentou continuam a vir dessa lista, e os IDs em content continuam a ser números JSON demasiado grandes para um double.
O que mudou na Research API este ano?
Duas alterações, ambas nas Research Tools do TikTok for Developers. A 26 de fevereiro, o TikTok mudou o seu circuito de dados para abranger todo o conteúdo de vídeo público, incluindo vídeos que não são elegíveis para o feed Para Ti, pelo que as contagens comparadas com extrações anteriores podem mudar. A 21 de maio, Query Videos e as consultas de vídeos com gosto, fixados e republicados passaram a devolver favorites_count, e Query Video Comments passou a devolver display_name para comentários e respostas.
O que mudou na revisão de aplicações a 20 de março de 2026?
Desde as 00:00 GMT desse dia, os programadores têm de preencher o Formulário de Pedido de Acesso à Accounts API do TikTok antes de submeter uma nova aplicação de programador ou de pedir um aumento de âmbito que inclua a permissão TikTok Accounts. O que deixa de funcionar é um envio feito sem ele. A correção é preencher primeiro o formulário, com informação clara e exata, e só depois submeter a aplicação ou a alteração de âmbito, cuja análise pode levar 2 a 3 dias úteis.
O que mudou nos comentários a 13 de fevereiro de 2026?
Os comentários podem ter imagens. /business/comment/image/upload/ recebe uma imagem e devolve um image_uri, que /business/comment/create/ e /business/comment/reply/create/ aceitam com image_width e image_height, e as listas de comentários devolvem image_url para os comentários com imagem. O texto passou a ser uma de duas opções numa resposta, por isso o código que assume que cada comentário tem texto deve também tratar image_url.
O que está marcado para remoção sem data?
user_id nas respostas de comentários. As referências do TikTok para /business/comment/list/ e /business/comment/reply/create/ marcam-no como To-be-deprecated, dizendo que será descontinuado na próxima versão da API, e recomendam unique_identifier, que se mantém igual em todas as APIs. A v1.3 em si não tem data de fim: a cronologia de versões do TikTok indica-a como disponível até TBD.
Como trata a easyCoexistence estas alterações?
A sua ligação ao TikTok funciona com tokens da API for Business, que mantêm os seus prazos de um dia e de um ano e que a própria renova, pelo que a alteração de 2 de novembro não lhe chega. O resto, alteração a alteração:
- Uma lista de métricas vazia em
get_social_insightspede ao TikTok ambas as flags,is_business_accountehas_advanced_access. reply_to_commentenvia o texto exatamente como foi escrito, pelo que se aplica o limite de 1 200 caracteres do TikTok, enquanto as automações mantêm as respostas do TikTok em 150 caracteres e as regras de comentários em 500.- Os eventos comment.update reencaminhados levam o text tal como o TikTok o envia, com os IDs convertidos em strings.
is_ade os restantes campos da lista de publicações são acessíveis a partir do seu próprio código em business/video/list/, com o token deget_social_credentials.- Os testes não precisam de sandbox: basta uma conta que seja sua, que se liga ao iniciar sessão no TikTok.
Erros comuns
- Fixar à mão os prazos dos tokens. O TikTok for Developers alterou os prazos documentados a 2 de novembro de 2026, enquanto o exemplo de atualização ainda mostra 86400; por isso, agende as atualizações a partir de expires_in em cada resposta.
- Manter o primeiro refresh token. No TikTok for Developers, cada atualização devolve um novo refresh_token e invalida o que enviou; guarde sempre o mais recente.
- Condicionar as funcionalidades do Advanced Access apenas a is_business_account. Desde 16 de outubro de 2026, o campo tem o valor false para contas com Advanced Access que não estão verificadas.
- Manter o limite de 150 caracteres por causa do TikTok. Os endpoints de comentários têm aceitado até 1 200 caracteres desde 7 de agosto de 2026.
De US$ 9 a US$ 0.75 por ligação por mês, descendo à medida que acrescenta ligações, com os primeiros 3 dias gratuitos.
Perguntas frequentes
A API for Business mudou os prazos dos tokens em 2026?
Não. O seu guia de autenticação continua a dar aos tokens de acesso de conta do TikTok um dia, e aos tokens de atualização um ano; as 2 horas e os 180 dias são próprios do TikTok for Developers.
Onde é que o TikTok anuncia as alterações à API?
No What's New em business-api.tiktok.com, para a API for Business, e no Changelog em developers.tiktok.com, para o TikTok for Developers. As páginas de referência também trazem notas datadas, como a do formulário de 20 de março.
O TikTok alterou os limites de pedidos da Accounts API em 2026?
As entradas de 2026 do What's New sobre a Accounts API não registam qualquer alteração: 40 pedidos por minuto por conta em cada endpoint, e 600 ou 1 000 por minuto por aplicação.
Qual é a alteração de 2026 mais importante para um agente de IA que responde a comentários do TikTok?
Duas: desde 7 de agosto, as respostas podem ter até 1 200 caracteres, e desde 18 de junho o comment.update traz o texto do comentário, pelo que o agente o lê a partir do evento.
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