Mudanças na API do TikTok em 2026: o que deixou de funcionar e o que fazer
Quatro mudanças na API do TikTok em 2026 exigem ação: o TikTok for Developers agora documenta tokens de acesso de 2 horas e refresh tokens de 180 dias que rotacionam (2 de novembro); is_business_account passa a valer só para Verified Business Account (16 de outubro); novos apps da Accounts API precisam do formulário de acesso do TikTok (20 de março); e as contas sandbox da API for Business terminam em 1º de dezembro. A maioria das outras mudanças acrescenta campos, como o texto do comentário nos webhooks.
O easyCoexistence mantém sua conexão com o TikTok atualizada para Claude, ChatGPT ou sua própria plataforma: tokens renovados antecipadamente, has_advanced_access e is_business_account nos campos padrão do perfil, eventos de comentário encaminhados com seu texto, e o token da conta obtido em get_social_credentials para o restante da API for Business.
As páginas de tokens do TikTok for Developers foram atualizadas: tokens de acesso de usuário valem 2 horas, refresh tokens valem 180 dias e rotacionam a cada renovação.
Desde então, is_business_account em /business/get/ marca apenas Verified Business Accounts, e has_advanced_access informa se há Advanced Access.
Caracteres que um comentário ou resposta pode ter pela API desde 7 de agosto de 2026, subindo de 150.
Quando o TikTok adicionou o texto do comentário ao evento de webhook comment.update.
Início da regra de que um novo app ou aumento de escopo com TikTok Accounts exige o Accounts API Access Application Form.
Data em que o TikTok descontinua as contas sandbox da API for Business, orientando a usar contas de teste em produção.
Quais mudanças da API do TikTok em 2026 quebram algo?
As páginas What's New e de referência do TikTok em business-api.tiktok.com, e o Changelog e as páginas de tokens em developers.tiktok.com, registram estas mudanças de 2026 nas APIs que gerenciam contas e seus conteúdos. 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 em 1º de dezembro de 2026?
As contas sandbox da API for Business. A página de sandbox do TikTok diz que serão descontinuadas até 1º de dezembro de 2026 e orienta criar sua própria conta de teste em produção. Elas são contas de anúncios com dados de relatório simulados em https://sandbox-ads.tiktok.com/open_api, então os testes da Accounts API passam para uma conta real do TikTok reservada para testes, com a URL de vídeo de teste que o TikTok indica para /business/video/publish/.
O que mudou nos tokens do TikTok for Developers em 2 de novembro de 2026?
As páginas de tokens agora dão aos tokens de acesso de usuário 2 horas a partir da emissão e aos refresh tokens 180 dias a partir da primeira emissão, e os refresh tokens passam a rotacionar: uma renovação bem-sucedida retorna um novo refresh_token e invalida imediatamente o enviado. O que quebra é um job que renova uma vez por dia ou reutiliza um refresh token armazenado. A correção é renovar dentro de expires_in, salvar cada novo refresh_token antes de usá-lo e planejar a reautorização em até 180 dias. O guia de autenticação da API for Business ainda dá aos tokens de conta do TikTok um dia e um ano.
O que mudou em is_business_account em 16 de outubro de 2026?
O TikTok adicionou has_advanced_access a /business/get/, como valor para fields e como campo de resposta, e restringiu is_business_account para significar apenas Verified Business Account. Código que lia is_business_account como sinal de Advanced Access agora recebe false para contas que têm Advanced Access sem verificação. A correção é solicitar os dois campos, que exigem o escopo user.account.type, e liberar os recursos que o Advanced Access desbloqueia quando um dos dois for true.
O que mudou nas sugestões de hashtag em 25 de setembro de 2026?
/business/hashtag/suggestion/ ganhou post_count, o número de posts que já usaram cada hashtag recomendada, e suas 10 sugestões agora são ordenadas por post_count após uma correspondência exata, o que o TikTok diz refletir as recomendações do app. Nada foi removido, então o código existente continua funcionando; um ranqueamento baseado na ordem antiga muda, e post_count serve para ranquear por ele.
O que mudou no texto de comentários em 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 menção de comentário da Mentions API. Nada quebra. Código que cortava respostas em 150 caracteres por causa do TikTok pode deixá-las mais longas, lembrando da nota do TikTok de que muitos comentários muito parecidos postados em pouco tempo podem ser sinalizados como spam.
Quais adições de 2026 não exigem mudança no código?
Três adições de publicação e de post são campos opcionais que chamadas existentes podem ignorar:
- 24 de julho: /business/publish/location/ lista as tags de localização de uma conta, e os endpoints de publicação aceitam
location_idcomlocation_name, que é obrigatório junto com ele. - 15 de maio:
is_adem /business/video/list/, como campo a solicitar e valor de resposta, mostra se um post está sendo promovido como anúncio. - 16 de janeiro:
music_sound_infonos endpoints de publicação de vídeo e foto anexa uma faixa da Commercial Music Library.
O que mudou nos webhooks de comentário em 18 de junho de 2026?
comment.update ganhou text, o conteúdo do comentário ou resposta, ao lado de comment_id, video_id, comment_action e do unique_identifier do comentarista. Um receptor pode ler as palavras do evento em vez de chamar /business/comment/list/; o nome de exibição e o username do comentarista ainda vêm dessa lista, e os IDs em content continuam sendo números JSON grandes demais para um double.
O que mudou na Research API neste ano?
Duas mudanças, ambas nas Research Tools do TikTok for Developers. Em 26 de fevereiro, o TikTok mudou seu pipeline de dados para cobrir todo o conteúdo público de vídeo, incluindo vídeos não elegíveis para o feed For You, então contagens comparadas com extrações anteriores podem variar. Em 21 de maio, Query Videos e as consultas de vídeos curtidos, fixados e repostados passaram a retornar favorites_count, e Query Video Comments passou a retornar display_name para comentários e respostas.
O que mudou na revisão de apps em 20 de março de 2026?
Desde 00:00 GMT desse dia, os desenvolvedores devem preencher o Accounts API Access Application Form do TikTok antes de enviar um novo app de desenvolvedor ou solicitar aumento de escopo que inclua a permissão TikTok Accounts. O que quebra é um envio feito sem ele. A correção é preencher o formulário primeiro, com informações claras e precisas, e só então enviar o app ou a mudança de escopo, cuja análise do TikTok pode levar de 2 a 3 dias úteis para ser respondida.
O que mudou nos comentários em 13 de fevereiro de 2026?
Comentários podem trazer imagens. /business/comment/image/upload/ recebe uma imagem e retorna 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 retornam image_url para comentários com imagem. Texto passou a ser uma das duas opções em uma resposta, então código que presume que cada comentário tem texto também deve tratar image_url.
O que está marcado para remoção sem data?
user_id nas respostas de comentário. As referências do TikTok para /business/comment/list/ e /business/comment/reply/create/ marcam o campo como To-be-deprecated, dizendo que será descontinuado na próxima versão da API, e recomendam unique_identifier, que se mantém igual entre as APIs. A v1.3 em si não tem data de fim: a linha do tempo de versões do TikTok a lista como disponível até TBD.
Como o easyCoexistence trata essas mudanças?
Sua conexão com o TikTok roda sobre tokens da API for Business, que mantêm suas validades de um dia e um ano e que ele mesmo renova, então a mudança de 2 de novembro não o atinge. O restante, mudança por mudança:
- Uma lista de métricas vazia em
get_social_insightspede ao TikTok as duas flags,is_business_accountehas_advanced_access. reply_to_commentenvia seu texto como escrito, então vale 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ário em 500.- Eventos comment.update encaminhados levam o text como o TikTok envia, com os IDs convertidos em strings.
is_ade os demais campos da lista de posts são acessíveis a partir do seu próprio código em business/video/list/, com o token deget_social_credentials.- Testar não exige sandbox: uma conta que você possui se conecta entrando no TikTok.
Erros comuns
- Fixar a validade dos tokens no código. O TikTok for Developers mudou as validades documentadas em 2 de novembro de 2026, enquanto seu exemplo de renovação ainda mostra 86400, então agende as renovações com base em expires_in.
- Manter o primeiro refresh token. No TikTok for Developers, cada renovação retorna um novo refresh_token e invalida o que você enviou, então salve sempre o mais recente.
- Liberar recursos de Advanced Access só com is_business_account. Desde 16 de outubro de 2026 esse campo é false para contas com Advanced Access que não são verificadas.
- Manter o limite de 150 caracteres por causa do TikTok. Os endpoints de comentário aceitam até 1.200 caracteres desde 7 de agosto de 2026.
De US$ 9 a US$ 0.75 por conexão por mês, caindo conforme você adiciona conexões, com os 3 primeiros dias grátis.
O easyCoexistence é uma API e um servidor MCP multicanal que conecta agentes de IA, como o Claude e o ChatGPT, ao WhatsApp, Instagram, TikTok, Facebook e mais. No WhatsApp, ele usa o Coexistence: a empresa continua usando o número no app WhatsApp Business enquanto a IA trabalha pela API oficial da Meta.
Perguntas frequentes
A API for Business mudou a validade dos tokens em 2026?
Não. O guia de autenticação dela ainda dá aos tokens de acesso de conta do TikTok um dia e aos refresh tokens um ano; as validades de 2 horas e 180 dias são do próprio TikTok for Developers.
Onde o TikTok anuncia mudanças na API?
Em 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 mudou os limites de taxa da Accounts API em 2026?
As entradas de What's New de 2026 sobre Accounts não registram mudança neles: 40 chamadas por minuto por conta em cada endpoint, e 600 ou 1.000 por minuto por app.
Qual mudança de 2026 mais importa para um agente de IA que responde comentários no TikTok?
Duas: as respostas podem ter até 1.200 caracteres desde 7 de agosto, e o comment.update traz o texto do comentário desde 18 de junho, então o agente o lê diretamente do evento.
Continue lendo
Conecte seu primeiro canal em dois minutos.
Sem esperar aprovação das plataformas. Conecte o WhatsApp, o Instagram, o TikTok ou outro canal, peça para a sua IA publicar, responder ou trazer os números, e veja funcionando.
- 3 dias grátis
- Cancele quando quiser
- Só APIs oficiais
- Monitorado 24/7
Verificado em