Como publicar um vídeo no TikTok pela API
Para publicar um vídeo pela API for Business do TikTok, envie POST /business/video/publish/ com o business_id da conta, um video_url em um domínio ou prefixo de URL verificado e um objeto post_info com a legenda e as configurações, junto com o cabeçalho Access-Token. O TikTok responde com um share_id; passe-o como publish_id para /business/publish/status/ até que o status indique PUBLISH_COMPLETE e os post_ids apareçam.
O easyCoexistence publica vídeos do TikTok com publish_tiktok_post a partir do Claude, do ChatGPT ou do seu próprio agente: passe um link HTTPS, a legenda e se os comentários estão ativados, e depois acompanhe a publicação com get_tiktok_publish_status, enquanto o arquivo chega ao TikTok pela sua rota de mídia verificada.
Retornado pela chamada de publicação, como v_pub_url~v1.2345123456789123456, e enviado à chamada de status como publish_id.
Desde então, o TikTok recusa publicar vídeos de URLs cujo domínio ou prefixo de URL não esteja verificado.
Limite do TikTok para publicações de vídeo por conta pelo endpoint de publicação, com no máximo 15 por dia.
Tempo que os post_ids podem levar para aparecer após PUBLISH_COMPLETE; o TikTok recomenda repetir a consulta após três minutos.
Enviado no webhook post.publish.publicly_available assim que uma publicação passa pela moderação, pronta para consultar suas métricas.
O que você precisa antes da primeira chamada?
Três coisas. Um access token da conta do TikTok e o open_id da conta, obtidos na troca de token; um app de desenvolvedor com a permissão Video Publish em TikTok Accounts; e o vídeo em uma URL HTTPS ou HTTP pública, que esteja em um domínio ou prefixo de URL verificado para o app. O TikTok baixa o arquivo por conta própria, então ele precisa continuar acessível, e o TikTok recomenda uma URL que dure pelo menos 30 minutos.
Como é a requisição de publicação?
Um POST para https://business-api.tiktok.com/open_api/v1.3/business/video/publish/ com o token da conta no cabeçalho Access-Token e Content-Type definido como application/json. O corpo JSON informa a conta em business_id, o arquivo em video_url e as configurações da publicação em post_info; este publica um vídeo com legenda, deixando comentários, Duet e Stitch ativados:
curl -X POST 'https://business-api.tiktok.com/open_api/v1.3/business/video/publish/' \
-H 'Access-Token: <ACCESS_TOKEN>' \
-H 'Content-Type: application/json' \
-d '{
"business_id": "<OPEN_ID>",
"video_url": "https://media.example.com/tiktok/launch.mp4",
"post_info": {
"caption": "Our new menu is live #food",
"is_brand_organic": false,
"is_branded_content": false,
"disable_comment": false,
"disable_duet": false,
"disable_stitch": false
}
}'Para que serve cada campo do corpo?
Os campos que a referência do TikTok lista para uma publicação de vídeo, começando pelo nível superior. A capa, o rótulo de conteúdo gerado por IA, uma localização, rascunhos e a opção somente para anúncios ficam no mesmo corpo:
business_id: oopen_idda conta obtido na troca de token.video_url: o arquivo que o TikTok baixa, em MP4, MOV ou WebM, em um domínio ou prefixo de URL verificado.post_info: obrigatório em todas as chamadas, mesmo como objeto vazio, e onde ficam as configurações da publicação.post_info.caption: até 2,200 caracteres contados em UTF-16, com #hashtags e até 30 @menções.post_info.is_brand_organiceis_branded_content: os rótulos Conteúdo promocional e Parceria paga, que a tabela do TikTok marca como obrigatórios.post_info.disable_comment,disable_duetedisable_stitch: true desativa comentários, Duet ou Stitch; os três são false por padrão.
O que o TikTok retorna?
O envelope habitual, com o ID da tarefa de publicação em data. Um código 0 significa que o TikTok aceitou a tarefa, não que o vídeo está no ar: o TikTok ainda precisa baixar o arquivo, verificá-lo e moderar a publicação. Nos exemplos do TikTok, o share_id de um vídeo começa com v_pub_url, e o de uma publicação de foto com p_pub_url.
{
"code": 0,
"message": "Ok",
"request_id": "20210817034316010245031056097316BA",
"data": {
"share_id": "v_pub_url~v1.2345123456789123456"
}
}Como acompanhar a publicação até ela ficar no ar?
Com GET /business/publish/status/, passando business_id e o share_id como publish_id. O status indica PROCESSING_DOWNLOAD enquanto o TikTok busca o arquivo, PUBLISH_COMPLETE quando a publicação passa pela moderação, ou FAILED com um motivo. Os post_ids chegam junto com PUBLISH_COMPLETE quando a publicação está visível publicamente, e podem atrasar até três minutos. O fluxo completo em Python:
import os, time, requests
API = "https://business-api.tiktok.com/open_api/v1.3"
HEADERS = {"Access-Token": os.environ["TIKTOK_ACCESS_TOKEN"]}
BUSINESS_ID = os.environ["TIKTOK_BUSINESS_ID"] # open_id from the token exchange
def call(method, path, **kwargs):
body = requests.request(method, f"{API}/{path}", headers=HEADERS, timeout=30, **kwargs).json()
if body.get("code") != 0: # errors arrive in code, usually with HTTP 200
raise RuntimeError(f"{body.get('code')}: {body.get('message')}")
return body["data"]
share_id = call("POST", "business/video/publish/", json={
"business_id": BUSINESS_ID,
"video_url": "https://media.example.com/tiktok/launch.mp4",
"post_info": {"caption": "Our new menu is live #food",
"is_brand_organic": False, "is_branded_content": False},
})["share_id"]
for _ in range(30):
time.sleep(60) # each check is a call; TikTok's stages take minutes
s = call("GET", "business/publish/status/",
params={"business_id": BUSINESS_ID, "publish_id": share_id})
if s["status"] == "FAILED":
raise RuntimeError(s.get("reason"))
if s["status"] == "PUBLISH_COMPLETE" and s.get("post_ids"):
print("Live:", s["post_ids"])
breakUm webhook pode substituir as consultas de status?
Sim, para um app que assina o event_type VIDEO com /business/webhook/update/. O TikTok então envia post.publish.failed ou post.publish.complete depois de baixar e verificar o arquivo, post.publish.publicly_available com o novo post_id quando a moderação é aprovada, e post.publish.no_longer_publicly_available se a publicação deixar de ser pública depois. Cada evento identifica a tarefa em publish_id, o mesmo valor do share_id.
Como publicar um vídeo pelo MCP?
Peça em linguagem simples ao Claude, ao ChatGPT ou a outro cliente conectado a https://easycoexistence.com/api/mcp. O assistente chama publish_tiktok_post com o account_id obtido em list_social_accounts, um video_url HTTPS, a legenda e, se quiser comentários desativados, disable_comment. O resultado traz o share_id do TikTok, e get_tiktok_publish_status, dados o account_id e esse share_id, retorna o status, os post_ids e o motivo do TikTok exatamente como estão.
publish_tiktok_post {
"account_id": "<ACCOUNT_ID>",
"video_url": "https://media.example.com/tiktok/launch.mp4",
"caption": "Our new menu is live #food",
"disable_comment": false
}
=> { "share_id": "v_pub_url~v1.2345123456789123456",
"note": "TikTok is processing the post. Check it with get_tiktok_publish_status." }
get_tiktok_publish_status { "account_id": "<ACCOUNT_ID>", "share_id": "v_pub_url~v1.2345123456789123456" }
=> { "status": "PUBLISH_COMPLETE", "post_ids": ["<POST_ID>"] }O que publish_tiktok_post envia ao TikTok?
Uma chamada para o mesmo endpoint, preenchida a partir da sua requisição. Seu link vai ao TikTok como um link assinado pela rota de mídia verificada do easyCoexistence, portanto não exige verificação própria; a legenda e disable_comment seguem como você informou; e is_brand_organic e is_branded_content seguem como false. As demais configurações, como Duet, Stitch, a capa e o rótulo de conteúdo gerado por IA, mantêm os padrões do TikTok, e o vídeo é publicado como publicação pública, como o endpoint foi feito para fazer.
O que dá para fazer com credenciais da Partner API?
Chamar o TikTok diretamente como a conta. GET /channels/{id}?credentials=1 em https://easycoexistence.com/api/v1, com sua chave ec_live_ como bearer token, retorna o canal com um objeto credentials: api_base, business_id, um access_token atual e token_expires_at. Consultas de status, listas de vídeos, comentários e métricas podem então rodar no seu próprio código. A publicação é a parte que exige planejamento: uma chamada direta de publicação passa o video_url ao TikTok sem alterações, as propriedades de URL são adicionadas com o ID e o secret de um app de desenvolvedor próprio, e o prefixo que o app do easyCoexistence verificou é a sua rota de mídia, que o publish_tiktok_post usa.
curl "https://easycoexistence.com/api/v1/channels/$CHANNEL_ID?credentials=1" \
-H "Authorization: Bearer $EC_API_KEY"
# "credentials": {
# "platform": "tiktok",
# "api_base": "https://business-api.tiktok.com/open_api/v1.3",
# "business_id": "<OPEN_ID>",
# "access_token": "<ACCESS_TOKEN>",
# "token_expires_at": "2026-11-01T09:00:00.000Z", ...
# }
curl -G 'https://business-api.tiktok.com/open_api/v1.3/business/publish/status/' \
-H 'Access-Token: <ACCESS_TOKEN>' \
--data-urlencode 'business_id=<OPEN_ID>' \
--data-urlencode 'publish_id=<SHARE_ID>'Como configurar
- Get the token and the account IDExchange the owner's authorization code at /tt_user/oauth2/token/, and keep access_token for the header and open_id for business_id.
- Host the videoPut the MP4, MOV or WebM file under a domain or URL prefix verified for your app, where it stays reachable for at least 30 minutes.
- Call the publish endpointPOST business_id, video_url and post_info, with the caption, the two brand flags and the engagement switches, to /business/video/publish/.
- Keep the share_idStore data.share_id from the response, the ID of this publishing task.
- Check the statusEvery few minutes, GET /business/publish/status/ with business_id and the share_id as publish_id, until PUBLISH_COMPLETE or FAILED.
- Record the post IDTake it from post_ids, or from post_id in the post.publish.publicly_available webhook, to read the video's metrics later.
Erros comuns
- Deixar de fora o post_info. O TikTok exige o objeto em todas as chamadas, mesmo quando nenhuma configuração muda.
- Procurar um ID de publicação na resposta da publicação. Ela retorna apenas o share_id; os IDs das publicações vêm da chamada de status ou do webhook publicly_available.
- Repetir uma chamada de publicação que expirou por tempo limite. A primeira requisição pode ter chegado ao TikTok, então verifique as publicações mais recentes da conta antes de enviá-la de novo.
- Tratar o código 0 como vídeo no ar. Ele significa que o TikTok aceitou a tarefa, e o arquivo ainda pode falhar nas verificações depois do download.
De US$ 9 a US$ 0.75 por conexão por mês, com a queda conforme você adiciona conexões, e 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
Qual endpoint publica um vídeo no TikTok?
POST https://business-api.tiktok.com/open_api/v1.3/business/video/publish/, com o token da conta no cabeçalho Access-Token e business_id, video_url e post_info no corpo JSON.
A API do TikTok pode enviar um arquivo de vídeo diretamente?
Não por /business/video/publish/. O endpoint recebe video_url e busca o arquivo a partir dali, então o vídeo precisa de uma URL em um domínio ou prefixo de URL verificado.
Como obtenho o ID de um vídeo publicado pela API?
Pelos post_ids em /business/publish/status/ quando o status for PUBLISH_COMPLETE e a publicação estiver pública, ou pelo post_id no webhook post.publish.publicly_available.
Posso agendar um vídeo do TikTok para depois pela API?
O endpoint de publicação publica no momento em que é chamado e não tem campo de horário. O easyCoexistence guarda as publicações agendadas na própria fila e chama o TikTok no horário que você definir.
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