Guia da API do TikTok em 2026: do seu app à primeira postagem
Para ir de um app de desenvolvedor até a primeira postagem no TikTok em 2026, cadastre-se como empresa na API for Business do TikTok, crie um app com a permissão TikTok Accounts, peça que o titular da conta o autorize, troque o código por um token de acesso de 24 horas e chame /business/video/publish/ com uma URL de vídeo verificada. Acompanhe o share_id retornado até PUBLISH_COMPLETE e, em seguida, adicione comentários, webhooks e insights.
O easyCoexistence cuida do lado do desenvolvedor por você: seu próprio app da API for Business e sua rota de mídia verificada, com tokens renovados e cada conta verificada a cada cerca de 6 horas, para que Claude, ChatGPT ou sua própria plataforma publique, responda a comentários e leia insights no TikTok por meio de um conector MCP ou da Partner API.
Quando o TikTok responde a um cadastro de desenvolvedor, que exige um e-mail de domínio corporativo verificado e um site da empresa.
Data a partir da qual novos apps e pedidos de escopo que incluam TikTok Accounts exigem antes o Accounts API Access Application Form.
Validade do auth_code que a aprovação do titular devolve; ele vale para uma única troca em /tt_user/oauth2/token/.
O que os dois endpoints de publicação retornam, enviado como publish_id para /business/publish/status/ para acompanhar a postagem.
Modo de visualização que o TikTok aplica ao conteúdo publicado pela Content Posting API por apps que ainda não passaram por auditoria.
Chamadas por conta autorizada em cada endpoint da Accounts API, dentro de um orçamento de 600 por minuto por app no nível Basic.
Qual é o caminho de um app de desenvolvedor do TikTok até a primeira postagem?
Cinco etapas na API for Business do TikTok, cada uma com uma revisão ou verificação própria. O cadastro e a revisão do app acontecem uma vez, a autorização acontece uma vez para cada conta que o app gerencia, e as duas últimas etapas se repetem a cada postagem. As seções abaixo as apresentam na ordem, com o endpoint, o campo e o limite de cada uma:
Qual API do TikTok você precisa?
A que corresponde à tarefa. O TikTok mantém dois portais de desenvolvedor: business-api.tiktok.com, para a API for Business, e developers.tiktok.com, para o TikTok for Developers, onde ficam as APIs Content Posting, Display e Research. Para gerenciar as postagens, os comentários e os insights de contas que uma empresa possui ou atende, a API for Business é a que tem os endpoints de comentários e os webhooks de comentários:
Quais contas do TikTok o app pode gerenciar?
Tanto contas pessoais quanto comerciais. A Accounts API do TikTok define três níveis: a conta geral do TikTok, com que todos começam; uma conta com Advanced Access, vinculada a uma conta TikTok for Business ou a uma Business Center não verificada; e a conta comercial 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 comercial verificada.
Como se cadastrar e obter a aprovação do app?
Como empresa, no portal TikTok for Business Developers, em três etapas que o TikTok revisa:
- Cadastro de desenvolvedor: um e-mail de domínio corporativo verificado e um site público da empresa, em um domínio que a empresa possua; o TikTok responde em três dias úteis e não cadastra desenvolvedores individuais.
- Accounts API Access Application Form: obrigatório desde 20 de março de 2026 antes de um novo app, ou de um aumento de escopo, que inclua a permissão TikTok Accounts.
- App de desenvolvedor: seus usos previstos e quem pode acessá-lo, uma URL de redirecionamento e a permissão TikTok Accounts, revisados em 2 a 3 dias úteis, com até cinco apps por desenvolvedor.
Quais permissões e escopos o app precisa?
Duas camadas, concedidas por pessoas diferentes. O app de desenvolvedor tem permissões dentro de TikTok Accounts, escolhidas em Scope of permission e revisadas pelo TikTok, e cada uma libera endpoints. A aprovação do titular da conta coloca escopos no token de acesso, e eles liberam campos e recursos, como user.insights para métricas diárias da conta, video.list e video.insights para dados das postagens, video.upload para rascunhos e comment.list para o webhook de comentários. /tt_user/token_info/get/ lista os escopos que um token carrega.
Como uma conta autoriza o app, e para que servem os tokens?
O titular abre a URL de autorização do titular da conta do app, encontrada em My Apps, App Detail, Basic Information, e aprova suas permissões. O TikTok redireciona para a URL de redirecionamento do app com um auth_code, e o servidor o troca em /tt_user/oauth2/token/ por um token de acesso válido por 24 horas, um refresh token válido por um ano e o open_id da conta. O token segue no cabeçalho Access-Token, e o open_id em business_id em cada chamada da Accounts API; /tt_user/oauth2/refresh_token/ renova o token.
Como publicar um vídeo e uma foto?
Com um POST para cada, a partir de URLs que o próprio TikTok baixa, em um domínio ou prefixo de URL verificado para o app. /business/video/publish/ recebe business_id, video_url e post_info, que traz 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. As duas respostas trazem um share_id, e o TikTok publica até seis postagens por minuto e 15 por dia por conta em cada um deles.
Como saber que a postagem foi ao ar?
Consulte /business/publish/status/ com business_id e o share_id como publish_id, ou inscreva o app nos webhooks de publicação. O status passa de PROCESSING_DOWNLOAD para PUBLISH_COMPLETE, ou para em FAILED com um motivo como frame_rate_check_failed, e SEND_TO_USER_INBOX indica um rascunho. Os post_ids chegam quando a postagem já pode ser vista publicamente, até três minutos após PUBLISH_COMPLETE, e /business/video/list/ filtra por esses IDs para ler as métricas da postagem.
Como ler e responder comentários?
Nas próprias postagens da conta, por video_id, que é o item_id de /business/video/list/. GET /business/comment/list/ retorna 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 elevou de 150 em 7 de agosto de 2026. Outros endpoints ocultam um comentário ou o exibem novamente, e apagam comentários que a própria conta escreveu.
Como funcionam os webhooks na API for Business?
Por app, e não por conta. POST /business/webhook/update/ com o app_id, o secret, um event_type e uma callback_url HTTPS inscreve o app: VIDEO traz os quatro eventos de publicação de postagens, e COMMENT traz comment.update em até cinco minutos após uma mudança. Cada entrega vem assinada no cabeçalho Tiktok-Signature com um HMAC-SHA256 chaveado pelo secret do app, precisa de uma resposta HTTP 200 imediatamente e, se não a receber, é repetida por até 72 horas.
De onde vêm os insights?
De dois endpoints. GET /business/get/ retorna o perfil e as métricas diárias da conta, como followers_count, video_views, profile_views e likes, de até 60 dias atrás em UTC. GET /business/video/list/ retorna os totais vitalícios de cada postagem, de video_views e reach até average_time_watched, até 20 postagens por página. A maioria dos totais chega com 24 a 48 horas de atraso, e cada campo precisa do seu escopo no token.
Quais limites moldam a integração?
Quatro, cada um contado separadamente:
- 40 chamadas por minuto por conta autorizada em cada endpoint da Accounts API.
- 600 chamadas por minuto para as chamadas da Accounts API de um app somadas no nível Basic, e 1,000 acima dele.
- Seis postagens por minuto e 15 por dia por conta em cada endpoint de publicação.
- Código 40100 dentro de uma resposta HTTP 200 quando o TikTok limita uma chamada: pausar por 5 minutos após um limite por minuto, ou até 00:00 UTC após um limite diário.
Qual é o caminho pelo easyCoexistence?
Mais curto, porque o easyCoexistence já fez o lado do desenvolvedor com seu próprio app da API for Business e sua rota de mídia verificada. Uma conta pessoal ou comercial se conecta ao fazer login no TikTok, e Claude, ChatGPT ou sua própria plataforma passam a trabalhar com ela por meio de um conector MCP ou da Partner API, sem cadastro, revisão de app nem servidor de tokens próprio:
Erros comuns
- Enviar o app antes do formulário de acesso. Desde 20 de março de 2026, o TikTok exige o Accounts API Access Application Form primeiro para um novo app ou pedido de escopo que inclua TikTok Accounts.
- Hospedar mídia em um domínio que o app não verificou. O TikTok baixa video_url e photo_images por conta própria e recusa URLs fora de um domínio ou prefixo de URL verificado.
- Projetar para uma só conta. Tokens, business_id e o limite de 40 por minuto pertencem a cada conta, enquanto as configurações de webhook e o orçamento combinado de chamadas pertencem ao app; modele os dois níveis desde o início.
- Pedir só os escopos que o recurso de hoje precisa. Um token mantém os escopos que o titular aprovou, então adicionar comentários ou insights depois significa que cada titular autoriza o app de novo.
De US$ 9 a US$ 0.75 por conexão ao mês, caindo conforme você adiciona conexões, com os primeiros 3 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
Preciso de um app de desenvolvedor do TikTok separado para cada conta de cliente?
Não. Um único app de desenvolvedor atende as contas que o autorizam, cada uma com seu próprio token e business_id, e o TikTok permite até cinco apps por desenvolvedor.
A Accounts API é a mesma coisa que a Marketing API do TikTok?
Não. As duas ficam na API for Business, mas a Marketing API roda anúncios com tokens de anunciante que não expiram, enquanto a Accounts API usa tokens de conta do TikTok que duram um dia.
Qual versão da API do TikTok o código novo deve usar?
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 mudanças incompatíveis em novas versões.
Quanto custa o easyCoexistence por conta do TikTok?
De US$ 9 a US$ 0.75 por conexão ao mês, definido pela faixa em que fica sua contagem total, com os primeiros 3 dias grátis. Cada conta do TikTok é uma conexão.
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