EntrarComeçar teste grátis
easyCoexistence APIs oficiais

URLs de mídia do TikTok: domínios verificados e prefixos de URL

A API for Business do TikTok baixa a mídia das publicações a partir de URLs: video_url, custom_thumbnail_url e photo_images. Cada URL precisa estar em um domínio ou prefixo de URL cuja propriedade o app de desenvolvedor tenha verificado. Um domínio é verificado com um registro DNS TXT, e um prefixo com um arquivo de assinatura colocado sob ele, pelas rotas /business/property/add/ e /business/property/verify/ com o app_id e o secret do app.

O easyCoexistence entrega sua mídia ao TikTok a partir do próprio prefixo de URL verificado: o publish_tiktok_post recebe um link HTTPS do Claude, do ChatGPT ou do seu próprio código e transmite o arquivo a partir dele quando o TikTok faz o download, então seu domínio não precisa de verificação.

Nov 16, 2023

Desde então, o TikTok recusa URLs de vídeo que não estejam em um domínio ou prefixo de URL verificado.

Oct 15, 2025

Desde então, as rotas de propriedades de URL também exigem o secret do app de desenvolvedor.

1 / 2

Valores de property_type: 1 para domínio, 2 para prefixo de URL.

0, 1, 2

Valores de property_status: pending, verified e not verified, quando a tentativa falhou e precisa ser repetida.

Apr 7, 2023

Desenvolvedores que publicaram vídeos antes disso tiveram os domínios dessas URLs de vídeo marcados como verificados automaticamente.

5 MB

Tamanho máximo de imagem aceito por /business/comment/image/upload/, enviado como dados de formulário multipart, para um comentário ou uma resposta.

Quais URLs o TikTok baixa?

Todo campo de mídia nos dois endpoints de publicação é uma URL que o próprio TikTok busca depois de aceitar a chamada, então o arquivo precisa continuar acessível até o download terminar:

  • video_url: o vídeo, que o TikTok recomenda manter válido por pelo menos 30 minutos.
  • custom_thumbnail_url: uma imagem para usar como capa do vídeo.
  • photo_images: até 35 imagens para uma publicação de fotos.
  • Tempo limite: o TikTok dá uma hora para o download e, depois, falha a publicação com video_pull_failed ou photo_pull_failed.

Qual é a diferença entre domínio e prefixo de URL?

O que você comprova que possui e, portanto, quais URLs contam como verificadas. Um domínio serve para mídia em um host que você possui ou controla; um prefixo serve para uma pasta em um host onde você só consegue enviar arquivos. As regras do TikTok para cada tipo de propriedade:

DomainURL prefix
What it isA site you own, such as example.com or a subdomainhttps:// plus a host, a path and a final /, such as https://www.example.com/videos/
ProofA DNS TXT record holding the signatureA file named file_name, holding the signature, uploaded under the prefix
CoversURLs on the domain and its subdomainsURLs that begin with the prefix
Leaves outThe parent: verifying video.example.com leaves example.com unverifiedSibling paths: /folder/user/ leaves /folder/public/ unverified
RedirectsNot applicableNot followed; a prefix answering 3xx is invalid

Como você verifica uma propriedade?

Por meio de duas chamadas que se autenticam com o app_id e o secret do app de desenvolvedor, em vez de um token de conta, com a prova colocada entre elas:

  • Adicionar: POST /business/property/add/ com url_property_meta, contendo property_type e url; a resposta traz signature, além de file_name para um prefixo, com property_status 0.
  • Provar: coloque a signature em um registro DNS TXT para um domínio, ou em um arquivo público chamado file_name, com extensão .txt única, sob um prefixo.
  • Checar: POST /business/property/verify/ com o mesmo url_property_meta; property_status 1 significa verificado, e 2 significa que a tentativa falhou.
Add a URL prefix
curl -X POST 'https://business-api.tiktok.com/open_api/v1.3/business/property/add/' \
  -H 'Content-Type: application/json' \
  -d '{
    "app_id": "<APP_ID>",
    "secret": "<APP_SECRET>",
    "url_property_meta": { "property_type": 2, "url": "https://media.example.com/tiktok/" }
  }'

# data.url_property_info: url, property_type, property_status (0), signature, file_name

Como você lista ou remove propriedades?

