EntrarComeçar teste grátis
easyCoexistence APIs oficiais

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.

share_id

Retornado pela chamada de publicação, como v_pub_url~v1.2345123456789123456, e enviado à chamada de status como publish_id.

Nov 16, 2023

Desde então, o TikTok recusa publicar vídeos de URLs cujo domínio ou prefixo de URL não esteja verificado.

6 a minute

Limite do TikTok para publicações de vídeo por conta pelo endpoint de publicação, com no máximo 15 por dia.

3 min

Tempo que os post_ids podem levar para aparecer após PUBLISH_COMPLETE; o TikTok recomenda repetir a consulta após três minutos.

post_id

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:

Publish a video with curl
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: o open_id da 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_organic e is_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_duet e disable_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.

The publish response
{
  "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:

Publish and follow a video in 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"])
        break

Um 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.

The MCP tool calls and their results
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.

Credentials from the Partner API, then a direct status check
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

  1. 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.
  2. 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.
  3. 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/.
  4. Keep the share_idStore data.share_id from the response, the ID of this publishing task.
  5. Check the statusEvery few minutes, GET /business/publish/status/ with business_id and the share_id as publish_id, until PUBLISH_COMPLETE or FAILED.
  6. 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.
Fazendo isso com o EasyCoexistence

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