GET /business/property/list/ com app_id e secret retorna url_property_info_list, cada entrada com property_type, url, property_status, signature e file_name. Subdomínios de um domínio verificado contam como verificados sem uma chamada própria, mas aparecem na lista apenas se tiverem sido adicionados. POST /business/property/delete/ com app_id, secret e url_property_meta remove uma propriedade que o app não possui nem controla mais.

Você pode enviar um arquivo em vez de uma URL?

Não para publicações. A Accounts API publica somente a partir de URLs, inclusive rascunhos, e seu único endpoint de upload, /business/comment/image/upload/, recebe a imagem de um comentário como dados de formulário multipart, em JPG, JPEG, WebP ou PNG de até 5 MB, e retorna um image_uri para um comentário ou resposta. Upload de arquivo em partes pertence à Content Posting API em developers.tiktok.com, uma API separada com apps próprios, onde o método de transferência se chama FILE_UPLOAD.

O que acontece com uma URL não verificada?

O TikTok recusa publicar a partir dela. A referência da API for Business declara a regra para vídeos e fotos, mas não define um código de retorno próprio para ela, então leia o código e a mensagem na resposta. A Content Posting API em developers.tiktok.com chama o mesmo caso de url_ownership_unverified, com HTTP 403. Para testar o endpoint de vídeo antes de qualquer propriedade ser verificada, o TikTok publica uma URL de vídeo de teste que não precisa de verificação:

TikTok's test video URL for /business/video/publish/
https://sf16-va.tiktokcdn.com/obj/eden-va2/uvpapzpbxjH-aulauvJ-WV[[/ljhwZthlaukjlkulzlp/3min.mp4

Como o easyCoexistence leva sua mídia ao TikTok?

Por meio de um prefixo de URL verificado próprio, https://easycoexistence.com/api/social/media/. O publish_tiktok_post aceita seu link HTTPS, recusa http:// antes de enviar qualquer coisa e entrega ao TikTok um link sob esse prefixo, com um token assinado que identifica seu arquivo, expira em 6 horas e mantém a extensão do arquivo. Quando o TikTok busca o link, o easyCoexistence verifica o token, confirma que seu link usa HTTPS em um endereço público e transmite o arquivo diretamente do seu link, incluindo requisições por intervalo (range) e redirecionamentos, sem armazená-lo. Se seu link falhar, o TikTok não consegue baixar o arquivo e a publicação falha.

What TikTok receives in place of your link
Your link:       https://cdn.example.com/videos/launch.mp4
Sent to TikTok:  https://easycoexistence.com/api/social/media/<SIGNED_TOKEN>.mp4

Erros comuns

  • Verificar um subdomínio e hospedar os arquivos no domínio pai. Um video.example.com verificado cobre os próprios subdomínios, não o example.com em si.
  • Servir o arquivo de assinatura do prefixo por meio de um redirecionamento. O TikTok não segue redirecionamentos para um prefixo de URL e trata uma resposta 3xx como inválida.
  • Salvar o arquivo de assinatura como name.txt.txt. O TikTok exige que o nome do arquivo corresponda a file_name, com uma única extensão .txt.
  • Apagar o arquivo logo após a chamada de publicação. O TikTok baixa o arquivo depois, por até uma hora, e falha a publicação se o link deixar de funcionar.
Fazendo isso com o EasyCoexistence

US$ 9 a US$ 0,75 por número conectado por mês, com preço caindo conforme você adiciona números, e 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

Por que o TikTok exige URLs de mídia verificadas?

O TikTok diz que verificar a propriedade das URLs de vídeo o ajuda a cumprir suas políticas sobre conteúdo protegido por direitos autorais e segurança do usuário.

Um domínio do TikTok verificado cobre seus subdomínios?

Sim. Subdomínios de um domínio verificado contam como verificados, embora /business/property/list/ os mostre apenas se tiverem sido adicionados.

A API for Business do TikTok pode publicar a partir de um link S3 ou CDN?

Sim, quando o link estiver sob um domínio ou prefixo de URL que o app tenha verificado, como um prefixo em um bucket ou caminho de CDN que você controla.

Publicações de fotos também precisam de URLs verificadas?

Sim. O endpoint de fotos do TikTok declara que publicações de fotos não podem ser feitas a partir de URLs de fotos não verificadas.

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